Esta página fue traducida automáticamente. Si detectas un error, selecciónalo y presiona Ctrl+Enter para informarlo a los editores.

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.