Documentation
Table of Contents
Objeto de escenario web
Los siguientes objetos están directamente relacionados con la API webcheck.
Escenario web
El objeto de escenario web tiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
| httptestid | ID | ID del escenario web. Comportamiento de la propiedad: - solo lectura - obligatorio para operaciones de actualización |
| hostid | ID | ID del host al que pertenece el escenario web. Comportamiento de la propiedad: - constante - obligatorio para operaciones de creación |
| nombre | cadena | Nombre del escenario web. Comportamiento de la propiedad: - obligatorio para las operaciones de creación |
| agent | string | Cadena del agente de usuario que será utilizada por el escenario web. Predeterminado: Zabbix |
| autenticación | entero | Método de autenticación que utilizará el escenario web. Valores posibles: 0 - (predeterminado) ninguno; 1 - autenticación HTTP básica; 2 - Autenticación NTLM. |
| retraso | cadena | Intervalo de ejecución del escenario web. Acepta segundos o unidades de tiempo con sufijo (por ejemplo, 30 s, 1 m, 2 h, 1 d) o una macro de usuario. Valor predeterminado: 1m. |
| headers | array | encabezados HTTP que se enviarán al realizar una solicitud. |
| http_password | cadena | Contraseña utilizada para la autenticación básica HTTP o NTLM. |
| http_proxy | cadena | Proxy que será utilizado por el escenario web dado como http://[nombre de usuario[:contraseña]@]proxy.example.com[:puerto]. |
| http_user | cadena | Nombre de usuario utilizado para la autenticación básica HTTP o NTLM. |
| retries | entero | Número de veces que un escenario web intentará ejecutar cada paso antes de fallar. Valor predeterminado: 1. |
| ssl_cert_file | cadena | Nombre del archivo de certificado SSL utilizado para la autenticación del cliente (debe estar en formato PEM). |
| ssl_key_file | cadena | Nombre del archivo de clave privada SSL utilizado para la autenticación del cliente (debe estar en formato PEM). |
| ssl_key_password | cadena | Contraseña de clave privada SSL. |
| status | integer | Si el escenario web está habilitado. Valores posibles: 0 - (predeterminado) habilitado; 1 - deshabilitado. |
| templateid | ID | ID del escenario web de la plantilla principal. Comportamiento de la propiedad: - solo lectura |
| variables | matriz | Escenario web variables. |
| verify_host | integer | Si se valida que el nombre de host para la conexión coincide con el del certificado del host. Valores posibles: 0 - (predeterminado) omitir la verificación del host;<br >1 - verificar host. |
| verify_peer | integer | Si se valida que el certificado del host es auténtico. Valores posibles: 0 - (predeterminado) omitir verificación de pares; 1 - verificar pares. |
| uuid | cadena | Identificador único global, utilizado para vincular escenarios web importados con los ya existentes. Generado automáticamente, si no se proporciona. Comportamiento de la propiedad: - compatible si el escenario web pertenece a una plantilla |
Paso del escenario
El objeto de paso del escenario define una verificación de escenario web específica. Tiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
| name | cadena | Nombre del paso del escenario. Comportamiento de la propiedad: - requerido |
| no | entero | Número de secuencia del paso en un escenario web. Comportamiento de la propiedad: - requerido |
| url | cadena | URL a verificar. Comportamiento de la propiedad: - obligatorio |
| follow_redirects | entero | Si se deben seguir los redireccionamientos HTTP. Valores posibles: 0: no seguir los redireccionamientos; 1: (predeterminado) seguir los redireccionamientos. |
| headers | matriz | encabezados HTTP que se enviarán al realizar una solicitud. Los encabezados de los pasos del escenario sobrescribirán los encabezados especificados para el escenario web. |
| posts | cadena/matriz | Variables HTTP POST como una cadena (datos de publicación sin procesar) o como una matriz de campos HTTP (datos del campo de formulario). |
| required | cadena | Texto que debe estar presente en la respuesta. |
| retrieve_mode | entero | Parte de la respuesta HTTP que el paso del escenario debe recuperar. Valores posibles: 0 - (predeterminado) solo cuerpo; 1 - solo encabezados;< br>2 - encabezados y cuerpo. |
| status_codes | cadena | Rangos de códigos de estado HTTP requeridos, separados por comas. |
| timeout | string | Tiempo de espera de solicitud en segundos. Acepta segundos, unidad de tiempo con sufijo o una macro de usuario. Predeterminado: 15 s. Máximo: 1h. Mínimo: 1s. |
| variables | matriz | Paso del escenario variables. |
| query_fields | matriz | Campos de consulta: conjunto de campos HTTP que se agregarán a la URL al realizar una solicitud. |
Campo HTTP
El objeto campo HTTP define el nombre y el valor que se utilizan para especificar las variables del escenario web, las cabeceras HTTP y los campos POST o de consulta. Tiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
| name | string | Nombre de la cabecera/variable/campo POST o GET. Comportamiento de la propiedad: - obligatorio |
| value | string | Valor de la cabecera/variable/campo POST o GET. Comportamiento de la propiedad: - obligatorio |
Etiqueta de escenario web
El objeto de etiqueta del escenario web tiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
| tag | cadena | Nombre de etiqueta del escenario web. Comportamiento de la propiedad: - obligatorio |
| value | cadena | Valor de etiqueta de escenario web. |