hostgroup.propagate

Description

object hostgroup.propagate(object parameters)

此方法允许将权限和标签筛选器应用于一个主机组的所有子组。

此方法仅适用于超级管理员用户类型。 可以在用户角色设置中撤销调用该方法的权限。 有关更多信息,请参见User roles

Parameters

(object) 参数定义了期望的输出。

此方法支持以下参数。

参数 数据类型 描述
groups object/array 要传播的Host groups

主机组必须定义了groupid属性。

参数行为:
- 必填
permissions boolean 设为"true"以传播权限。

参数行为:
- 必填 如果 tag_filters 未设置
tag_filters boolean 设为"true"以传播标签过滤器。

参数行为:
- 必填 如果 permissions 未设置

Return values

(object) 返回一个 object,其中包含传播的 主机 组的 ID,这些 ID 位于 groupids 属性下。

Examples

Propagating host group permissions and tag filters to its subgroups.

将 主机组 权限和标签筛选器传播到其子组。

执行请求:

{
           "jsonrpc": "2.0",
           "method": "hostgroup.propagate",
           "params": {
               "groups": [
                   {
                       "groupid": "6"
                   }
               ],
               "permissions": true,
               "tag_filters": true
           },
           "id": 1
       }

Response:

{
           "jsonrpc": "2.0",
           "result": {
               "groupids": [
                   "6"
               ]
           },
           "id": 1
       }

See also

Source

CHostGroup::propagate() 函数位于 ui/include/classes/api/services/CHostGroup.php 文件中。