On this page

Proxy 对象

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

proxy

proxy 对象具有以下属性。

Property Type Description
proxyid ID proxy 的 ID。

Property behavior
- 只读
- 更新操作中为 必需
name string proxy 的名称。

Property behavior
- 创建操作中为 必需
proxy_groupid ID proxy 组的 ID。

0 - proxy 未分配到任何 proxy 组。
local_address string 用于 active agent 的地址。用于连接的 IP 地址或 DNS 名称。

Property behavior
- 当 proxy_groupid 不为 0 时为 必需
local_port string 用于连接的本地 proxy 端口号。

支持用户宏。

默认值:10051。

Property behavior
- 当 proxy_groupid 不为 0支持
operating_mode integer proxy 类型。

可能的值:
0 - active proxy;
1 - passive proxy。

Property behavior
- 创建操作中为 必需
description text proxy 的描述。
lastaccess timestamp proxy 上次连接到服务器的时间。

Property behavior
- 只读
address string 用于连接的 IP 地址或 DNS 名称。

支持用户宏。

Property behavior
- 当 Zabbix proxy operating mode 为 passive 时为 必需
port string 用于连接的端口号。

支持用户宏。

默认值:10051。

Property behavior
- 当 Zabbix proxy operating mode 为 passive 时支持
allowed_addresses string active Zabbix proxy 的逗号分隔 IP 地址或 DNS 名称。
tls_connect integer 与 proxy 的连接。

可能的值:
1 - (默认)不加密;
2 - PSK;
4 - 证书。
tls_accept integer 来自 proxy 的连接。

可能的位图值:
1 - (默认)不加密;
2 - PSK;
4 - 证书。

这是一个位掩码字段;可以使用任意可能位图值的总和(例如,PSK 和证书为 6)。
tls_issuer string 证书颁发者。
tls_subject string 证书主题。
tls_psk_identity string PSK 标识;必须仅与一个 PSK 配对(在自动注册主机proxy中)。

请勿在 PSK 标识中包含敏感信息,因为该标识会通过未加密的网络发送,以告知接收方应使用哪个 PSK。

Property behavior
- 只写
- 当 tls_connect 设置为 "PSK",或 tls_accept 包含 "PSK" 位时为 必需
tls_psk string 预共享密钥(PSK);必须至少包含 32 位十六进制数字。

Property behavior
- 只写
- 当 tls_connect 设置为 "PSK",或 tls_accept 包含 "PSK" 位时为 必需
custom_timeouts integer 是否在 proxy 级别覆盖全局监控项超时。

可能的值:
0 - (默认)使用全局设置;
1 - 覆盖超时。
timeout_zabbix_agent string 处理时间不超过 timeout_* 秒。
接受秒数(例如 160300),或带有时间后缀的值(例如 30s1m)。也接受用户宏。

可能的值范围:1-600s。

默认值:""。

Property behavior
- 当 custom_timeouts 设置为 1 时为 必需
timeout_simple_check
timeout_snmp_agent
timeout_external_check
timeout_db_monitor
timeout_http_agent
timeout_ssh_agent
timeout_telnet_agent
timeout_script
timeout_browser
version integer proxy 的版本。

由三部分组成的 Zabbix 版本号,每部分使用两位十进制数字,例如 60401 表示版本 6.4.1,70002 表示版本 7.0.2,依此类推。
0 - 未知的 proxy 版本。

Property behavior
- 只读
compatibility integer proxy 与 Zabbix 服务器版本的比较结果。

可能的值:
0 - 未定义;
1 - 当前版本(proxy 和服务器具有相同的主版本);
2 - 过时版本(proxy 版本低于服务器版本,但仍获得部分支持);
3 - 不支持的版本(proxy 版本低于服务器之前的 LTS 版本,或服务器主版本低于 proxy 主版本)。

Property behavior
- 只读
state integer proxy 的状态。

可能的值:
0 - 未知;
1 - 离线;
2 - 在线。

Property behavior
- 只读