This is a translation of the original English documentation page. Help us make it better.

sla.update

Leírás

objektum sla.update(object/array slaids)

Ez a módszer lehetővé teszi a meglévő SLA bejegyzések frissítését.

Ez a módszer csak az Admin és a Kiemelt rendszergazda számára érhető el felhasználói típusok. A metódus meghívására vonatkozó engedélyek felhasználói szerepkörben visszavonhatók beállítások. Lásd: User roles további információért.

Paraméterek

`(objektum/tömb) SLA-tulajdonságok frissítendők.

A "slaid" tulajdonságot minden SLA-hoz meg kell határozni, minden máshoz a tulajdonságok nem kötelezőek. Csak az átadott tulajdonságok frissülnek a többi változatlan marad.

A standard SLA tulajdonságok mellett a metódus a következő paramétereket fogadja el.

Paraméter | Típus | Leírás |

|---------------------|---------------------------- --------------------------|------------------------ -------------------------------------------------- -------------------------------------------------- ----------------------------------------------| | service_tags | tömb | SLA service tags az aktuális SLA szolgáltatáscímkék cseréjéhez.

Legalább egy szolgáltatáscímkét meg kell adni. | | ütemterv | tömb | SLA schedule a jelenlegi lecseréléséhez.

A paraméter üresként történő megadása 24x7 ütemezésként értelmeződik. | | kizárva_leállások | tömb | SLA [kizárt leállások] (/manual/api/reference/sla/object#sla-excluded-downtime) a jelenlegiek cseréjéhez. |

Visszatérési értékek

"(object)" Egy objektumot ad vissza, amely tartalmazza a frissített SLA-k azonosítóit a "slaids" tulajdonság alatt.

Példák

Updating service tags

Make SLA with ID "5" to be calculated at monthly intervals for NoSQL related services, without changing its schedule or excluded downtimes; set SLO to 95%.

Request:

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

Response:

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

Changing the schedule of an SLA

Switch the SLA with ID "5" to a 24x7 schedule.

Request:

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

Response:

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

Changing the excluded downtimes for an SLA

Add a planned 4 hour long RAM upgrade downtime on the 6th of April, 2022, while keeping (needs to be defined anew) a previously existing software upgrade planned on the 4th of July for the SLA with ID "5".

Request:

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

Response:

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

Forrás

CSla::update() az ui/include/classes/api/services/CSla.php-ban.