Documentation
Table of Contents
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 użytkowników typu Admin i Super admin. Uprawnienia do wywołania metody można odebrać w ustawieniach ról użytkownika. Zobacz Role użytkownika aby uzyskać więcej informacji.
Parametry
(object/array) Właściwości SLA do zaktualizowania.
Właściwość slaid musi być zdefiniowana dla każdego SLA, wszystkie inne właściwości są opcjonalne. Tylko przekazane właściwości zostaną zaktualizowane, wszystkie inne pozostaną niezmienione.
Oprócz standardowych właściwości SLA, metoda akceptuje następujące parametry.
| Parametr | Typ | Opis |
|---|---|---|
| service_tags | array | Znaczniki usługi SLA, które zastąpią bieżące tagi usługi SLA. Przynajmniej jeden tag usługi musi być określony. |
| schedule | array | Harmonogram SLA, który zastąpi bieżący. Określenie parametru jako pusty zostanie zinterpretowane jako harmonogram 24x7. |
| excluded_downtimes | array | Wyłączone czasy przestoju SLA, które zastąpią bieżące. |
Zwracane wartości
(object) Zwraca obiekt zawierający identyfikatory zaktualizowanych SLA we właściwości slaids.
Przykłady
Aktualizacja tagów usług
Ustaw SLA o identyfikatorze "5" do obliczeń co miesiąc dla usług związanych z NoSQL, bez zmiany harmonogramu ani wyłączonych czasów przestoju; ustaw SLO na 95%.
Zapytanie:
{
"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"
}
]
}
],
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Odpowiedź:
Zmiana harmonogramu SLA
Przełącz SLA o identyfikatorze "5" na harmonogram 24x7.
Zapytanie:
{
"jsonrpc": "2.0",
"method": "service.update",
"params": {
"slaid": "5",
"schedule": []
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Odpowiedź:
Zmiana wyłączonych czasów przestoju dla SLA
Dodaj zaplanowany przestój na 4 godziny związany z aktualizacją RAM-u dnia 6 kwietnia 2022 roku, zachowując (musi być zdefiniowany ponownie) wcześniej istniejącą planowaną aktualizację oprogramowania w dniu 4 lipca dla SLA o identyfikatorze "5".
Zapytanie:
{
"jsonrpc": "2.0",
"method": "service.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"
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Odpowiedź:
Źródło
CSla::update() w ui/include/classes/api/services/CSla.php.