Você está visualizando a documentação da versão de desenvolvimento, que pode estar incompleta.
Esta página foi traduzida automaticamente. Se você notar um erro, selecione-o e pressione Ctrl+Enter para reportá-lo aos editores.

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 Funções de usuário para 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.

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

Os hosts devem ter apenas a propriedade hostid definida.

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.