Sidebar

更新

描述

·object proxy.delete(array proxies)·

此方法允许更新现有的代理。

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

参数

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

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

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

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

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

返回值

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

示例

更改代理监控的主机

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

请求:

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

响应:

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

更改代理状态

将代理更改为主动代理,并重命名为“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
       }

参见

源来源

ui/include/classes/api/services/CProxy.php 中的 CProxy::update()。