You are viewing documentation for the development version, it may be incomplete.
Join our translation project and help translate Zabbix documentation into your native language.

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 per crear.

A més de les propietats SLA estàndard, el mètode admet els paràmetres següents.

Paràmetre Tipus Descripció
service_tags array Etiquetes de servei SLA que s'ha de crear per a l'SLA.

Comportament del paràmetre:
- obligatori
schedule array programació SLA que s'ha de crear per a l'SLA.
Especificar un paràmetre buit s'interpretarà com una planificació 24x7.
Per defecte: programació 24x7.
excluded_downtimes array temps d'indisponibilitat SLA exclòs que s'ha de 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"
                       }
                   ]
               }
           ],
           "id": 1
       }

Resposta:

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

Font

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