adding details to rest API calls for role updates opensearch-project#…

…7234 (opensearch-project#7254)

* adding details to rest API calls for role updates opensearch-project#7234

Signed-off-by: AntonEliatra <anton.rubin@eliatra.com>

* Update _security/access-control/api.md

Signed-off-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com>

---------

Signed-off-by: AntonEliatra <anton.rubin@eliatra.com>
Signed-off-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com>
Co-authored-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com>

_security/access-control/api.md

@@ -815,18 +815,24 @@ Creates, updates, or deletes multiple roles in a single call.
 PATCH _plugins/_security/api/roles
 [
   {
-    "op": "replace", "path": "/role1/index_permissions/0/fls", "value": ["test1", "test2"]
+    "op": "replace", "path": "/role1/index_permissions/0/fls", "value": ["myfield*", "~myfield1"]
   },
   {
     "op": "remove", "path": "/role1/index_permissions/0/dls"
   },
   {
-    "op": "add", "path": "/role2/cluster_permissions", "value": ["manage_snapshots"]
+    "op": "add", "path": "/role2/cluster_permissions/-", "value": {
+      "index_patterns": ["test_index"],
+      "allowed_actions": ["indices:data/read/scroll/clear"]
+    }
   }
 ]
 ```
 {% include copy-curl.html %}
 
+You can use `-` to insert a new permission to the end of the array of permissions.
+{: .note}
+
 #### Example response
 
 ```json