[comment]: # aside: 1

[comment]: # ({b839f372-d8014f4f})
# 设置 object

以下objects与`settings`API直接相关。

[comment]: # ({/b839f372-d8014f4f})

[comment]: # ({1ba972b7-a08f9118})
### 设置

settings 对象具有以下属性。

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|default\_lang|string|系统默认语言。<br><br>默认值: `en_US`.|
|default\_timezone|string|系统默认时区。<br><br>默认值: `system` - 系统默认值。<br><br>有关支持的完整时区列表，请参阅 [PHP 文档](https://www.php.net/manual/en/timezones.php)。|
|default\_theme|string|默认主题。<br><br>可选值:<br>`blue-theme` - *(默认)* 蓝色；<br>`dark-theme` - 深色；<br>`hc-light` - 高对比度浅色；<br>`hc-dark` - 高对比度深色。|
|search\_limit|integer|搜索和筛选结果的限制。<br><br>默认值: 1000。|
|max\_overview\_table\_size|integer|Data overview 和 Trigger overview 仪表板小组件中的最大列数和行数。<br><br>默认值: 50。|
|max\_in\_table|integer|表格单元格内显示的最大元素数量。<br><br>默认值: 50。|
|server\_check\_interval|integer|当 Zabbix 服务器宕机时显示警告。<br><br>可选值:<br>0 - 不显示警告；<br>10 - *(默认)* 显示警告。|
|work\_period|string|工作时间。<br><br>默认值: 1-5,09:00-18:00。|
|show\_technical\_errors|integer|向非超级管理员用户以及未加入启用调试模式的用户组的用户显示技术错误（PHP/SQL）。<br><br>可选值:<br>0 - *(默认)* 不显示技术错误；<br>1 - 显示技术错误。|
|history\_period|string|在 Latest data、Web 和 Data overview 仪表板小组件中显示历史数据的最长时间。<br>接受带后缀的秒数和时间单位。<br><br>默认值: 24h。|
|period\_default|string|时间筛选器的默认周期。<br>接受带后缀的秒数和时间单位，并支持月和年（30s、1m、2h、1d、1M、1y）。<br><br>默认值: 1h。|
|max\_period|string|时间筛选器的最大周期。<br>接受带后缀的秒数和时间单位，并支持月和年（30s、1m、2h、1d、1M、1y）。<br><br>默认值: 2y。|
|severity\_color\_0|string|“未分类”严重性的颜色，使用十六进制颜色代码。<br><br>默认值: 97AAB3。|
|severity\_color\_1|string|“信息”严重性的颜色，使用十六进制颜色代码。<br><br>默认值: 7499FF。|
|severity\_color\_2|string|“警告”严重性的颜色，使用十六进制颜色代码。<br><br>默认值: FFC859。|
|severity\_color\_3|string|“一般”严重性的颜色，使用十六进制颜色代码。<br><br>默认值: FFA059。|
|severity\_color\_4|string|“严重”严重性的颜色，使用十六进制颜色代码。<br><br>默认值: E97659。|
|severity\_color\_5|string|“灾难”严重性的颜色，使用十六进制颜色代码。<br><br>默认值: E45959。|
|severity\_name\_0|string|“未分类”严重性的名称。<br><br>默认值: Not classified。|
|severity\_name\_1|string|“信息”严重性的名称。<br><br>默认值: Information。|
|severity\_name\_2|string|“警告”严重性的名称。<br><br>默认值: Warning。|
|severity\_name\_3|string|“一般”严重性的名称。<br><br>默认值: Average。|
|severity\_name\_4|string|“严重”严重性的名称。<br><br>默认值: High。|
|severity\_name\_5|string|“灾难”严重性的名称。<br><br>默认值: Disaster。|
|custom\_color|integer|使用自定义事件状态颜色。<br><br>可选值:<br>0 - *(默认)* 不使用自定义事件状态颜色；<br>1 - 使用自定义事件状态颜色。|
|ok\_period|string|显示 OK 触发器的周期。<br>接受带后缀的秒数和时间单位。<br><br>默认值: 5m。|
|blink\_period|string|状态变更时触发器闪烁的周期。<br>接受带后缀的秒数和时间单位。<br><br>默认值: 2m。|
|problem\_unack\_color|string|未确认 PROBLEM 事件的颜色，使用十六进制颜色代码。<br><br>默认值: CC0000。|
|problem\_ack\_color|string|已确认 PROBLEM 事件的颜色，使用十六进制颜色代码。<br><br>默认值: CC0000。|
|ok\_unack\_color|string|未确认 RESOLVED 事件的颜色，使用十六进制颜色代码。<br><br>默认值: 009900。|
|ok\_ack\_color|string|已确认 RESOLVED 事件的颜色，使用十六进制颜色代码。<br><br>默认值: 009900。|
|problem\_unack\_style|integer|未确认 PROBLEM 事件的闪烁效果。<br><br>可选值:<br>0 - 不显示闪烁；<br>1 - *(默认)* 显示闪烁。|
|problem\_ack\_style|integer|已确认 PROBLEM 事件的闪烁效果。<br><br>可选值:<br>0 - 不显示闪烁；<br>1 - *(默认)* 显示闪烁。|
|ok\_unack\_style|integer|未确认 RESOLVED 事件的闪烁效果。<br><br>可选值:<br>0 - 不显示闪烁；<br>1 - *(默认)* 显示闪烁。|
|ok\_ack\_style|integer|已确认 RESOLVED 事件的闪烁效果。<br><br>可选值:<br>0 - 不显示闪烁；<br>1 - *(默认)* 显示闪烁。|
|url|string|前端 URL。|
|discovery\_groupid|ID|自动放置发现的主机的主机组 ID。|
|default\_inventory\_mode|integer|默认主机清单模式。<br><br>可选值:<br>-1 - *(默认)* 禁用；<br>0 - 手动；<br>1 - 自动。|
|alert\_usrgrpid|ID|数据库宕机告警消息将发送到的用户组 ID。<br><br>如果设置为 "0"，则不会发送告警消息。|
|snmptrap\_logging|integer|记录未匹配的 SNMP trap。<br><br>可选值:<br>0 - 不记录未匹配的 SNMP trap；<br>1 - *(默认)* 记录未匹配的 SNMP trap。|
|login\_attempts|integer|登录失败次数达到该值后，登录表单将被阻止。<br><br>默认值: 5。|
|login\_block|string|如果登录失败次数超过 login\_attempts 字段中定义的值，登录表单将被阻止的时间间隔。<br>接受带后缀的秒数和时间单位。<br><br>默认值: 30s。|
|validate\_uri\_schemes|integer|验证 URI 方案。<br><br>可选值:<br>0 - 不验证；<br>1 - *(默认)* 验证。|
|uri\_valid\_schemes|string|有效的 URI 方案。<br><br>默认值: http,https,ftp,file,mailto,tel,ssh。|
|x\_frame\_options|string|X-Frame-Options HTTP 头。<br><br>默认值: SAMEORIGIN。|
|iframe\_sandboxing\_enabled|integer|使用 iframe 沙箱。<br><br>可选值:<br>0 - 不使用；<br>1 - *(默认)* 使用。|
|iframe\_sandboxing\_exceptions|string|iframe 沙箱例外。|
|connect\_timeout|string|与 Zabbix 服务器的连接超时。<br><br>可选范围: 1-30s。<br><br>默认值: 3s。<br><br>[属性行为](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|socket\_timeout|string|网络默认超时。<br><br>可选范围: 1-300s。<br><br>默认值: 3s。<br><br>[属性行为](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|media\_type\_test\_timeout|string|媒体类型测试的网络超时。<br><br>可选范围: 1-300s。<br><br>默认值: 65s。<br><br>[属性行为](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|item\_test\_timeout|string|监控项测试的网络超时。<br><br>可选范围: 1-600s。<br><br>默认值: 60s。<br><br>[属性行为](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|script\_timeout|string|脚本执行的网络超时。<br><br>可选范围: 1-300s。<br><br>默认值: 60s。<br><br>[属性行为](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|report\_test\_timeout|string|计划报告测试的网络超时。<br><br>可选范围: 1-300s。<br><br>默认值: 60s。<br><br>[属性行为](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|auditlog\_enabled|integer|是否启用审计日志记录。<br><br>可选值:<br>0 - 禁用；<br>1 - *(默认)* 启用。|
|auditlog\_mode|integer|是否启用服务器（System user）执行的低级别发现、网络发现和自动注册活动的审计日志记录。<br><br>可选值:<br>0 - 禁用；<br>1 - *(默认)* 启用。|
|ha\_failover\_delay|string|故障切换延迟（秒）。<br><br>默认值: 1m。<br><br>[属性行为](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
|geomaps\_tile\_provider|string|地理地图瓦片提供商。<br><br>可选值:<br>`OpenStreetMap.Mapnik` - *(默认)* OpenStreetMap Mapnik；<br>`OpenTopoMap` - OpenTopoMap；<br>`Stamen.TonerLite` - Stamen Toner Lite；<br>`Stamen.Terrain` - Stamen Terrain；<br>`USGS.USTopo` - USGS US Topo；<br>`USGS.USImagery` - USGS US Imagery。<br><br>支持空字符串，以指定 `geomaps_tile_url`、`geomaps_max_zoom` 和 `geomaps_attribution` 的自定义值。|
|geomaps\_tile\_url|string|地理地图瓦片 URL。<br><br>[属性行为](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `geomaps_tile_provider` is set to empty string|
|geomaps\_max\_zoom|integer|地理地图最大缩放级别。<br><br>可选范围: 0-30。<br><br>[属性行为](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `geomaps_tile_provider` is set to empty string|
|geomaps\_attribution|string|地理地图署名文本。<br><br>[属性行为](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `geomaps_tile_provider` is set to empty string|
|vault\_provider|integer|Vault 提供商。<br><br>可选值:<br>0 - *(默认)* HashiCorp Vault；<br>1 - CyberArk Vault。|
|timeout\_zabbix\_agent|string|处理时间不超过 `timeout_*` 秒。<br>接受带后缀的秒数或时间单位（例如 30s、1m）。也接受用户宏。<br><br>可选范围: 1-600s。<br><br>默认值: 3s。<br>`timeout_browser` 的默认值: 60s。<br><br>[属性行为](/manual/api/reference_commentary#property-behavior):<br>- *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|^|^|

[comment]: # ({/1ba972b7-a08f9118})