fix(mongodb): apply role

Author: ldecarvalho-doc

pages/managed-mongodb-databases/how-to/manage-users.mdx

@@ -42,7 +42,7 @@ You can create more users and grant them pre-set roles via the [Scaleway Managed
 
 ### How to create a user
 
-1. Edit the POST request payload you will use to create your user. Replace the values of each parameters with your values of choice following the parameter descriptions below.
+1. Edit the POST request payload you will use to create your user. Replace the values of each parameter with your values of choice following the parameter descriptions below.
     ```
       {
         "name": "<username>",
@@ -63,24 +63,83 @@ You can create more users and grant them pre-set roles via the [Scaleway Managed
       -d '{
         "name": "<username>",
         "password": "<password>",
-    }' \
+          }' \
       "https://api.scaleway.com/mongodb/v1alpha1/regions/fr-par/instances/{instance_id}/users"
     ```
 
     You should get a response like the following:
     ```
     {
-        "name": "<username>",
-        "password": "<password>",
+      "name": "<username>",
+      "password": "<password>",
         "roles": [
-            {
-                "role": "<username>",
-                "database": "<password>",
-                "any_database": true
-            }
+          {
+            "role": "read_write",
+            "any_database": true
+          },
+          {
+            "role": "db_admin",
+            "any_database": true
+          },
+          {
+            "role": "sync",
+            "any_database": true
+          }
         ]
     }
     ```
 
+All users you create will have the `read_write`, `db_admin` and `sync` roles by default.
+
+You can follow the steps below to update a user's role(s) to the one(s) of your choice.
+
 ### How to apply a role to a user
 
+1. Edit the POST request payload you will use to update the user role. Replace the values of each parameter with your values of choice following the parameter descriptions below.
+
+    In this example, we define a single `read_write` role for the user.
+
+    ```
+    {
+      "name": "<username>",
+      "roles": [
+        {
+          "role": "read_write",
+          "any_database": true
+        }
+      ]
+    }
+    ```
+
+    | Role        | Description                                                        |
+    | :--------------- | :----------------------------------------------------------------- |
+    | `read`     | Read rights on the database |
+    | `read_write`           | Read and write rights on the database|
+    | `db_admin`           | |
+    | `sync`           | |
+
+2. Run the following command to apply a new role to the user. Make sure you include the payload you edited in the previous step and that you replace the parameters in the call with your information. `{instance_id}` corresponds to the UUID of the Managed MongoDB®.
+
+    ```
+    curl -X PUT \
+      -H "X-Auth-Token: $SCW_SECRET_KEY" \
+      -H "Content-Type: application/json" \
+      -d '{
+        "name": "<username>",
+        "roles": [
+          {
+            "role": "read_write",
+            "any_database": true
+          }
+        ]
+      }' \
+      "https://api.scaleway.com/mongodb/v1alpha1/regions/$SCW_REGION/instances/{instance_id}/roles"
+    ```
+
+    If the call was successful, you will get the payload with the new roles as a response.
+
+    <Message type="note">
+      Assigning roles upon user creation will be available shortly. Refer to the [Scaleway Changelog](/docs/changelog/?product=mongodb) to keep up with the latest Managed MongoDB® updates.
+    </Message>
+
+