object proxy.update(object/array proxies)
此方法用于 update 现有的 proxies。
此方法仅适用于 超级管理员 用户类型。可以在用户角色设置中撤销调用该方法的权限。更多信息请参见 User roles。
(object/array)
Proxy 属性将被更新。
必须为每个 proxy 定义 proxyid
属性,所有其他属性是可选的。仅传递的属性将被更新,其余属性将保持不变。
除了 proxy 外,该方法还接受以下参数。
参数 | 数据类型 | 描述 |
---|---|---|
hosts | array | 要由 proxy 监控的 Hosts。 如果 一个主机 已由其他 proxy 监控,则它将被重新分配给当前的 proxy。 主机 必须仅定义 hostid 属性。 |
(object)
返回一个 object,其中包含更新后的 proxies 的 ID,这些 ID 位于 proxyids
属性下。
更新 proxy 以监控给定的两个 主机。
执行请求:
{
"jsonrpc": "2.0",
"method": "proxy.update",
"params": {
"proxyid": "10293",
"hosts": [
{
"hostid": "10294"
},
{
"hostid": "10295"
}
]
},
"id": 1
}
响应:
将 proxy 更改为一个主动的 proxy,并将其重命名为“Active proxy”。
执行请求:
{
"jsonrpc": "2.0",
"method": "proxy.update",
"params": {
"proxyid": "10293",
"name": "Active proxy",
"operating_mode": "0"
},
"id": 1
}
响应:
用ID "5" 更新 proxy 并将其添加到 ID 为 "1" 的 proxy 组 中。
执行请求:
{
"jsonrpc": "2.0",
"method": "proxy.create",
"params": {
"proxyid": "5",
"proxy_groupid": "1",
"local_address": "127.0.0.1"
},
"id": 1
}
响应:
CProxy::update() 在 ui/include/classes/api/services/CProxy.php 中。