com.atlassian.confluence.content.render.xhtml.migration.exceptions.UnknownMacroMigrationException: The macro 'next_previous_link3' is unknown.

Updating Role Details

Description

There will be situations where you will need to update the role details, such as the permissions or the role name. In such situation you can update the role details using the REST API given below.

URL/mdm-admin/roles?rolename={rolename}
HTTP MethodPUT
Request/Response Formatapplication/json
cURL command
curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer <EMM_API_TOKEN>" -d @'<JSON_PAYLOAD>' -k -v https://<EMM_HOST>:<EMM_HTTPS_PORT>/mdm-admin/roles?rolename={rolename} 
  • For more information on how to generate the <EMM_API_TOKEN>, see Generating the EMM API Token.
  • Define the path to the JSON file, which includes the required properties to update the role as the <JSON_PAYLOAD> value. For more information, see the Sample JSON Definition.
  • By default, <EMM_HOST> is localhost. However, if you are using a public IP, the respective IP address or domain needs to be specified.
  • By default, <EMM_HTTPS_PORT> has been set to 9443. However, if the port offset has been incremented by n, the default port value needs to be incremented by n.
  • Provide the name of the role you wish to update as the value for {rolename}.

Example:

curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer 33392fb365b3ac693b405b565ddc8a3a" -d @'role.json' -k -v https://localhost:9443/mdm-admin/roles?rolename=engineer 
 Sample output
> PUT /mdm-admin/roles?rolename=engineer HTTP/1.1
> Host: localhost:9443
> User-Agent: curl/7.43.0
> Accept: */*
> Content-Type: application/json
> Authorization: Bearer 33392fb365b3ac693b405b565ddc8a3a
> Content-Length: 103
< HTTP/1.1 200 OK
< Cache-Control: private
< Expires: Thu, 01 Jan 1970 05:30:00 IST
< Date: Sun, 06 Mar 2016 13:34:18 GMT
< Content-Length: 0
< Server: WSO2 Carbon Server
Sample JSON Definition 
{
  "roleName": "engineer",
  "permissions": [
    "device-mgt/policies/view"
  ],
  "users": [
    "tom"
  ]
}
PropertyDefinitionData
Type 
roleName

Define the name of the role you wish to create.

String
permissions

Provide the permissions that needs to be associated with the role. You can keep this property empty and update it later on.

For more information on the permissions, see permissions associated with the APIs.

String
usersProvide the users that belong to the role you are creating. You can keep this property empty and update it later on.String
com.atlassian.confluence.content.render.xhtml.migration.exceptions.UnknownMacroMigrationException: The macro 'next_previous_links2' is unknown.