Documentation
Table of Contents
proxy.create
描述
object proxy.create(object/array proxies)此方法允许create新的proxies。
此方法仅适用于超级管理员用户类型。可以在用户角色设置中撤销调用该方法的权限。更多信息请参见User roles。
参数
(object/array) 创建 Proxies。
除了 proxy 外，该方法还接受以下参数。
| 参数 | 数据类型 | 描述 |
|---|---|---|
| hosts | array | 被 proxy 监控的 Hosts。 如果 一个主机 已经被另一个 proxy 监控，则它将被重新分配到当前的 proxy。 该 主机 必须仅定义了 hostid 属性。 |
返回值
(object) 返回一个 object，其中包含在 proxyids 属性下列出的已创建 proxies 的 ID。返回的 ID 顺序与传入的 proxies 顺序一致。
示例
创建主动式 proxy
创建一个动作 proxy“Active proxy”，并分配 一个主机 由其进行监控。
执行请求:
{
"jsonrpc": "2.0",
"method": "proxy.create",
"params": {
"name": "Active proxy",
"operating_mode": "0",
"hosts": [
{
"hostid": "10279"
}
]
},
"id": 1
}响应：
创建被动式 proxy
创建一个被动的 proxy "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
}响应：
创建一个 proxy 并将其添加到 proxy 组
创建一个主动型 proxy“Active proxy”，并将其添加到 ID 为“1”的 proxy 组。
执行请求:
{
"jsonrpc": "2.0",
"method": "proxy.create",
"params": {
"name": "Active proxy",
"proxy_groupid": "1",
"operating_mode": "0"
},
"id": 1
}响应：
另请参阅
来源
CProxy::create() 在 ui/include/classes/api/services/CProxy.php 中。