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 Maintenance está establecido en "con recolecció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

Crear un mantenimiento

Cree un mantenimiento con recopilación de datos para el grupo de hosts con ID "2" y con etiquetas de problema service:mysqld y error. Debe estar activo desde el 17.03.2026 hasta el 17.03.2027, entrar en vigor cada domingo a las 18:00 y durar una hora.

Solicitud:

{
    "jsonrpc": "2.0",
    "method": "maintenance.create",
    "params": {
        "name": "Sunday maintenance",
        "active_since": 1773720240,
        "active_till": 1805256240,
        "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

Fuente

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