# Deep Security Manager REST API

## Path: / rest / administrator-roles / {roleID} / hosts

Update an administrator role with an additional set of hosts.

Administrator roles can have access to all hosts or can be restricted to a set of listed hosts. Access to a host may also be granted if the host is in a host group that the administrator has access to.

Any pre-existing hosts for the role will be retained and augmented by the hosts specified by the request.

Path parameters:
  roleID - the role ID.

Resources
Name | Description
--- | ---
{hostID} | Remove a host from an administrator role.

Method Summary
Resource | Description
--- | ---
`PUT /rest/administrator-roles/{roleID}/hosts` | Update an administrator role with a new (complete) set of hosts.
`POST /rest/administrator-roles/{roleID}/hosts` | Update an administrator role with an additional set of hosts.

Method Detail
Update an administrator role with a new (complete) set of hosts. Administrator roles can have access to all hosts or can be restricted to a set of listed hosts. Access to a host may also be granted if the host is in a host group that the administrator has access to. Any pre-existing hosts for the role will be replaced by the hosts specified in the request. Input: `ModifyAdministratorRoleHostsRequest` - an {@link ModifyAdministratorRoleHostsRequest} with the new hosts for the administrator role. Output: `ModifyAdministratorRoleResponse` - a {@link ModifyAdministratorRoleResponse} with the modified 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 modify administrator roles 404 - if the user is authorized to modify administrator roles but the administrator role does not exist or if the user is not authorized to modify the requested administrator role
Update an administrator role with an additional set of hosts. Administrator roles can have access to all hosts or can be restricted to a set of listed hosts. Access to a host may also be granted if the host is in a host group that the administrator has access to. Any pre-existing hosts for the role will be retained and augmented by the hosts specified by the request. Input: `AddAdministratorRoleHostsRequest` - an {@link AddAdministratorRoleHostsRequest} with the new hosts to add to the administrator role. Output: `ModifyAdministratorRoleResponse` - a {@link ModifyAdministratorRoleResponse} with the modified 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 modify administrator roles 404 - if the user is authorized to modify administrator roles but the administrator role does not exist or if the user is not authorized to modify the requested administrator role

Copyright © 2017 Trend Micro Inc. All Rights Reserved.