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 activar el método se pueden revocar en la configuración del rol de usuario. Ver User roles para más información.

Parámetros

(object/array) Maintenances to create.

Además del standard maintenanceproperties, el método acepta los siguientes parámetros.

Parámetro	Tipo	Descripción
groups	objeto/matriz	Host grupos que se someterá a mantenimiento. Los grupos de hosts deben tener la propiedad `groupid` definida. < br>Se debe especificar al menos un objeto de `grupos` o `hosts`.
hosts	objeto/matriz	Hosts que se someterán a mantenimiento. Los hosts deben tener la propiedad `hostid` definida. Se debe especificar al menos un objeto de `grupos` o `hosts`.
timeperiods (obligatorio)	objeto/matriz	Mantenimiento time periods.
tags	objeto/matriz	Problem tags. Defina qué problemas se deben suprimir. Si no se proporcionan etiquetas, se suprimirán todos los problemas del host de mantenimiento activo.
groupids (obsoleto)	matriz	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 hosts con ID "2" y con etiquetas de problema servicio:mysqld y error. Debe estar activo desde 22.01.2013 al 22.01.2014, entra en vigor cada domingo a las 18:00 y el último por 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": ""
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Respuesta:

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

Ver también

-Time period

Fuente

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

Documentation