hostinterface.replacehostinterfaces
描述
object hostinterface.replacehostinterfaces(object parameters)
此方法允许替换指定主机上的所有主机接口。
此方法仅对管理员和超级管理员用户类型可用。调用该方法的权限可在用户角色设置中撤销。更多信息请参阅User roles。
参数
(object) 包含需要更新的主机 ID参数及
新的主机接口.
| 参数 | 数据类型 | 描述 |
|---|---|---|
| interfaces | object/array | 用于替换当前主机接口的Host interfaces. 参数行为: - 必填 |
| hostid | ID | 需要更新的主机 ID. 参数行为: - 必填 |
返回值
(object) 返回一个包含所创建object的主机接口ID的数组，该数组位于interfaceids属性下。
示例
替换主机接口
将所有主机接口替换为单个agent接口.
执行请求:
{
"jsonrpc": "2.0",
"method": "hostinterface.replacehostinterfaces",
"params": {
"hostid": "30052",
"interfaces": {
"dns": "",
"ip": "127.0.0.1",
"main": 1,
"port": "10050",
"type": 1,
"useip": 1
}
},
"id": 1
}响应:
{
"jsonrpc": "2.0",
"result": {
"interfaceids": [
"30081"
]
},
"id": 1
}另请参阅
来源
CHostInterface::replaceHostInterfaces() 位于 ui/include/classes/api/services/CHostInterface.php 文件中.