sla.get

Descrizione

integer/array sla.get(object parameters)

Questo metodo consente di recuperare gli oggetti SLA in base ai parametri specificati.

Questo metodo è disponibile per utenti di qualsiasi tipo. Le autorizzazioni per chiamare il metodo possono essere revocate nelle impostazioni del ruolo utente. Vedere User roles per ulteriori informazioni.

Parametri

(object) Parametri che definiscono l'output desiderato.

Il metodo supporta i seguenti parametri.

Parametro Tipo Descrizione
slaids ID/array Restituisce solo gli SLA con gli ID specificati.
serviceids ID/array Restituisce solo gli SLA corrispondenti ai servizi specifici.
selectSchedule query Restituisce una proprietà schedule con le pianificazioni SLA.

Supporta count.
selectExcludedDowntimes query Restituisce una proprietà excluded_downtimes con i tempi di inattività esclusi dell'SLA.

Supporta count.
selectServiceTags query Restituisce una proprietà service_tags con i tag di servizio dell'SLA.

Supporta count.
sortfield string/array Ordina il risultato in base alle proprietà specificate.

Valori possibili: slaid, name, period, slo, effective_date, timezone, status, description.
countOutput boolean Questi parametri sono descritti nel commento di riferimento.
editable boolean
excludeSearch boolean
filter object
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Valori restituiti

(integer/array) Restituisce uno dei seguenti:

  • un array di oggetti;
  • il numero di oggetti recuperati, se è stato utilizzato il parametro countOutput.

Esempi

Recupero di tutti gli SLA

Recupera tutti i dati relativi a tutti gli SLA e alle loro proprietà.

Richiesta:

{
    "jsonrpc": "2.0",
    "method": "sla.get",
    "params": {
        "output": "extend",
        "selectSchedule": ["period_from", "period_to"],
        "selectExcludedDowntimes": ["name", "period_from", "period_to"],
        "selectServiceTags": ["tag", "operator", "value"],
        "preservekeys": true
    },
    "id": 1
}

Risposta:

{
    "jsonrpc": "2.0",
    "result": {
        "1": {
            "slaid": "1",
            "name": "Database Uptime",
            "period": "1",
            "slo": "99.9995",
            "effective_date": "1672444800",
            "timezone": "America/Toronto",
            "status": "1",
            "description": "Provide excellent uptime for main SQL database engines.",
            "service_tags": [
                {
                    "tag": "database",
                    "operator": "0",
                    "value": "mysql"
                },
                {
                    "tag": "database",
                    "operator": "0",
                    "value": "postgresql"
                }
            ],
            "schedule": [
                {
                    "period_from": "0",
                    "period_to": "601200"
                }
            ],
            "excluded_downtimes": [
                {
                    "name": "Software version upgrade rollout",
                    "period_from": "1648760400",
                    "period_to": "1648764900"
                }
            ]
        }
    },
    "id": 1
}

Fonte

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