proxy.update

Descrição

object proxy.update(object/array proxies)

Este método permite atualizar proxies existentes.

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 User roles para obter mais informações.

Parâmetros

(object/array) Propriedades do proxy a serem atualizadas.

A propriedade proxyid deve ser definida para cada proxy; todas as outras propriedades são opcionais. Somente as propriedades passadas serão atualizadas; todas as outras permanecerão inalteradas.

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

Parameter Type Description
hosts array Hosts a serem monitorados pelo proxy.
Se um host já estiver sendo monitorado por um proxy diferente, 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 atualizados na propriedade proxyids.

Exemplos

Alterar hosts monitorados por um proxy

Atualize o proxy para monitorar os dois hosts fornecidos.

Requisição:

{
    "jsonrpc": "2.0",
    "method": "proxy.update",
    "params": {
        "proxyid": "10293",
        "hosts": [
            {
                "hostid": "10294"
            },
            {
                "hostid": "10295"
            }
        ]
    },
    "id": 1
}

Resposta:

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

Alterar o status do proxy

Altere o proxy para um proxy ativo e renomeie-o para "Active proxy".

Requisição:

{
    "jsonrpc": "2.0",
    "method": "proxy.update",
    "params": {
        "proxyid": "10293",
        "name": "Active proxy",
        "operating_mode": "0"
    },
    "id": 1
}

Resposta:

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

Adicionar um proxy a um grupo de proxies

Atualize o proxy com ID "5" e adicione-o ao grupo de proxies com ID "1".

Requisição:

{
    "jsonrpc": "2.0",
    "method": "proxy.create",
    "params": {
        "proxyid": "5",
        "proxy_groupid": "1",
        "local_address": "127.0.0.1"
    },
    "id": 1
}

Resposta:

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

Veja também

Fonte

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