sla.create

Descripció

object sla.create(object/array SLAs)

Aquest mètode permet crear nous objectes SLA.

Tenim aquest mètode disponible només per als usuaris Admin i Super admin. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu Rols d'usuari.

Paràmetres

(object/array) Objectes SLA a crear.

A més de les [propietats SLA estàndard] (object#sla), el mètode admet els paràmetres següents.

Paràmetre Tipus Descripció
service_tags
(obligatori)		 array Etiquetes de servei de SLA per crear per a l'SLA.
S'ha d'especificar com a mínim una etiqueta de servei.
schedule array La programació d'SLA que s'ha de crear per a l'SLA.
Especificar un paràmetre buit s'interpretarà com una programació 24x7.
Per defecte: 24x7.
excluded_downtimes array El temps d'inactivitat exclòs de l'SLA que es crearà per a l'SLA.

Valors de retorn

(object) Retorna un objecte amb els IDs dels SLAs creats segons la propietat slaids. L'ordre dels IDs retornats correspon a l'ordre dels SLAs donats.

Exemples

Creació d'un SLA

Cal crear una entrada d'SLA:

  • per fer un seguiment de la disponibilitat de serveis relacionats amb el motor SQL;
  • amb horari personalitzat tots els dies de la setmana excepte la darrera hora de dissabte;
  • amb data efectiva el darrer dia de l'any 2022;
  • amb 1 hora i 15 minuts d'inactivitat programada a partir de la mitjanit del 4 de juliol;
  • S'habilitarà el càlcul setmanal d'informes de SLA;
  • SLO mínim acceptable serà del 99,9995%.

Petició:

{
    "jsonrpc": "2.0",
    "method": "sla.create",
    "params": [
        {
            "name": "Database Uptime",
            "slo": "99.9995",
            "period": "1",
            "timezone": "America/Toronto",
            "description": "Provide excellent uptime for main database engines.",
            "effective_date": 1672444800,
            "status": 1,
            "schedule": [
                {
                    "period_from": 0,
                    "period_to": 601200
                }
            ],
            "service_tags": [
                {
                    "tag": "Database",
                    "operator": "0",
                    "value": "MySQL"
                },
                {
                    "tag": "Database",
                    "operator": "0",
                    "value": "PostgreSQL"
                }
            ],
            "excluded_downtimes": [
                {
                    "name": "Software version upgrade rollout",
                    "period_from": "1648760400",
                    "period_to": "1648764900"
                }
            ]
        }
    ],
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

Resposta:

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

Font

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