On this page

设置 object

以下objects与settingsAPI直接相关。

设置

settings 对象具有以下属性。

Property Type Description
default_lang string 系统默认语言。

默认值: en_US.
default_timezone string 系统默认时区。

默认值: system - 系统默认值。

有关支持的完整时区列表，请参阅 PHP 文档。
default_theme string 默认主题。

可选值:
blue-theme - (默认) 蓝色；
dark-theme - 深色；
hc-light - 高对比度浅色；
hc-dark - 高对比度深色。
search_limit integer 搜索和筛选结果的限制。

默认值: 1000。
max_overview_table_size integer Data overview 和 Trigger overview 仪表板小组件中的最大列数和行数。

默认值: 50。
max_in_table integer 表格单元格内显示的最大元素数量。

默认值: 50。
server_check_interval integer 当 Zabbix 服务器宕机时显示警告。

可选值:
0 - 不显示警告；
10 - (默认) 显示警告。
work_period string 工作时间。

默认值: 1-5,09:00-18:00。
show_technical_errors integer 向非超级管理员用户以及未加入启用调试模式的用户组的用户显示技术错误（PHP/SQL）。

可选值:
0 - (默认) 不显示技术错误；
1 - 显示技术错误。
history_period string 在 Latest data、Web 和 Data overview 仪表板小组件中显示历史数据的最长时间。
接受带后缀的秒数和时间单位。

默认值: 24h。
period_default string 时间筛选器的默认周期。
接受带后缀的秒数和时间单位，并支持月和年（30s、1m、2h、1d、1M、1y）。

默认值: 1h。
max_period string 时间筛选器的最大周期。
接受带后缀的秒数和时间单位，并支持月和年（30s、1m、2h、1d、1M、1y）。

默认值: 2y。
severity_color_0 string “未分类”严重性的颜色，使用十六进制颜色代码。

默认值: 97AAB3。
severity_color_1 string “信息”严重性的颜色，使用十六进制颜色代码。

默认值: 7499FF。
severity_color_2 string “警告”严重性的颜色，使用十六进制颜色代码。

默认值: FFC859。
severity_color_3 string “一般”严重性的颜色，使用十六进制颜色代码。

默认值: FFA059。
severity_color_4 string “严重”严重性的颜色，使用十六进制颜色代码。

默认值: E97659。
severity_color_5 string “灾难”严重性的颜色，使用十六进制颜色代码。

默认值: E45959。
severity_name_0 string “未分类”严重性的名称。

默认值: Not classified。
severity_name_1 string “信息”严重性的名称。

默认值: Information。
severity_name_2 string “警告”严重性的名称。

默认值: Warning。
severity_name_3 string “一般”严重性的名称。

默认值: Average。
severity_name_4 string “严重”严重性的名称。

默认值: High。
severity_name_5 string “灾难”严重性的名称。

默认值: Disaster。
custom_color integer 使用自定义事件状态颜色。

可选值:
0 - (默认) 不使用自定义事件状态颜色；
1 - 使用自定义事件状态颜色。
ok_period string 显示 OK 触发器的周期。
接受带后缀的秒数和时间单位。

默认值: 5m。
blink_period string 状态变更时触发器闪烁的周期。
接受带后缀的秒数和时间单位。

默认值: 2m。
problem_unack_color string 未确认 PROBLEM 事件的颜色，使用十六进制颜色代码。

默认值: CC0000。
problem_ack_color string 已确认 PROBLEM 事件的颜色，使用十六进制颜色代码。

默认值: CC0000。
ok_unack_color string 未确认 RESOLVED 事件的颜色，使用十六进制颜色代码。

默认值: 009900。
ok_ack_color string 已确认 RESOLVED 事件的颜色，使用十六进制颜色代码。

默认值: 009900。
problem_unack_style integer 未确认 PROBLEM 事件的闪烁效果。

可选值:
0 - 不显示闪烁；
1 - (默认) 显示闪烁。
problem_ack_style integer 已确认 PROBLEM 事件的闪烁效果。

可选值:
0 - 不显示闪烁；
1 - (默认) 显示闪烁。
ok_unack_style integer 未确认 RESOLVED 事件的闪烁效果。

