> Web场景对象
以下对象与webcheckAPI直接相关。
Web场景
Web场景对象具有以下属性。
| 属性 类 | 说明 | |
|---|---|---|
| httptestid | string | (readonly) Web场景的ID |
| hostid (required) |
string | Web场景所属主机的ID。 |
| name (required) |
string | Web场景的名称 |
| agent | string | 将由Web场景使用的用户代理字符串。 默认: Zabbix |
| applicationid | string | Web场景所属应用程序的ID。 |
| authentication | integer | 将由Web场景使用的身份验证方法。 可能的值： 0 - (默认) 无; 1 - 基本的HTTP认证; 2 - NTLM身份验证 |
| delay | string | Web场景的执行间隔。 接受秒，时间单位后缀和用户宏。 默认: 1m. |
| headers | string | 执行请求时将发送的HTTP标题。 |
| http_password | string | 用于认证的密码。 对于具有基本HTTP或NTLM身份验证的Web场景是必需的. |
| http_proxy | string | 将由Web场景使用的代理http://[username[:password]@]proxy.example.com[:port]. |
| http_user | string | 用于认证的用户名 对于具有基本HTTP或NTLM身份验证的Web场景，必需。 |
| nextcheck | timestamp | (readonly)下一个Web场景执行的时间。 |
| retries | integer | Web场景在失败之前尝试执行每个步骤的次数。 默认: 1. |
| ssl_cert_file | string | 用于客户端身份验证的SSL证书文件的名称（必须为PEM格式）。 |
| ssl_key_file | string | 用于客户端认证的SSL私钥文件的名称（必须为PEM格式）。 |
| ssl_key_password | string | SSL私钥密码。 |
| status | integer | 是否启用了Web方案。 可能的值： 0 - (默认) 启用; 1 -禁用. |
| templateid | string | (readonly) 父模板Web方案的ID。 |
| variables | string | Web场景变量。 |
| verify_host | integer | 验证SSL证书中指定的主机名是否与场景中使用的主机名相匹配。 可能的值： 0 - (默认) 跳过主机验证; 1 - 验证主机。 |
| verify_peer | integer | 是否验证Web服务器的SSL证书。 \\可能的值： 0 - (默认) 跳过对等验证; 1 - 验证对等 |
场景步骤
场景步骤对象定义特定的Web场景检查。 它具有以下属性。
| 属性 类 | 说明 | |
|---|---|---|
| httpstepid | string | (readonly) 情景步骤的ID |
| name (required) |
string | 场景步骤的名称。 |
| no (required) |
integer | Web场景中步骤的序列号。 |
| url (required) |
string | 要检查的URL。 |
| follow_redirects | integer | 是否遵循HTTP重定向 可能的值： 0 - 不要重新导向; 1 - (default) 遵循重定向 |
| headers | string (deprecated) array of HTTP fields |
执行请求时将发送的HTTP headers。场景步骤headers将覆盖Web场景指定的HTTP headers。 |
| httptestid | string | (readonly) 该步骤所属的Web方案的ID。 |
| posts | string array of HTTP fields |
HTTP POST字符串（原始POST数据）或者一个 HTTP字段 数组 (来自字段数据)。 |
| required | string | 必须在响应中存在的文本。 |
| retrieve_mode | integer | 方案步骤必须检索的HTTP响应的一部分。 \\可能的值： 0 - (default) 仅有文体; 1 - 仅有标题. |
| status_codes | string | 所需HTTP状态代码的范围用逗号分隔。 |
| timeout | string | 请求超时（秒）。接受秒数，带后缀的时间单位和用户宏。 默认: 15s. |
| variables | string (deprecated) array of HTTP字段 |
场景步骤变量。 |
| query_fields | array of HTTP字段 查 | 字段 - 在执行请求时将添加到URL HTTP字段 |
<note important>对于Web场景和Web场景步骤对象的headers和variables字段，都允许使用HTTP字段类型的字符串和数组。
不推荐使用 headers和 variables 的字符串数据类型，将来的版本将删除它们。 :::
HTTP 字段
HTTP字段对象定义名称和值，用于指定查询字段数据的变量，HTTP标头，POST表单字段数据。它具有以下属性。
| 属性 类 | 说明 | |
|---|---|---|
| name (required) |
string | header / variable / POST 或者 GET 字段的名称。 |
| value (required) |
string | header / variable / POST 或者 GET 字段的值。 |