hostinterface.replacehostinterfaces
描述
object hostinterface.replacehostinterfaces(object parameters)
此方法允许替换指定主机上的所有主机接口。
此方法仅对管理员和超级管理员用户类型可用。调用该方法的权限可在用户角色设置中撤销。更多信息请参阅User roles。
参数
(object) 参数包含待更新主机的ID及新的主机接口配置。
| 参数 | 数据类型 | 说明 |
|---|---|---|
| hostid (required) |
string | 待更新主机的ID标识。 |
| interfaces (required) |
object/array | 用于替换当前主机接口的Host interfaces配置。 |
返回值
(object) 返回一个包含所创建主机接口ID的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
}
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}响应：
另请参阅
来源
CHostInterface::replaceHostInterfaces() 方法位于 ui/include/classes/api/services/CHostInterface.php 文件中。