object host.massadd(object parameters)
此方法允许同时向所有指定主机添加多个关联objects。
此方法仅限管理员和超级管理员用户类型使用。调用该方法的权限可通过用户角色设置进行撤销。详见User roles获取更多信息。
(object)
参数包含要update的主机 ID以及要添加到所有主机的objects.
该方法接受以下参数.
参数 | 数据类型 | 描述 |
---|---|---|
hosts (required) |
object/array | 待更新的主机. 该主机必须已定义 hostid 属性. |
groups | object/array | 要添加到指定主机的主机组. 主机组必须已定义 groupid 属性. |
interfaces | object/array | 要为指定主机创建的Host interfaces. |
macros | object/array | 要为指定主机创建的User macros. |
templates | object/array | 要链接到指定主机的模板. 模板必须已定义 templateid 属性. |
(object)
返回一个包含已更新objectID的主机数组 其ID位于hostids
属性下
向两个主机添加两个新宏.
请求:
{
"jsonrpc": "2.0",
"method": "host.massadd",
"params": {
"hosts": [
{
"hostid": "10160"
},
{
"hostid": "10167"
}
],
"macros": [
{
"macro": "{$TEST1}",
"value": "MACROTEST1"
},
{
"macro": "{$TEST2}",
"value": "MACROTEST2",
"description": "Test description"
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}
响应:
CHost::massAdd() 位于 ui/include/classes/api/services/CHost.php 文件中。