CategorySetPermissions
Allows you to specify which role has access permissions for a specific category, and what these access permissions are for role members and non-members.
NOTE: This is an administrative action that can be sent only by users that belong to an authorization role that allows the Admin
standard role, or which enables the action explicitly. See Authorization Roles Configuration Parameters.
NOTE: To set general role privileges, you must use the RoleSetPrivilegeForRole action.
Example
http://12.3.4.56:9000/action=CategorySetPermissions&Category=32349987602210557106&Role=USA&MemberPermissions=Read
This action grants all members of the USA
role Read
access to the category with the ID 32349987602210557106
.
Required Parameters
The following action parameters are required.
Parameter | Description |
---|---|
Category | The ID of the category to set permissions for. |
You must set at least one of the following parameters.
Parameter | Description |
---|---|
MemberPermissions | The permissions to grant to role members. |
NonMemberPermissions | The permissions to grant to non-members of the role. |
Role | The role for which to set category access permissions. |
Optional Parameters
This action accepts the following optional parameters.
Parameter | Description |
---|---|
Recurse | Apply the permission changes to the children of the category. |
UserName | The name of the user that sends the action. |
This action accepts the following standard ACI action parameters.
Parameter | Description |
---|---|
ActionID | A string to use to identify an ACI action. |
EncryptResponse | Encrypt the output. |
FileName | The file to write output to. |
ForceTemplateRefresh | Forces the server to load the template from disk. |
Output | Writes output to a file. |
ResponseFormat | The format of the action output. |
Template | The template to use for the action output. |
TemplateParamCSVs | A list of variables to use for the specified template. |
Comments
You must set one of the following parameters: