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

Time period

Fonte

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

Documentation