更新

描述

·object proxy.delete(array proxies)·

此方法允许更新现有的proxy。

此方法对于任何用户可用。可以在用户角色设置中撤销调用该方法的权限。更多信息请查看 用户角色。

参数

(object/array)待更新的proxy属性。

每个proxy必须定义proxyid属性，其他的所有属性都是可选的。只有传递的属性将被更新，其他的所有属性将保持不变。

除了标准proxy属性，该方法还接受以下参数。

参数类型描述
hostsarrayproxy监视的主机。如果主机已被其他proxy监控，则会将其重新分配给当前proxy。

主机必须定义hostid属性。
interfaceobject主机接口替换被动proxy的现有接口。

返回值

(object)返回一个对象，该对象包含proxyids属性下更新的proxy的 ID。

示例

更改proxy监控的主机

更新proxy以监视两个给定主机。

请求：

  1. {
  2.            "jsonrpc": "2.0",
  3.            "method": "proxy.update",
  4.            "params": {
  5.                "proxyid": "10293",
  6.                "hosts": [
  7.                    "10294",
  8.                    "10295"
  9.                ]
  10.            },
  11.            "auth": "038e1d7b1735c6a5436ee9eae095879e",
  12.            "id": 1
  13.        }

响应：

  1. {
  2.            "jsonrpc": "2.0",
  3.            "result": {
  4.                "proxyids": [
  5.                    "10293"
  6.                ]
  7.            },
  8.            "id": 1
  9.        }

更改proxy状态

将代理更改为主动proxy，并重命名为“Active proxy”。

请求：

  1. {
  2.            "jsonrpc": "2.0",
  3.            "method": "proxy.update",
  4.            "params": {
  5.                "proxyid": "10293",
  6.                "host": "Active proxy",
  7.                "status": "5"
  8.            },
  9.            "auth": "038e1d7b1735c6a5436ee9eae095879e",
  10.            "id": 1
  11.        }

响应：

  1. {
  2.            "jsonrpc": "2.0",
  3.            "result": {
  4.                "proxyids": [
  5.                    "10293"
  6.                ]
  7.            },
  8.            "id": 1
  9.        }

参见

来源

CProxy::update() in ui/include/classes/api/services/CProxy.php.