创建

描述

object proxy.create(object/array proxies)

此方法允许您创建新的 proxy。

此方法仅适用于 Super admin 用户类型。调用该方法的权限可以在用户角色设置中撤销。有关更多信息，请参见 User roles。

参数

(object/array) 要创建的 proxy。

除标准 proxy 属性外，该方法还接受以下参数。

参数 类型 描述
hosts array 由该 proxy 监控的主机。
如果某个主机已由其他 proxy 监控，则会将其重新分配给当前 proxy。

主机只能定义 hostid 属性。
apm object proxy 的应用性能监控 (APM)设置。

返回值

(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
}

使用基于证书加密创建 proxy

创建一个使用基于证书的加密的主动 proxy。该 proxy 配置为监控主机 "10785"。

请求：

{
    "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
}

响应：

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

创建启用 APM 的 proxy

创建一个启用 APM 的 active proxy“Active proxy”。

该 proxy 每秒最多接受 1000 条消息，为追踪添加 deployment.environment 资源属性，并为指标添加 cloud.region 资源属性。

请求:

{
    "jsonrpc": "2.0",
    "method": "proxy.create",
    "params": {
        "name": "Active proxy",
        "operating_mode": "0",
        "apm": {
            "data_collection_status": "1",
            "max_messages_per_second": "1000",
            "additional_resource_attributes": [
                {
                    "key": "deployment.environment",
                    "value": "production",
                    "signal_type": "0"
                },
                {
                    "key": "cloud.region",
                    "value": "eu-central-1",
                    "signal_type": "1"
                }
            ]
        }
    },
    "id": 1
}

响应：

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

另请参阅

来源

ui/include/classes/api/services/CProxy.php 中的 CProxy::create()。