Objeto de cenário web
Os seguintes objetos estão diretamente relacionados à API webcheck.
Cenário web
O objeto de cenário web tem as seguintes propriedades.
| Property | Type | Description |
|---|---|---|
| httptestid | ID | ID do cenário web. Comportamento da propriedade: - somente leitura - obrigatório para operações de atualização |
| hostid | ID | ID do host ao qual o cenário web pertence. Comportamento da propriedade: - constante - obrigatório para operações de criação |
| name | string | Nome do cenário web. Comportamento da propriedade: - obrigatório para operações de criação |
| agent | string | String do user agent que será usada pelo cenário web. Padrão: Zabbix |
| authentication | integer | Método de autenticação que será usado pelo cenário web. Valores possíveis: 0 - (padrão) nenhum; 1 - autenticação HTTP básica; 2 - autenticação NTLM; 3 - autenticação Kerberos; 4 - autenticação Digest. |
| delay | string | Intervalo de execução do cenário web. Aceita um número de segundos (por exemplo, 1, 60, 300), um valor com um sufixo de tempo (por exemplo, 30s, 1m, 2h, 1d) ou uma macro de usuário.Padrão: 1m. |
| headers | array | Cabeçalhos HTTP que serão enviados ao realizar uma solicitação. |
| http_password | string | Senha usada para autenticação HTTP básica, NTLM, Kerberos ou Digest. |
| http_proxy | string | proxy que será usado pelo cenário web, no formato http://\[username\[:password\]@\]proxy.example.com\[:port]. |
| http_user | string | Nome de usuário usado para autenticação HTTP básica, NTLM, Kerberos ou Digest. |
| retries | integer | Número de vezes que um cenário web tentará executar cada etapa antes de falhar. Padrão: 1. |
| ssl_cert_file | string | Nome do arquivo de certificado SSL usado para autenticação do cliente (deve estar no formato PEM). |
| ssl_key_file | string | Nome do arquivo de chave privada SSL usado para autenticação do cliente (deve estar no formato PEM). |
| ssl_key_password | string | Senha da chave privada SSL. |
| status | integer | Indica se o cenário web está habilitado. Valores possíveis: 0 - (padrão) habilitado; 1 - desabilitado. |
| templateid | ID | ID do cenário web do template pai. Comportamento da propriedade: - somente leitura |
| variables | array | Variáveis do cenário web. |
| verify_host | integer | Indica se o nome do host da conexão deve ser validado para corresponder ao nome no certificado do host. Valores possíveis: 0 - (padrão) ignorar a verificação do host; 1 - verificar o host. |
| verify_peer | integer | Indica se o certificado do host deve ser validado quanto à autenticidade. Valores possíveis: 0 - (padrão) ignorar a verificação do peer; 1 - verificar o peer. |
| uuid | string | Identificador exclusivo global, usado para vincular cenários web importados aos já existentes. Gerado automaticamente, se não for informado. Comportamento da propriedade: - suportado se o cenário web pertencer a um template |
Etapa do cenário
O objeto de etapa do cenário define uma verificação específica de cenário web. Ele possui as seguintes propriedades.
| Propriedade | Tipo | Descrição |
|---|---|---|
| name | string | Nome da etapa do cenário. Comportamento da propriedade: - obrigatório |
| no | integer | Número de sequência da etapa em um cenário web. Comportamento da propriedade: - obrigatório |
| url | string | URL a ser verificada. Comportamento da propriedade: - obrigatório |
| follow_redirects | integer | Define se os redirecionamentos HTTP devem ser seguidos. Valores possíveis: 0 - não seguir redirecionamentos; 1 - (padrão) seguir redirecionamentos. |
| headers | array | Cabeçalhos HTTP que serão enviados ao realizar uma solicitação. Os cabeçalhos da etapa do cenário substituirão os cabeçalhos especificados para o cenário web. |
| posts | string/array | Variáveis HTTP POST como uma string (dados brutos do post) ou como um array de campos HTTP (dados dos campos do formulário). |
| required | string | Texto que deve estar presente na resposta. |
| retrieve_mode | integer | Parte da resposta HTTP que a etapa do cenário deve recuperar. Valores possíveis: 0 - (padrão) somente o corpo; 1 - somente os cabeçalhos; 2 - cabeçalhos e corpo. |
| status_codes | string | Intervalos de códigos de status HTTP necessários, separados por vírgulas. |
| timeout | string | Tempo limite da solicitação em segundos. Aceita um número de segundos (por exemplo, 1, 60, 300), um valor com um sufixo de tempo (por exemplo, 30s, 1m, 1h) ou uma macro de usuário.Padrão: 15s. Máximo: 1h. Mínimo: 1s. |
| variables | array | Variáveis da etapa do cenário. |
| query_fields | array | Campos de consulta - array de campos HTTP que serão adicionados à URL ao realizar uma solicitação. |
Campo HTTP
O objeto de campo HTTP define o nome e o valor que são usados para especificar as variáveis do cenário web, cabeçalhos HTTP e campos POST ou campos de consulta. Ele possui as seguintes propriedades.
| Propriedade | Tipo | Descrição |
|---|---|---|
| name | string | Nome do cabeçalho/variável/campo POST ou GET. Comportamento da propriedade: - obrigatório |
| value | string | Valor do cabeçalho/variável/campo POST ou GET. Comportamento da propriedade: - obrigatório |
Tag de web scenario
O objeto de tag de web scenario possui as seguintes propriedades.
| Property | Type | Description |
|---|---|---|
| tag | string | Nome da tag de web scenario. Property behavior: - required |
| value | string | Valor da tag de web scenario. |