更新

描述

object proxy.update(object/array proxies)

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

此方法仅适用于 Super admin 用户类型。调用该方法的权限可以在用户角色设置中撤销。有关更多信息，请参见 User roles。

参数

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

必须为每个 proxy 定义 proxyid 属性，所有其他属性均为可选。仅更新传入的属性，其他属性保持不变。

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

参数 类型 描述
hosts array proxy 要监控的主机。
如果某个主机已由其他 proxy 监控，则会将其重新分配给当前 proxy。

主机只能定义 hostid 属性。
apm object proxy 的应用性能监控 (APM)设置。

返回值

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

示例

更改被Proxy监控的主机

更新Proxy以监控两个给定的主机。

请求:

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

响应:

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

更改Proxy状态

将Proxy更改为活动Proxy，并将其重命名为“Acitve Proxy”。

请求:

{
    "jsonrpc": "2.0",
    "method": "proxy.update",
    "params": {
        "proxyid": "10293",
        "name": "Acitve Proxy",
        "operating_mode": "0"
    },
    "id": 1
}

响应：

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

将Proxy添加到Proxy组

更新 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
}

响应:

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

另请参阅

来源

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