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/matriz) Mantenimientos a crear.

Además del mantenimiento estándar propiedades, el método acepta lo siguiente parámetros.

Parámetro	Tipo	Descripción
grupos	objeto/matriz	Grupos de hosts que se someterán a mantenimiento. Los grupos de hosts deben tener solo la propiedad `groupid` definida. Comportamiento de parámetros: - obligatorio si `hosts` no está configurado
hosts	objeto/matriz	Hosts que se someterán a mantenimiento. Los hosts deben tener solo la propiedad `hostid` definida. <br >Comportamiento de parámetros: - obligatorio si `grupos` no está configurado
timeperiods	object/array	Mantenimiento períodos de tiempo. Comportamiento de parámetros: - obligatorio
tags	object/array	Etiquetas de problema. Defina qué problemas se deben suprimir. Si no se proporcionan etiquetas, todas están activas Los problemas de mantenimiento del host se suprimirán. Comportamiento de parámetros: - compatible si `maintenance_type` de objeto de mantenimiento está configurado en "con recopilación de datos"
groupids (obsoleto)	array	Este parámetro está obsoleto; utilice `groups` en su lugar. ID de los grupos de hosts que se someterán a mantenimiento.
hostids (obsoleto)	matriz	Este parámetro está obsoleto; utilice `hosts` en su lugar. ID de los hosts que se someterán a mantenimiento.

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