sla.get

Descripción

integer/array role.get(object parameters)

El método permite recuperar roles según los parámetros dados.

Este método está disponible para usuarios de cualquier tipo. Permisos para activar el método se pueden revocar en la configuración de roles de usuario. Ver User roles para más información.

Parámetros

(object) Parámetros que definen la salida deseada.

El método admite los siguientes parámetros.

Parameter | Tipo | Descripción |

|---------------------------------|----------------------- ------------------------------|------------------- -------------------------------------------------- -------------------------------------------------- -------------------------------------------------- --| | slaids | cadena/matriz | Devuelva solo SLA con los IDs proporcionados. | | serviceids | cadena/matriz | Devuelva únicamente los SLA que coincidan con los servicios específicos. | | selectSchedule | consulta | Devuelva una propiedad schedule con programaciones SLA.

Admite count. | | selectExcludedDowntimes | consulta | Devuelva una propiedad excluded_downtimes con tiempos de inactividad excluidos por SLA.

Admite count. | | selectServiceTags | consulta | Devuelve una propiedad service_tags con etiquetas de servicio SLA.

Admite count. | | sortfield | cadena/matriz | Ordene el resultado según las propiedades dadas.

Los valores posibles son: slaid, name, period, slo, Effective_date, timezone, status y description. | | countOutput | booleano | Estos parámetros, que son comunes para todos los métodos get, se describen en detalle en el reference commentary. | | editable | booleano | ^ | | excludeSearch | booleano | ^ | | filter | objeto | ^ | | limit | entero | ^ | | output | consulta | ^ | | preservekeys | booleano | ^ | | search | objeto | ^ | | searchByAny | booleano | ^ | | searchWildcardsEnabled | booleano | ^ | | sortorder | cadena/matriz | ^ | | startSearch | booleano | ^ |

Valores de retorno

(integer/array)` Devuelve:

  • una matriz de objetos;
  • el recuento de objetos recuperados, si el parámetro countOutput ha sido usado.

Ejemplos

Recuperando todos los SLAs

Recupere todos los datos sobre todos os SLAs y sus propiedades.

Solicitud:

{
           "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
           },
           "auth": "85dd04b94cbfad794616eb923be13c71",
           "id": 1
       }

Respuesta:

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

Fuente

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