设置对象

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

设置

设置对象具有以下属性。

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

默认值：en_US。
default_timezone string 默认系统时区。

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

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

可能的值：
blue-theme - （默认） 蓝色；
blue-classic-theme - 蓝色（经典）；
dark-theme - 深色；
dark-blue-theme - 深蓝色；
dark-classic-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 仪表板小组件中显示历史数据的最大时间段。
接受秒数（例如 1、60、300），或带有时间后缀的值（例如 30s、1m、2h、1d）。

默认值：24h。
period_default string 时间筛选器的默认时间段。
接受秒数（例如 1、60、300），或带有时间后缀的值（例如 30s、1m、2h、1d、1M、1y），包括对月份和年份的支持。

默认值：1h。
max_period string 时间筛选器的最大时间段。
接受秒数（例如 1、60、300），或带有时间后缀的值（例如 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 触发器的时间段。
接受秒数（例如 1、60、300），或带有时间后缀的值（例如 30s、1m、2h）。

默认值：5m。
blink_period string 触发器状态发生变化时的闪烁时间段。
接受秒数（例如 1、60、300），或带有时间后缀的值（例如 30s、1m、2h）。

默认值：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 字段中定义的值，登录表单被阻止的时间间隔。
接受秒数（例如 1、60），或带有时间后缀的值（例如 30s、1m）。

默认值：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
device_link_timeout string 添加移动设备以便与 Zabbix 移动应用配合使用时的超时时间；适用于 Zabbix API 与桥接适配器之间的通信。

可能的值范围：1-300s。

默认值：60s。

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

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

可能的值：
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。

属性行为：
- 当 geomaps_tile_provider 设置为空字符串时supported
geomaps_max_zoom integer 地理地图最大缩放级别。

可能的值：0-30。

属性行为：
- 当 geomaps_tile_provider 设置为空字符串时supported
geomaps_attribution string 地理地图归属文本。

属性行为：
- 当 geomaps_tile_provider 设置为空字符串时supported
vault_provider integer Vault 提供程序。

可能的值：
0 - （默认） HashiCorp Vault；
1 - CyberArk Vault。
proxy_secrets_provider integer 通过以下方式解析 secret 宏值：

可能的值：
0 - （默认） 仅服务器；
1 - 服务器和 proxy 独立解析。
timeout_zabbix_agent string 处理时间不超过 timeout_* 秒。
接受秒数（例如 1、60、300），或带有时间后缀的值（例如 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
timeout_telemetry_query
apm_global_db object 全局数据源配置。

全局数据源

全局数据源对象具有以下属性：

Property Type Description
status integer 全局数据源状态。

可能的值：
0 - （默认） 未配置；
1 - 已配置。
url string 用于连接数据源的 URL。

属性行为：
- 如果用户将 status 更改为 1（已配置），则必需。
authentication_type integer 身份验证类型。

可能的值：
0 - （默认） 使用用户名和密码；
1 - 不使用身份验证。

属性行为：
- 如果用户将 status 更改为 1（已配置），则必需。
username string 用于登录数据源的用户名。

属性行为：
- 当 status 设置为 1（已配置）且 authentication_type 设置为 0（用户名和密码）时支持。
- 如果用户将 authentication_type 更改为 0（用户名和密码），则必需。
password string 用于登录数据源的密码。

此参数的值可以为空。

属性行为：
- 当 status 设置为 1（已配置）且 authentication_type 设置为 0（用户名和密码）时支持。
db string 数据库名称。

此参数的值可以为空。

属性行为：
- 当 status 设置为 1（已配置）时支持。
ssl_verify_peer integer 验证服务器证书。

可能的值：
0 - （默认） 禁用；
1 - 启用。

属性行为：
- 当 status 设置为 1（已配置）且 url 使用 https:// 方案时支持。
ssl_verify_host integer 验证主机。

可能的值：
0 - 禁用；
1 - （默认） 启用。

属性行为：
- 当 status 设置为 1（已配置）且 url 使用 https:// 方案时支持。