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 文件中。