maintenance.update

Descrição

object maintenance.update(object/array maintenances)

Este método permite atualizar 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 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. Somente as propriedades passadas serão atualizadas, todas as outras permanecerão inalteradas.

Além das propriedades padrão de manutenção, o método aceita os seguintes parâmetros.

Parâmetro	Tipo	Descrição
groups	object/array	Grupos de hosts para substituir os grupos atuais. Os grupos de hosts devem ter apenas a propriedade `groupid` definida. Comportamento do parâmetro: - obrigatório se `hosts` não estiver definido
hosts	object/array	Hosts para substituir os hosts atuais. Os hosts devem ter apenas a propriedade `hostid` definida. Comportamento do parâmetro: - obrigatório se `groups` não estiver definido
timeperiods	object/array	Períodos de tempo de manutenção para substituir os períodos atuais.
tags	object/array	Tags de problema para substituir as tags atuais. Comportamento do parâmetro: - suportado se `maintenance_type` do objeto Maintenance estiver definido como "com coleta de dados"

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.

Requisição:

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

Resposta:

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

Veja também

Período de tempo

Fonte

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

Documentation