maintenance.create

Descrição

object maintenance.create(object/array maintenances)

Este método permite criar novas manutenções.

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 f unção do usuário. Consulte Funções de usuário para obter mais informações.

Parâmetros

(object/array) Manutenções a criar.

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 que passará por manutenção.

Os grupos de hosts devem ter a propriedade groupid definida.

Pelo menos um objeto de groups ou hosts deve ser especificado.
hosts object/array Hosts que passará por manutenção.

Os hosts devem ter a propriedade hostid definida.

Pelo menos um objeto de groups ou hosts deve ser especificado.
timeperiods
(requerido)
object/array Manutenção time periods.
tags object/array Problem tags.

Defina quais problemas devem ser suprimidos.
Se nenhuma tag for fornecida, todos os problemas de host de manutenção ativos serão suprimidos.

Valores de retorno

(object) Retorna um objeto contendo os IDs das manutenções criadas na propriedade maintenanceids. A ordem dos IDs retornados corresponde à ordem da manutenção aprovada.

Exemplos

Criando uma manutenção

Crie uma manutenção com coleta de dados para o grupo de hosts com ID "2" e com tags de problema service:mysqld e error. Deve estar ativo de 22.01.2013 a 22.01.2014, entrar em vigor todos os domingos às 18h e durar uma hora

Request:

{
           "jsonrpc": "2.0",
           "method": "maintenance.create",
           "params": {
               "name": "Sunday maintenance",
               "active_since": 1358844540,
               "active_till": 1390466940,
               "tags_evaltype": 0,
               "groups": [
                   {"groupid": "2"}
               ],
               "timeperiods": [
                   {
                       "period": 3600,
                       "timeperiod_type": 3,
                       "start_time": 64800,
                       "every": 1,
                       "dayofweek": 64
                   }
               ],
               "tags": [
                   {
                       "tag": "service",
                       "operator": "0",
                       "value": "mysqld"
                   },
                   {
                       "tag": "error",
                       "operator": "2",
                       "value": ""
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Response:

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

Veja também

Fonte

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