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.