On this page
Proxy object
以下 objects 直接与 proxy API 相关。
proxy
proxy 对象具有以下属性。
| Property | Type | Description |
|---|---|---|
| proxyid | ID | proxy 的 ID。 Property behavior: - read-only - required for update operations |
| name | string | proxy 的名称。 Property behavior: - required for create operations |
| proxy_groupid | ID | proxy 组的 ID。 0 - proxy 未分配到任何 proxy 组。 |
| local_address | string | 活动 agent 的地址。要连接的 IP 地址或 DNS 名称。 Property behavior: - required if proxy_groupid is not 0 |
| local_port | string | 用于连接的本地 proxy 端口号。 支持用户宏。 默认值：10051。 Property behavior: - supported if proxy_groupid is not 0 |
| operating_mode | integer | proxy 类型。 可能的值： 0 - active proxy； 1 - passive proxy。 Property behavior: - required for create operations |
| description | text | proxy 的描述。 |
| lastaccess | timestamp | proxy 上次连接到服务器的时间。 Property behavior: - read-only |
| address | string | 要连接的 IP 地址或 DNS 名称。 支持用户宏。 Property behavior: - required if the Zabbix proxy operating mode is passive |
| port | string | 要连接的端口号。 支持用户宏。 默认值：10051。 Property behavior: - supported if the Zabbix proxy operating mode is passive |
| allowed_addresses | string | 以逗号分隔的 active Zabbix proxy 的 IP 地址或 DNS 名称。 |
| tls_connect | integer | 到 proxy 的连接。 可能的值： 1 - (default) 不加密； 2 - PSK； 4 - 证书。 |
| tls_accept | integer | 来自 proxy 的连接。 可能的位图值： 1 - (default) 不加密； 2 - PSK； 4 - 证书。 这是一个位掩码字段；可接受任意可能位图值之和（例如，PSK 和证书可填 6）。 |
| tls_issuer | string | 证书颁发者。 |
| tls_subject | string | 证书主题。 |
| tls_psk_identity | string | PSK 标识；必须且只能与一个 PSK 配对（跨 autoregistration、hosts 和 proxies）。 请勿在 PSK 标识中包含敏感信息，因为它会以未加密方式在网络中传输，以告知接收方应使用哪个 PSK。 Property behavior: - write-only - required if tls_connect is set to "PSK", or tls_accept contains the "PSK" bit |
| tls_psk | string | 预共享密钥（PSK）；至少必须包含 32 个十六进制数字。 Property behavior: - write-only - required if tls_connect is set to "PSK", or tls_accept contains the "PSK" bit |
| custom_timeouts | integer | 是否在 proxy 级别覆盖全局监控项超时。 可能的值： 0 - (default) 使用全局设置； 1 - 覆盖超时。 |
| timeout_zabbix_agent | string | 处理时间不超过 timeout_* 秒。接受秒数或带后缀的时间单位（例如，30s、1m）。也接受用户宏。 可能的取值范围：1-600s。 默认值：""。 Property behavior: - required if custom_timeouts is set to 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: - read-only |
| compatibility | integer | proxy 与 Zabbix 服务器版本的兼容性。 可能的值： 0 - 未定义； 1 - 当前版本（proxy 和服务器具有相同的主版本号）； 2 - 过时版本（proxy 版本早于服务器版本，但仍部分受支持）； 3 - 不受支持的版本（proxy 版本早于服务器前一个 LTS 发行版版本，或服务器主版本号早于 proxy 主版本号）。 Property behavior: - read-only |
| state | integer | proxy 的状态。 可能的值： 0 - 未知； 1 - 离线； 2 - 在线。 Property behavior: - read-only |