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 da 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 informadas 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.

Parameter Type Description
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:
- required 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:
- required se groups não estiver definido
timeperiods object/array Períodos de tempo da manutenção para substituir os períodos atuais.
tags object/array Tags de problema para substituir as tags atuais.

Comportamento do parâmetro:
- supported se maintenance_type do objeto Maintenance estiver definido como "with data collection"
groupids
(deprecated)		 array Este parâmetro está obsoleto, use groups em seu lugar.
IDs dos grupos de hosts que entrarão em manutenção.
hostids
(deprecated)		 array Este parâmetro está obsoleto, use hosts em seu lugar.
IDs dos hosts que entrarão em 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.

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.