sla.update

Opis

object sla.update(object/array slaids)

Ta metoda umożliwia aktualizację istniejących wpisów SLA.

Ta metoda jest dostępna tylko dla typów użytkowników Admin i Super admin. Uprawnienia do wywołania tej metody mogą zostać cofnięte w ustawieniach roli użytkownika. Więcej informacji można znaleźć w sekcji User roles.

Parametry

(object/array) Właściwości SLA do zaktualizowania.

Właściwość slaid musi być zdefiniowana dla każdego SLA, wszystkie pozostałe właściwości są opcjonalne. Zaktualizowane zostaną tylko przekazane właściwości, wszystkie pozostałe pozostaną bez zmian.

Oprócz standardowych właściwości SLA, metoda akceptuje następujące parametry.

Parametr Type Opis
service_tags array Tagi usług SLA zastępujące bieżące tagi usług SLA.
schedule array Harmonogram SLA zastępujący bieżący.
Podanie pustego parametru będzie interpretowane jako harmonogram 24x7.
excluded_downtimes array Wykluczone przestoje SLA zastępujące bieżące.

Wartości zwracane

(object) Zwraca obiekt zawierający identyfikatory zaktualizowanych SLA we właściwości slaids.

Przykłady

Aktualizacja tagów usługi

Ustaw SLA o ID „5” tak, aby było obliczane w interwałach miesięcznych dla usług związanych z NoSQL, bez zmiany jego harmonogramu ani wykluczonych przestojów; ustaw SLO na 95%.

Żądanie:

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

Odpowiedź:

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

Zmiana harmonogramu SLA

Przełącz SLA o ID „5” na harmonogram 24x7.

Żądanie:

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

Odpowiedź:

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

Zmiana wykluczonych przestojów dla SLA

Dodaj planowany 4-godzinny przestój związany z rozbudową pamięci RAM w dniu 6 kwietnia 2022 r., zachowując jednocześnie (należy go zdefiniować ponownie) wcześniej istniejący plan aktualizacji oprogramowania z 4 lipca dla SLA o ID „5”.

Żądanie:

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

Odpowiedź:

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

Źródło

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