2022 Zabbix中国峰会
2022 Zabbix中国峰会

hostgroup.propagate

描述

object hostgroup.propagate(object parameters)

此方法可将权限和标记过滤器应用到主机组的所有子组。

该方法仅适用于 Super admin 用户类型,调用该方法的权限可在用户角色设置中撤销。 更多信息请参阅 用户角色

参数

(object) 定义所需输出的参数。

该方法支持以下参数。

参数 类型 说明
groups object/array 要传播的主机组

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

参数行为:
- 必须
permissions boolean 设置为 "true "可传播权限。

参数行为:
- 如果未设置 "标签过滤器",则为必填项
tag_filters boolean 设置为 "true "可传播标签筛选器。

参数行为:
- 如果未设置 "权限",则为必填项

返回值

(object) 返回一个对象,其中在 groupids 属性下包含传播的主机组 ID。

示例

将主机组权限和标记过滤器传播到其子组

将主机组权限和标记过滤器传播到其子组。

请求

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

响应:

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

另见

来源

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