hostgroup.propagate

Description

object hostgroup.propagate(object parameters)

This method allows to apply permissions and tag filters to all subgroups of a host group.

This method is only available to Super admin user types. Permissions to call the method can be revoked in user role settings. See User roles for more information.

Parameters

(object) Parameters defining the desired output.

The method supports the following parameters.

ParameterTypeDescription
groupsobject/arrayHost groups to propagate.

The host groups must have the groupid property defined.

Parameter behavior:
- required
permissionsbooleanSet to “true” to propagate permissions.

Parameter behavior:
- required if tag_filters is not set
tag_filtersbooleanSet to “true” to propagate tag filters.

Parameter behavior:
- required if permissions is not set

Return values

(object) Returns an object containing the IDs of the propagated host groups under the groupids property.

Examples

Propagating host group permissions and tag filters to its subgroups.

Propagate host group permissions and tag filters to its subgroups.

Request:

  1. {
  2. "jsonrpc": "2.0",
  3. "method": "hostgroup.propagate",
  4. "params": {
  5. "groups": [
  6. {
  7. "groupid": "6"
  8. }
  9. ],
  10. "permissions": true,
  11. "tag_filters": true
  12. },
  13. "id": 1
  14. }

Response:

  1. {
  2. "jsonrpc": "2.0",
  3. "result": {
  4. "groupids": [
  5. "6",
  6. ]
  7. },
  8. "id": 1
  9. }

See also

Source

CHostGroup::propagate() in ui/include/classes/api/services/CHostGroup.php.