> Web场景对象

以下对象与webcheckAPI直接相关。

Web场景

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

属性类型说明
httptestidstring(readonly) Web场景的ID
hostid
(required)
stringWeb场景所属主机的ID。
name
(required)
stringWeb场景的名称
agentstring将由Web场景使用的用户代理字符串。

默认: Zabbix
applicationidstringWeb场景所属应用程序的ID。
authenticationinteger将由Web场景使用的身份验证方法。

可能的值:
0 - (默认) 无;
1 - 基本的HTTP认证;
2 - NTLM身份验证
delaystringWeb场景的执行间隔。 接受秒,时间单位后缀和用户宏。

默认: 1m.
headersstring执行请求时将发送的HTTP标题。
http_passwordstring用于认证的密码。

对于具有基本HTTP或NTLM身份验证的Web场景是必需的.
http_proxystring将由Web场景使用的代理http://[username[:password]@]proxy.example.com[:port].
http_userstring用于认证的用户名

对于具有基本HTTP或NTLM身份验证的Web场景,必需。
nextchecktimestamp(readonly)下一个Web场景执行的时间。
retriesintegerWeb场景在失败之前尝试执行每个步骤的次数。

默认: 1.
ssl_cert_filestring用于客户端身份验证的SSL证书文件的名称(必须为PEM格式)。
ssl_key_filestring用于客户端认证的SSL私钥文件的名称(必须为PEM格式)。
ssl_key_passwordstringSSL私钥密码。
statusinteger是否启用了Web方案。

可能的值:
0 - (默认) 启用;
1 -禁用.
templateidstring(readonly) 父模板Web方案的ID。
variablesstringWeb场景变量。
verify_hostinteger验证SSL证书中指定的主机名是否与场景中使用的主机名相匹配。

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

场景步骤

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

属性类型说明
httpstepidstring(readonly) 情景步骤的ID
name
(required)
string场景步骤的名称。
no
(required)
integerWeb场景中步骤的序列号。
url
(required)
string要检查的URL。
follow_redirectsinteger是否遵循HTTP重定向

可能的值:
0 - 不要重新导向;
1 - (default) 遵循重定向
headersstring (deprecated)
array of HTTP fields
执行请求时将发送的HTTP headers。场景步骤headers将覆盖Web场景指定的HTTP headers。
httptestidstring(readonly) 该步骤所属的Web方案的ID。
postsstring
array of HTTP fields
HTTP POST字符串(原始POST数据)或者一个 HTTP字段 数组 (来自字段数据)。
requiredstring必须在响应中存在的文本。
retrieve_modeinteger方案步骤必须检索的HTTP响应的一部分。
\可能的值:
0 - (default) 仅有文体;
1 - 仅有标题.
status_codesstring所需HTTP状态代码的范围用逗号分隔。
timeoutstring请求超时(秒)。接受秒数,带后缀的时间单位和用户宏。

默认: 15s.
variablesstring (deprecated)
array of HTTP字段
场景步骤变量。
query_fieldsarray of HTTP字段查询字段 - 在执行请求时将添加到URL HTTP字段

对于Web场景和Web场景步骤对象的headersvariables字段,都允许使用HTTP字段类型的字符串和数组。
不推荐使用 headersvariables 的字符串数据类型,将来的版本将删除它们。

HTTP 字段

HTTP字段对象定义名称和值,用于指定查询字段数据的变量,HTTP标头,POST表单字段数据。它具有以下属性。

属性类型说明
name
(required)
stringheader / variable / POST 或者 GET 字段的名称。
value
(required)
stringheader / variable / POST 或者 GET 字段的值。