Sidebar

zh:manual:api:reference:proxy:update

更新

描述

object proxy.update(object/array proxies)

此方法允许更新已存在的代理Proxy

代理Proxy参数

(object/array)代理Proxy参数被更新

每个主机必须定义proxyid参数,其他参数是可选的。仅仅传递的参数会被更新,其他的参数将保持不变。

此外standard proxy properties,此方法接受以下参数

Parameter Type Description
hosts array 代理Proxy监视的主机。如果一个主机已经被一个不同的代理Proxy监控,他将会重新分配到当前的代理
\\主机必须拥有hostid属性
interface object 主机接口将会替换已存在的主机接口用于被动代理Proxy

返回值

(object)返回一个对象,该对象包含proxyids属性下更新的代理Proxy的id。

示例如下

改变一个主机的代理Proxy

更新代理Proxy以监视两个给定的主机。

Request:

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

Response:

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

改变代理的状态

改变代理Proxy的模式是主动模式,并且重命名为“Active proxy”.

Request:

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

Response:

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

猜你想看

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