[comment]: # aside: 1 [comment]: # translation:outdated [comment]: # ({b751c407-a17bb95b}) # Objeto de escenario web Los siguientes objetos están directamente relacionados con la API `webcheck`. [comment]: # ({/b751c407-a17bb95b}) [comment]: # ({6e8252e9-e60908bb}) ### Escenario web El objeto de escenario web tiene las siguientes propiedades. |Propiedad|[Tipo](/manual/api/reference_commentary#data_types)|Descripción| |--|--|------| |httptestid|ID|ID del escenario web.

[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *solo lectura*
- *obligatorio* para operaciones de actualización| |hostid|ID|ID del host al que pertenece el escenario web.

[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *constante*
- *obligatorio* para operaciones de creación| |nombre|cadena|Nombre del escenario web.

[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *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](/manual/api/reference/httptest/object#http-field) 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](/manual/api/reference_commentary#property-behavior):
- *solo lectura*| |variables|matriz|Escenario web [variables](/manual/api/reference/httptest/object#http-field).| |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;
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](/manual/api/reference_commentary#property-behavior):
- *compatible* si el escenario web pertenece a una plantilla| [comment]: # ({/6e8252e9-e60908bb}) [comment]: # ({550e6dd8-eb20f47d}) ### Paso del escenario El objeto de paso del escenario define una verificación de escenario web específica. Tiene las siguientes propiedades. |Propiedad|[Tipo](/manual/api/reference_commentary#data_types)|Descripción| |--|--|------| |name|cadena|Nombre del paso del escenario.

[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *requerido*| |no|entero|Número de secuencia del paso en un escenario web.

[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *requerido*| |url|cadena|URL a verificar.

[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *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](/manual/api/reference/httptest/object#http-field) 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](/manual/api/reference/httptest/object#http-field) (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](/manual/api/reference/httptest/object#http-field).| |query\_fields|matriz|Campos de consulta: conjunto de [campos HTTP](/manual/api/reference/httptest/object#http-field) que se agregarán a la URL al realizar una solicitud.| [comment]: # ({/550e6dd8-eb20f47d}) [comment]: # ({10a55bc3-d69e8b7b}) ### 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](/manual/api/reference_commentary#data_types)|Descripción| |--|--|------| |name|cadena|Nombre del encabezado/variable/POST o campo GET.

[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *obligatorio*| |value|cadena|Valor del encabezado/variable/campo POST o GET.

[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *obligatorio*| [comment]: # ({/10a55bc3-d69e8b7b}) [comment]: # ({0a47168c-c7ab7fb0}) ### Etiqueta de escenario web El objeto de etiqueta del escenario web tiene las siguientes propiedades. |Propiedad|[Tipo](/manual/api/reference_commentary#data_types)|Descripción| |--|--|------| |tag|cadena|Nombre de etiqueta del escenario web.

[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *obligatorio*| |value|cadena|Valor de etiqueta de escenario web.| [comment]: # ({/0a47168c-c7ab7fb0})