# Deep Security Manager REST API

## Path: / rest / administrator-roles

List administrator roles.

Resources
Name | Description
--- | ---
{roleID} | Describe an administrator role.

Method Summary
Resource | Description
--- | ---
`GET /rest/administrator-roles?administratorRoleID=…&administratorRoleIDOp=…&maxItems=…` | List administrator roles.
`POST /rest/administrator-roles` | Create a new administrator role.

Method Detail
List administrator roles. Output: `ListAdministratorRolesResponse` - a {@link ListAdministratorRolesResponse} with the administrator roles. Query parameters: administratorRoleID - (optional) used to define the starting point for the query. Combine with `administratorRoleIDOp` to page through results. administratorRoleIDOp - (optional, required if `administratorRoleID` is specified) Currently supported operations are: gt (greater than) ge (greater than or equal to) eq (equal to) lt (less than) le (less than or equal to) maxItems - (optional) the number of items to retrieve. The maximum value for this parameter is controlled by the "Maximum number of items to retrieve from database" setting on the administrator account, which defaults to 5000. Cookie parameters: sID - a session ID returned by the Authentication API. Produces: application/json Consumes: application/json HTTP return codes: 200 - if the request is successful 403 - if the user is not authorized to view administrator roles
Create a new administrator role. Input: `CreateAdministratorRoleRequest` - a {@link CreateAdministratorRoleRequest} with the details of the administrator role. Output: `CreateAdministratorRoleResponse` - a {@link CreateAdministratorRoleResponse} with the details of the administrator role. Cookie parameters: sID - a session ID returned by the Authentication API. Produces: application/json Consumes: application/json HTTP return codes: 200 - if the request is successful 403 - if the user is not authorized to create administrator roles

Copyright © 2017 Trend Micro Inc. All Rights Reserved.