[comment]: # aside: 1
[comment]: # ({b839f372-d8014f4f})
# 设置对象
以下对象都是与`settings` 直接相关的API。
[comment]: # ({/b839f372-d8014f4f})
[comment]: # ({551bc787-a08f9118})
### 设置
settings 对象具有以下属性。
|属性|[类型](/manual/api/reference_commentary#data-types)|描述|
|--|--|------|
|default\_lang|string|系统默认语言。
默认值：`en_US`。|
|default\_timezone|string|系统默认时区。
默认值：`system` - 系统默认。
有关支持的时区完整列表，请参阅 [PHP documentation](https://www.php.net/manual/en/timezones.php)。|
|default\_theme|string|默认主题。
可能的值：
`blue-theme` - *（默认）* 蓝色；
`blue-classic-theme` - 蓝色（经典）；
`dark-theme` - 深色；
`dark-classic-theme` - 深色（经典）；
`hc-light` - 高对比度浅色；
`hc-dark` - 高对比度深色。|
|search\_limit|integer|搜索和筛选结果的限制数量。
默认值：1000。|
|max\_overview\_table\_size|integer|仪表板中“数据概览”和“触发器概览”部件的最大列数和行数。
默认值：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|在“最新数据”、Web 和“数据概览”仪表板部件中显示历史数据的最大时间段。
接受秒数以及带后缀的时间单位。
默认值：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|“未分类”严重性的名称。
默认值：未分类。|
|severity\_name\_1|string|“信息”严重性的名称。
默认值：信息。|
|severity\_name\_2|string|“警告”严重性的名称。
默认值：警告。|
|severity\_name\_3|string|“一般”严重性的名称。
默认值：一般。|
|severity\_name\_4|string|“高”严重性的名称。
默认值：高。|
|severity\_name\_5|string|“灾难”严重性的名称。
默认值：灾难。|
|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。
[属性行为](/manual/api/reference_commentary#property-behavior)：
- *required*|
|socket\_timeout|string|网络默认超时时间。
可能的值范围：1-300s。
默认值：3s。
[属性行为](/manual/api/reference_commentary#property-behavior)：
- *required*|
|media\_type\_test\_timeout|string|媒介类型测试的网络超时时间。
可能的值范围：1-300s。
默认值：65s。
[属性行为](/manual/api/reference_commentary#property-behavior)：
- *required*|
|item\_test\_timeout|string|监控项测试的网络超时时间。
可能的值范围：1-600s。
默认值：60s。
[属性行为](/manual/api/reference_commentary#property-behavior)：
- *required*|
|script\_timeout|string|脚本执行的网络超时时间。
可能的值范围：1-300s。
默认值：60s。
[属性行为](/manual/api/reference_commentary#property-behavior)：
- *required*|
|report\_test\_timeout|string|计划报表测试的网络超时时间。
可能的值范围：1-300s。
默认值：60s。
[属性行为](/manual/api/reference_commentary#property-behavior)：
- *required*|
|auditlog\_enabled|integer|是否启用审计日志记录。
可能的值：
0 - 禁用；
1 - *（默认）* 启用。|
|auditlog\_mode|integer|是否启用对由服务器（系统用户）执行的低级别发现、网络发现和自动注册活动的审计日志记录。
可能的值：
0 - 禁用；
1 - *（默认）* 启用。|
|ha\_failover\_delay|string|故障切换延迟（秒）。
默认值：1m。
[属性行为](/manual/api/reference_commentary#property-behavior)：
- *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。
[属性行为](/manual/api/reference_commentary#property-behavior)：
- 当 `geomaps_tile_provider` 设置为空字符串时，*supported*|
|geomaps\_max\_zoom|integer|地理地图最大缩放级别。
可能的值：0-30。
[属性行为](/manual/api/reference_commentary#property-behavior)：
- 当 `geomaps_tile_provider` 设置为空字符串时，*supported*|
|geomaps\_attribution|string|地理地图署名文本。
[属性行为](/manual/api/reference_commentary#property-behavior)：
- 当 `geomaps_tile_provider` 设置为空字符串时，*supported*|
|vault\_provider|integer|Vault 提供商。
可能的值：
0 - *（默认）* HashiCorp Vault；
1 - CyberArk Vault。|
|proxy\_secrets\_provider|integer|通过以下方式解析密钥宏值：
可能的值：
0 - *（默认）* 仅服务器；
1 - 服务器和 proxies 独立解析。|
|timeout\_zabbix\_agent|string|处理耗时不超过 `timeout_*` 秒。
接受秒数或带后缀的时间单位（例如 30s、1m）。也接受用户宏。
可能的值范围：1-600s。
默认值：3s。
`timeout_browser` 的默认值：60s。
[属性行为](/manual/api/reference_commentary#property-behavior)：
- *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]: # ({/551bc787-a08f9118})