Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

maintenance.update

Descrição

object maintenance.update(object/array maintenances)

Este método permite atualizar as manutenções existentes.

Este método está disponível apenas para os tipos de usuário Admin e Super admin. As permissões para chamar o método podem ser revogadas nas configurações de função do usuário. Consulte Funções de usuário para obter mais informações.

Parâmetros

(object/array) Propriedades de manutenção a serem atualizadas.

A propriedade maintenanceid deve ser definida para cada manutenção, 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 manutenção padrão, o método aceita os seguintes parâmetros.

Parâmetro Tipo Descrição
groups object/array Host grupos para substituir os grupos atuais.

Os grupos de hosts devem ter a propriedade groupid definida.
hosts object/array Hosts para substituir os hosts atuais.

Os hosts devem ter a propriedade hostid definida
timeperiods object/array Manutenção períodos de tempo para substituir os períodos atuais.
tags object/array Tags de problema para substituir as tags atuais.

Pelo menos um host ou grupo de hosts deve ser definido para cada manutenção.

Valores de retorno

(object) Retorna um objeto contendo os IDs das manutenções atualizadas na propriedade maintenanceids.

Exemplos

Atribuindo hosts diferentes

Substitua os hosts atualmente atribuídos à manutenção por dois diferentes.

Request:

{
           "jsonrpc": "2.0",
           "method": "maintenance.update",
           "params": {
               "maintenanceid": "3",
               "hosts": [
                   {"hostid": "10085"},
                   {"hostid": "10084"}
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Response:

{
           "jsonrpc": "2.0",
           "result": {
               "maintenanceids": [
                   "3"
               ]
           },
           "id": 1
       }

Veja também

Fonte

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