可选值:
0 - 不显示闪烁；
1 - (默认) 显示闪烁。
ok_ack_style integer 已确认 RESOLVED 事件的闪烁效果。

可选值:
0 - 不显示闪烁；
1 - (默认) 显示闪烁。
url string 前端 URL。
discovery_groupid ID 自动放置发现的主机的主机组 ID。
default_inventory_mode integer 默认主机清单模式。

可选值:
-1 - (默认) 禁用；
0 - 手动；
1 - 自动。
alert_usrgrpid ID 数据库宕机告警消息将发送到的用户组 ID。

如果设置为 "0"，则不会发送告警消息。
snmptrap_logging integer 记录未匹配的 SNMP trap。

可选值:
0 - 不记录未匹配的 SNMP trap；
1 - (默认) 记录未匹配的 SNMP trap。
login_attempts integer 登录失败次数达到该值后，登录表单将被阻止。

默认值: 5。
login_block string 如果登录失败次数超过 login_attempts 字段中定义的值，登录表单将被阻止的时间间隔。
接受带后缀的秒数和时间单位。

默认值: 30s。
validate_uri_schemes integer 验证 URI 方案。

可选值:
0 - 不验证；
1 - (默认) 验证。
uri_valid_schemes string 有效的 URI 方案。

默认值: http,https,ftp,file,mailto,tel,ssh。
x_frame_options string X-Frame-Options HTTP 头。

默认值: SAMEORIGIN。
iframe_sandboxing_enabled integer 使用 iframe 沙箱。

可选值:
0 - 不使用；
1 - (默认) 使用。
iframe_sandboxing_exceptions string iframe 沙箱例外。
connect_timeout string 与 Zabbix 服务器的连接超时。

可选范围: 1-30s。

默认值: 3s。

属性行为:
- required
socket_timeout string 网络默认超时。

可选范围: 1-300s。

默认值: 3s。

属性行为:
- required
media_type_test_timeout string 媒体类型测试的网络超时。

可选范围: 1-300s。

默认值: 65s。

属性行为:
- required
item_test_timeout string 监控项测试的网络超时。

可选范围: 1-600s。

默认值: 60s。

属性行为:
- required
script_timeout string 脚本执行的网络超时。

可选范围: 1-300s。

默认值: 60s。

属性行为:
- required
report_test_timeout string 计划报告测试的网络超时。

可选范围: 1-300s。

默认值: 60s。

属性行为:
- required
auditlog_enabled integer 是否启用审计日志记录。

可选值:
0 - 禁用；
1 - (默认) 启用。
auditlog_mode integer 是否启用服务器（System user）执行的低级别发现、网络发现和自动注册活动的审计日志记录。

可选值:
0 - 禁用；
1 - (默认) 启用。
ha_failover_delay string 故障切换延迟（秒）。

默认值: 1m。

属性行为:
- read-only
geomaps_tile_provider string 地理地图瓦片提供商。

可选值:
OpenStreetMap.Mapnik - (默认) OpenStreetMap Mapnik；
OpenTopoMap - OpenTopoMap；
Stamen.TonerLite - Stamen Toner Lite；
Stamen.Terrain - Stamen Terrain；
USGS.USTopo - USGS US Topo；
USGS.USImagery - USGS US Imagery。

支持空字符串，以指定 geomaps_tile_url、geomaps_max_zoom 和 geomaps_attribution 的自定义值。
geomaps_tile_url string 地理地图瓦片 URL。

属性行为:
- supported if geomaps_tile_provider is set to empty string
geomaps_max_zoom integer 地理地图最大缩放级别。

可选范围: 0-30。

属性行为:
- supported if geomaps_tile_provider is set to empty string
geomaps_attribution string 地理地图署名文本。

属性行为:
- supported if geomaps_tile_provider is set to empty string
vault_provider integer Vault 提供商。

可选值:
0 - (默认) HashiCorp Vault；
1 - CyberArk Vault。
timeout_zabbix_agent string 处理时间不超过 timeout_* 秒。
接受带后缀的秒数或时间单位（例如 30s、1m）。也接受用户宏。

可选范围: 1-600s。

默认值: 3s。
timeout_browser 的默认值: 60s。

属性行为:
- required
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