proxy.create

描述

object proxy.create(object/array proxies)

此方法允许create新的proxies.

此方法仅适用于超级管理员用户类型. 调用该方法的权限可在用户角色设置中撤销. 详见 User roles 获取更多信息.

参数

(object/array) Proxies 到 create.

除了 proxy 之外， 该方法还接受以下参数。

参数 数据类型 描述
hosts array 由 proxy 监控的 Hosts。如果 一个主机 已被其他 proxy 监控，它将被重新分配给当前的 proxy。

主机 必须定义 hostid 属性。
interface object 为被动 proxy 创建的 主机 interface。

被动 proxies 必需。

返回值

(object) 返回一个包含所创建proxies ID的object， 这些ID存储在proxyids属性下。返回的ID顺序与传入的proxies顺序保持一致。

示例

创建主动式 proxy

创建一个动作proxy "活跃proxy" 并分配一个主机由其监控

请求:

{
    "jsonrpc": "2.0",
    "method": "proxy.create",
    "params": {
        "host": "Active proxy",
        "status": "5",
        "hosts": [
            {
                "hostid": "10279"
            }
        ]
    },
    "auth": "ab9638041ec6922cb14b07982b268f47",
    "id": 1
}

响应:

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

创建被动式 proxy

创建一个被动proxy"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
}

响应:

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

Creating a proxy with certificate-based encryption

Create an active proxy with certificate-based encryption. The proxy is configured to monitor host "10785".

Request:

{
    "jsonrpc": "2.0",
    "method": "proxy.create",
    "params": {
        "name": "Active proxy",
        "operating_mode": "0",
        "hosts": [
            {
                "hostid": "10785"
            }
        ],
        "tls_accept": "4",
        "tls_issuer": "CN=Signing CA,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com",
        "tls_subject": "CN=Zabbix server,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com"
    },
    "id": 1
}

Response:

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

另请参阅

来源

CProxy::create() 位于 ui/include/classes/api/services/CProxy.php 文件中。