这是原厂英文文档的翻译页面. 欢迎帮助我们 完善文档.
2022 Zabbix中国峰会
2022 Zabbix中国峰会

> Web场景对象

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

Web场景

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

属性 类型 描述
httptestid 字符串 (只读) Web场景的ID。
hostid
(必填)
字符串 Web场景所属主机的ID。
name
(必填)
字符串 Web场景的名称。
agent 字符串 Web场景将使用的用户代理字符串。

默认: Zabbix
authentication 整数 Web场景将使用的身份认证方法。

可用值:
0 - (默认) none;
1 - 基本的HTTP身份认证;
2 - NTLM身份认证。
delay 字符串 Web场景的执行间隔。接受秒,带后缀的时间单位和用户宏。

默认: 1m。
headers array of HTTP fields 执行请求时将发送的HTTP请求头。
http_password 字符串 用于基本的HTTP或NTLM身份认证的密码。
http_proxy 字符串 Web场景将使用的代理,如下所示: http://[username[:password]@]proxy.example.com[:port]
http_user 字符串 用于基本的HTTP或NTLM身份认证的用户名。
nextcheck 时间戳 (只读)下一个Web场景执行的时间。
retries 整数 Web场景在失败之前尝试执行每个步骤的次数。

默认: 1。
ssl_cert_file 字符串 用于客户端身份认证的SSL证书文件的名称(必须是PEM格式)。
ssl_key_file 字符串 用于客户端身份认证的SSL私钥文件的名称(必须是PEM格式)。
ssl_key_password 字符串 SSL私钥密码。
status 整数 Web场景是否可用。

可用值:
0 - (默认) 可用;
1 - 不可用。
templateid 字符串 (只读) 父模板Web场景的ID。
variables array of HTTP fields Web场景变量。
verify_host 整数 是否验证SSL证书里指定的主机名与Web场景中使用的主机名匹配。

可能的值:
0 - (默认) 跳过主机验证;
1 - 验证主机。
verify_peer 整数 是否验证Web服务器的SSL证书。

可用值:
0 - (默认) 跳过对等验证;
1 - 验证对等。
uuid 字符串 (在现有的Web场景上只读)
全局唯一标识符,用于将导入的Web场景连接到现有场景。仅用于模板上的web场景。

注意,对于某些方法(更新、删除),必需/可选参数组合是不同的。

Web场景标签

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

属性 类型 描述
tag
(必填)
string Web场景标签的名称。
value string Web场景标签的值。

场景步骤

场景步骤对象定义了一个特定的Web场景检查。具有如下属性。

属性 类型 描述
httpstepid string (只读) Web场景步骤ID。
name
(必填)
string Web场景的名称。
no
(必填)
integer 一个Web场景步骤的序列号。
url
(必填)
string 待检查的URL。
follow_redirects integer 是否遵循HTTP重定向。

可用值:
0 - 不遵循重定向;
1 - (默认) 遵循重定向。
headers array of HTTP fields 执行请求时将发送的HTTP请求头。场景步骤请求头将被重写为Web场景指定的请求头。
httptestid string (只读) 步骤所属Web场景的ID。
posts string
array of HTTP fields
HTTP POST变量作为一个字符串(原始的post数据)或一个HTTP fields (表单字段数据)的数组。
required string 响应中必须出现的文本。
retrieve_mode integer 场景步骤必须获取的一部分HTTP响应。

可用值:
0 - (默认) 仅返回内容;
1 - 仅请求头;
2 - 请求头和内容。
status_codes string 用逗号隔开的所需HTTP状态码的范围。
timeout string 请求超时时间(秒)。接受秒,带后缀的时间单位和用户宏。

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

HTTP字段

HTTP字段定义了名称和值,用于指定查询字段数据中的变量,HTTP请求头,POST表单字段数据。具有如下属性。

属性 类型 描述
name
(必填)
string 请求头/变量/POST或GET字段的名称。
value
(必填)
string 请求头/变量/POST或GET字段的值。