# Deep Security Manager REST API

## Path: / rest / administrator-roles / {roleID} / host-groups

Update an administrator role with an additional set of host groups.

Administrator roles can have access to all host groups or can be restricted to a set of listed host groups (and any child host groups of the listed host groups). Administrators will have access to any host in the set of allowed host groups (and any child host group of the listed host groups).

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

Path parameters:
  roleID - the role ID.

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

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

Method Detail
Update an administrator role with a new (complete) set of host groups. Administrator roles can have access to all host groups or can be restricted to a set of listed host groups (and any child host groups of the listed host groups). Administrators will have access to any host in the set of allowed host groups (and any child host group of the listed host groups). Any pre-existing host groups for the role will be replaced by the host groups specified in the request. Input: `ModifyAdministratorRoleHostGroupsRequest` - an {@link ModifyAdministratorRoleHostGroupsRequest} with the new host groups 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 host groups. Administrator roles can have access to all host groups or can be restricted to a set of listed host groups (and any child host groups of the listed host groups). Administrators will have access to any host in the set of allowed host groups (and any child host group of the listed host groups). Any pre-existing host groups for the role will be retained and augmented by the host groups specified by the request. Input: `AddAdministratorRoleHostGroupsRequest` - an {@link AddAdministratorRoleHostGroupsRequest} with the new host groups 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.