创建
描述
object proxy.create(object/array proxies)
此方法允许创建新的Proxy。
此方法仅适用于 超级管理员 用户类型。调用该方法的权限可以在用户角色设置中撤销。有关更多信息,请参阅 用户角色。
参数
(object/array)
要创建的代理。
除了 标准代理属性 之外,该方法还接受以下参数。
参数 | 类型 | 说明 |
---|---|---|
hosts | array | 主机 要由代理监控。 如果主机已由其他代理监控,则将重新分配给当前代理。 主机必须仅定义 hostid 属性。 |
返回值
(object)
返回一个对象,其中包含 proxyids
属性下创建的Proxy的 ID。返回的 ID 的顺序与传递的Proxy的顺序相匹配。
示例
创建主动式Proxy
创建一个叫做”Active Proxy”的主动式Proxy,并指定一个主机由其监控。
请求:
{
"jsonrpc": "2.0",
"method": "proxy.create",
"params": {
"name": "Active Proxy",
"operating_mode": "0",
"hosts": [{
"hostid": "10279"
}]
},
"id": 1
}
响应:
{
"jsonrpc": "2.0",
"result": {
"proxyids": [
"10280"
]
},
"id": 1
}
创建被动式代理
创建一个叫做“Passive Proxy”的被动式代理,并指定两个主机由其监控。
请求:
{
"jsonrpc": "2.0",
"method": "proxy.create",
"params": {
"name": "Passive Proxy",
"operating_mode": "1",
"address": "127.0.0.1",
"port": "10051",
"hosts": [{
"hostid": "10192"
},
{
"hostid": "10139"
}
]
},
"id": 1
}
响应:
{
"jsonrpc": "2.0",
"result": {
"proxyids": [
"10284"
]
},
"id": 1
}
创建Proxy并将其添加到Proxy组
创建主动式Proxy “Active proxy”,并将其添加到 ID 为“1”的代理组。
请求:
{
"jsonrpc": "2.0",
"method": "proxy.create",
"params": {
"name": "Active proxy",
"proxy_groupid": "1",
"operating_mode": "0"
},
"id": 1
}
响应:
{
"jsonrpc": "2.0",
"result": {
"proxyids": ["5"]
},
"id": 1
}
另请参阅
来源
ui/include/classes/api/services/CProxy.php 中的 CProxy::create()。