创建

描述

object proxy.create(object/array **proxies**)

此方法用于创建新的代理Proxy

参数

(object/array) 创建代理

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

ParameterTypeDescription
hostsarray由代理监视的主机。如果一个主机已经被另一个代理监视，那么它将被重新分配给当前代理。

此主机必须拥有hostid属性
interfaceobject创建主机接口用于被动代理

被动代理的需求

返回值

(object)返回一个对象，该对象包含在proxyids属性下创建的代理的id。返回的id的顺序与所传递的代理的顺序相匹配。

示例如下

创建一个主动的代理

创一个动作代理“Active proxy”，并分配一个由其监控的主机

Request:

  1. {
  2.     "jsonrpc": "2.0",
  3.     "method": "proxy.create",
  4.     "params": {
  5.         "host": "Active proxy",
  6.         "status": "5",
  7.         "hosts": [
  8.             {
  9.                 "hostid": "10279"
  10.             }
  11.         ]
  12.     },
  13.     "auth": "ab9638041ec6922cb14b07982b268f47",
  14.     "id": 1
  15. }

Response:

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

创建一个被动 Proxy

创建一个被动 Proxy “Passive proxy”，并分配2个由其监控的主机。

Request:

  1. {
  2.     "jsonrpc": "2.0",
  3.     "method": "proxy.create",
  4.     "params": {
  5.         "host": "Passive proxy",
  6.         "status": "6",
  7.         "interface": {
  8.             "ip": "127.0.0.1",
  9.             "dns": "",
  10.             "useip": "1",
  11.             "port": "10051"
  12.         },
  13.         "hosts": [
  14.             {
  15.                 "hostid": "10192"
  16.             },
  17.             {
  18.                 "hostid": "10139"
  19.             }
  20.         ]
  21.     },
  22.     "auth": "ab9638041ec6922cb14b07982b268f47",
  23.     "id": 1
  24. }

响应:

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

See also

源

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