Sidebar

fr:manual:api:reference:maintenance:create

maintenance.create

Description

object maintenance.create(object/array maintenances)

Cette méthode permet de créer de nouvelles maintenances.

Paramètres

(object/array) Maintenances à créer.

En plus des propriétés de l'objet maintenance standard, la méthode accepte les paramètres suivants.

Paramètre Type Description
groupids
(obligatoire)
array ID des groupes d'hôtes qui vont subir une maintenance.
hostids
(obligatoire)
array ID des hôtes qui vont subir une maintenance.
timeperiods
(obligatoire)
array Périodes.
tags array Tag de problème.

Défini quels problèmes doivent être supprimés.
Si aucun tag n’est spécifié, tous les problèmes d’hôte en maintenance actives seront supprimés.
Au moins un hôte ou un groupe d’hôtes doit être défini pour chaque maintenance.

Valeurs retournées

(object) Retourne un objet contenant les identifiants des maintenances créées sous la propriété maintenanceids. L'ordre des ID retournés correspond à l'ordre des maintenances transmises.

Exemples

Création d'une maintenance

Créez une maintenance avec collecte de données pour le groupe d'hôtes “2” avec le tag de problème service:​mysqld et error. Elle doit être active du 22.01.2013 au 22.01.2014, entrer en vigueur chaque dimanche à 18h00 et durer une heure.

Requête :

{
    "jsonrpc": "2.0",
    "method": "maintenance.create",
    "params": {
        "name": "Sunday maintenance",
        "active_since": 1358844540,
        "active_till": 1390466940,
        "tags_evaltype": 0,
        "groupids": [
            "2"
        ],
        "timeperiods": [
            {
                "timeperiod_type": 3,
                "every": 1,
                "dayofweek": 64,
                "start_time": 64800,
                "period": 3600
            }
        ],
        "tags": [
            {
                "tag": "service",
                "operator": "0",
                "value": "mysqld",
            },
            {
                "tag": "error",
                "operator": "2",
                "value": ""
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

Réponse :

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

Voir également

Source

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