On this page
hostgroup.propagate
Description
object hostgroup.propagate(object parameters)
此方法允许将权限和标签筛选器应用于一个主机组的所有子组。
此方法仅适用于超级管理员用户类型。
可以在用户角色设置中撤销调用该方法的权限。
有关更多信息，请参见[User
roles](/manual/web_interface/frontend_sections/users/user_roles)。
参数
(object) 定义所需输出的参数。
该方法支持以下参数。
|参数|类型|描述|
|--|--|------|
|groups|object/array|要传播的主机组。
主机组必须定义 groupid 属性。
参数行为：
- required|
|permissions|boolean|设置为 "true" 以传播权限。
参数行为：
- 如果未设置 tag_filters，则为 required|
|tag_filters|boolean|设置为 "true" 以传播标签过滤器。
参数行为：
- 如果未设置 permissions，则为 required|
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 文件中。