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 文件中。