host.massadd
描述
object host.massadd(object parameters)
该方法允许同时向所有指定主机添加多个关联的objects。
此方法仅限管理员和超级管理员用户类型使用。调用该方法的权限可通过用户角色设置进行撤销。更多信息请参阅User roles。
参数
(object) 参数包含待更新的主机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) 返回一个包含已更新主机ID的object，存储于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 文件中。