创建
描述
object proxy.create(object/array proxies)
此方法允许创建新的proxy。
此方法对于任何用户可用。可以在用户角色设置中撤销调用该方法的权限。更多信息请查看 用户角色。
参数
(object/array) 创建proxy。
除了标准proxy属性，该方法还接受以下参数。
| 参数 | 类型 | 描述 |
|---|---|---|
| hosts | array | 由proxy监视的主机。如果一个主机已经被另一个代理监视，那么它将被重新分配给当前proxy。 此主机必须拥有 hostid属性。 |
| interface | object | 创建主机接口用于被动proxy。 被动proxy是必需的。 |
返回值
(object)返回一个对象,该对象包含在proxyids属性下创建的proxy的ids，返回的Ids的顺序与所传递的代理的顺序相匹配。
示例
创建一个主动代理
创建主动代理"Active proxy"，并分配要监控的主机。
请求：
{
"jsonrpc": "2.0",
"method": "proxy.create",
"params": {
"host": "Active proxy",
"status": "5",
"hosts": [
{
"hostid": "10279"
}
]
},
"auth": "ab9638041ec6922cb14b07982b268f47",
"id": 1
}响应：
创建一个被动代理
创建一个被动代理“Passive proxy”，并分配两台要监控的主机。
请求：
{
"jsonrpc": "2.0",
"method": "proxy.create",
"params": {
"host": "Passive proxy",
"status": "6",
"interface": {
"ip": "127.0.0.1",
"dns": "",
"useip": "1",
"port": "10051"
},
"hosts": [
{
"hostid": "10192"
},
{
"hostid": "10139"
}
]
},
"auth": "ab9638041ec6922cb14b07982b268f47",
"id": 1
}响应：
参见
来源
ui/include/classes/api/services/CProxy.php 中的 CProxy::create()。