Web 场景对象

以下对象与 webcheck API 直接相关。

Web 场景

Web 场景对象具有以下属性。

属性 类型 描述
httptestid ID Web 场景的 ID。

属性行为:
- 只读
- 更新操作所需
hostid ID Web 场景所属主机的 ID。

属性行为:
- 常量
- 创建操作所需
name string Web 场景的名称。

属性行为
- 创建操作所需
agent string Web 场景将使用的用户代理字符串。

默认值:Zabbix
authentication integer Web 场景将使用的身份验证方法。

可能的值:
0 - (默认值) 无;
1 - 基本 HTTP 身份验证;
2 - NTLM 身份验证。
delay string Web 场景的执行间隔。

接受秒或带后缀的时间单位(例如 30 秒、1 分钟、2 小时、1 天)或用户宏。

默认值:1 分钟。
headers array 执行请求时将发送的HTTP 标头
http_password string 用于基本 HTTP 或 NTLM 身份验证的密码。
http_proxy string Web 场景将使用的代理,形式为 http://[username[:password]@]proxy.example.com[:port]
http_user string 用于基本 HTTP 或 NTLM 身份验证的用户名。
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 ID 父模板 Web 方案的 ID。

属性行为
- 只读
variables array Web 方案 变量
verify_host integer 是否验证连接的主机名是否与主机证书中的主机名匹配。

可能的值:
0 - (默认) 跳过主机验证;
1 - 验证主机。
verify_peer integer 是否验证主机的证书是否真实。

可能的值:
0 - (默认)跳过对等验证;
1 - 验证对等。
uuid string 全局唯一标识符,用于将导入的 Web 场景链接到已经存在的场景。如果未指定,则自动生成。

属性行为
- 如果 Web 场景属于模板,则 支持

Web 场景标签

Web 场景标签对象具有以下属性。

属性 类型 说明
tag string Web 场景标签名称。

属性行为:
- 必填
string Web 场景标签值。

场景步骤

场景步骤对象定义特定的 Web 场景检查。它具有 以下属性。

属性 类型 说明
name string 场景步骤的名称。

属性行为:
- 必填
no 整数 Web 场景中步骤的序列号。

属性行为:
- 必填
url string 要检查的 URL。

属性行为:
- 必填
follow_redirects integer 是否遵循 HTTP 重定向。

可能的值:
0 - 不遵循重定向;
1 - (默认) 遵循重定向。
headers array 执行请求时将发送的HTTP 标头。场景步骤标头将覆盖为 Web 场景指定的标头。
posts string/array HTTP POST 变量作为字符串(原始帖子数据)或作为 HTTP 字段 数组(表单字段数据)。
required string 响应中必须存在的文本。
retrieve_mode 整数 场景步骤必须检索的 HTTP 响应的一部分。

可能的值:
0 - (默认) 仅主体;
1 - 仅标头;
2 - 标头和主体。
status_codes 字符串 所需 HTTP 状态代码的范围,以逗号分隔。
timeout 字符串 请求超时(秒)。接受秒、带后缀的时间单位或用户宏。

默认值:15 秒。最大值:1 小时。最小值:1 秒。
variables 数组 场景步骤 变量
query_fields 数组 查询字段 - 执行请求时将添加到 URL 的 HTTP 字段 数组。

HTTP 字段

HTTP 字段对象定义用于指定 Web 场景变量、HTTP 标头和 POST 字段或查询字段的名称和值。 它具有以下属性。

属性 类型 说明
名称 字符串 标头/变量/POST 或 GET 字段的名称。

属性行为:
- 必填
字符串 标头/变量/POST 或 GET 字段的值。

属性行为:
- 必填