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 do usuário. Veja Usuário
roles
para obter mais informações.

Parâmetros

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

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

Além das propriedades de proxy padrão, 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 a propriedade hostid definida.
interface object Host interface para substituir a interface existente para o proxy passivo.

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.

Request:

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

Response:

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

Alterar o status do proxy

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

Request:

{
           "jsonrpc": "2.0",
           "method": "proxy.update",
           "params": {
               "proxyid": "10293",
               "host": "Active proxy",
               "status": "5"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Response:

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

Veja também

Fonte

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