更新

描述

·object proxy.delete(array proxies)·

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

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

参数

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

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

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

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

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

返回值

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

示例

更改proxy监控的主机

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

请求:

{
           "jsonrpc": "2.0",
           "method": "proxy.update",
           "params": {
               "proxyid": "10293",
               "hosts": [
                   "10294",
                   "10295"
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

响应:

{
           "jsonrpc": "2.0",
           "result": {
               "proxyids": [
                   "10293"
               ]
           },
           "id": 1
       }

更改proxy状态

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

请求:

{
           "jsonrpc": "2.0",
           "method": "proxy.update",
           "params": {
               "proxyid": "10293",
               "host": "Active proxy",
               "status": "5"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

响应:

{
           "jsonrpc": "2.0",
           "result": {
               "proxyids": [
                   "10293"
               ]
           },
           "id": 1
       }

参见

来源

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