maintenance.update

Beschreibung

object maintenance.update(object/array maintenances)

Mit dieser Methode können Sie vorhandene Wartungen aktualisieren.

Diese Methode ist nur für Benutzertypen vom Typ Admin und Super admin verfügbar. Die Berechtigung zum Aufrufen der Methode kann in den Einstellungen der Benutzerrolle entzogen werden. Weitere Informationen finden Sie unter Benutzerrollen.

Parameter

(object/array) Zu aktualisierende Wartungseigenschaften.

Die Eigenschaft maintenanceid muss für jede Wartung definiert sein, alle anderen Eigenschaften sind optional. Nur die übergebenen Eigenschaften werden aktualisiert, alle anderen bleiben unverändert.

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

Parameter Typ Beschreibung
groups object/array Host-Gruppen, die die aktuellen Gruppen ersetzen.

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

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

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

Parameterverhalten:
- erforderlich, wenn groups nicht gesetzt ist
timeperiods object/array Wartungs-Zeitperioden, die die aktuellen Zeiträume ersetzen.
tags object/array Problem-Tags, die die aktuellen Tags ersetzen.

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 aktualisierten Wartung unter der Eigenschaft maintenanceids enthält.

Beispiele

Zuweisen verschiedener Hosts

Ersetzen Sie die Hosts, die derzeit der Wartung zugewiesen sind, durch zwei andere.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "maintenance.update",
    "params": {
        "maintenanceid": "3",
        "hosts": [
            {"hostid": "10085"},
            {"hostid": "10084"}
        ]
    },
    "id": 1
}

Antwort:

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

Siehe auch

Quelle

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