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.
(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. |
(object)
Retorna um objeto contendo os IDs dos proxies atualizados na propriedade proxyids
.
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:
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:
CProxy::update() in ui/include/classes/api/services/CProxy.php.