maintenance.update

Descrição

object maintenance.update(object/array maintenances)

Este método permite atualizar maintenances existentes.

Este método está disponível apenas para 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 de usuário. Consulte User roles 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. Somente as propriedades passadas serão atualizadas; todas as demais 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 que substituirão 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 que substituirão os hosts atuais.

Os hosts devem ter apenas a propriedade hostid definida.

Comportamento do parâmetro:
- obrigatório se groups não estiver definido
triggers object/array Triggers que substituirão os triggers atuais.

Os triggers devem ter apenas a propriedade triggerid definida.

Comportamento do parâmetro:
- obrigatório se groups e hosts não estiverem definidos
- suportado se maintenance_type=0 (com coleta de dados)
event_names object/array Nomes de eventos que substituirão os nomes de eventos atuais.

Comportamento do parâmetro:
- suportado se maintenance_type=0 (com coleta de dados)
tags object/array Tags de problema que substituirão as tags atuais.

Comportamento do parâmetro:
- suportado se maintenance_type do objeto Maintenance estiver definido como "com coleta de dados"
timeperiods object/array Períodos de tempo de manutenção que substituirão os períodos atuais.

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

Fonte

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