Se encuentra viendo la documentación de la versión en desarrollo, puede estar incompleta.
Únase a nuestro proyecto de traducción y ayude a traducir la documentación de Zabbix a su lengua materna.

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 cadena ID del escenario web.

Comportamiento de la propiedad:
- solo lectura
- obligatorio para operaciones de actualización
hostid cadena ID del equipo al que pertenece el escenario web.

Comportamiento de la propiedad:
- constante
- obligatorio para operaciones de creación
name cadena Nombre del escenario web.

Comportamiento de la propiedad:
- obligatorio para las operaciones de creación
agent cadena Cadena del agente de usuario que será utilizada por el escenario web.

Predeterminado: Zabbix
authentication 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.
delay cadena Intervalo de ejecución del escenario web.
Acepta segundos, unidad de tiempo con sufijo o una macro de usuario.

Predeterminado: 1m.
headers matriz 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 cadena ID del escenario web de la plantilla principal.

Comportamiento de la propiedad:
- solo lectura
variables matriz Escenario web variables.
verify_host entero Si se debe verificar que el nombre de equipo especificado en el certificado SSL coincida con el utilizado en el escenario.

Valores posibles:
0 - (predeterminado) omitir la verificación del host;
1 - verificar host.
verify_peer entero Si se debe verificar el certificado SSL del servidor web.

Valores posibles:
0 - (predeterminado) omitir la 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

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.

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 de campo HTTP define el nombre y el valor que se utiliza para especificar las variables del escenario web, los encabezados HTTP y los campos POST o de consulta. Tiene las siguientes propiedades.

Propiedad Tipo Descripción
name cadena Nombre del encabezado/variable/POST o campo GET.

Comportamiento de la propiedad:
- obligatorio
value cadena Valor del encabezado/variable/campo POST o GET.

Comportamiento de la propiedad:
- obligatorio