maintenance.update

Beschreibung

object maintenance.update(object/array maintenances)

Diese Methode ermöglicht es Ihnen, vorhandene Wartungen zu aktualisieren.

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

Parameter

(object/array) Zu aktualisierende Wartungseigenschaften.

Die Eigenschaft maintenanceid muss für jede Wartung definiert werden. 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 Type Beschreibung
groups object/array Hostgruppen, die die aktuellen Gruppen ersetzen.

Für die Hostgruppen darf nur die Eigenschaft groupid definiert sein.

Parameterverhalten:
- erforderlich, wenn hosts nicht festgelegt 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 festgelegt ist
triggers object/array Auslöser, die die aktuellen Auslöser ersetzen.

Für die Auslöser darf nur die Eigenschaft triggerid definiert sein.

Parameterverhalten:
- erforderlich, wenn groups und hosts nicht festgelegt sind
- unterstützt, wenn maintenance_type=0 (mit Datensammlung)
event_names object/array Ereignisnamen, die die aktuellen Ereignisnamen ersetzen.

Parameterverhalten:
- unterstützt, wenn maintenance_type=0 (mit Datensammlung)
tags object/array Problem-Tags, die die aktuellen Tags ersetzen.

Parameterverhalten:
- unterstützt, wenn maintenance_type des Wartungsobjekts auf „mit Datensammlung“ gesetzt ist
timeperiods object/array Wartungs-Zeitintervalle, die die aktuellen Zeitintervalle ersetzen.

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.