sla.update

Beschrijving

object sla.update(object/array slaids)

Met deze methode kunnen bestaande SLA-items worden bijgewerkt.

Deze methode is alleen beschikbaar voor Admin en Super admin gebruikers typen. Machtigingen om de methode aan te roepen kunnen worden ingetrokken in de gebruikersrol instellingen. Zie Gebruiker rollen voor meer informatie.

Parameters

(object/array) SLA-eigenschappen moeten worden bijgewerkt.

De eigenschap slaid moet worden gedefinieerd voor elke SLA, alle andere eigenschappen zijn optioneel. Alleen de doorgegeven eigenschappen worden bijgewerkt, allemaal andere blijven ongewijzigd.

Naast de standaard SLA-eigenschappen, is de methode accepteert de volgende parameters.

Parameter | Type | Beschrijving |

|---------------------|--------------------------- --------------------------|----------------------- -------------------------------------------------- -------------------------------------------------- ---------------------------------------------| | dienst_tags | reeks | SLA servicetags om de huidige SLA-servicetags te vervangen.

Er moet minimaal één servicetag worden opgegeven. | | schema | reeks | SLA schedule om de huidige te vervangen.

Het opgeven van een parameter als leeg wordt geïnterpreteerd als een 24x7-planning. | | uitgesloten_downtimes | reeks | SLA uitgesloten downtime om de huidige te vervangen. |

Retourwaarden

(object) Retourneert een object dat de ID's van de verwijderde SLA's bevat onder de eigenschap slaids.

Voorbeelden

Updaten van servicetags

Maak een SLA met ID "5" die maandelijks moet worden berekend voor NoSQL-gerelateerde services, zonder de planning te wijzigen of uitvaltijden uit te sluiten; stel SLO in op 95%.

Verzoek:

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

Antwoord:

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

Het schema van een SLA wijzigen

Schakel de SLA met ID "5" om naar een 24x7 schema.

Verzoek:

{
           "jsonrpc": "2.0",
           "method": "service.update",
           "params": {
               "slaid": "5",
               "schedule": []
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Antwoord:

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

De uitgesloten uitvaltijden voor een SLA wijzigen

Voeg een geplande uitvaltijd van 4 uur voor RAM-upgrade toe op 6 april 2022, met behoud van (moet opnieuw worden gedefinieerd) een eerder bestaande software-upgrade gepland op 4 juli voor de SLA met ID "5".

Verzoek:

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

Antwoord:

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

Bron

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