sla.update

Beschreibung

object sla.update(object/array slaids)

Diese Methode ermöglicht die Aktualisierung bestehender SLA-Einträge.

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

Parameter

(object/array) Zu aktualisierende SLA-Eigenschaften.

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

Zusätzlich zu den standardmäßigen SLA-Eigenschaften akzeptiert die Methode die folgenden Parameter.

Parameter Type Beschreibung
service_tags array SLA-Service-Tags, die die aktuellen SLA-Service-Tags ersetzen.
schedule array SLA-Zeitplan, der den aktuellen ersetzt.
Wird der Parameter leer angegeben, wird dies als 24x7-Zeitplan interpretiert.
excluded_downtimes array SLA-Ausschlusszeiten, die die aktuellen ersetzen.

Rückgabewerte

(object) Gibt ein Objekt zurück, das die IDs der aktualisierten SLAs in der Eigenschaft slaids enthält.

Beispiele

Aktualisieren von Service-Tags

Legen Sie fest, dass die SLA mit der ID „5“ in monatlichen Intervallen für NoSQL-bezogene Services berechnet wird, ohne ihren Zeitplan oder ausgeschlossene Ausfallzeiten zu ändern; setzen Sie das SLO auf 95 %.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "sla.update",
    "params": [
        {
            "slaid": "5",
            "name": "NoSQL Database engines",
            "slo": "95",
            "period": 2,
            "service_tags": [
                {
                    "tag": "database",
                    "operator": "0",
                    "value": "redis"
                },
                {
                    "tag": "database",
                    "operator": "0",
                    "value": "mongodb"
                }
            ]
        }
    ],
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": {
        "slaids": [
            "5"
        ]
    },
    "id": 1
}

Ändern des Zeitplans eines SLA

Schalten Sie das SLA mit der ID „5“ auf einen 24x7-Zeitplan um.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "sla.update",
    "params": {
        "slaid": "5",
        "schedule": []
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": {
        "slaids": [
            "5"
        ]
    },
    "id": 1
}

Ändern der ausgeschlossenen Ausfallzeiten für ein SLA

Fügen Sie eine geplante 4-stündige Ausfallzeit für ein RAM-Upgrade am 6. April 2022 hinzu, wobei ein zuvor vorhandenes geplantes Software-Upgrade am 4. Juli für das SLA mit der ID „5“ beibehalten wird (muss neu definiert werden).

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "sla.update",
    "params": {
        "slaid": "5",
        "excluded_downtimes": [
            {
                "name": "Software version upgrade rollout",
                "period_from": "1648760400",
                "period_to": "1648764900"
            },
            {
                "name": "RAM upgrade",
                "period_from": "1649192400",
                "period_to": "1649206800"
            }
        ]
    },
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": {
        "slaids": [
            "5"
        ]
    },
    "id": 1
}

Quelle

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