proxy.create

Descrição

object proxy.create(object/array proxies)

Este método permite que você crie novos proxies.

Este método está disponível apenas para o tipo de usuário Super admin. As permissões para chamar o método podem ser revogadas nas configurações de função de usuário. Consulte Funções de usuário para obter mais informações.

Parâmetros

(object/array) Proxies a serem criados.

Além das propriedades padrão do proxy, o método aceita os seguintes parâmetros.

Parâmetro Tipo Descrição
hosts array Hosts a serem monitorados pelo proxy.
Se um host já estiver sendo monitorado por outro proxy, ele será reatribuído ao proxy atual.

Os hosts devem ter apenas a propriedade hostid definida.
apm object Configurações de monitoramento de desempenho de aplicações (APM) do proxy.

Valores de retorno

(object) Retorna um objeto contendo os IDs dos proxies criados na propriedade proxyids. A ordem dos IDs retornados corresponde à ordem dos proxies passados.

Exemplos

Criar um proxy ativo

Crie um proxy de ação "Active proxy" e atribua um host para ser monitorado por ele.

Requisição:

{
    "jsonrpc": "2.0",
    "method": "proxy.create",
    "params": {
        "name": "Active proxy",
        "operating_mode": "0",
        "hosts": [
            {
                "hostid": "10279"
            }
        ]
    },
    "id": 1
}

Resposta:

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

Criar um proxy passivo

Crie um proxy passivo "Passive proxy" e atribua dois hosts para serem monitorados por ele.

Requisição:

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

Resposta:

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

Criando um proxy e adicionando-o a um grupo de proxies

Crie um proxy ativo "Active proxy" e adicione-o ao grupo de proxies com ID "1".

Requisição:

{
    "jsonrpc": "2.0",
    "method": "proxy.create",
    "params": {
        "name": "Active proxy",
        "proxy_groupid": "1",
        "operating_mode": "0"
    },
    "id": 1
}

Resposta:

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

Criando um proxy com criptografia baseada em certificado

Crie um proxy ativo com criptografia baseada em certificado. O proxy está configurado para monitorar o 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
}

Criando um proxy com APM habilitado

Crie um proxy ativo "Active proxy" com o APM habilitado. O proxy aceita até 1000 mensagens por segundo, adiciona o atributo de recurso deployment.environment aos traces e adiciona o atributo de recurso cloud.region às métricas.

Solicitação:

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

Resposta:

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

Veja também

Fonte

CProxy::create() em ui/include/classes/api/services/CProxy.php.