Se encuentra viendo la documentación de la versión en desarrollo, puede estar incompleta.
Únase a nuestro proyecto de traducción y ayude a traducir la documentación de Zabbix a su lengua materna.

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 de llas propiedades de mantenimiento estándar, el método acepta los siguientes parámetros.

Parámetro Tipo Descripción
groups objeto/matriz Grupos de equipos que se someterán a mantenimiento.

Los grupos de equipos deben tener la propiedad groupid definida.
< br>Comportamiento de parámetros:
- obligatorio si hosts no está configurado
hosts objeto/matriz Equipos que se someterán a mantenimiento.

Los equipos deben tener solo la propiedad hostid definida.
<br >Comportamiento de parámetros:
- obligatorio si grupos no está configurado
timeperiods objeto/matriz Períodos de tiempo de mantenimiento.

Comportamiento de parámetros:
- obligatorio
tags objeto/matriz Etiquetas de problema.

Defina qué problemas se deben suprimir.
Si no se proporcionan etiquetas, todas están activas se suprimirán los problemas del host de mantenimiento.

Comportamiento de parámetros:
- compatible si maintenance_type de objeto de mantenimiento está configurado en "con recopilación de datos"
groupids
(obsoleto)
matriz Este parámetro está obsoleto; utilice groups en su lugar.
ID de los grupos de equipos que se someterán a mantenimiento.
hostids
(obsoleto)
matriz Este parámetro está obsoleto; utilice hosts en su lugar.
ID de los equipos 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.