maintenance.create

Beschreibung

object maintenance.create(object/array maintenances)

Diese Methode ermöglicht das Erstellen neuer Wartungen.

Diese Methode ist nur für die Benutzertypen Admin und Super admin verfügbar. Die Berechtigungen zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle entzogen werden. Weitere Informationen finden Sie unter Benutzerrollen.

Parameter

(object/array) Zu erstellende Wartungen.

Zusätzlich zu den Standard-Wartungseigenschaften akzeptiert die Methode die folgenden Parameter.

Parameter Type Beschreibung
groups object/array Host-Gruppen, die gewartet werden.

Für die Host-Gruppen darf nur die Eigenschaft groupid definiert sein.

Parameterverhalten:
- erforderlich, wenn hosts nicht gesetzt ist
hosts object/array Hosts, die gewartet werden.

Für die Hosts darf nur die Eigenschaft hostid definiert sein.

Parameterverhalten:
- erforderlich, wenn groups nicht gesetzt ist
timeperiods object/array Wartungs-Zeitperioden.

Parameterverhalten:
- erforderlich
tags object/array Problem-Tags.

Definieren, welche Probleme unterdrückt werden müssen.
Wenn keine Tags angegeben werden, werden alle Probleme aktiver Wartungs-Hosts unterdrückt.

Parameterverhalten:
- unterstützt, wenn maintenance_type des Wartungsobjekts auf „with data collection“ gesetzt ist

Rückgabewerte

(object) Gibt ein Objekt zurück, das die IDs der erstellten Maintenances unter der Eigenschaft maintenanceids enthält. Die Reihenfolge der zurückgegebenen IDs entspricht der Reihenfolge der übergebenen Maintenances.

Beispiele

Erstellen einer Wartung

Erstellen Sie eine Wartung mit Datensammlung für die Host-Gruppe mit der ID „2“ und mit den Problem-Tags service:mysqld und error. Sie muss vom 17.03.2026 bis zum 17.03.2027 aktiv sein, jeden Sonntag um 18:00 Uhr wirksam werden und eine Stunde dauern.

Anfrage:

{
    "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
}

Antwort:

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

Siehe auch

Quelle

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