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.