maintenance.create

Descripción

object maintenance.create(object/array maintenances)

Este método permite crear nuevos mantenimientos.

Este método solo está disponible para los tipos de usuario Administrador y Superadministrador. Los permisos para llamar al método se pueden revocar en la configuración del rol de usuario. Ver Roles de usuario para más información.

Parámetros

(objeto/array) Mantenimientos a crear.

Además de las propiedades estándar de mantenimiento, el método acepta los siguientes parámetros.

Parámetro	Tipo	Descripción
groups	objeto/array	Grupos de hosts que estarán en mantenimiento. Los grupos de hosts deben tener definida únicamente la propiedad `groupid`. Comportamiento del parámetro: - obligatorio si `hosts` no está definido
hosts	objeto/array	Hosts que estarán en mantenimiento. Los hosts deben tener definida únicamente la propiedad `hostid`. Comportamiento del parámetro: - obligatorio si `groups` no está definido
timeperiods	objeto/array	Períodos de tiempo de mantenimiento. Comportamiento del parámetro: - obligatorio
tags	objeto/array	Etiquetas de problema. Defina qué problemas deben suprimirse. Si no se especifican etiquetas, se suprimirán todos los problemas activos de los hosts en mantenimiento. Comportamiento del parámetro: - soportado si `maintenance_type` del objeto de mantenimiento está establecido en "con recopilación de datos"

Valores de retorno

(objeto) Devuelve un objeto que contiene los ID de los mantenimientos creados bajo la propiedad maintenanceids. El orden de los ID devueltos coinciden con el orden de los mantenimientos pasados.

Ejemplos

Creando un mantenimiento

Cree un mantenimiento con recopilación de datos para el grupo de equipos con ID "2" y con etiquetas de problema service:mysqld y error. Debe estar activo desde 22.01.2013 al 22.01.2014, entra en vigor cada domingo a las 18:00 durante una hora.

Solicitud:

{
           "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": ""
                   }
               ]
           },
           "id": 1
       }

Respuesta:

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

Ver también

-Periodo de tiempo

Fuente

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

Documentation