sla.update

Descrizione

object sla.update(object/array slaids)

Questo metodo consente di aggiornare voci SLA esistenti.

Questo metodo è disponibile solo per i tipi di utente Admin e Super admin. Le autorizzazioni per chiamare il metodo possono essere revocate nelle impostazioni del ruolo utente. Per ulteriori informazioni, vedere Ruoli utente.

Parametri

(object/array) Proprietà dell'SLA da aggiornare.

La proprietà slaid deve essere definita per ogni SLA, tutte le altre proprietà sono facoltative. Verranno aggiornate solo le proprietà passate, tutte le altre rimarranno invariate.

Oltre alle proprietà SLA standard, il metodo accetta i seguenti parametri.

Parametro Type Descrizione
service_tags array Tag di servizio SLA per sostituire i tag di servizio SLA correnti.
schedule array Pianificazione SLA per sostituire quella corrente.
Specificare il parametro come vuoto sarà interpretato come una pianificazione 24x7.
excluded_downtimes array Tempi di inattività esclusi dell'SLA per sostituire quelli correnti.

Valori restituiti

(object) Restituisce un oggetto contenente gli ID degli SLA aggiornati nella proprietà slaids.

Esempi

Aggiornamento dei tag del servizio

Fare in modo che l'SLA con ID "5" venga calcolato a intervalli mensili per i servizi correlati a NoSQL, senza modificarne la pianificazione o i periodi di inattività esclusi; impostare l'SLO al 95%.

Richiesta:

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

Risposta:

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

Modifica della pianificazione di un SLA

Imposta l'SLA con ID "5" su una pianificazione 24x7.

Richiesta:

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

Risposta:

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

Modifica dei periodi di inattività esclusi per un SLA

Aggiungere un periodo di inattività pianificato di 4 ore per un aggiornamento della RAM il 6 aprile 2022, mantenendo (deve essere definito nuovamente) un aggiornamento software pianificato precedentemente esistente il 4 luglio per l'SLA con ID "5".

Richiesta:

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

Risposta:

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

Fonte

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