en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |eventids|string/array|Return only events with the given IDs.| |groupids|string/array|Return only events created by objects that belong to the given host groups.| |hostids|string/array|Return only events created by objects that belong to the given hosts.| |objectids|string/array|Return only events created by the given objects.| |source|integer|Return only events with the given type.<br><br>Refer to the [event object page](object#event) for a list of supported event types.<br><br>Default: 0 - trigger events.| |object|integer|Return only events created by objects of the given type.<br><br>Refer to the [event object page](object#event) for a list of supported object types.<br><br>Default: 0 - trigger.| |acknowledged|boolean|If set to `true` return only acknowledged events.| |suppressed|boolean|`true` - return only suppressed events;<br>`false` - return events in the normal state.| |severities|integer/array|Return only events with given event severities. Applies only if object is trigger.| |evaltype|integer|Rules for tag searching.<br><br>Possible values:<br>0 - (default) And/Or;<br>2 - Or.| |tags|array of objects|Return only events with given tags. Exact match by tag and case-insensitive search by value and operator.<br>Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>An empty array returns all events.<br><br>Possible operator types:<br>0 - (default) Like;<br>1 - Equal;<br>2 - Not like;<br>3 - Not equal<br>4 - Exists;<br>5 - Not exists.| |eventid\_from|string|Return only events with IDs greater or equal to the given ID.| |eventid\_till|string|Return only events with IDs less or equal to the given ID.| |time\_from|timestamp|Return only events that have been created after or at the given time.| |time\_till|timestamp|Return only events that have been created before or at the given time.| |problem\_time\_from|timestamp|Returns only events that were in the problem state starting with `problem_time_from`. Applies only if the source is trigger event and object is trigger. Mandatory if `problem_time_till` is specified.| |problem\_time\_till|timestamp|Returns only events that were in the problem state until `problem_time_till`. Applies only if the source is trigger event and object is trigger. Mandatory if `problem_time_from` is specified.| |value|integer/array|Return only events with the given values.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with hosts containing the object that created the event. Supported only for events generated by triggers, items or LLD rules.| |selectRelatedObject|query|Return a `relatedObject` property with the object that created the event. The type of object returned depends on the event type.| |select\_alerts|query|Return an [alerts](/manual/api/reference/alert/object) property with alerts generated by the event. Alerts are sorted in reverse chronological order.| |select\_acknowledges|query|Return an `acknowledges` property with event updates. Event updates are sorted in reverse chronological order.<br><br>The event update object has the following properties:<br>`acknowledgeid` - `(string)` acknowledgment's ID;<br>`userid` - `(string)` ID of the user that updated the event;<br>`eventid` - `(string)` ID of the updated event;<br>`clock` - `(timestamp)` time when the event was updated;<br>`message` - `(string)` text of the message;<br>`action` - `(integer)` update action that was performed see [event.acknowledge](/manual/api/reference/event/acknowledge);<br>`old_severity` - `(integer)` event severity before this update action;<br>`new_severity` - `(integer)` event severity after this update action;<br>`username` - `(string)` username of the user that updated the event;<br>`name` - `(string)` name of the user that updated the event;<br>`surname` - `(string)` surname of the user that updated the event.<br><br>Supports `count`.| |selectTags|query|Return a [tags](/manual/api/reference/event/object#Event_tag) property with event tags.| |selectSuppressionData|query|Return a `suppression_data` property with the list of maintenances:<br>`maintenanceid` - `(string)` ID of the maintenance;<br>`suppress_until` - `(integer)` time until the event is suppressed.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `eventid`, `objectid` and `clock`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	### 参数  `(object)` 定义所需要输出的参数。  此方法支持以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |eventids|string/array|仅返回具有给定 ID 的事件。| |groupids|string/array|仅返回由属于给定主机组的对象创建的事件。|  |hostids|string/array|仅返回由属于给定主机的对象创建的事件。| |objectids|string/array|仅返回由给定对象创建的事件。| |source|integer|仅返回给定类型的事件。<br><br>参阅 [事件对象页面](object#事件) 获取支持的事件类型列表。<br><br>默认值：0 - 触发器事件。| |object|integer|仅返回由给定类型的对象创建的事件。<br><br>参阅 [事件对象页面](object#事件) 获取支持的事件类型列表。<br><br>默认值：0 - 触发器。| |acknowledged|boolean|如果设置为 `true` 仅返回已确认的事件。| |suppressed|boolean|`true` - 只返回被抑制的事件；<br>`false` - 返回正常状态的事件。| |severities|integer/array|仅返回具有给定严重性的事件。仅当对象是触发器时才适用。| |evaltype|integer|标签搜索规则。<br><br>可用值：<br>0 - （默认）和/或；<br>2 - 或。| |tags|对象数组|仅返回具有给定标签的事件。通过标签进行精确匹配，通过值和操作符进行不区分大小写的匹配。<br>格式：`[{"tag"："<tag>"， "value"："<value>"，"operator"："<operator>"}，...]`。<br>空数组返回所有事件。<br><br>可能的运算符类型：<br>0 - （默认） Like（类似于……）；<br>1 - Equal（等于）；<br>2 - Not like（不类似于……）；<br>3 - Not equal（不等于）；<br>4 - Exists（存在）；<br>5 - Not exists（不存在）。| |eventid\_from|string|仅返回 ID 大于或等于给定 ID 的事件。| |eventid\_till|string|仅返回 ID 小于或等于给定 ID 的事件。| |time\_from|timestamp|仅返回在给定时间或在给定时间之后创建的事件。| |time\_till|timestamp|仅返回在给定时间或在给定时间之前创建的事件。| |problem\_time\_from|timestamp|仅返回从`problem_time_from`设定的时间开始处于问题状态的事件。仅当事件源是触发器事件且对象为触发时适用。如果指定了 `problem_time_till` ，则为强制性。| |problem\_time\_till|timestamp|仅返回在`problem_time_still`设定的时间之前处于问题状态的事件。仅当事件源是触发器事件且对象为触发时适用。如果指定了 `problem_time_from`  ，则为强制性。| |value|integer/array|仅返回具有给定值的事件。| |selectHosts|query|返回 [主机](/manual/api/reference/host/object) 属性，其中 hosts 包含创建事件的对象。仅支持由触发器、监控项或 LLD 规则生成的事件。| |selectRelatedObject|query|返回带有创建事件的对象的 'relatedObject ' 属性。返回的对象类型取决于事件类型。| |select\_alerts|query|返回由事件生成的告警的 [告警](/manual/api/reference/alert/object) 属性。警报按时间倒序排列。| |select\_acknowledges|query|返回带有事件更新的 `acknowledges` 属性。 事件更新按时间倒序排列。<br><br>事件更新对象具有以下属性：<br>`acknowledgeid` - `(string)` 确认事件的ID；<br>`userid` - `(string)` 更新事件的用户ID；<br>`eventid` - `(string)` 更新事件的ID；<br>`clock` - `(timestamp)` 事件被更新的时间；<br>`message` - `(string)` 消息文本；<br>`action` - `(integer)` 更新执行的操作，参见 [event.acknowledge](/manual/api/reference/event/acknowledge)；<br>`old_severity` - `(integer)` 此更新操作之前的事件严重性；<br>`new_severity` - `(integer)` 此更新操作后的事件严重性；<br>`username` - `(string)` 更新该事件的用户的username（用户名）；<br>`name` - `(string)` 更新该事件的用户的name（可见名）；<br>`surname` - `(string)` 更新事件的用户的surname（姓）。<br><br>支持 `count`。| |selectTags|query|返回事件标签的 [标签](/manual/api/reference/event/object#事件标签) 属性。| |selectSuppressionData|query|返回维护列表的`suppression_data` 属性：<br>`maintenanceid` - `(string)` 维护期ID；<br>`suppress_until` - `(integer)` 事件被抑制的时间。| |sortfield|string/array|按给定属性对结果进行排序。<br><br>可用值：`eventid`，`objectid` 和 `clock`。| |countOutput|boolean|这些参数对于所有的 `get` 方法都是通用的，详细描述请参见 [参考说明](/manual/api/reference_commentary#通用get方法参数) 页面。| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |eventids|string/array|Return only events with the given IDs.| |groupids|string/array|Return only events created by objects that belong to the given host groups.| |hostids|string/array|Return only events created by objects that belong to the given hosts.| |objectids|string/array|Return only events created by the given objects.| |source|integer|Return only events with the given type.<br><br>Refer to the [event object page](object#event) for a list of supported event types.<br><br>Default: 0 - trigger events.| |object|integer|Return only events created by objects of the given type.<br><br>Refer to the [event object page](object#event) for a list of supported object types.<br><br>Default: 0 - trigger.| |acknowledged|boolean|If set to `true` return only acknowledged events.| |suppressed|boolean|`true` - return only suppressed events;<br>`false` - return events in the normal state.| |severities|integer/array|Return only events with given event severities. Applies only if object is trigger.| |evaltype|integer|Rules for tag searching.<br><br>Possible values:<br>0 - (default) And/Or;<br>2 - Or.| |tags|array of objects|Return only events with given tags. Exact match by tag and case-insensitive search by value and operator.<br>Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>An empty array returns all events.<br><br>Possible operator types:<br>0 - (default) Like;<br>1 - Equal;<br>2 - Not like;<br>3 - Not equal<br>4 - Exists;<br>5 - Not exists.| |eventid\_from|string|Return only events with IDs greater or equal to the given ID.| |eventid\_till|string|Return only events with IDs less or equal to the given ID.| |time\_from|timestamp|Return only events that have been created after or at the given time.| |time\_till|timestamp|Return only events that have been created before or at the given time.| |problem\_time\_from|timestamp|Returns only events that were in the problem state starting with `problem_time_from`. Applies only if the source is trigger event and object is trigger. Mandatory if `problem_time_till` is specified.| |problem\_time\_till|timestamp|Returns only events that were in the problem state until `problem_time_till`. Applies only if the source is trigger event and object is trigger. Mandatory if `problem_time_from` is specified.| |value|integer/array|Return only events with the given values.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with hosts containing the object that created the event. Supported only for events generated by triggers, items or LLD rules.| |selectRelatedObject|query|Return a `relatedObject` property with the object that created the event. The type of object returned depends on the event type.| |select\_alerts|query|Return an [alerts](/manual/api/reference/alert/object) property with alerts generated by the event. Alerts are sorted in reverse chronological order.| |select\_acknowledges|query|Return an `acknowledges` property with event updates. Event updates are sorted in reverse chronological order.<br><br>The event update object has the following properties:<br>`acknowledgeid` - `(string)` acknowledgment's ID;<br>`userid` - `(string)` ID of the user that updated the event;<br>`eventid` - `(string)` ID of the updated event;<br>`clock` - `(timestamp)` time when the event was updated;<br>`message` - `(string)` text of the message;<br>`action` - `(integer)` update action that was performed see [event.acknowledge](/manual/api/reference/event/acknowledge);<br>`old_severity` - `(integer)` event severity before this update action;<br>`new_severity` - `(integer)` event severity after this update action;<br>`username` - `(string)` username of the user that updated the event;<br>`name` - `(string)` name of the user that updated the event;<br>`surname` - `(string)` surname of the user that updated the event.<br><br>Supports `count`.| |selectTags|query|Return a [tags](/manual/api/reference/event/object#Event_tag) property with event tags.| |selectSuppressionData|query|Return a `suppression_data` property with the list of maintenances:<br>`maintenanceid` - `(string)` ID of the maintenance;<br>`suppress_until` - `(integer)` time until the event is suppressed.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `eventid`, `objectid` and `clock`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	### 参数  `(object)` 定义所需要输出的参数。  此方法支持以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |eventids|string/array|仅返回具有给定 ID 的事件。| |groupids|string/array|仅返回由属于给定主机组的对象创建的事件。|  |hostids|string/array|仅返回由属于给定主机的对象创建的事件。| |objectids|string/array|仅返回由给定对象创建的事件。| |source|integer|仅返回给定类型的事件。<br><br>参阅 [事件对象页面](object#事件) 获取支持的事件类型列表。<br><br>默认值：0 - 触发器事件。| |object|integer|仅返回由给定类型的对象创建的事件。<br><br>参阅 [事件对象页面](object#事件) 获取支持的事件类型列表。<br><br>默认值：0 - 触发器。| |acknowledged|boolean|如果设置为 `true` 仅返回已确认的事件。| |suppressed|boolean|`true` - 只返回被抑制的事件；<br>`false` - 返回正常状态的事件。| |severities|integer/array|仅返回具有给定严重性的事件。仅当对象是触发器时才适用。| |evaltype|integer|标签搜索规则。<br><br>可用值：<br>0 - （默认）和/或；<br>2 - 或。| |tags|对象数组|仅返回具有给定标签的事件。通过标签进行精确匹配，通过值和操作符进行不区分大小写的匹配。<br>格式：`[{"tag"："<tag>"， "value"："<value>"，"operator"："<operator>"}，...]`。<br>空数组返回所有事件。<br><br>可能的运算符类型：<br>0 - （默认） Like（类似于……）；<br>1 - Equal（等于）；<br>2 - Not like（不类似于……）；<br>3 - Not equal（不等于）；<br>4 - Exists（存在）；<br>5 - Not exists（不存在）。| |eventid\_from|string|仅返回 ID 大于或等于给定 ID 的事件。| |eventid\_till|string|仅返回 ID 小于或等于给定 ID 的事件。| |time\_from|timestamp|仅返回在给定时间或在给定时间之后创建的事件。| |time\_till|timestamp|仅返回在给定时间或在给定时间之前创建的事件。| |problem\_time\_from|timestamp|仅返回从`problem_time_from`设定的时间开始处于问题状态的事件。仅当事件源是触发器事件且对象为触发时适用。如果指定了 `problem_time_till` ，则为强制性。| |problem\_time\_till|timestamp|仅返回在`problem_time_still`设定的时间之前处于问题状态的事件。仅当事件源是触发器事件且对象为触发时适用。如果指定了 `problem_time_from`  ，则为强制性。| |value|integer/array|仅返回具有给定值的事件。| |selectHosts|query|返回 [主机](/manual/api/reference/host/object) 属性，其中 hosts 包含创建事件的对象。仅支持由触发器、监控项或 LLD 规则生成的事件。| |selectRelatedObject|query|返回带有创建事件的对象的 'relatedObject ' 属性。返回的对象类型取决于事件类型。| |select\_alerts|query|返回由事件生成的告警的 [告警](/manual/api/reference/alert/object) 属性。警报按时间倒序排列。| |select\_acknowledges|query|返回带有事件更新的 `acknowledges` 属性。 事件更新按时间倒序排列。<br><br>事件更新对象具有以下属性：<br>`acknowledgeid` - `(string)` 确认事件的ID；<br>`userid` - `(string)` 更新事件的用户ID；<br>`eventid` - `(string)` 更新事件的ID；<br>`clock` - `(timestamp)` 事件被更新的时间；<br>`message` - `(string)` 消息文本；<br>`action` - `(integer)` 更新执行的操作，参见 [event.acknowledge](/manual/api/reference/event/acknowledge)；<br>`old_severity` - `(integer)` 此更新操作之前的事件严重性；<br>`new_severity` - `(integer)` 此更新操作后的事件严重性；<br>`username` - `(string)` 更新该事件的用户的username（用户名）；<br>`name` - `(string)` 更新该事件的用户的name（可见名）；<br>`surname` - `(string)` 更新事件的用户的surname（姓）。<br><br>支持 `count`。| |selectTags|query|返回事件标签的 [标签](/manual/api/reference/event/object#事件标签) 属性。| |selectSuppressionData|query|返回维护列表的`suppression_data` 属性：<br>`maintenanceid` - `(string)` 维护期ID；<br>`suppress_until` - `(integer)` 事件被抑制的时间。| |sortfield|string/array|按给定属性对结果进行排序。<br><br>可用值：`eventid`，`objectid` 和 `clock`。| |countOutput|boolean|这些参数对于所有的 `get` 方法都是通用的，详细描述请参见 [参考说明](/manual/api/reference_commentary#通用get方法参数) 页面。| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |eventids|string/array|Return only problems with the given IDs.| |groupids|string/array|Return only problems created by objects that belong to the given host groups.| |hostids|string/array|Return only problems created by objects that belong to the given hosts.| |objectids|string/array|Return only problems created by the given objects.| |source|integer|Return only problems with the given type.<br><br>Refer to the [problem event object page](object#problem) for a list of supported event types.<br><br>Default: 0 - problem created by a trigger.| |object|integer|Return only problems created by objects of the given type.<br><br>Refer to the [problem event object page](object#problem) for a list of supported object types.<br><br>Default: 0 - trigger.| |acknowledged|boolean|`true` - return acknowledged problems only;<br>`false` - unacknowledged only.| |suppressed|boolean|`true` - return only suppressed problems;<br>`false` - return problems in the normal state.| |severities|integer/array|Return only problems with given event severities. Applies only if object is trigger.| |evaltype|integer|Rules for tag searching.<br><br>Possible values:<br>0 - (default) And/Or;<br>2 - Or.| |tags|array of objects|Return only problems with given tags. Exact match by tag and case-insensitive search by value and operator.<br>Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>An empty array returns all problems.<br><br>Possible operator types:<br>0 - (default) Like;<br>1 - Equal;<br>2 - Not like;<br>3 - Not equal<br>4 - Exists;<br>5 - Not exists.| |recent|boolean|`true` - return PROBLEM and recently RESOLVED problems (depends on Display OK triggers for N seconds)<br>Default: `false` - UNRESOLVED problems only| |eventid\_from|string|Return only problems with IDs greater or equal to the given ID.| |eventid\_till|string|Return only problems with IDs less or equal to the given ID.| |time\_from|timestamp|Return only problems that have been created after or at the given time.| |time\_till|timestamp|Return only problems that have been created before or at the given time.| |selectAcknowledges|query|Return an `acknowledges` property with the problem updates. Problem updates are sorted in reverse chronological order.<br><br>The problem update object has the following properties:<br>`acknowledgeid` - `(string)` update's ID;<br>`userid` - `(string)` ID of the user that updated the event;<br>`eventid` - `(string)` ID of the updated event;<br>`clock` - `(timestamp)` time when the event was updated;<br>`message` - `(string)` text of the message;<br>`action` - `(integer)`type of update action (see [event.acknowledge](/manual/api/reference/event/acknowledge));<br>`old_severity` - `(integer)` event severity before this update action;<br>`new_severity` - `(integer)` event severity after this update action;<br><br>Supports `count`.| |selectTags|query|Return a [tags](/manual/api/reference/problem/object#problem_tag) property with the problem tags. Output format: `[{"tag": "<tag>", "value": "<value>"}, ...]`.| |selectSuppressionData|query|Return a `suppression_data` property with the list of maintenances:<br>`maintenanceid` - `(string)` ID of the maintenance;<br>`suppress_until` - `(integer)` time until the problem is suppressed.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `eventid`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	### 参数  `(object)` 定义所需输出的参数。  该方法支持以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |eventids|string/array|仅返回给定 ID 的问题。| |groupids|string/array|仅返回属于给定主机组的对象创建的问题。| |hostids|string/array|仅返回属于给定主机的对象创建的问题。| |objectids|string/array|仅返回给定对象创建的问题。| |source|integer|仅返回给定类型的问题。<br><br>有关支持的事件类型列表，请参阅[问题事件对象页面](object#问题)。<br><br>默认值：0 - 由触发器创建的问题。| |object|integer|仅返回由给定类型的对象创建的问题。<br><br>有关支持的对象类型列表，请参阅[问题事件对象页面](object#问题)。<br><br>默认值：0 - 触发器。| |acknowledged|boolean|`true` - 仅返回已确认的问题；<br>`false` - 仅未确认。| |suppressed|boolean|`true` - 仅返回被抑制的问题；<br>`false` - 返回正常状态的问题。| |severities|integer/array|仅返回给定事件严重性的问题。仅当对象是触发器时才适用。| |evaltype|integer|标签搜索规则。<br><br>可用值：<br>0 - （默认） And/Or；<br>2 - Or。| |tags|对象数组|仅返回给定标签的问题。按标签精确匹配，按值和运算符不区分大小写搜索。<br>格式：`[{"tag": "<tag>", "value": "<value>", "operator": "<operator> "}, ...]`。<br>空数组返回所有问题。<br><br>可能的运算符类型：<br>0 - （默认）相似；<br>1 - 等于；<br>2 - 不相似；<br>3 - 不等于；<br>4 - 存在；<br>5 - 不存在。| |recent|boolean|`true` - 返回 PROBLEM 和最近解决的问题（取决于 N 秒的 Display OK 触发器）。<br>默认值：`false` - 仅未解决的问题。| |eventid\_from|string|仅返回 ID 大于或等于给定 ID 的问题。| |eventid\_till|string|仅返回 ID 小于或等于给定 ID 的问题。| |time\_from|timestamp|仅返回在给定时间之后或在给定时间创建的问题。| |time\_till|timestamp|仅返回在给定时间之前或在给定时间创建的问题。| |selectAcknowledges|query|返回带有问题更新的 `acknowledges` 属性。问题更新按时间倒序排列。<br><br>问题更新对象具有以下属性：<br>`acknowledgeid` - `(string)` 更新的 ID；<br>`userid` - `(string) ` 更新事件的用户 ID；<br>`eventid` - `(string)` 更新事件的 ID；<br>`clock` - `(timestamp)` 事件更新的时间；<br> `message` - `(string)` 消息文本；<br>`action` - `(integer)` 更新操作类型（参见 [event.acknowledge](/manual/api/reference/event/acknowledge)）；<br>`old_severity` - 此更新操作之前的`(integer)` 事件严重性；<br>`new_severity` - 此更新操作后的`(integer)` 事件严重性；<br><br>支持`count`。| |selectTags|query|返回带有问题标签的 [tags](/manual/api/reference/problem/object#problem_tag) 属性。输出格式：`[{"tag": "<tag>", "value": "<value>"}, ...]`。| |selectSuppressionData|query|返回带有维护列表的 `suppression_data` 属性：<br>`maintenanceid` - `(string)` 维护的 ID；<br>`suppress_until` - `(integer)` 出现问题的时间被压制。| |sortfield|string/array|按给定的属性对结果进行排序。<br><br>可用值：`eventid`。| |countOutput|boolean|这些参数对所有的 `get` 方法是通用的，详情请参阅 [参考说明](/manual/api/reference_commentary#通用get方法参数) 。| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |eventids|string/array|Return only problems with the given IDs.| |groupids|string/array|Return only problems created by objects that belong to the given host groups.| |hostids|string/array|Return only problems created by objects that belong to the given hosts.| |objectids|string/array|Return only problems created by the given objects.| |source|integer|Return only problems with the given type.<br><br>Refer to the [problem event object page](object#problem) for a list of supported event types.<br><br>Default: 0 - problem created by a trigger.| |object|integer|Return only problems created by objects of the given type.<br><br>Refer to the [problem event object page](object#problem) for a list of supported object types.<br><br>Default: 0 - trigger.| |acknowledged|boolean|`true` - return acknowledged problems only;<br>`false` - unacknowledged only.| |suppressed|boolean|`true` - return only suppressed problems;<br>`false` - return problems in the normal state.| |severities|integer/array|Return only problems with given event severities. Applies only if object is trigger.| |evaltype|integer|Rules for tag searching.<br><br>Possible values:<br>0 - (default) And/Or;<br>2 - Or.| |tags|array of objects|Return only problems with given tags. Exact match by tag and case-insensitive search by value and operator.<br>Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>An empty array returns all problems.<br><br>Possible operator types:<br>0 - (default) Like;<br>1 - Equal;<br>2 - Not like;<br>3 - Not equal<br>4 - Exists;<br>5 - Not exists.| |recent|boolean|`true` - return PROBLEM and recently RESOLVED problems (depends on Display OK triggers for N seconds)<br>Default: `false` - UNRESOLVED problems only| |eventid\_from|string|Return only problems with IDs greater or equal to the given ID.| |eventid\_till|string|Return only problems with IDs less or equal to the given ID.| |time\_from|timestamp|Return only problems that have been created after or at the given time.| |time\_till|timestamp|Return only problems that have been created before or at the given time.| |selectAcknowledges|query|Return an `acknowledges` property with the problem updates. Problem updates are sorted in reverse chronological order.<br><br>The problem update object has the following properties:<br>`acknowledgeid` - `(string)` update's ID;<br>`userid` - `(string)` ID of the user that updated the event;<br>`eventid` - `(string)` ID of the updated event;<br>`clock` - `(timestamp)` time when the event was updated;<br>`message` - `(string)` text of the message;<br>`action` - `(integer)`type of update action (see [event.acknowledge](/manual/api/reference/event/acknowledge));<br>`old_severity` - `(integer)` event severity before this update action;<br>`new_severity` - `(integer)` event severity after this update action;<br><br>Supports `count`.| |selectTags|query|Return a [tags](/manual/api/reference/problem/object#problem_tag) property with the problem tags. Output format: `[{"tag": "<tag>", "value": "<value>"}, ...]`.| |selectSuppressionData|query|Return a `suppression_data` property with the list of maintenances:<br>`maintenanceid` - `(string)` ID of the maintenance;<br>`suppress_until` - `(integer)` time until the problem is suppressed.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `eventid`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	### 参数  `(object)` 定义所需输出的参数。  该方法支持以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |eventids|string/array|仅返回给定 ID 的问题。| |groupids|string/array|仅返回属于给定主机组的对象创建的问题。| |hostids|string/array|仅返回属于给定主机的对象创建的问题。| |objectids|string/array|仅返回给定对象创建的问题。| |source|integer|仅返回给定类型的问题。<br><br>有关支持的事件类型列表，请参阅[问题事件对象页面](object#问题)。<br><br>默认值：0 - 由触发器创建的问题。| |object|integer|仅返回由给定类型的对象创建的问题。<br><br>有关支持的对象类型列表，请参阅[问题事件对象页面](object#问题)。<br><br>默认值：0 - 触发器。| |acknowledged|boolean|`true` - 仅返回已确认的问题；<br>`false` - 仅未确认。| |suppressed|boolean|`true` - 仅返回被抑制的问题；<br>`false` - 返回正常状态的问题。| |severities|integer/array|仅返回给定事件严重性的问题。仅当对象是触发器时才适用。| |evaltype|integer|标签搜索规则。<br><br>可用值：<br>0 - （默认） And/Or；<br>2 - Or。| |tags|对象数组|仅返回给定标签的问题。按标签精确匹配，按值和运算符不区分大小写搜索。<br>格式：`[{"tag": "<tag>", "value": "<value>", "operator": "<operator> "}, ...]`。<br>空数组返回所有问题。<br><br>可能的运算符类型：<br>0 - （默认）相似；<br>1 - 等于；<br>2 - 不相似；<br>3 - 不等于；<br>4 - 存在；<br>5 - 不存在。| |recent|boolean|`true` - 返回 PROBLEM 和最近解决的问题（取决于 N 秒的 Display OK 触发器）。<br>默认值：`false` - 仅未解决的问题。| |eventid\_from|string|仅返回 ID 大于或等于给定 ID 的问题。| |eventid\_till|string|仅返回 ID 小于或等于给定 ID 的问题。| |time\_from|timestamp|仅返回在给定时间之后或在给定时间创建的问题。| |time\_till|timestamp|仅返回在给定时间之前或在给定时间创建的问题。| |selectAcknowledges|query|返回带有问题更新的 `acknowledges` 属性。问题更新按时间倒序排列。<br><br>问题更新对象具有以下属性：<br>`acknowledgeid` - `(string)` 更新的 ID；<br>`userid` - `(string) ` 更新事件的用户 ID；<br>`eventid` - `(string)` 更新事件的 ID；<br>`clock` - `(timestamp)` 事件更新的时间；<br> `message` - `(string)` 消息文本；<br>`action` - `(integer)` 更新操作类型（参见 [event.acknowledge](/manual/api/reference/event/acknowledge)）；<br>`old_severity` - 此更新操作之前的`(integer)` 事件严重性；<br>`new_severity` - 此更新操作后的`(integer)` 事件严重性；<br><br>支持`count`。| |selectTags|query|返回带有问题标签的 [tags](/manual/api/reference/problem/object#problem_tag) 属性。输出格式：`[{"tag": "<tag>", "value": "<value>"}, ...]`。| |selectSuppressionData|query|返回带有维护列表的 `suppression_data` 属性：<br>`maintenanceid` - `(string)` 维护的 ID；<br>`suppress_until` - `(integer)` 出现问题的时间被压制。| |sortfield|string/array|按给定的属性对结果进行排序。<br><br>可用值：`eventid`。| |countOutput|boolean|这些参数对所有的 `get` 方法是通用的，详情请参阅 [参考说明](/manual/api/reference_commentary#通用get方法参数) 。| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |globalmacro|flag|Return global macros instead of host macros.| |globalmacroids|string/array|Return only global macros with the given IDs.| |groupids|string/array|Return only host macros that belong to hosts or templates from the given host groups.| |hostids|string/array|Return only macros that belong to the given hosts or templates.| |hostmacroids|string/array|Return only host macros with the given IDs.| |inherited|boolean|If set to `true` return only host prototype user macros inherited from a template.| |selectGroups|query|Return host groups that the host macro belongs to in the [groups](/manual/api/reference/hostgroup/object) property.<br><br>Used only when retrieving host macros.| |selectHosts|query|Return hosts that the host macro belongs to in the [hosts](/manual/api/reference/host/object) property.<br><br>Used only when retrieving host macros.| |selectTemplates|query|Return templates that the host macro belongs to in the [templates](/manual/api/reference/template/object) property.<br><br>Used only when retrieving host macros.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible value: `macro`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	### Parameters  `(object)` 定义所需输出的参数.  该方法支持以下参数.  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |globalmacro|flag|返回全局宏而不是主机宏.| |globalmacroids|string/array|仅返回具有给定ID的全局宏.| |groupids|string/array|根据给定主机群组仅返回属于主机或模板的主机宏.| |hostids|string/array|仅返回属于给定主机或模板的宏.| |hostmacroids|string/array|仅返回给定主机宏ID的主机宏.| |inherited|boolean|如果设置为 `true` 仅返回从模板继承过来的主机原型的宏.| |selectGroups|query| 在 [groups](/manual/api/reference/hostgroup/object) 属性中返回拥有这个主机宏的主机组.<br><br>仅在查询主机宏时有效.| |selectHosts|query|在 [hosts](/manual/api/reference/host/object) 属性中返回拥有这个主机宏的主机.<br><br>仅在查询主机宏时有效.| |selectTemplates|query|在 [templates](/manual/api/reference/template/object) 属性中返回拥有这个主机宏的模板.<br><br>仅在查询主机宏时有效.| |sortfield|string/array|按给定参数排序返回结果.<br><br>可用值: `macro`.| |countOutput|boolean|这些参数对所有 `get` 方法是通用的，在 [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) 页面有详细描述.| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |globalmacro|flag|Return global macros instead of host macros.| |globalmacroids|string/array|Return only global macros with the given IDs.| |groupids|string/array|Return only host macros that belong to hosts or templates from the given host groups.| |hostids|string/array|Return only macros that belong to the given hosts or templates.| |hostmacroids|string/array|Return only host macros with the given IDs.| |inherited|boolean|If set to `true` return only host prototype user macros inherited from a template.| |selectGroups|query|Return host groups that the host macro belongs to in the [groups](/manual/api/reference/hostgroup/object) property.<br><br>Used only when retrieving host macros.| |selectHosts|query|Return hosts that the host macro belongs to in the [hosts](/manual/api/reference/host/object) property.<br><br>Used only when retrieving host macros.| |selectTemplates|query|Return templates that the host macro belongs to in the [templates](/manual/api/reference/template/object) property.<br><br>Used only when retrieving host macros.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible value: `macro`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	### Parameters  `(object)` 定义所需输出的参数.  该方法支持以下参数.  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |globalmacro|flag|返回全局宏而不是主机宏.| |globalmacroids|string/array|仅返回具有给定ID的全局宏.| |groupids|string/array|根据给定主机群组仅返回属于主机或模板的主机宏.| |hostids|string/array|仅返回属于给定主机或模板的宏.| |hostmacroids|string/array|仅返回给定主机宏ID的主机宏.| |inherited|boolean|如果设置为 `true` 仅返回从模板继承过来的主机原型的宏.| |selectGroups|query| 在 [groups](/manual/api/reference/hostgroup/object) 属性中返回拥有这个主机宏的主机组.<br><br>仅在查询主机宏时有效.| |selectHosts|query|在 [hosts](/manual/api/reference/host/object) 属性中返回拥有这个主机宏的主机.<br><br>仅在查询主机宏时有效.| |selectTemplates|query|在 [templates](/manual/api/reference/template/object) 属性中返回拥有这个主机宏的模板.<br><br>仅在查询主机宏时有效.| |sortfield|string/array|按给定参数排序返回结果.<br><br>可用值: `macro`.| |countOutput|boolean|这些参数对所有 `get` 方法是通用的，在 [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) 页面有详细描述.| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |graphids|string/array|Return only graph items that belong to the given graphs.| |itemids|string/array|Return only graph items with the given item IDs.| |type|integer|Return only graph items with the given type.<br><br>Refer to the [graph item object page](object#graph_item) for a list of supported graph item types.| |selectGraphs|query|Return a [graphs](/manual/api/reference/graph/object) property with an array of graphs that the item belongs to.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `gitemid`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |sortorder|string/array|^|
zh-cn	 ### 参数  `(object)` 定义所需输出的参数。  该方法支持以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |graphids|string/array|只返回属于给定图表的图表监控项。| |itemids|string/array|只返回具有给定监控项ID的图表监控项。| |type|integer|只返回具有给定类型的图表监控项。<br><br>请参考[图表监控项对象页](object#图表监控项)，了解支持的图表监控项类型列表。| |selectGraphs|query|返回一个[图表](/manual/api/reference/graph/object)属性，其中包含该监控项所属的图表的数组。| |sortfield|string/array|按给定的属性对结果进行排序。<br><br>可用值： `gitemid`。| |countOutput|boolean|这些参数是所有 "get "方法的共同参数，在[参考说明](/manual/api/reference_commentary#通用get方法参数)页面中有详细描述。| |editable|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |sortorder|string/array|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |graphids|string/array|Return only graph items that belong to the given graphs.| |itemids|string/array|Return only graph items with the given item IDs.| |type|integer|Return only graph items with the given type.<br><br>Refer to the [graph item object page](object#graph_item) for a list of supported graph item types.| |selectGraphs|query|Return a [graphs](/manual/api/reference/graph/object) property with an array of graphs that the item belongs to.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `gitemid`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |sortorder|string/array|^|
zh-cn	 ### 参数  `(object)` 定义所需输出的参数。  该方法支持以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |graphids|string/array|只返回属于给定图表的图表监控项。| |itemids|string/array|只返回具有给定监控项ID的图表监控项。| |type|integer|只返回具有给定类型的图表监控项。<br><br>请参考[图表监控项对象页](object#图表监控项)，了解支持的图表监控项类型列表。| |selectGraphs|query|返回一个[图表](/manual/api/reference/graph/object)属性，其中包含该监控项所属的图表的数组。| |sortfield|string/array|按给定的属性对结果进行排序。<br><br>可用值： `gitemid`。| |countOutput|boolean|这些参数是所有 "get "方法的共同参数，在[参考说明](/manual/api/reference_commentary#通用get方法参数)页面中有详细描述。| |editable|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |sortorder|string/array|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |graphids|string/array|Return only graphs with the given IDs.| |groupids|string/array|Return only graphs that belong to hosts in the given host groups.| |templateids|string/array|Return only graph that belong to the given templates.| |hostids|string/array|Return only graphs that belong to the given hosts.| |itemids|string/array|Return only graphs that contain the given items.| |templated|boolean|If set to `true` return only graphs that belong to templates.| |inherited|boolean|If set to `true` return only graphs inherited from a template.| |expandName|flag|Expand macros in the graph name.| |selectGroups|query|Return a [groups](/manual/api/reference/hostgroup/object) property with the host groups that the graph belongs to.| |selectTemplates|query|Return a [templates](/manual/api/reference/template/object) property with the templates that the graph belongs to.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with the hosts that the graph belongs to.| |selectItems|query|Return an [items](/manual/api/reference/item/object) property with the items used in the graph.| |selectGraphDiscovery|query|Return a `graphDiscovery` property with the graph discovery object. The graph discovery objects links the graph to a graph prototype from which it was created.<br><br>It has the following properties:<br>`graphid` - `(string)` ID of the graph;<br>`parent_graphid` - `(string)` ID of the graph prototype from which the graph has been created.| |selectGraphItems|query|Return a [gitems](/manual/api/reference/graphitem/object) property with the items used in the graph.| |selectDiscoveryRule|query|Return a [discoveryRule](/manual/api/reference/drule/object) property with the low-level discovery rule that created the graph.| |filter|object|Return only those results that exactly match the given filter.<br><br>Accepts an array, where the keys are property names, and the values are either a single value or an array of values to match against.<br><br>Supports additional filters:<br>`host` - technical name of the host that the graph belongs to;<br>`hostid` - ID of the host that the graph belongs to.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `graphid`, `name` and `graphtype`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	 ### 参数  `(object)` 参数定义了所需的输出。  该方法支持以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |graphids|string/array|只返回具有给定ID的图表。| |groupids|string/array|只返回属于给定主机组中的主机的图表。| |templateids|string/array|只返回属于给定模板的图表。| |hostids|string/array|只返回属于给定主机的图表。| |itemids|string/array|只返回包含给定监控项的图表。| |templated|boolean|如果设置为`true`，只返回属于模板的图表。| |inherited|boolean|如果设置为`true`，只返回从模板继承的图表。| |expandName|flag|在图表名称中扩展宏。| |selectGroups|query|返回一个[组](/manual/api/reference/hostgroup/object)属性，其中包含该图表所属的主机组。| |selectTemplates|query|返回一个[模板](/manual/api/reference/template/object)属性，其中包含该图表所属的模板。| |selectHosts|query|返回一个[主机](/manual/api/reference/host/object)属性，其中包含该图表所属的主机。| |selectItems|query|返回一个[监控项](/manual/api/reference/item/object)属性，其中包含该图表中使用的监控项。| |selectGraphDiscovery|query|返回一个 `graphDiscovery` 属性和图表发现对象。图表发现对象将图表和创建图标的原型联系起来。<br><br>它具有以下属性：<br>`graphid` - `(string)` 图表的ID；<br>`parent_graphid` - `(string)` 创建图表的图表原型的ID。| |selectGraphItems|query|返回一个[图表监控项](/manual/api/reference/graphitem/object)属性，其中包含该图表中使用的监控项。| |selectDiscoveryRule|query|返回一个[发现规则](/manual/api/reference/drule/object)属性，其中包含创建该图表的低级发现规则。| |filter|object|只返回那些与给定过滤器完全匹配的结果。<br><br>接受一个数组，其中键是属性名称，而值是其匹配的单一的值或一个数组的值。<br><br>支持额外的过滤器：<br>`host` - 图表所属主机的技术名称；<br>`hostid` - 图表所属主机的ID。| |sortfield|string/array|按给定的属性对结果进行排序。<br><br>可用值： `graphid`, `name` 和 `graphtype`。| |countOutput|boolean|这些参数对所有的 "get "方法均是通用的，在[参考说明](/manual/api/reference_commentary#通用get方法参数)页面中有详细描述。| |editable|boolean|^| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |graphids|string/array|Return only graphs with the given IDs.| |groupids|string/array|Return only graphs that belong to hosts in the given host groups.| |templateids|string/array|Return only graph that belong to the given templates.| |hostids|string/array|Return only graphs that belong to the given hosts.| |itemids|string/array|Return only graphs that contain the given items.| |templated|boolean|If set to `true` return only graphs that belong to templates.| |inherited|boolean|If set to `true` return only graphs inherited from a template.| |expandName|flag|Expand macros in the graph name.| |selectGroups|query|Return a [groups](/manual/api/reference/hostgroup/object) property with the host groups that the graph belongs to.| |selectTemplates|query|Return a [templates](/manual/api/reference/template/object) property with the templates that the graph belongs to.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with the hosts that the graph belongs to.| |selectItems|query|Return an [items](/manual/api/reference/item/object) property with the items used in the graph.| |selectGraphDiscovery|query|Return a `graphDiscovery` property with the graph discovery object. The graph discovery objects links the graph to a graph prototype from which it was created.<br><br>It has the following properties:<br>`graphid` - `(string)` ID of the graph;<br>`parent_graphid` - `(string)` ID of the graph prototype from which the graph has been created.| |selectGraphItems|query|Return a [gitems](/manual/api/reference/graphitem/object) property with the items used in the graph.| |selectDiscoveryRule|query|Return a [discoveryRule](/manual/api/reference/drule/object) property with the low-level discovery rule that created the graph.| |filter|object|Return only those results that exactly match the given filter.<br><br>Accepts an array, where the keys are property names, and the values are either a single value or an array of values to match against.<br><br>Supports additional filters:<br>`host` - technical name of the host that the graph belongs to;<br>`hostid` - ID of the host that the graph belongs to.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `graphid`, `name` and `graphtype`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	 ### 参数  `(object)` 参数定义了所需的输出。  该方法支持以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |graphids|string/array|只返回具有给定ID的图表。| |groupids|string/array|只返回属于给定主机组中的主机的图表。| |templateids|string/array|只返回属于给定模板的图表。| |hostids|string/array|只返回属于给定主机的图表。| |itemids|string/array|只返回包含给定监控项的图表。| |templated|boolean|如果设置为`true`，只返回属于模板的图表。| |inherited|boolean|如果设置为`true`，只返回从模板继承的图表。| |expandName|flag|在图表名称中扩展宏。| |selectGroups|query|返回一个[组](/manual/api/reference/hostgroup/object)属性，其中包含该图表所属的主机组。| |selectTemplates|query|返回一个[模板](/manual/api/reference/template/object)属性，其中包含该图表所属的模板。| |selectHosts|query|返回一个[主机](/manual/api/reference/host/object)属性，其中包含该图表所属的主机。| |selectItems|query|返回一个[监控项](/manual/api/reference/item/object)属性，其中包含该图表中使用的监控项。| |selectGraphDiscovery|query|返回一个 `graphDiscovery` 属性和图表发现对象。图表发现对象将图表和创建图标的原型联系起来。<br><br>它具有以下属性：<br>`graphid` - `(string)` 图表的ID；<br>`parent_graphid` - `(string)` 创建图表的图表原型的ID。| |selectGraphItems|query|返回一个[图表监控项](/manual/api/reference/graphitem/object)属性，其中包含该图表中使用的监控项。| |selectDiscoveryRule|query|返回一个[发现规则](/manual/api/reference/drule/object)属性，其中包含创建该图表的低级发现规则。| |filter|object|只返回那些与给定过滤器完全匹配的结果。<br><br>接受一个数组，其中键是属性名称，而值是其匹配的单一的值或一个数组的值。<br><br>支持额外的过滤器：<br>`host` - 图表所属主机的技术名称；<br>`hostid` - 图表所属主机的ID。| |sortfield|string/array|按给定的属性对结果进行排序。<br><br>可用值： `graphid`, `name` 和 `graphtype`。| |countOutput|boolean|这些参数对所有的 "get "方法均是通用的，在[参考说明](/manual/api/reference_commentary#通用get方法参数)页面中有详细描述。| |editable|boolean|^| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |graphids|string/array|Return only host groups that contain hosts or templates with the given graphs.| |groupids|string/array|Return only host groups with the given host group IDs.| |hostids|string/array|Return only host groups that contain the given hosts.| |maintenanceids|string/array|Return only host groups that are affected by the given maintenances.| |monitored\_hosts|flag|Return only host groups that contain monitored hosts.| |real\_hosts|flag|Return only host groups that contain hosts.| |templated\_hosts|flag|Return only host groups that contain templates.| |templateids|string/array|Return only host groups that contain the given templates.| |triggerids|string/array|Return only host groups that contain hosts or templates with the given triggers.| |with\_graphs|flag|Return only host groups that contain hosts with graphs.| |with\_graph\_prototypes|flag|Return only host groups that contain hosts with graph prototypes.| |with\_hosts\_and\_templates|flag|Return only host groups that contain hosts *or* templates.| |with\_httptests|flag|Return only host groups that contain hosts with web checks.<br><br>Overrides the `with_monitored_httptests` parameter.| |with\_items|flag|Return only host groups that contain hosts or templates with items.<br><br>Overrides the `with_monitored_items` and `with_simple_graph_items` parameters.| |with\_item\_prototypes|flag|Return only host groups that contain hosts with item prototypes.<br><br>Overrides the `with_simple_graph_item_prototypes` parameter.| |with\_simple\_graph\_item\_prototypes|flag|Return only host groups that contain hosts with item prototypes, which are enabled for creation and have numeric type of information.| |with\_monitored\_httptests|flag|Return only host groups that contain hosts with enabled web checks.| |with\_monitored\_items|flag|Return only host groups that contain hosts or templates with enabled items.<br><br>Overrides the `with_simple_graph_items` parameter.| |with\_monitored\_triggers|flag|Return only host groups that contain hosts with enabled triggers. All of the items used in the trigger must also be enabled.| |with\_simple\_graph\_items|flag|Return only host groups that contain hosts with numeric items.| |with\_triggers|flag|Return only host groups that contain hosts with triggers.<br><br>Overrides the `with_monitored_triggers` parameter.| |selectDiscoveryRule|query|Return a [discoveryRule](/manual/api/reference/drule/object) property with the LLD rule that created the host group.| |selectGroupDiscovery|query|Return a `groupDiscovery` property with the host group discovery object.<br><br>The host group discovery object links a discovered host group to a host group prototype and has the following properties:<br>`groupid` - `(string)` ID of the discovered host group;<br>`lastcheck` - `(timestamp)` time when the host group was last discovered;<br>`name` - `(string)` name of the host group prototype;<br>`parent_group_prototypeid` - `(string)` ID of the host group prototype from which the host group has been created;<br>`ts_delete` - `(timestamp)` time when a host group that is no longer discovered will be deleted.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with the hosts that belong to the host group.<br><br>Supports `count`.| |selectTemplates|query|Return a [templates](/manual/api/reference/template/object) property with the templates that belong to the host group.<br><br>Supports `count`.| |limitSelects|integer|Limits the number of records returned by subselects.<br><br>Applies to the following subselects:<br>`selectHosts` - results will be sorted by `host`;<br>`selectTemplates` - results will be sorted by `host`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `groupid`, `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	### 参数  `(对象)` 参数定义所需的输出。  该方法支持以下参数。  |参数|[类](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |graphids|字符串/数组|只返回包含给定图形的主机或模板的主机组。| |groupids|字符串/数组|只返回具有给定主机组id的主机组。| |hostids|字符串/数组|只返回包含给定主机的主机组。| |maintenanceids|字符串/数组|只返回受给定维护影响的主机组。| |monitored\_hosts|标记|只返回包含监控主机的主机组。| |real\_hosts|标记|只返回包含主机的主机组。| |templated\_hosts|标记|只返回包含模板的主机组。| |templateids|字符串/数组|只返回包含给定模板的主机组。| |triggerids|字符串/数组|只返回包含具有给定触发器的主机或模板的主机组。| |with\_graphs|标记|只返回包含有图形的主机的主机组。| |with\_graph\_prototypes|标记|只返回包含带有图形原型的主机的主机组。| |with\_hosts\_and\_templates|标记|只返回包含主机 **或** 模板的主机组。| |with\_httptests|标记|只返回包含web检查主机的主机组。<br><br>覆盖 `with_monitored_httptests` 参数。| |with\_items|标记|只返回包含有监控项的主机或模板的主机组。<br><br>覆盖 `with_monitored_items` 和 `with_simple_graph_items` 参数。| |with\_item\_prototypes|标记|只返回包含带有监控项原型的主机的主机组。<br><br>覆盖 `with_simple_graph_item_prototypes` 参数。| |with\_simple\_graph\_item\_prototypes|标记|只返回包含具有监控项原型的主机的主机组，监控项原型支持创建并具有数字类型的信息。| |with\_monitored\_httptests|标记|只返回包含启用web检查的主机的主机组。| |with\_monitored\_items|标记|只返回包含启用监控项的主机或模板的主机组。<br><br>覆盖 `with_simple_graph_items` 参数。| |with\_monitored\_triggers|标记|只返回包含启用触发器的主机的主机组。触发器中使用的所有监控项也必须启用。| |with\_simple\_graph\_items|标记|只返回包含带有数字监控项的主机的主机组。| |with\_triggers|标记|只返回包含有触发器的主机的主机组。<br><br>覆盖 `with_monitored_triggers` 参数。| |selectDiscoveryRule|查询|返回 [发现规则](/manual/api/reference/drule/对象) 属性和创建主机组的LLD规则。| |selectGroupDiscovery|查询|返回 `groupDiscovery` 属性和主机组发现对象.<br><br>发现主机组对象将发现的主机组链接到主机组原型，具有以下属性:<br>`groupid` - `(字符串)` 发现的主机组ID;<br>`lastcheck` - `(时间戳)` 最后发现主机组的时间;<br>`name` - `(字符串)` 主机组原型的名称;<br>`parent_group_prototypeid` - `(字符串)` 创建主机组的主机组原型ID;<br>`ts_delete` - `(时间戳)` 当主机组未被发现时，删除该主机组的时间。| |selectHosts|查询|返回[主机](/manual/api/reference/host/对象)属性和属于主机组的主机。<br><br>支持 `count`.| |selectTemplates|查询|返回 [模板](/manual/api/reference/template/对象) 属性和属于主机组的模板。<br><br>支持 `count`.| |limitSelects|整型|限制子查询返回的记录数量。<br><br>适用于下列子查询项:<br>`selectHosts` - 结果将按 `host` 排序;<br>`selectTemplates` - r结果将按 `host` 排序。| |sortfield|字符串/数组|根据给定的属性对结果进行排序。<br><br>可能的值是: `groupid`, `name`.| |countOutput|布尔值|这些对所有 `get` 方法通用的参数在 [参考注释](/manual/api/reference_commentary#common_get_method_parameters) 中有详细描述。| |editable|布尔值|^| |excludeSearch|布尔值|^| |filter|对象|^| |limit|整型|^| |output|查询|^| |preservekeys|布尔值|^| |search|对象|^| |searchByAny|布尔值|^| |searchWildcardsEnabled|布尔值|^| |sortorder|字符串/数组|^| |startSearch|布尔值|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groupids|string/array|Return only maintenances that are assigned to the given host groups.| |hostids|string/array|Return only maintenances that are assigned to the given hosts.| |maintenanceids|string/array|Return only maintenances with the given IDs.| |selectGroups|query|Return a [groups](/manual/api/reference/hostgroup/object) property with host groups assigned to the maintenance.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with hosts assigned to the maintenance.| |selectTags|query|Return a [tags](/manual/api/reference/maintenance/object#problem_tag) property with problem tags of the maintenance.| |selectTimeperiods|query|Return a [timeperiods](/manual/api/reference/maintenance/object#Time_period) property with time periods of the maintenance.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `maintenanceid`, `name` and `maintenance_type`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	### 参数  `(object)` 定义所需输出的参数。  该方法支持以下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|说明| |---------|--------------------------------------|------------| |groupids|string/array|只返回分配给给定主机组的维护。| |hostids|string/array|仅返回分配给给定主机的维护。| |maintenanceids|string/array|只返回给定 ID 的维护。| |selectGroups|query|返回一个 [groups](/manual/api/reference/hostgroup/object) 属性，其中主机组分配给维护。| |selectHosts|query|返回一个 [hosts](/manual/api/reference/host/object) 属性，其中主机分配给维护。| |selectTags|query|返回带有维护问题标签的 [tags](/manual/api/reference/maintenance/object#problem_tag) 属性。| |selectTimeperiods|query|返回带有维护时间段的 [timeperiods](/manual/api/reference/maintenance/object#Time_period) 属性。| |sortfield|string/array|按给定属性对结果进行排序。<br><br>可用值：`maintenanceid`、`name` 和 `maintenance_type`。| |countOutput|boolean|这些参数对所有 `get` 方法都是通用的，在 [参考评论](/manual/api/reference_commentary#common_get_method_parameters) 中有详细描述。| |可编辑|boolean|^| |排除搜索|boolean|^| |过滤器|object|^| |限制|integer|^| |输出|query|^| |preservekeys|boolean|^| |搜索|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |排序|string/array|^| |开始搜索|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groupids|string/array|Return only scripts that can be run on the given host groups.| |hostids|string/array|Return only scripts that can be run on the given hosts.| |scriptids|string/array|Return only scripts with the given IDs.| |usrgrpids|string/array|Return only scripts that can be run by users in the given user groups.| |selectGroups|query|Return a [groups](/manual/api/reference/hostgroup/object) property with host groups that the script can be run on.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with hosts that the script can be run on.| |selectActions|query|Return a [actions](/manual/api/reference/action/object) property with actions that the script is associated with.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `scriptid` and `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	### 参数 `(对象)` 定义所需输出的参数。  此方法支持如下参数。  |参数|[类型](/manual/api/reference_commentary#数据_类型)|描述| |---------|---------------------------------------------------|-----------| |groupids|string/array|返回可以在给定主机组上运行的脚本| |hostids|string/array|返回可以在给定主机上运行的脚本。| |scriptids|string/array|返回具有给定ID的脚本。| |usrgrpids|string/array|返回可以被给定用户组中用户运行的脚本| |selectGroups|query|返回可以在其上运行脚本的主机群组的 [群组](/manual/api/reference/hostgroup/object) 属性。| |selectHosts|query|返回可以在其上运行脚本的主机的[主机](/manual/api/reference/host/object)属性。| |selectActions|query|返回与脚本相关联的动作的[动作](/manual/api/reference/action/object)属性。| |sortfield|string/array|根据给定属性将结果排序。<br><br>可能的值: `scriptid` 和 `name`.| |countOutput|boolean|这些参数与所有`get`方法相同，详细描述见[reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |groupids|string/array|Return only scripts that can be run on the given host groups.| |hostids|string/array|Return only scripts that can be run on the given hosts.| |scriptids|string/array|Return only scripts with the given IDs.| |usrgrpids|string/array|Return only scripts that can be run by users in the given user groups.| |selectGroups|query|Return a [groups](/manual/api/reference/hostgroup/object) property with host groups that the script can be run on.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with hosts that the script can be run on.| |selectActions|query|Return a [actions](/manual/api/reference/action/object) property with actions that the script is associated with.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `scriptid` and `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	### 参数 `(对象)` 定义所需输出的参数。  此方法支持如下参数。  |参数|[类型](/manual/api/reference_commentary#数据_类型)|描述| |---------|---------------------------------------------------|-----------| |groupids|string/array|返回可以在给定主机组上运行的脚本| |hostids|string/array|返回可以在给定主机上运行的脚本。| |scriptids|string/array|返回具有给定ID的脚本。| |usrgrpids|string/array|返回可以被给定用户组中用户运行的脚本| |selectGroups|query|返回可以在其上运行脚本的主机群组的 [群组](/manual/api/reference/hostgroup/object) 属性。| |selectHosts|query|返回可以在其上运行脚本的主机的[主机](/manual/api/reference/host/object)属性。| |selectActions|query|返回与脚本相关联的动作的[动作](/manual/api/reference/action/object)属性。| |sortfield|string/array|根据给定属性将结果排序。<br><br>可能的值: `scriptid` 和 `name`.| |countOutput|boolean|这些参数与所有`get`方法相同，详细描述见[reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groupids|string/array|Return only web scenarios that belong to the given host groups.| |hostids|string/array|Return only web scenarios that belong to the given hosts.| |httptestids|string/array|Return only web scenarios with the given IDs.| |inherited|boolean|If set to `true` return only web scenarios inherited from a template.| |monitored|boolean|If set to `true` return only enabled web scenarios that belong to monitored hosts.| |templated|boolean|If set to `true` return only web scenarios that belong to templates.| |templateids|string/array|Return only web scenarios that belong to the given templates.| |expandName|flag|Expand macros in the name of the web scenario.| |expandStepName|flag|Expand macros in the names of scenario steps.| |evaltype|integer|Rules for tag searching.<br><br>Possible values:<br>0 - (default) And/Or;<br>2 - Or.| |tags|array of objects|Return only web scenarios with given tags. Exact match by tag and case-sensitive or case-insensitive search by tag value depending on operator value.<br>Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>An empty array returns all web scenarios.<br><br>Possible operator types:<br>0 - (default) Like;<br>1 - Equal;<br>2 - Not like;<br>3 - Not equal<br>4 - Exists;<br>5 - Not exists.| |selectHosts|query|Return the hosts that the web scenario belongs to as an array in the [hosts](/manual/api/reference/host/object) property.| |selectSteps|query|Return web scenario steps in the [steps](/manual/api/reference/httptest/object#scenario_step) property.<br><br>Supports `count`.| |selectTags|query|Return the web scenario tags in [tags](/manual/api/reference/httptest/object#web_scenario_tag) property.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `httptestid` and `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	 ### 参数  `(object)` 定义期望输出的参数。  此方法支持以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |groupids|string/array|仅返回属于给定主机组的Web场景。| |hostids|string/array|仅返回属于给定主机的Web场景。| |httptestids|string/array|仅返回给定ID的Web场景。| |inherited|boolean|如果设置为`true`，仅返回从模板继承的Web场景。| |monitored|boolean|如果设置为`true`，仅返回属于被监控主机的可用Web场景。| |templated|boolean|如果设置为`true`，仅返回属于模板的Web场景。| |templateids|string/array|仅返回属于给定模板的Web场景。| |expandName|flag|以Web场景的名称展开宏。| |expandStepName|flag|以场景步骤的名称展开宏。| |evaltype|integer|用于标签搜索的规则。<br><br>可用值：<br>0 - (默认) And/Or；<br>2 - Or。| |tags|array of objects|仅返回给定标签的Web场景。根据标签进行精确匹配，并根据运算符值按标签值进行区分大小写或不区分大小写的搜索。<br>格式：`[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`。<br>一个空数组返回所有的Web场景。<br><br>可能的运算符类型：<br>0 - (默认) Like；<br>1 - Equal；<br>2 - Not like；<br>3 - Not equal；<br>4 - Exists；<br>5 - Not exists。| |selectHosts|query|在[hosts](/manual/api/reference/host/object)属性中，以一个数组的方式返回Web场景所属的主机。| |selectSteps|query|在[steps](/manual/api/reference/httptest/object#场景步骤)属性中返回Web场景步骤。<br><br>支持`count`。| |selectTags|query|在[tags](/manual/api/reference/httptest/object#web场景标签)属性中返回Web场景标签。| |sortfield|string/array|按照给定属性对结果进行排序。<br><br>可能的值：`httptestid`和`name`。| |countOutput|boolean|这些参数对所有`get`方法是公共的，详细描述请参见[参考说明](/manual/api/reference_commentary#通用get方法参数) 。| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |groupids|string/array|Return only web scenarios that belong to the given host groups.| |hostids|string/array|Return only web scenarios that belong to the given hosts.| |httptestids|string/array|Return only web scenarios with the given IDs.| |inherited|boolean|If set to `true` return only web scenarios inherited from a template.| |monitored|boolean|If set to `true` return only enabled web scenarios that belong to monitored hosts.| |templated|boolean|If set to `true` return only web scenarios that belong to templates.| |templateids|string/array|Return only web scenarios that belong to the given templates.| |expandName|flag|Expand macros in the name of the web scenario.| |expandStepName|flag|Expand macros in the names of scenario steps.| |evaltype|integer|Rules for tag searching.<br><br>Possible values:<br>0 - (default) And/Or;<br>2 - Or.| |tags|array of objects|Return only web scenarios with given tags. Exact match by tag and case-sensitive or case-insensitive search by tag value depending on operator value.<br>Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>An empty array returns all web scenarios.<br><br>Possible operator types:<br>0 - (default) Like;<br>1 - Equal;<br>2 - Not like;<br>3 - Not equal<br>4 - Exists;<br>5 - Not exists.| |selectHosts|query|Return the hosts that the web scenario belongs to as an array in the [hosts](/manual/api/reference/host/object) property.| |selectSteps|query|Return web scenario steps in the [steps](/manual/api/reference/httptest/object#scenario_step) property.<br><br>Supports `count`.| |selectTags|query|Return the web scenario tags in [tags](/manual/api/reference/httptest/object#web_scenario_tag) property.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `httptestid` and `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	 ### 参数  `(object)` 定义期望输出的参数。  此方法支持以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |groupids|string/array|仅返回属于给定主机组的Web场景。| |hostids|string/array|仅返回属于给定主机的Web场景。| |httptestids|string/array|仅返回给定ID的Web场景。| |inherited|boolean|如果设置为`true`，仅返回从模板继承的Web场景。| |monitored|boolean|如果设置为`true`，仅返回属于被监控主机的可用Web场景。| |templated|boolean|如果设置为`true`，仅返回属于模板的Web场景。| |templateids|string/array|仅返回属于给定模板的Web场景。| |expandName|flag|以Web场景的名称展开宏。| |expandStepName|flag|以场景步骤的名称展开宏。| |evaltype|integer|用于标签搜索的规则。<br><br>可用值：<br>0 - (默认) And/Or；<br>2 - Or。| |tags|array of objects|仅返回给定标签的Web场景。根据标签进行精确匹配，并根据运算符值按标签值进行区分大小写或不区分大小写的搜索。<br>格式：`[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`。<br>一个空数组返回所有的Web场景。<br><br>可能的运算符类型：<br>0 - (默认) Like；<br>1 - Equal；<br>2 - Not like；<br>3 - Not equal；<br>4 - Exists；<br>5 - Not exists。| |selectHosts|query|在[hosts](/manual/api/reference/host/object)属性中，以一个数组的方式返回Web场景所属的主机。| |selectSteps|query|在[steps](/manual/api/reference/httptest/object#场景步骤)属性中返回Web场景步骤。<br><br>支持`count`。| |selectTags|query|在[tags](/manual/api/reference/httptest/object#web场景标签)属性中返回Web场景标签。| |sortfield|string/array|按照给定属性对结果进行排序。<br><br>可能的值：`httptestid`和`name`。| |countOutput|boolean|这些参数对所有`get`方法是公共的，详细描述请参见[参考说明](/manual/api/reference_commentary#通用get方法参数) 。| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |ha\_nodeids|string/array|Return only nodes with the given node IDs.| |filter|object|Return only those results that exactly match the given filter.<br><br>Accepts an array, where the keys are property names, and the values are either a single value or an array of values to match against.<br><br>Allows filtering by the node properties: `name`, `address`, `status`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `name`, `lastaccess`, `status`.| |countOutput|flag|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |sortorder|string/array|^|
zh-cn	 ### 参数  `(object)` 参数定义所期望的输出。  该方法支持以下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |ha\_nodeids|string/array|只返回具有给定节点ID的节点。| |filter|object|只返回那些与给定过滤器完全匹配的结果。<br><br>接受一个数组，其中键是属性名称，而值是一个单一的值或一个数组的值来匹配。<br><br>允许通过节点属性进行过滤： `name`、`address` 和 `status`.| |sortfield|string/array|按给定的属性对结果进行排序。<br><br>可能的取值： `name`、`lastaccess` 和 `status`.| |countOutput|flag|这些参数是所有 `get` 方法的共同参数，在[参考注释](/manual/api/reference_commentary#common_get_method_parameters)中详细描述。| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |sortorder|string/array|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |ha\_nodeids|string/array|Return only nodes with the given node IDs.| |filter|object|Return only those results that exactly match the given filter.<br><br>Accepts an array, where the keys are property names, and the values are either a single value or an array of values to match against.<br><br>Allows filtering by the node properties: `name`, `address`, `status`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `name`, `lastaccess`, `status`.| |countOutput|flag|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |sortorder|string/array|^|
zh-cn	 ### 参数  `(object)` 参数定义所期望的输出。  该方法支持以下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |ha\_nodeids|string/array|只返回具有给定节点ID的节点。| |filter|object|只返回那些与给定过滤器完全匹配的结果。<br><br>接受一个数组，其中键是属性名称，而值是一个单一的值或一个数组的值来匹配。<br><br>允许通过节点属性进行过滤： `name`、`address` 和 `status`.| |sortfield|string/array|按给定的属性对结果进行排序。<br><br>可能的取值： `name`、`lastaccess` 和 `status`.| |countOutput|flag|这些参数是所有 `get` 方法的共同参数，在[参考注释](/manual/api/reference_commentary#common_get_method_parameters)中详细描述。| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |sortorder|string/array|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |history|integer|History object types to return.<br><br>Possible values:<br>0 - numeric float;<br>1 - character;<br>2 - log;<br>3 - numeric unsigned;<br>4 - text.<br><br>Default: 3.| |hostids|string/array|Return only history from the given hosts.| |itemids|string/array|Return only history from the given items.| |time\_from|timestamp|Return only values that have been received after or at the given time.| |time\_till|timestamp|Return only values that have been received before or at the given time.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `itemid` and `clock`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	 ### 参数  `(object)` 参数定义所期望的输出。  该方法支持以下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |history|integer|要返回的历史对象的类型。<br><br>可能的取值：<br>0 - 浮点数；<br>1 - 字符；<br>2 - 日志；<br>3 - 无符号数；<br>4 - 文本。<br><br>默认： 3.| |hostids|string/array|只返回给定主机的历史。| |itemids|string/array|只返回给定监控项的历史。| |time\_from|timestamp|只返回在给定时间或在给定时间之后收到的值。| |time\_till|timestamp|只返回在给定时间之前或在给定时间收到的值。| |sortfield|string/array|按给定的属性对结果进行排序。<br><br>可能的取值： `itemid` 和 `clock`.| |countOutput|boolean|这些参数是所有 `get` 方法的共同参数，在[参考注释](/manual/api/reference_commentary#common_get_method_parameters)页面中有详细描述。| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |history|integer|History object types to return.<br><br>Possible values:<br>0 - numeric float;<br>1 - character;<br>2 - log;<br>3 - numeric unsigned;<br>4 - text.<br><br>Default: 3.| |hostids|string/array|Return only history from the given hosts.| |itemids|string/array|Return only history from the given items.| |time\_from|timestamp|Return only values that have been received after or at the given time.| |time\_till|timestamp|Return only values that have been received before or at the given time.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `itemid` and `clock`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	 ### 参数  `(object)` 参数定义所期望的输出。  该方法支持以下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |history|integer|要返回的历史对象的类型。<br><br>可能的取值：<br>0 - 浮点数；<br>1 - 字符；<br>2 - 日志；<br>3 - 无符号数；<br>4 - 文本。<br><br>默认： 3.| |hostids|string/array|只返回给定主机的历史。| |itemids|string/array|只返回给定监控项的历史。| |time\_from|timestamp|只返回在给定时间或在给定时间之后收到的值。| |time\_till|timestamp|只返回在给定时间之前或在给定时间收到的值。| |sortfield|string/array|按给定的属性对结果进行排序。<br><br>可能的取值： `itemid` 和 `clock`.| |countOutput|boolean|这些参数是所有 `get` 方法的共同参数，在[参考注释](/manual/api/reference_commentary#common_get_method_parameters)页面中有详细描述。| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |iconmapids|string/array|Return only icon maps with the given IDs.| |sysmapids|string/array|Return only icon maps that are used in the given maps.| |selectMappings|query|Return a [mappings](/manual/api/reference/iconmap/object#icon_mapping) property with the icon mappings used.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `iconmapid` and `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	 ### 参数  `(object)` 定义所需输出的参数  该方法支持如下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |iconmapids|string/array|只返回具有给定id的图标映射。| |sysmapids|string/array|只返回在给定映射中使用的图标映射。| |selectMappings|query|Return a [mappings](/manual/api/reference/iconmap/object#icon_mapping) property with the icon mappings used.| |sortfield|string/array|根据给定的属性对结果进行排序。<br><br>可选值: `iconmapid` 和 `name`。| |countOutput|boolean|这些参数对于所有的“get”方法都是通用的，详细描述请参见 [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |iconmapids|string/array|Return only icon maps with the given IDs.| |sysmapids|string/array|Return only icon maps that are used in the given maps.| |selectMappings|query|Return a [mappings](/manual/api/reference/iconmap/object#icon_mapping) property with the icon mappings used.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `iconmapid` and `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	 ### 参数  `(object)` 定义所需输出的参数  该方法支持如下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |iconmapids|string/array|只返回具有给定id的图标映射。| |sysmapids|string/array|只返回在给定映射中使用的图标映射。| |selectMappings|query|Return a [mappings](/manual/api/reference/iconmap/object#icon_mapping) property with the icon mappings used.| |sortfield|string/array|根据给定的属性对结果进行排序。<br><br>可选值: `iconmapid` 和 `name`。| |countOutput|boolean|这些参数对于所有的“get”方法都是通用的，详细描述请参见 [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |imageids|string/array|Return only images with the given IDs.| |sysmapids|string/array|Return images that are used on the given maps.| |select\_image|flag|Return an `image` property with the Base64 encoded image.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `imageid` and `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	### 参数  `(object)` 定义目标输出参数。  此方法支持以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |imageids|string/array|仅返回指定 ID 的图像。| |sysmapids|string/array|返回使用指定映射的图像。| |select\_image|flag|返回 `image` 属性，其中包含 Base64 类型编码图像。| |sortfield|string/array|按照给定的属性对结果进行排序。<br><br>可用类型：`imageid` 和 `name`。 | |countOutput|boolean|这些参数对所有的 `get` 方法是通用的，详情请参阅 [参考说明](/manual/api/reference_commentary#通用get方法参数) 。| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |imageids|string/array|Return only images with the given IDs.| |sysmapids|string/array|Return images that are used on the given maps.| |select\_image|flag|Return an `image` property with the Base64 encoded image.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `imageid` and `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	### 参数  `(object)` 定义目标输出参数。  此方法支持以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |imageids|string/array|仅返回指定 ID 的图像。| |sysmapids|string/array|返回使用指定映射的图像。| |select\_image|flag|返回 `image` 属性，其中包含 Base64 类型编码图像。| |sortfield|string/array|按照给定的属性对结果进行排序。<br><br>可用类型：`imageid` 和 `name`。 | |countOutput|boolean|这些参数对所有的 `get` 方法是通用的，详情请参阅 [参考说明](/manual/api/reference_commentary#通用get方法参数) 。| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |itemids|string/array|Return only trends with the given item IDs.| |time\_from|timestamp|Return only values that have been collected after or at the given time.| |time\_till|timestamp|Return only values that have been collected before or at the given time.| |countOutput|boolean|Count the number of retrieved objects.| |limit|integer|Limit the amount of retrieved objects.| |output|query|Set fields to output.|
zh-cn	### 参数  `(object)` 定义期望输出的参数.  该方法支持以下参数.  | 参数        | [类型](/manual/api/reference_commentary#data_types) | 描述                                      | | ----------- | --------------------------------------------------- | ----------------------------------------- | | itemids     | string/array                                        | 仅返回指定监控项ID的趋势.                 | | time\_from  | timestamp                                           | 仅返回在给定时间之后或在给定时间收集的值. | | time\_till  | timestamp                                           | 仅返回在给定时间之前或在给定时间收集的值. | | countOutput | boolean                                             | 统计检索到的对象的数量.                   | | limit       | integer                                             | 限制检索对象的数量.                       | | output      | query                                               | 设置要输出的字段.                         |

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |itemids|string/array|Return only trends with the given item IDs.| |time\_from|timestamp|Return only values that have been collected after or at the given time.| |time\_till|timestamp|Return only values that have been collected before or at the given time.| |countOutput|boolean|Count the number of retrieved objects.| |limit|integer|Limit the amount of retrieved objects.| |output|query|Set fields to output.|
zh-cn	### 参数  `(object)` 定义期望输出的参数.  该方法支持以下参数.  | 参数        | [类型](/manual/api/reference_commentary#data_types) | 描述                                      | | ----------- | --------------------------------------------------- | ----------------------------------------- | | itemids     | string/array                                        | 仅返回指定监控项ID的趋势.                 | | time\_from  | timestamp                                           | 仅返回在给定时间之后或在给定时间收集的值. | | time\_till  | timestamp                                           | 仅返回在给定时间之前或在给定时间收集的值. | | countOutput | boolean                                             | 统计检索到的对象的数量.                   | | limit       | integer                                             | 限制检索对象的数量.                       | | output      | query                                               | 设置要输出的字段.                         |

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |mediaids|string/array|Return only users that use the given media.| |mediatypeids|string/array|Return only users that use the given media types.| |userids|string/array|Return only users with the given IDs.| |usrgrpids|string/array|Return only users that belong to the given user groups.| |getAccess|flag|Adds additional information about user permissions.<br><br>Adds the following properties for each user:<br>`gui_access` - *(integer)* user's frontend authentication method. Refer to the `gui_access` property of the [user group object](/manual/api/reference/usergroup/object#user_group) for a list of possible values.<br>`debug_mode` - *(integer)* indicates whether debug is enabled for the user. Possible values: 0 - debug disabled, 1 - debug enabled.<br>`users_status` - *(integer)* indicates whether the user is disabled. Possible values: 0 - user enabled, 1 - user disabled.| |selectMedias|query|Return media used by the user in the [medias](/manual/api/reference/user/object#media) property.| |selectMediatypes|query|Return media types used by the user in the [mediatypes](/manual/api/reference/mediatype/object) property.| |selectUsrgrps|query|Return user groups that the user belongs to in the [usrgrps](/manual/api/reference/usergroup/object) property.| |selectRole|query|Return user role in the [role](/manual/api/reference/role/object#role) property.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `userid` and `username`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	### 参数  `(object)` 定义需要输出的参数.  此方法支持如下参数.  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |mediaids|string/array|仅返回使用了给定媒介的用户.| |mediatypeids|string/array|仅返回使用了给定媒介类型的用户.| |userids|string/array|仅返回给定用户ID内的用户.| |usrgrpids|string/array|仅返回属于给定用户组的用户.| |getAccess|flag|添加关于用户权限附加信息.<br><br>为每个用户添加以下属性:<br>`gui_access` - *(integer)* 用户的前端认证方法. 参考 `gui_access` 的属性关于 [用户组对象](/manual/api/reference/usergroup/object#user_group) 可接受的值列表.<br>`debug_mode` - *(integer)* 表明是否为用户启用了调试功能. 可用值: 0 - 禁用调试模式, 1 - 启用调试模式.<br>`users_status` - *(integer)* 表明用户是否禁用. 可用值: 0 - 启用用户, 1 - 禁用用户.| |selectMedias|query|在 [媒介](/manual/api/reference/user/object#media) 属性中返回用户使用的媒介.| |selectMediatypes|query|在 [媒介类型](/manual/api/reference/mediatype/object) 属性中返回用户使用的媒介类型.| |selectUsrgrps|query|在 [用户组](/manual/api/reference/usergroup/object) 属性中返回用户所归属的组.| |selectRole|query|在 [角色](/manual/api/reference/role/object#role) 属性中返回用户的角色.| |sortfield|string/array|根据给定的属性对结果进行排序.<br><br>可用值: `userid` 和 `username`.| |countOutput|boolean|这些参数对于所有的 `get` 方法是常见的,在 [参考说明](/manual/api/reference_commentary#common_get_method_parameters)中有详细描述.| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |mediaids|string/array|Return only users that use the given media.| |mediatypeids|string/array|Return only users that use the given media types.| |userids|string/array|Return only users with the given IDs.| |usrgrpids|string/array|Return only users that belong to the given user groups.| |getAccess|flag|Adds additional information about user permissions.<br><br>Adds the following properties for each user:<br>`gui_access` - *(integer)* user's frontend authentication method. Refer to the `gui_access` property of the [user group object](/manual/api/reference/usergroup/object#user_group) for a list of possible values.<br>`debug_mode` - *(integer)* indicates whether debug is enabled for the user. Possible values: 0 - debug disabled, 1 - debug enabled.<br>`users_status` - *(integer)* indicates whether the user is disabled. Possible values: 0 - user enabled, 1 - user disabled.| |selectMedias|query|Return media used by the user in the [medias](/manual/api/reference/user/object#media) property.| |selectMediatypes|query|Return media types used by the user in the [mediatypes](/manual/api/reference/mediatype/object) property.| |selectUsrgrps|query|Return user groups that the user belongs to in the [usrgrps](/manual/api/reference/usergroup/object) property.| |selectRole|query|Return user role in the [role](/manual/api/reference/role/object#role) property.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `userid` and `username`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	### 参数  `(object)` 定义需要输出的参数.  此方法支持如下参数.  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |mediaids|string/array|仅返回使用了给定媒介的用户.| |mediatypeids|string/array|仅返回使用了给定媒介类型的用户.| |userids|string/array|仅返回给定用户ID内的用户.| |usrgrpids|string/array|仅返回属于给定用户组的用户.| |getAccess|flag|添加关于用户权限附加信息.<br><br>为每个用户添加以下属性:<br>`gui_access` - *(integer)* 用户的前端认证方法. 参考 `gui_access` 的属性关于 [用户组对象](/manual/api/reference/usergroup/object#user_group) 可接受的值列表.<br>`debug_mode` - *(integer)* 表明是否为用户启用了调试功能. 可用值: 0 - 禁用调试模式, 1 - 启用调试模式.<br>`users_status` - *(integer)* 表明用户是否禁用. 可用值: 0 - 启用用户, 1 - 禁用用户.| |selectMedias|query|在 [媒介](/manual/api/reference/user/object#media) 属性中返回用户使用的媒介.| |selectMediatypes|query|在 [媒介类型](/manual/api/reference/mediatype/object) 属性中返回用户使用的媒介类型.| |selectUsrgrps|query|在 [用户组](/manual/api/reference/usergroup/object) 属性中返回用户所归属的组.| |selectRole|query|在 [角色](/manual/api/reference/role/object#role) 属性中返回用户的角色.| |sortfield|string/array|根据给定的属性对结果进行排序.<br><br>可用值: `userid` 和 `username`.| |countOutput|boolean|这些参数对于所有的 `get` 方法是常见的,在 [参考说明](/manual/api/reference_commentary#common_get_method_parameters)中有详细描述.| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |mediatypeids|string/array|Return only media types with the given IDs.| |mediaids|string/array|Return only media types used by the given media.| |userids|string/array|Return only media types used by the given users.| |selectMessageTemplates|query|Return a [message\_templates](/manual/api/reference/mediatype/object#Message_template) property with an array of media type messages.| |selectUsers|query|Return a [users](//manual/api/reference/user/object) property with the users that use the media type.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `mediatypeid`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	### 参数  `(object)` 参数定义了所需的输出。  此方法支持以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |mediatypeids|string/array|只返回带有给定ID列表的媒介类型。| |mediaids|string/array|仅返回给定媒介使用的媒介类型。| |userids|string/array|仅返回给定用户使用的媒介类型。| |selectMessageTemplates|query|返回一个包含[消息模板](/manual/api/reference/mediatype/object#消息模板)消息数组的属性。| |selectUsers|query|返回使用媒介类型的[用户](//manual/api/reference/user/object)属性。| |sortfield|string/array|按给定属性对结果进行排序。<br><br>可用值：`mediatypeid`。| |countOutput|boolean|这些参数对所有的 `get` 方法是通用的，详情请参阅 [参考说明](/manual/api/reference_commentary#通用get方法参数) 。| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |mediatypeids|string/array|Return only media types with the given IDs.| |mediaids|string/array|Return only media types used by the given media.| |userids|string/array|Return only media types used by the given users.| |selectMessageTemplates|query|Return a [message\_templates](/manual/api/reference/mediatype/object#Message_template) property with an array of media type messages.| |selectUsers|query|Return a [users](//manual/api/reference/user/object) property with the users that use the media type.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `mediatypeid`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	### 参数  `(object)` 参数定义了所需的输出。  此方法支持以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |mediatypeids|string/array|只返回带有给定ID列表的媒介类型。| |mediaids|string/array|仅返回给定媒介使用的媒介类型。| |userids|string/array|仅返回给定用户使用的媒介类型。| |selectMessageTemplates|query|返回一个包含[消息模板](/manual/api/reference/mediatype/object#消息模板)消息数组的属性。| |selectUsers|query|返回使用媒介类型的[用户](//manual/api/reference/user/object)属性。| |sortfield|string/array|按给定属性对结果进行排序。<br><br>可用值：`mediatypeid`。| |countOutput|boolean|这些参数对所有的 `get` 方法是通用的，详情请参阅 [参考说明](/manual/api/reference_commentary#通用get方法参数) 。| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |proxyids|string/array|Return only proxies with the given IDs.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with the hosts monitored by the proxy.| |selectInterface|query|Return an [interface](/manual/api/reference/proxy/object#proxy_interface) property with the proxy interface used by a passive proxy.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `hostid`, `host` and `status`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	### 参数  `(object)` 定义所需输出的参数。  此方法支持以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |proxyids|string/array|仅返回具有给定 ID 的proxy。| |selectHosts|query|返回一个[主机](/manual/api/reference/host/object)属性，其中包含proxy监控的主机。| |selectInterface|query|返回一个[接口](/manual/api/reference/proxy/object#proxy_interface)属性， 其中包含被 被动proxy使用的proxy接口。| |sortfield|string/array|按照给定的属性对结果进行排序。<br><br>可用值：`hostid`，`host` 和 `status`。| |countOutput|boolean|这些参数对所有`get`方法是通用的，详细描述请查看[参考说明](/manual/api/reference_commentary#通用get方法参数)。| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |proxyids|string/array|Return only proxies with the given IDs.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with the hosts monitored by the proxy.| |selectInterface|query|Return an [interface](/manual/api/reference/proxy/object#proxy_interface) property with the proxy interface used by a passive proxy.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `hostid`, `host` and `status`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	### 参数  `(object)` 定义所需输出的参数。  此方法支持以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |proxyids|string/array|仅返回具有给定 ID 的proxy。| |selectHosts|query|返回一个[主机](/manual/api/reference/host/object)属性，其中包含proxy监控的主机。| |selectInterface|query|返回一个[接口](/manual/api/reference/proxy/object#proxy_interface)属性， 其中包含被 被动proxy使用的proxy接口。| |sortfield|string/array|按照给定的属性对结果进行排序。<br><br>可用值：`hostid`，`host` 和 `status`。| |countOutput|boolean|这些参数对所有`get`方法是通用的，详细描述请查看[参考说明](/manual/api/reference_commentary#通用get方法参数)。| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |reportids|string/array|Return only scheduled reports with the given report IDs.| |expired|boolean|If set to `true` returns only expired scheduled reports, if `false` - only active scheduled reports.| |selectUsers|query|Return a [users](/manual/api/reference/user/object) property the report is configured to be sent to.| |selectUserGroups|query|Return a [user\_groups](/manual/api/reference/user/object) property the report is configured to be sent to.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `reportid`, `name`, `status`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	### 参数  `(object)` 定义了需求输出的参数。  该方法支持如下参数。  |参数|[类型](zh/manual/api/reference_commentary#data_types)|说明| |---------|---------------------------------------------------|-----------| |reportids|字符串/数组|根据设定的ID号返回对应定时报表。| |expired|布尔值|若设定为`true`则只返回失效的定时报表，若设定为`false`，则只返回有效的定时报表。| |selectUsers|搜索请求|返回报告所设定的发送目标的[用户](zh/manual/api/reference/user/object)属性。| |selectUserGroups|搜索请求|返回报告所定的发送目标的[用户组](zh/manual/api/reference/user/object) 属性。| |sortfield|字符串/数组|设定属性参数用来分类返回数据。<br><br>可设定的参数包括：`reportid`, `name`, `status`.| |countOutput|布尔值|该类参数在所有的`get`方法中应用广泛，用户可以参考[引用评论](zh/manual/api/reference_commentary#common_get_method_parameters) 页面来获取更多详细信息。| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |reportids|string/array|Return only scheduled reports with the given report IDs.| |expired|boolean|If set to `true` returns only expired scheduled reports, if `false` - only active scheduled reports.| |selectUsers|query|Return a [users](/manual/api/reference/user/object) property the report is configured to be sent to.| |selectUserGroups|query|Return a [user\_groups](/manual/api/reference/user/object) property the report is configured to be sent to.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `reportid`, `name`, `status`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	### 参数  `(object)` 定义了需求输出的参数。  该方法支持如下参数。  |参数|[类型](zh/manual/api/reference_commentary#data_types)|说明| |---------|---------------------------------------------------|-----------| |reportids|字符串/数组|根据设定的ID号返回对应定时报表。| |expired|布尔值|若设定为`true`则只返回失效的定时报表，若设定为`false`，则只返回有效的定时报表。| |selectUsers|搜索请求|返回报告所设定的发送目标的[用户](zh/manual/api/reference/user/object)属性。| |selectUserGroups|搜索请求|返回报告所定的发送目标的[用户组](zh/manual/api/reference/user/object) 属性。| |sortfield|字符串/数组|设定属性参数用来分类返回数据。<br><br>可设定的参数包括：`reportid`, `name`, `status`.| |countOutput|布尔值|该类参数在所有的`get`方法中应用广泛，用户可以参考[引用评论](zh/manual/api/reference_commentary#common_get_method_parameters) 页面来获取更多详细信息。| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |roleids|string/array|Return only roles with the given IDs.| |selectRules|query|Return role rules in the [rules](/manual/api/reference/role/object#role_rules) property.| |selectUsers|query|Select [users](/manual/api/reference/user/object) this role is assigned to.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `roleid`, `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	### 参数  `(object)` 该参数表明了用户想得到的数据结果。  该方法支持以下参数。  |参数|[类型](zh/manual/api/reference_commentary#data_types)|说明| |---------|---------------------------------------------------|-----------| |roleids|字符串/数组|根据提供的ID号返回角色用户。| |selectRules|询问|根据[角色用户](zh/manual/api/reference/role/object#role_rules) 属性返回角色规则。| |selectUsers|询问|选择分配给该角色的[用户](zh/manual/api/reference/user/object)。| |sortfield|字符串/数组|根据用户罗列的属性对反馈结果进行分类。<br><br>可配置的参数包括：`roleid`， `name`。| |countOutput|布尔值|该参数在`get`方式中应用广泛，具体内容可参考[评论引用](/manual/api/reference_commentary#common_get_method_parameters)页面。| |editable|布尔值|^| |excludeSearch|布尔值|^| |filter|对象|^| |limit|整数|^| |output|询问|^| |preservekeys|布尔值|^| |search|对象|^| |searchByAny|布尔值|^| |searchWildcardsEnabled|布尔值|^| |sortorder|字符串/数组|^| |startSearch|布尔值|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |roleids|string/array|Return only roles with the given IDs.| |selectRules|query|Return role rules in the [rules](/manual/api/reference/role/object#role_rules) property.| |selectUsers|query|Select [users](/manual/api/reference/user/object) this role is assigned to.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `roleid`, `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	### 参数  `(object)` 该参数表明了用户想得到的数据结果。  该方法支持以下参数。  |参数|[类型](zh/manual/api/reference_commentary#data_types)|说明| |---------|---------------------------------------------------|-----------| |roleids|字符串/数组|根据提供的ID号返回角色用户。| |selectRules|询问|根据[角色用户](zh/manual/api/reference/role/object#role_rules) 属性返回角色规则。| |selectUsers|询问|选择分配给该角色的[用户](zh/manual/api/reference/user/object)。| |sortfield|字符串/数组|根据用户罗列的属性对反馈结果进行分类。<br><br>可配置的参数包括：`roleid`， `name`。| |countOutput|布尔值|该参数在`get`方式中应用广泛，具体内容可参考[评论引用](/manual/api/reference_commentary#common_get_method_parameters)页面。| |editable|布尔值|^| |excludeSearch|布尔值|^| |filter|对象|^| |limit|整数|^| |output|询问|^| |preservekeys|布尔值|^| |search|对象|^| |searchByAny|布尔值|^| |searchWildcardsEnabled|布尔值|^| |sortorder|字符串/数组|^| |startSearch|布尔值|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |serviceids|string/array|Return only services with the given IDs.| |parentids|string/array|Return only services that are linked to the given parent services.| |deep\_parentids|flag|Return all direct and indirect child services. Used together with `parentids`.| |childids|string/array|Return only services that are linked to the given child services.| |evaltype|integer|Rules for tag searching.<br><br>Possible values:<br>0 - *(default)* And/Or;<br>2 - Or.| |tags|object/array of objects|Return only services with given tags. Exact match by tag and case-sensitive or case-insensitive search by tag value depending on operator value.<br>Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>An empty array returns all services.<br><br>Possible operator values:<br>0 - *(default)* Contains;<br>1 - Equals;<br>2 - Does not contain;<br>3 - Does not equal;<br>4 - Exists;<br>5 - Does not exist.| |problem\_tags|object/array of objects|Return only services with given problem tags. Exact match by tag and case-sensitive or case-insensitive search by tag value depending on operator value.<br>Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>An empty array returns all services.<br><br>Possible operator values:<br>0 - *(default)* Contains;<br>1 - Equals;<br>2 - Does not contain;<br>3 - Does not equal;<br>4 - Exists;<br>5 - Does not exist.| |without\_problem\_tags|flag|Return only services without problem tags.| |selectAlarms|query|Return an [alarms](/manual/api/reference/service/object#service_alarm) property with service alarms.<br><br>Supports `count`.| |selectChildren|query|Return a `children` property with the child services.<br><br>Supports `count`.| |selectParents|query|Return a `parents` property with the parent services.<br><br>Supports `count`.| |selectTags|query|Return a [tags](/manual/api/reference/service/object#service_tag) property with service tags.<br><br>Supports `count`.| |selectTimes|query|Return a [times](/manual/api/reference/service/object#service_time) property with service times.<br><br>Supports `count`.| |selectProblemEvents|query|Return a `problem_events` property with an array of problem event objects.<br><br>The problem event object has the following properties:<br>`eventid` - *(string)* Event ID;<br>`severity` - *(string)* Current event severity;<br>`name` - *(string)* Resolved event name.<br><br>Supports `count`.| |selectProblemTags|query|Return a [problem\_tags](/manual/api/reference/service/object#problem_tag) property with problem tags.<br><br>Supports `count`.| |selectStatusRules|query|Return a [status\_rules](/manual/api/reference/service/object#status_rule) property with status rules.<br><br>Supports `count`.|  |   |   |   | |---|---|---| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `name` and `sortorder`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|  
zh-cn	### Parameters 参数  `(object)` Parameters defining the desired output. `(object)`定义所需输出的参数。  The method supports the following parameters. 该方法支持以下参数。  |Parameter 参数             T|pe 类型                  Des|ription 说明| |------------------------------|------------------------------|--------------| |serviceids|string/array 字符串/数组   Retu|n only services with the given IDs. 仅返回拥有指定ID的服务。| |parentids|string/array 字符串/数组   Retu|n only services with the given hard-dependent parent services. 仅返回拥有指定硬依赖父服务的服务。| |childids|string/array 字符串/数组   Retu|n only services that are hard-dependent on the given child services. 仅返回在指定子服务上有硬依赖的服务。| |selectParent|query 查询                 R|turn the hard-dependent parent service in the `parent` property. 返回`parent`属性中的硬依赖父服务。| |selectDependencies|query 查询                 R|turn child service dependencies in the `dependencies` property. 返回在`dependencies`属性中有依赖的子服务。| |selectParentDependencies|query 查询                 R|turn parent service dependencies in the `parentDependencies` property. 返回在`parentDependencies`属性中有依赖的父服务。| |selectTimes|query 查询                 R|turn service times in the `times` property. 返回在`times`属性中的服务时间。| |selectAlarms|query 查询                 R|turn service alarms in the `alarms` property. 返回在`alarms`属性中的服务告警。| |selectTrigger|query 查询                 R|turn the associated trigger in the `trigger` property. 返回在`trigger`属性中的关联触发器。| |sortfield|string/array 字符串/数组   Sort|the result by the given properties. 按指定的属性对结果分类。<br><br>Possible values are: `name` and `sortorder`. 许可值是：`name`和`sortorder`。| |countOutput|boolean 布尔值             Th|se parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters). 这些参数非常普遍，适用于所有`get`方法，具体描述详见于[reference commentary](/zh/manual/api/reference_commentary#common_get_method_parameters)。| |editable|boolean 布尔值             ::|<| |excludeSearch|boolean 布尔值             ::|<| |filter|object 对象                :|:| |limit|integer 整数型             ::|<| |output|query 查询                 :|:| |preservekeys|boolean 布尔值             ::|<| |search|object 对象                :|:| |searchByAny|boolean 布尔值             ::|<| |searchWildcardsEnabled|boolean 布尔值             ::|<| |sortorder|string/array 字符串/数组   :::|<| |startSearch|boolean 布尔值             ::|<|  

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  | Parameter               | [Type](/manual/api/reference_commentary#data_types) | Description                                                                                                                                                               | |-------------------------|-----------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | slaids                  | string/array                                        | Return only SLAs with the given IDs.                                                                                                                                      | | serviceids              | string/array                                        | Return only SLAs matching the specific services.                                                                                                                          | | selectSchedule          | query                                               | Return a `schedule` property with SLA schedules.<br><br>Supports `count`.                                                                                                 | | selectExcludedDowntimes | query                                               | Return an `excluded_downtimes` property with SLA excluded downtimes.<br><br>Supports `count`.                                                                             | | selectServiceTags       | query                                               | Return a `service_tags` property with SLA service tags.<br><br>Supports `count`.                                                                                          | | sortfield               | string/array                                        | Sort the result by the given properties.<br><br>Possible values are: `slaid`, `name`, `period`, `slo`, `effective_date`, `timezone`, `status` and `description`.          | | countOutput             | boolean                                             | These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters). | | editable                | boolean                                             | ^                                                                                                                                                                         | | excludeSearch           | boolean                                             | ^                                                                                                                                                                         | | filter                  | object                                              | ^                                                                                                                                                                         | | limit                   | integer                                             | ^                                                                                                                                                                         | | output                  | query                                               | ^                                                                                                                                                                         | | preservekeys            | boolean                                             | ^                                                                                                                                                                         | | search                  | object                                              | ^                                                                                                                                                                         | | searchByAny             | boolean                                             | ^                                                                                                                                                                         | | searchWildcardsEnabled  | boolean                                             | ^                                                                                                                                                                         | | sortorder               | string/array                                        | ^                                                                                                                                                                         | | startSearch             | boolean                                             | ^                                                                                                                                                                         |
zh-cn	### 参数  `(object)` 定义所需输出的参数。  该方法支持以下参数。  | 参数 | [类型](/manual/api/reference_commentary#data_types) | 描述 | |-----|-----|----| | slaids | 字符串/数组 | 仅返回具有给定 ID 的 SLA。 | | serviceids | 字符串/数组 | 仅返回与特定服务匹配的 SLA。 | | selectSchedule | 查询 | 返回带有 SLA 计划的“计划”属性。<br><br>支持“计数”。 | | selectExcludedDowntimes| 查询 | 返回包含 SLA 排除的停机时间的 `excluded_downtimes` 属性。<br><br>支持 `计数`。 | | selectServiceTags | 查询 | 返回带有 SLA 服务标签的 `service_tags` 属性。<br><br>支持 `计数`。 | | sortfield | 字符串/数组 | 按给定属性对结果进行排序。<br><br>可能的值为：`slaid`、`name`、`period`、`slo`、`effective_date`、`timezone`、`status` 和 `description`。 | | countOutput | 布尔 | [参考注释](/manual/api/reference_commentary#common_get_method_parameters) 中详细描述了所有“get”方法通用的这些参数。 | | editable | 布尔 | ^ | | excludeSearch | 布尔 | ^ | | filter | 对象 | ^ | | limit | 整数 | ^ | | output | 查询 | ^ | | preservekeys | 布尔 | ^ | | search | 对象 | ^ | | searchByAny | 布尔 | ^ | | searchWildcardsEnabled | 布尔 | ^ | | sortorder | 字符串/数组 | ^ | | startSearch | 布尔 | ^ |

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |status|integer|Return only user groups with the given status.<br><br>Refer to the [user group page](object#user_group) for a list of supported statuses.| |userids|string/array|Return only user groups that contain the given users.| |usrgrpids|string/array|Return only user groups with the given IDs.| |selectTagFilters|query|Return user group tag based permissions in the [tag\_filters](/manual/api/reference/usergroup/object#tag_based_permission) property.<br><br>It has the following properties:<br>`groupid` - (string) ID of the host group;<br>`tag` - (string) tag name;<br>`value` - (string) tag value.| |selectUsers|query|Return the users from the user group in the [users](/manual/api/reference/user/object#user) property.| |selectRights|query|Return user group rights in the [rights](/manual/api/reference/usergroup/object#permission) property.<br><br>It has the following properties:<br>`permission` - (integer) access level to the host group;<br>`id` - (string) ID of the host group.<br><br>Refer to the [user group page](object#permission) for a list of access levels to host groups.| |limitSelects|integer|Limits the number of records returned by subselects.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `usrgrpid`, `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	### 参数  `(object)` 定义所需输出的参数.  该方法支持以下参数.  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |status|integer|只返回具有给定状态的用户组.<br><br>参阅 [用户组页面](object#user_group) 获取支持的状态列表.| |userids|string/array|只返回包含给定用户的用户组.| |usrgrpids|string/array|只返回具有给定ID的用户组.| |selectTagFilters|query|在 [标签权限](/manual/api/reference/usergroup/object#tag_based_permission) 属性中返回用户标签权限.<br><br>它具有以下属性:<br>`groupid` - (string) 主机组ID;<br>`tag` - (string) 标签名;<br>`value` - (string) 标签值.| |selectUsers|query|在 [用户](/manual/api/reference/user/object#user) 属性中返回用户组中的用户.| |selectRights|query|在 [权限](/manual/api/reference/usergroup/object#permission) 属性中返回用户组权限.<br><br>它具有以下属性:<br>`permission` - (integer) 访问级别到主机组;<br>`id` - (string) 主机组的ID.<br><br>参阅 [用户组页面](object#permission) 获取主机组的访问级别列表.| |limitSelects|integer|限制子选择返回的记录数.| |sortfield|string/array|按照给定的属性对结果进行排序.<br><br>可接受的值: `usrgrpid`, `name`.| |countOutput|boolean|`get` 方法的常用参数都被记录在 [参考说明](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |status|integer|Return only user groups with the given status.<br><br>Refer to the [user group page](object#user_group) for a list of supported statuses.| |userids|string/array|Return only user groups that contain the given users.| |usrgrpids|string/array|Return only user groups with the given IDs.| |selectTagFilters|query|Return user group tag based permissions in the [tag\_filters](/manual/api/reference/usergroup/object#tag_based_permission) property.<br><br>It has the following properties:<br>`groupid` - (string) ID of the host group;<br>`tag` - (string) tag name;<br>`value` - (string) tag value.| |selectUsers|query|Return the users from the user group in the [users](/manual/api/reference/user/object#user) property.| |selectRights|query|Return user group rights in the [rights](/manual/api/reference/usergroup/object#permission) property.<br><br>It has the following properties:<br>`permission` - (integer) access level to the host group;<br>`id` - (string) ID of the host group.<br><br>Refer to the [user group page](object#permission) for a list of access levels to host groups.| |limitSelects|integer|Limits the number of records returned by subselects.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `usrgrpid`, `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	### 参数  `(object)` 定义所需输出的参数.  该方法支持以下参数.  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |status|integer|只返回具有给定状态的用户组.<br><br>参阅 [用户组页面](object#user_group) 获取支持的状态列表.| |userids|string/array|只返回包含给定用户的用户组.| |usrgrpids|string/array|只返回具有给定ID的用户组.| |selectTagFilters|query|在 [标签权限](/manual/api/reference/usergroup/object#tag_based_permission) 属性中返回用户标签权限.<br><br>它具有以下属性:<br>`groupid` - (string) 主机组ID;<br>`tag` - (string) 标签名;<br>`value` - (string) 标签值.| |selectUsers|query|在 [用户](/manual/api/reference/user/object#user) 属性中返回用户组中的用户.| |selectRights|query|在 [权限](/manual/api/reference/usergroup/object#permission) 属性中返回用户组权限.<br><br>它具有以下属性:<br>`permission` - (integer) 访问级别到主机组;<br>`id` - (string) 主机组的ID.<br><br>参阅 [用户组页面](object#permission) 获取主机组的访问级别列表.| |limitSelects|integer|限制子选择返回的记录数.| |sortfield|string/array|按照给定的属性对结果进行排序.<br><br>可接受的值: `usrgrpid`, `name`.| |countOutput|boolean|`get` 方法的常用参数都被记录在 [参考说明](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |sysmapids|string/array|Returns only maps with the given IDs.| |userids|string/array|Returns only maps that belong to the given user IDs.| |expandUrls|flag|Adds global map URLs to the corresponding map elements and expands macros in all map element URLs.| |selectIconMap|query|Returns an [iconmap](/manual/api/reference/iconmap/object) property with the icon map used on the map.| |selectLinks|query|Returns a [links](/manual/api/reference/map/object#Map_link) property with the map links between elements.| |selectSelements|query|Returns a [selements](/manual/api/reference/map/object#map_element) property with the map elements.| |selectUrls|query|Returns a [urls](/manual/api/reference/map/object#Map_URL) property with the map URLs.| |selectUsers|query|Returns a [users](/manual/api/reference/map/object#Map_user) property with users that the map is shared with.| |selectUserGroups|query|Returns a [userGroups](/manual/api/reference/map/object#Map_user_group) property with user groups that the map is shared with.| |selectShapes|query|Returns a [shapes](/manual/api/reference/map/object#Map_shapes) property with the map shapes.| |selectLines|query|Returns a [lines](/manual/api/reference/map/object#Map_lines) property with the map lines.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `name`, `width` and `height`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	### 参数  `(object)` 定义所需输出的参数。  该方法支持以下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|说明| |---------|---------------------------------------------------|-----------| |sysmapids|string/array|只返回给定 ID 的拓扑图。| |userids|string/array|只返回属于给定用户 ID 的拓扑图。| |expandUrls|flag|将全局地图 URL 添加到相应的地图元素，并在所有地图元素 URL 中展开宏。| |selectIconMap|query|返回一个 [iconmap](/manual/api/reference/iconmap/object) 属性以及地图上使用的图标地图。| |selectLinks|query|返回一个 [links](/manual/api/reference/map/object#Map_link) 属性，其中包含元素之间的地图链接。| |selectSelements|query|返回带有地图元素的 [selements](/manual/api/reference/map/object#map_element) 属性。| |selectUrls|query|返回带有地图 URL 的 [urls](/manual/api/reference/map/object#Map_URL) 属性。| |selectUsers|query|返回一个 [users](/manual/api/reference/map/object#Map_user) 属性，其中包含与地图共享的用户。| |selectUserGroups|query|返回一个 [userGroups](/manual/api/reference/map/object#Map_user_group) 属性，其中包含与地图共享的用户组。| |selectShapes|query|返回带有地图形状的 [shapes](/manual/api/reference/map/object#Map_shapes) 属性。| |selectLines|query|返回带有地图线的 [lines](/manual/api/reference/map/object#Map_lines) 属性。| |sortfield|string/array|按给定属性对结果进行排序。<br><br>可用值：`name`、`width` 和 `height`。| |countOutput|boolean|这些参数对所有 `get` 方法都是通用的，在 [参考评论](/manual/api/reference_commentary#common_get_method_parameters) 中有详细描述。| |可编辑|boolean|^| |排除搜索|boolean|^| |过滤器|object|^| |限制|integer|^| |输出|query|^| |preservekeys|boolean|^| |搜索|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |排序|string/array|^| |开始搜索|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |sysmapids|string/array|Returns only maps with the given IDs.| |userids|string/array|Returns only maps that belong to the given user IDs.| |expandUrls|flag|Adds global map URLs to the corresponding map elements and expands macros in all map element URLs.| |selectIconMap|query|Returns an [iconmap](/manual/api/reference/iconmap/object) property with the icon map used on the map.| |selectLinks|query|Returns a [links](/manual/api/reference/map/object#Map_link) property with the map links between elements.| |selectSelements|query|Returns a [selements](/manual/api/reference/map/object#map_element) property with the map elements.| |selectUrls|query|Returns a [urls](/manual/api/reference/map/object#Map_URL) property with the map URLs.| |selectUsers|query|Returns a [users](/manual/api/reference/map/object#Map_user) property with users that the map is shared with.| |selectUserGroups|query|Returns a [userGroups](/manual/api/reference/map/object#Map_user_group) property with user groups that the map is shared with.| |selectShapes|query|Returns a [shapes](/manual/api/reference/map/object#Map_shapes) property with the map shapes.| |selectLines|query|Returns a [lines](/manual/api/reference/map/object#Map_lines) property with the map lines.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `name`, `width` and `height`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	### 参数  `(object)` 定义所需输出的参数。  该方法支持以下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|说明| |---------|---------------------------------------------------|-----------| |sysmapids|string/array|只返回给定 ID 的拓扑图。| |userids|string/array|只返回属于给定用户 ID 的拓扑图。| |expandUrls|flag|将全局地图 URL 添加到相应的地图元素，并在所有地图元素 URL 中展开宏。| |selectIconMap|query|返回一个 [iconmap](/manual/api/reference/iconmap/object) 属性以及地图上使用的图标地图。| |selectLinks|query|返回一个 [links](/manual/api/reference/map/object#Map_link) 属性，其中包含元素之间的地图链接。| |selectSelements|query|返回带有地图元素的 [selements](/manual/api/reference/map/object#map_element) 属性。| |selectUrls|query|返回带有地图 URL 的 [urls](/manual/api/reference/map/object#Map_URL) 属性。| |selectUsers|query|返回一个 [users](/manual/api/reference/map/object#Map_user) 属性，其中包含与地图共享的用户。| |selectUserGroups|query|返回一个 [userGroups](/manual/api/reference/map/object#Map_user_group) 属性，其中包含与地图共享的用户组。| |selectShapes|query|返回带有地图形状的 [shapes](/manual/api/reference/map/object#Map_shapes) 属性。| |selectLines|query|返回带有地图线的 [lines](/manual/api/reference/map/object#Map_lines) 属性。| |sortfield|string/array|按给定属性对结果进行排序。<br><br>可用值：`name`、`width` 和 `height`。| |countOutput|boolean|这些参数对所有 `get` 方法都是通用的，在 [参考评论](/manual/api/reference_commentary#common_get_method_parameters) 中有详细描述。| |可编辑|boolean|^| |排除搜索|boolean|^| |过滤器|object|^| |限制|integer|^| |输出|query|^| |preservekeys|boolean|^| |搜索|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |排序|string/array|^| |开始搜索|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |taskids|string/array|Return only tasks with the given IDs.| |output|query|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |preservekeys|boolean|^|
zh-cn	### 参数  `(object)` 定义所需输出的参数。  该方法支持以下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |taskids|string/array|仅返回具有给定ID的任务。| |output|query|这些参数对于所有`get`方法都是通用的，在[reference commentary](/manual/api/reference_commentary#common_get_method_parameters)中有详细描述。| |preservekeys|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |taskids|string/array|Return only tasks with the given IDs.| |output|query|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |preservekeys|boolean|^|
zh-cn	### 参数  `(object)` 定义所需输出的参数。  该方法支持以下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |taskids|string/array|仅返回具有给定ID的任务。| |output|query|这些参数对于所有`get`方法都是通用的，在[reference commentary](/manual/api/reference_commentary#common_get_method_parameters)中有详细描述。| |preservekeys|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |tokenids|string/array|Return only tokens with the given IDs.| |userids|string/array|Return only tokens created for the given users.| |token|string|Return only tokens created for the given *Auth token*.| |valid\_at|timestamp|Return only tokens which are valid (not expired) at the given date and time.| |expired\_at|timestamp|Return only tokens which are expired (not valid) at the given date and time.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `tokenid`, `name`, `lastaccess`, `status`, `expires_at` and `created_at`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	### 参数  `(object)` 定义期望输出的参数。  此方法支持以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |tokenids|string/array|仅返回给定ID的令牌。| |userids|string/array|仅返回为给定用户创建的令牌。| |token|string|仅返回为给定*身份验证令牌*创建的令牌。| |valid\_at|timestamp|仅返回在给定的日期和时间内是有效(未过期)的令牌。| |expired\_at|timestamp|仅返回在给定的日期和时间内是过期(无效)的令牌。| |sortfield|string/array|按给定的属性对结果进行排序。<br><br>可用值:`tokenid`，`name`，`lastaccess`，`status`，`expires_at`和`created_at`。| |countOutput|boolean|这些参数对所有的 `get` 方法是通用的，详情请参阅 [参考说明](/manual/api/reference_commentary#通用get方法参数) 。| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |valuemapids|string/array|Return only value maps with the given IDs.| |selectMappings|query|Return the value mappings for current value map in the [mappings](/manual/api/reference/valuemap/object#value_mappings) property.<br><br>Supports `count`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `valuemapid`, `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	 ### 参数  `(object)` 定义期望输出的参数。  此方法支持以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |valuemapids|string/array|仅返回给定ID的值映射。| |selectMappings|query|返回 [mappings](/manual/api/reference/valuemap/object#值映射关系) 属性中当前值映射的值映射关系。<br><br>支持`count`。| |sortfield|string/array|按照给定的属性对结果进行排序。<br><br>可用值： `valuemapid`，`name`。| |countOutput|boolean|这些参数对所有`get`方法是公共的，详细描述请参见[参考说明](/manual/api/reference_commentary#通用get方法参数) 。| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |valuemapids|string/array|Return only value maps with the given IDs.| |selectMappings|query|Return the value mappings for current value map in the [mappings](/manual/api/reference/valuemap/object#value_mappings) property.<br><br>Supports `count`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `valuemapid`, `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
zh-cn	 ### 参数  `(object)` 定义期望输出的参数。  此方法支持以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |valuemapids|string/array|仅返回给定ID的值映射。| |selectMappings|query|返回 [mappings](/manual/api/reference/valuemap/object#值映射关系) 属性中当前值映射的值映射关系。<br><br>支持`count`。| |sortfield|string/array|按照给定的属性对结果进行排序。<br><br>可用值： `valuemapid`，`name`。| |countOutput|boolean|这些参数对所有`get`方法是公共的，详细描述请参见[参考说明](/manual/api/reference_commentary#通用get方法参数) 。| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the LLD rules to copy and the target hosts.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |discoveryids|array|IDs of the LLD rules to be copied.| |hostids|array|IDs of the hosts to copy the LLD rules to.|
zh-cn	### 参数  `(object)` 定义要复制的 LLD 规则和目标主机的参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |discoveryids|array|要复制的 LLD 规则的 ID。| |hostids|array|将 LLD 规则复制到的主机的 ID。|

en-us	### Parameters  `(object)` Parameters defining the LLD rules to copy and the target hosts.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |discoveryids|array|IDs of the LLD rules to be copied.| |hostids|array|IDs of the hosts to copy the LLD rules to.|
zh-cn	### 参数  `(object)` 定义要复制的 LLD 规则和目标主机的参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |discoveryids|array|要复制的 LLD 规则的 ID。| |hostids|array|将 LLD 规则复制到的主机的 ID。|

en-us	### Parameters  `(object)` Parameters defining the objects to be exported and the format to use.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**format**<br>(required)|string|Format in which the data must be exported.<br><br>Possible values:<br>`yaml` - YAML;<br>`xml` - XML;<br>`json` - JSON;<br>`raw` - unprocessed PHP array.| |prettyprint|boolean|Make the output more human readable by adding indentation.<br><br>Possible values:<br>`true` - add indentation;<br>`false` - *(default)* do not add indentation.| |**options**<br>(required)|object|Objects to be exported.<br><br>The `options` object has the following parameters:<br>`groups` - `(array)` IDs of host groups to export;<br>`hosts` - `(array)` IDs of hosts to export;<br>`images` - `(array)` IDs of images to export;<br>`maps` - `(array)` IDs of maps to export;<br>`mediaTypes` - `(array)` IDs of media types to export;<br>`templates` - `(array)` IDs of templates to export.<br>|
zh-cn	### 参数  `(object)` 参数定义了导出的对象以及使用的格式。  |参数|[类型](/manual/api/reference_commentary#data_types)|说明| |---------|---------------------------------------------------|-----------| |**format**<br>(required)|string|导出数据的格式。<br><br>可用值为:<br>`yaml` - YAML;<br>`xml` - XML;<br>`json` - JSON;<br>`raw` - 未处理的PHP数组.| |prettyprint|boolean|通过添加缩进，使输出更具可读性。<br><br>可用值为:<br>`true` - 添加缩进;<br>`false` - *(default)* 不添加缩进.| |**options**<br>(required)|object|要导出的对象<br><br>要导出的`options`对象有以下参数：<br>`groups` - `(array)` 要导出的主机组ID;<br>`hosts` - `(array)` 要导出的主机ID;<br>`images` - `(array)` 要导出的图表ID;<br>`maps` - `(array)` 要导出的拓扑图ID;<br>`mediaTypes` - `(array)` 要导出的媒介类型ID;<br>`templates` - `(array)` 要导出的模板ID。<br>|

en-us	### Parameters  `(object)` Parameters defining the objects to be exported and the format to use.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**format**<br>(required)|string|Format in which the data must be exported.<br><br>Possible values:<br>`yaml` - YAML;<br>`xml` - XML;<br>`json` - JSON;<br>`raw` - unprocessed PHP array.| |prettyprint|boolean|Make the output more human readable by adding indentation.<br><br>Possible values:<br>`true` - add indentation;<br>`false` - *(default)* do not add indentation.| |**options**<br>(required)|object|Objects to be exported.<br><br>The `options` object has the following parameters:<br>`groups` - `(array)` IDs of host groups to export;<br>`hosts` - `(array)` IDs of hosts to export;<br>`images` - `(array)` IDs of images to export;<br>`maps` - `(array)` IDs of maps to export;<br>`mediaTypes` - `(array)` IDs of media types to export;<br>`templates` - `(array)` IDs of templates to export.<br>|
zh-cn	### 参数  `(object)` 参数定义了导出的对象以及使用的格式。  |参数|[类型](/manual/api/reference_commentary#data_types)|说明| |---------|---------------------------------------------------|-----------| |**format**<br>(required)|string|导出数据的格式。<br><br>可用值为:<br>`yaml` - YAML;<br>`xml` - XML;<br>`json` - JSON;<br>`raw` - 未处理的PHP数组.| |prettyprint|boolean|通过添加缩进，使输出更具可读性。<br><br>可用值为:<br>`true` - 添加缩进;<br>`false` - *(default)* 不添加缩进.| |**options**<br>(required)|object|要导出的对象<br><br>要导出的`options`对象有以下参数：<br>`groups` - `(array)` 要导出的主机组ID;<br>`hosts` - `(array)` 要导出的主机ID;<br>`images` - `(array)` 要导出的图表ID;<br>`maps` - `(array)` 要导出的拓扑图ID;<br>`mediaTypes` - `(array)` 要导出的媒介类型ID;<br>`templates` - `(array)` 要导出的模板ID。<br>|

en-us	### Parameters  `(object)` Settings properties to be updated.
zh-cn	 ### 参数  `(对象)` 设置待更新的属性。

en-us	#### Parameters  |Parameter|Description|Defaults|Example| |--|------|--|---| |*endpoint*|Protocol and address of the endpoint, defined as `protocol://connection_string`<br><br>Possible protocol values: *rtu*, *ascii* (Agent 2 only), *tcp*<br><br>Connection string format:<br><br>with *tcp* - `address:port`<br>with serial line: *rtu*, *ascii* - `port_name:speed:params`<br>where<br>'speed' - 1200, 9600 etc<br>'params' - data bits (5,6,7 or 8), parity (n,e or o for none/even/odd), stop bits (1 or 2)|protocol: none<br><br>*rtu/ascii* protocol:<br>port\_name: none<br>speed: 115200<br>params: 8n1<br><br>*tcp* protocol:<br>address: none<br>port: 502|tcp://192.168.6.1:511<br>tcp://192.168.6.2<br>tcp://\[::1\]:511<br>tcp://::1<br>tcp://localhost:511<br>tcp://localhost<br>rtu://COM1:9600:8n<br>ascii://COM2:1200:7o2<br>rtu://ttyS0:9600<br>ascii://ttyS1| |*slave id*|Modbus address of the device it is intended for (1 to 247), see [MODBUS Messaging Implementation Guide](https://modbus.org/docs/Modbus_Messaging_Implementation_Guide_V1_0b.pdf) (page 23)<br><br>tcp device (not GW) will ignore the field|serial: 1<br><br>tcp: 255 (0xFF)|2| |*function*|Empty or value of a supported function:<br><br>1 - Read Coil,<br>2 - Read Discrete Input,<br>3 - Read Holding Registers,<br>4 - Read Input Registers|empty|3| |*address*|Address of the first registry, coil or input.<br><br>If 'function' is empty, then 'address' should be in range for:<br>Coil - 00001 - 09999<br>Discrete input - 10001 - 19999<br>Input register - 30001 - 39999<br>Holding register - 40001 - 49999<br><br>If 'function' is not empty, the 'address' field will be from 0 till 65535 and used without modification (PDU)|empty function: 00001<br><br>non-empty function: 0|9999| |*count*|Count of sequenced 'type' which will be read from device, where:<br><br>for Coil or Discrete input the 'type' = 1 bit<br>for other cases: (count\*type)/2 = real count of registers for reading<br>If 'offset' is not 0, the value will be added to 'real count'<br>Acceptable range for 'real count' is 1:65535|1|2| |*type*|Data type:<br><br>for Read Coil and Read Discrete Input - *bit*<br><br>for Read Holding Registers and Read Input Registers:<br>*int8* - 8bit<br>*uint8* - 8bit (unsigned)<br>*int16* - 16bit<br>*uint16* - 16bit (unsigned)<br>*int32* - 32bit<br>*uint32* - 32bit (unsigned)<br>*float* - 32bit<br>*uint64* - 64bit (unsigned)<br>*double* - 64bit|bit<br>uint16|uint64| |*endianness*|Endianness type:<br>*be* - Big Endian<br>*le* - Little Endian<br>*mbe* - Mid-Big Endian<br>*mle* - Mid-Little Endian<br><br>Limitations:<br>for 1 bit - be<br>for 8 bits - be,le<br>for 16 bits - be,le|be|le| |*offset*|Number of registers, starting from 'address', the result of which will be discarded.<br><br>The size of each register is 16bit (needed to support equipment that does not support random read access).|0|4|
zh-cn	#### 参数  |参数|说明|默认值|示例| |--|------|--|---| |*endpoint*|端点的协议和地址，定义为 `protocol://connection_string`<br><br>可能的协议值：*rtu*、*ascii*（仅限 Agent 2）、*tcp*<br> <br>连接字符串格式：<br><br>with *tcp* - `address:port`<br>with serial line: *rtu*, *ascii* - `port_name:speed:params`<br>where< br>“速度”- 1200、9600 等<br>“参数”- 数据位（5、6、7 或 8）、奇偶校验（n、e 或 o 表示无/偶数/奇数）、停止位（1 或 2 )|协议：无<br><br>*rtu/ascii* 协议：<br>端口\_名称：无<br>速度：115200<br>参数：8n1<br><br>*tcp* 协议：< br>地址：无<br>端口：502|tcp://192.168.6.1:511<br>tcp://192.168.6.2<br>tcp://\[::1\]:511<br> tcp://::1<br>tcp://localhost:511<br>tcp://localhost<br>rtu://COM1:9600:8n<br>ascii://COM2:1200:7o2< br>rtu://ttyS0:9600<br>ascii://ttyS1| |*slave id*|设备的 Modbus 地址（1 到 247），参见 [MODBUS 消息传递实施指南](https://modbus.org/docs/Modbus_Messaging_Implementation_Guide_V1_0b.pdf)（第 23 页）<br> <br>tcp 设备（不是 GW）将忽略字段|serial: 1<br><br>tcp: 255 (0xFF)|2| |*function*|支持函数的空值或值：<br><br>1 - 读取线圈，<br>2 - 读取离散输入，<br>3 - 读取保持寄存器，<br>4 - 读取输入寄存器 |空|3| |*address*|第一个注册表、线圈或输入的地址。<br><br>如果“函数”为空，则“地址”应在以下范围内：<br>线圈 - 00001 - 09999<br>离散输入 - 10001 - 19999<br>输入寄存器 - 30001 - 39999<br>保持寄存器 - 40001 - 49999<br><br>如果'函数'不为空，'地址'字段将从 0 到 65535 并使用无修改 (PDU)|空函数：00001<br><br>非空函数：0|9999| |*count*|将从设备读取的序列“类型”的计数，其中：<br><br>对于线圈或离散输入，“类型”= 1 位<br>对于其他情况：（计数\*类型 )/2 = 用于读取的寄存器的实际计数<br>如果'offset'不为0，则该值将添加到'real count'<br>'real count'的可接受范围是1:65535|1|2| |*type*|数据类型：<br><br>用于读取线圈和读取离散输入 - *位*<br><br>用于读取保持寄存器和读取输入寄存器：<br>*int8* - 8 位<br >*uint8* - 8 位（无符号）<br>*int16* - 16 位<br>*uint16* - 16 位（无符号）<br>*int32* - 32 位<br>*uint32* - 32 位（无符号）<br> *float* - 32 位<br>*uint64* - 64 位（无符号）<br>*double* - 64 位|位<br>uint16|uint64| |*endianness*|字节序类型：<br>*be* - Big Endian<br>*le* - Little Endian<br>*mbe* - Mid-Big Endian<br>*mle* - Mid-Little Endian<br ><br>限制：<br>1 位 - be<br>8 位 - be,le<br>16 位 - be,le|be|le| |*offset*|寄存器个数，从'address'开始，其结果将被丢弃。<br><br>每个寄存器的大小为16bit（需要支持不支持随机读访问的设备）。 |0|4|

en-us	#### Parameters  |Parameter|Mandatory|Range|Default|Description| |--|--|--|--|----------| |AlertScriptsPath|no| |/usr/local/share/zabbix/alertscripts|Location of custom alert scripts (depends on compile-time installation variable *datadir*).| |AllowRoot|no| |0|Allow the server to run as 'root'. If disabled and the server is started by 'root', the server will try to switch to the 'zabbix' user instead. Has no effect if started under a regular user.<br>0 - do not allow<br>1 - allow| |AllowUnsupportedDBVersions|no| |0|Allow the server to work with unsupported database versions.<br>0 - do not allow<br>1 - allow| |CacheSize|no|128K-64G|32M|Size of configuration cache, in bytes.<br>Shared memory size for storing host, item and trigger data.| |CacheUpdateFrequency|no|1-3600|60|Determines how often Zabbix will perform update of configuration cache in seconds.<br>See also [runtime control](/manual/concepts/server#server_process) options.| |DBHost|no| |localhost|Database host name.<br>In case of MySQL localhost or empty string results in using a socket. In case of PostgreSQL<br>only empty string results in attempt to use socket.<br>In case of [Oracle](/manual/appendix/install/oracle#connection_set_up) empty string results in using the Net Service Name connection method; in this case consider using the TNS\_ADMIN environment variable to specify the directory of the tnsnames.ora file.| |DBName|yes| | |Database name.<br>In case of [Oracle](/manual/appendix/install/oracle#connection_set_up) if the Net Service Name connection method is used, specify the service name from tnsnames.ora or set to empty string; set the TWO\_TASK environment variable if DBName is set to empty string.| |DBPassword|no| | |Database password.<br>Comment this line if no password is used.| |DBPort|no|1024-65535| |Database port when not using local socket.<br>In case of [Oracle](/manual/appendix/install/oracle#connection_set_up) if the Net Service Name connection method is used this parameter will be ignored; the port number from the tnsnames.ora file will be used instead.| |DBSchema|no| | |Schema name. Used for PostgreSQL.| |DBSocket|no| | |Path to MySQL socket file.| |DBUser|no| | |Database user.| |DBTLSConnect|no| | |Setting this option enforces to use TLS connection to database:<br>*required* - connect using TLS<br>*verify\_ca* - connect using TLS and verify certificate<br>*verify\_full* - connect using TLS, verify certificate and verify that database identity specified by DBHost matches its certificate<br><br>On MySQL starting from 5.7.11 and PostgreSQL the following values are supported: "required", "verify\_ca", "verify\_full". On MariaDB starting from version 10.2.6 "required" and "verify\_full" values are supported.<br>By default not set to any option and the behavior depends on database configuration.<br><br>This parameter is supported since Zabbix 5.0.0.| |DBTLSCAFile|no<br>(yes, if DBTLSConnect set to one of: verify\_ca, verify\_full)| | |Full pathname of a file containing the top-level CA(s) certificates for database certificate verification.<br>This parameter is supported since Zabbix 5.0.0.| |DBTLSCertFile|no| | |Full pathname of file containing Zabbix server certificate for authenticating to database.<br>This parameter is supported since Zabbix 5.0.0.| |DBTLSKeyFile|no| | |Full pathname of file containing the private key for authenticating to database.<br>This parameter is supported since Zabbix 5.0.0.| |DBTLSCipher|no| | |The list of encryption ciphers that Zabbix server permits for TLS protocols up through TLSv1.2.<br>Supported only for MySQL.<br>This parameter is supported since Zabbix 5.0.0.| |DBTLSCipher13|no| | |The list of encryption ciphersuites that Zabbix server permits for TLSv1.3 protocol.<br>Supported only for MySQL, starting from version 8.0.16.<br>This parameter is supported since Zabbix 5.0.0.| |DebugLevel|no|0-5|3|Specifies debug level:<br>0 - basic information about starting and stopping of Zabbix processes<br>1 - critical information<br>2 - error information<br>3 - warnings<br>4 - for debugging (produces lots of information)<br>5 - extended debugging (produces even more information)<br>See also [runtime control](/manual/concepts/server#server_process) options.| |ExportDir|no| | |Directory for [real-time export](/manual/appendix/install/real_time_export) of events, history and trends in newline-delimited JSON format. If set, enables real-time export.<br>This parameter is supported since Zabbix 4.0.0.| |ExportFileSize|no|1M-1G|1G|Maximum size per export file in bytes. Only used for rotation if ExportDir is set.<br>This parameter is supported since Zabbix 4.0.0.| |ExportType|no| | |List of comma-delimited entity types (events, history, trends) for [real-time export](/manual/appendix/install/real_time_export) (all types by default). Valid only if ExportDir is set.<br>*Note* that if ExportType is specified, but ExportDir is not, then this is a configuration error and the server will not start.<br>e.g.:<br>ExportType=history,trends - export history and trends only<br>ExportType=events - export events only| |ExternalScripts|no| |/usr/local/share/zabbix/externalscripts|Location of external scripts (depends on compile-time installation variable *datadir*).| |Fping6Location|no| |/usr/sbin/fping6|Location of fping6.<br>Make sure that fping6 binary has root ownership and SUID flag set.<br>Make empty ("Fping6Location=") if your fping utility is capable to process IPv6 addresses.| |FpingLocation|no| |/usr/sbin/fping|Location of fping.<br>Make sure that fping binary has root ownership and SUID flag set!| |HANodeName|no| | |The high availability cluster node name.<br>When empty the server is working in standalone mode and a node with empty name is created.| |HistoryCacheSize|no|128K-2G|16M|Size of history cache, in bytes.<br>Shared memory size for storing history data.| |HistoryIndexCacheSize|no|128K-2G|4M|Size of history index cache, in bytes.<br>Shared memory size for indexing history data stored in history cache.<br>The index cache size needs roughly 100 bytes to cache one item.<br>This parameter is supported since Zabbix 3.0.0.| |HistoryStorageDateIndex|no| |0|Enable preprocessing of history values in history storage to store values in different indices based on date:<br>0 - disable<br>1 - enable| |HistoryStorageURL|no| | |History storage HTTP\[S\] URL.<br>This parameter is used for [Elasticsearch](/manual/appendix/install/elastic_search_setup) setup.| |HistoryStorageTypes|no| |uint,dbl,str,log,text|Comma separated list of value types to be sent to the history storage.<br>This parameter is used for [Elasticsearch](/manual/appendix/install/elastic_search_setup) setup.| |HousekeepingFrequency|no|0-24|1|Determines how often Zabbix will perform housekeeping procedure in hours.<br>Housekeeping is removing outdated information from the database.<br>*Note*: To prevent housekeeper from being overloaded (for example, when history and trend periods are greatly reduced), no more than 4 times HousekeepingFrequency hours of outdated information are deleted in one housekeeping cycle, for each item. Thus, if HousekeepingFrequency is 1, no more than 4 hours of outdated information (starting from the oldest entry) will be deleted per cycle.<br>*Note*: To lower load on server startup housekeeping is postponed for 30 minutes after server start. Thus, if HousekeepingFrequency is 1, the very first housekeeping procedure after server start will run after 30 minutes, and will repeat with one hour delay thereafter.<br>Since Zabbix 3.0.0 it is possible to disable automatic housekeeping by setting HousekeepingFrequency to 0. In this case the housekeeping procedure can only be started by *housekeeper\_execute* runtime control option and the period of outdated information deleted in one housekeeping cycle is 4 times the period since the last housekeeping cycle, but not less than 4 hours and not greater than 4 days.<br>See also [runtime control](/manual/concepts/server#server_process) options.| |Include|no| | |You may include individual files or all files in a directory in the configuration file.<br>To only include relevant files in the specified directory, the asterisk wildcard character is supported for pattern matching. For example: `/absolute/path/to/config/files/*.conf`.<br>See [special notes](special_notes_include) about limitations.| |JavaGateway|no| | |IP address (or hostname) of Zabbix Java gateway.<br>Only required if Java pollers are started.| |JavaGatewayPort|no|1024-32767|10052|Port that Zabbix Java gateway listens on.| |ListenBacklog|no|0 - INT\_MAX|SOMAXCONN|The maximum number of pending connections in the TCP queue.<br>Default value is a hard-coded constant, which depends on the system.<br>Maximum supported value depends on the system, too high values may be silently truncated to the 'implementation-specified maximum'.| |ListenIP|no| |0.0.0.0|List of comma delimited IP addresses that the trapper should listen on.<br>Trapper will listen on all network interfaces if this parameter is missing.| |ListenPort|no|1024-32767|10051|Listen port for trapper.| |LoadModule|no| | |Module to load at server startup. Modules are used to extend functionality of the server.<br>Formats:<br>LoadModule=<module.so><br>LoadModule=<path/module.so><br>LoadModule=</abs\_path/module.so><br>Either the module must be located in directory specified by LoadModulePath or the path must precede the module name. If the preceding path is absolute (starts with '/') then LoadModulePath is ignored.<br>It is allowed to include multiple LoadModule parameters.| |LoadModulePath|no| | |Full path to location of server modules.<br>Default depends on compilation options.| |LogFile|yes, if LogType is set to *file*, otherwise<br>no| | |Name of log file.| |LogFileSize|no|0-1024|1|Maximum size of log file in MB.<br>0 - disable automatic log rotation.<br>*Note*: If the log file size limit is reached and file rotation fails, for whatever reason, the existing log file is truncated and started anew.| |LogType|no| |file|Log output type:<br>*file* - write log to file specified by LogFile parameter,<br>*system* - write log to syslog,<br>*console* - write log to standard output.<br>This parameter is supported since Zabbix 3.0.0.| |LogSlowQueries|no|0-3600000|0|Determines how long a database query may take before being logged in milliseconds.<br>0 - don't log slow queries.<br>This option becomes enabled starting with DebugLevel=3.| |MaxHousekeeperDelete|no|0-1000000|5000|No more than 'MaxHousekeeperDelete' rows (corresponding to \[tablename\], \[field\], \[value\]) will be deleted per one task in one housekeeping cycle.<br>If set to 0 then no limit is used at all. In this case you must know what you are doing, so as not to [overload the database!](zabbix_server#footnotes) **^[2](zabbix_server#footnotes)^**<br>This parameter applies only to deleting history and trends of already deleted items.| |NodeAddress|no| | |IP or hostname with optional port to override how the frontend should connect to the server.<br>Format: <address>\[:port\]<br>The priority of addresses used by the frontend to specify the server address is: NodeAddress (1); ListenIP (if not 0.0.0.0 or ::) (2); localhost (default) (3)<br>See also: HANodeName parameter| |PidFile|no| |/tmp/zabbix\_server.pid|Name of PID file.| |ProxyConfigFrequency|no|1-604800|3600|Determines how often Zabbix server sends configuration data to a Zabbix proxy in seconds. Used only for proxies in a passive mode.| |ProblemHousekeepingFrequency|no| 1-3600|60|Determines how often Zabbix will delete problems for deleted triggers in seconds.|  |ProxyDataFrequency|no|1-3600|1|Determines how often Zabbix server requests history data from a Zabbix proxy in seconds. Used only for proxies in a passive mode.| |ServiceManagerSyncFrequency|no|1-3600|60| Determines how often Zabbix will synchronize configuration of a service manager in seconds.| |SNMPTrapperFile|no| |/tmp/zabbix\_traps.tmp|Temporary file used for passing data from SNMP trap daemon to the server.<br>Must be the same as in zabbix\_trap\_receiver.pl or SNMPTT configuration file.| |SocketDir|no| |/tmp|Directory to store IPC sockets used by internal Zabbix services.<br>This parameter is supported since Zabbix 3.4.0.| |SourceIP|no| | |Source IP address for:<br>- outgoing connections to Zabbix proxy and Zabbix agent;<br>- agentless connections (VMware, SSH, JMX, SNMP, Telnet and simple checks);<br>- HTTP agent connections;<br>- script item JavaScript HTTP requests;<br>- preprocessing JavaScript HTTP requests;<br>- sending notification emails (connections to SMTP server);<br>- webhook notifications (JavaScript HTTP connections);<br>- connections to the Vault| |SSHKeyLocation|no| | |Location of public and private keys for SSH checks and actions| |SSLCertLocation|no| | |Location of SSL client certificate files for client authentication.<br>This parameter is used in web monitoring only.| |SSLKeyLocation|no| | |Location of SSL private key files for client authentication.<br>This parameter is used in web monitoring only.| |SSLCALocation|no| | |Override the location of certificate authority (CA) files for SSL server certificate verification. If not set, system-wide directory will be used.<br>Note that the value of this parameter will be set as libcurl option CURLOPT\_CAPATH. For libcurl versions before 7.42.0, this only has effect if libcurl was compiled to use OpenSSL. For more information see [cURL web page](http://curl.haxx.se/libcurl/c/CURLOPT_CAPATH.html).<br>This parameter is used in web monitoring since Zabbix 2.4.0 and in SMTP authentication since Zabbix 3.0.0.| |StartAlerters|no|1-100|3|Number of pre-forked instances of [alerters](/manual/concepts/server#server_process_types).<br>This parameter is supported since Zabbix 3.4.0.| |StartDBSyncers|no|1-100|4|Number of pre-forked instances of [history syncers](/manual/concepts/server#server_process_types).<br>*Note*: Be careful when changing this value, increasing it may do more harm than good. Roughly, the default value should be enough to handle up to 4000 NVPS.| |StartDiscoverers|no|0-250|1|Number of pre-forked instances of [discoverers](/manual/concepts/server#server_process_types).| |StartEscalators|no|1-100|1|Number of pre-forked instances of [escalators](/manual/concepts/server#server_process_types).<br>This parameter is supported since Zabbix 3.0.0.| |StartHistoryPollers|no|0-1000|5|Number of pre-forked instances of [history pollers](/manual/concepts/server#server_process_types).<br>This parameter is supported since Zabbix 5.4.0.| |StartHTTPPollers|no|0-1000|1|Number of pre-forked instances of [HTTP pollers](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^**.| |StartIPMIPollers|no|0-1000|0|Number of pre-forked instances of [IPMI pollers](/manual/concepts/server#server_process_types).| |StartJavaPollers|no|0-1000|0|Number of pre-forked instances of [Java pollers](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^**.| |StartLLDProcessors|no|1-100|2|Number of pre-forked instances of low-level discovery (LLD) [workers](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^**.<br>The LLD manager process is automatically started when an LLD worker is started.<br>This parameter is supported since Zabbix 4.2.0.| |StartODBCPollers|no|0-1000|1|Number of pre-forked instances of [ODBC pollers](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^**.| |StartPingers|no|0-1000|1|Number of pre-forked instances of [ICMP pingers](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^**.| |StartPollersUnreachable|no|0-1000|1|Number of pre-forked instances of [pollers for unreachable hosts](/manual/concepts/server#server_process_types) (including IPMI and Java)**^[1](zabbix_server#footnotes)^**.<br>At least one poller for unreachable hosts must be running if regular, IPMI or Java pollers are started.| |StartPollers|no|0-1000|5|Number of pre-forked instances of [pollers](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^**.| |StartPreprocessors|no|1-1000|3|Number of pre-forked instances of preprocessing [workers](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^**.<br>The preprocessing manager process is automatically started when a preprocessor worker is started.<br>This parameter is supported since Zabbix 3.4.0.| |StartProxyPollers|no|0-250|1|Number of pre-forked instances of [pollers for passive proxies](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^**.| |StartReportWriters|no|0-100|0|Number of pre-forked instances of [report writers](/manual/concepts/server#server_process_types).<br>If set to 0, scheduled report generation is disabled.<br>The report manager process is automatically started when a report writer is started.<br>This parameter is supported since Zabbix 5.4.0.| |StartSNMPTrapper|no|0-1|0|If set to 1, [SNMP trapper](/manual/concepts/server#server_process_types) process will be started.| |StartTimers|no|1-1000|1|Number of pre-forked instances of [timers](/manual/concepts/server#server_process_types).<br>Timers process maintenance periods.| |StartTrappers|no|0-1000|5|Number of pre-forked instances of [trappers](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^**.<br>Trappers accept incoming connections from Zabbix sender, active agents and active proxies.| |StartVMwareCollectors|no|0-250|0|Number of pre-forked [VMware collector](/manual/concepts/server#server_process_types) instances.| |StatsAllowedIP|no| | |List of comma delimited IP addresses, optionally in CIDR notation, or DNS names of external Zabbix instances. Stats request will be accepted only from the addresses listed here. If this parameter is not set no stats requests will be accepted.<br>If IPv6 support is enabled then '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1' are treated equally and '::/0' will allow any IPv4 or IPv6 address. '0.0.0.0/0' can be used to allow any IPv4 address.<br>Example: StatsAllowedIP=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com<br>This parameter is supported since Zabbix 4.2.0.| |Timeout|no|1-30|3|Specifies how long we wait for agent, SNMP device or external check in seconds.| |TLSCAFile|no| | |Full pathname of a file containing the top-level CA(s) certificates for peer certificate verification, used for encrypted communications between Zabbix components.<br>This parameter is supported since Zabbix 3.0.0.| |TLSCertFile|no| | |Full pathname of a file containing the server certificate or certificate chain, used for encrypted communications between Zabbix components.<br>This parameter is supported since Zabbix 3.0.0.| |TLSCipherAll|no| | |GnuTLS priority string or OpenSSL (TLS 1.2) cipher string. Override the default ciphersuite selection criteria for certificate- and PSK-based encryption.<br>Example: TLS\_AES\_256\_GCM\_SHA384:TLS\_CHACHA20\_POLY1305\_SHA256:TLS\_AES\_128\_GCM\_SHA256<br>This parameter is supported since Zabbix 4.4.7.| |TLSCipherAll13|no| | |Cipher string for OpenSSL 1.1.1 or newer in TLS 1.3. Override the default ciphersuite selection criteria for certificate- and PSK-based encryption.<br>Example for GnuTLS: NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL::+SIGN-ALL:+CTYPE-X.509<br>Example for OpenSSL: EECDH+aRSA+AES128:RSA+aRSA+AES128:kECDHEPSK+AES128:kPSK+AES128<br>This parameter is supported since Zabbix 4.4.7.| |TLSCipherCert|no| | |GnuTLS priority string or OpenSSL (TLS 1.2) cipher string. Override the default ciphersuite selection criteria for certificate-based encryption.<br>Example for GnuTLS: NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL:+CTYPE-X.509<br>Example for OpenSSL: EECDH+aRSA+AES128:RSA+aRSA+AES128<br>This parameter is supported since Zabbix 4.4.7.| |TLSCipherCert13|no| | |Cipher string for OpenSSL 1.1.1 or newer in TLS 1.3. Override the default ciphersuite selection criteria for certificate-based encryption.<br>This parameter is supported since Zabbix 4.4.7.| |TLSCipherPSK|no| | |GnuTLS priority string or OpenSSL (TLS 1.2) cipher string. Override the default ciphersuite selection criteria for PSK-based encryption.<br>Example for GnuTLS: NONE:+VERS-TLS1.2:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL<br>Example for OpenSSL: kECDHEPSK+AES128:kPSK+AES128<br>This parameter is supported since Zabbix 4.4.7.| |TLSCipherPSK13|no| | |Cipher string for OpenSSL 1.1.1 or newer in TLS 1.3. Override the default ciphersuite selection criteria for PSK-based encryption.<br>Example: TLS\_CHACHA20\_POLY1305\_SHA256:TLS\_AES\_128\_GCM\_SHA256<br>This parameter is supported since Zabbix 4.4.7.| |TLSCRLFile|no| | |Full pathname of a file containing revoked certificates. This parameter is used for encrypted communications between Zabbix components.<br>This parameter is supported since Zabbix 3.0.0.| |TLSKeyFile|no| | |Full pathname of a file containing the server private key, used for encrypted communications between Zabbix components.<br>This parameter is supported since Zabbix 3.0.0.| |TmpDir|no| |/tmp|Temporary directory.| |TrapperTimeout|no|1-300|300|Specifies how many seconds trapper may spend processing new data.| |TrendCacheSize|no|128K-2G|4M|Size of trend cache, in bytes.<br>Shared memory size for storing trends data.| |TrendFunctionCacheSize|no|128K-2G|4M|Size of trend function cache, in bytes.<br>Shared memory size for caching calculated trend function data.| |UnavailableDelay|no|1-3600|60|Determines how often host is checked for availability during the [unavailability](/manual/appendix/items/unreachability#unavailable_host) period, in seconds.| |UnreachableDelay|no|1-3600|15|Determines how often host is checked for availability during the [unreachability](/manual/appendix/items/unreachability#unreachable_host) period in seconds.| |UnreachablePeriod|no|1-3600|45|Determines after how many seconds of [unreachability](/manual/appendix/items/unreachability#unreachable_host) treat a host as unavailable.| |User|no| |zabbix|Drop privileges to a specific, existing user on the system.<br>Only has effect if run as 'root' and AllowRoot is disabled.| |ValueCacheSize|no|0,128K-64G|8M|Size of history value cache, in bytes.<br>Shared memory size for caching item history data requests.<br>Setting to 0 disables value cache (not recommended).<br>When value cache runs out of the shared memory a warning message is written to the server log every 5 minutes.| |VaultDBPath|no| | |Vault path from where credentials for database will be retrieved by keys 'password' and 'username'.<br>Example: secret/zabbix/database<br>This option can only be used if DBUser and DBPassword are not specified.<br>This parameter is supported since Zabbix 5.2.0.| |VaultToken|no| | |Vault authentication token that should have been generated exclusively for Zabbix server with read-only permission to the paths specified in [Vault macros](/manual/config/macros/user_macros#configuration) and read-only permission to the path specified in the optional VaultDBPath configuration parameter.<br>It is an error if VaultToken and VAULT\_TOKEN environment variable are defined at the same time.<br>This parameter is supported since Zabbix 5.2.0.| |VaultURL|no| |https://127.0.0.1:8200|Vault server HTTP\[S\] URL. System-wide CA certificates directory will be used if SSLCALocation is not specified.<br>This parameter is supported since Zabbix 5.2.0.| |VMwareCacheSize|no|256K-2G|8M|Shared memory size for storing VMware data.<br>A VMware internal check zabbix\[vmware,buffer,...\] can be used to monitor the VMware cache usage (see [Internal checks](/manual/config/items/itemtypes/internal)).<br>Note that shared memory is not allocated if there are no vmware collector instances configured to start.| |VMwareFrequency|no|10-86400|60|Delay in seconds between data gathering from a single VMware service.<br>This delay should be set to the least update interval of any VMware monitoring item.| |VMwarePerfFrequency|no|10-86400|60|Delay in seconds between performance counter statistics retrieval from a single VMware service.<br>This delay should be set to the least update interval of any VMware monitoring [item](/manual/config/items/itemtypes/simple_checks/vmware_keys#footnotes) that uses VMware performance counters.| |VMwareTimeout|no|1-300|10|The maximum number of seconds vmware collector will wait for a response from VMware service (vCenter or ESX hypervisor).| |WebServiceURL|no| | |HTTP\[S\] URL to Zabbix web service in the format `<host:port>/report`. For example: `http://localhost:10053/report`<br>This parameter is supported since Zabbix 5.4.0.|
zh-cn	#### 参数  |参数|是否必选设置|范围|默认值|说明| |---------|---------|-----|-------|-----------| |AlertScriptsPath|否| |/usr/local/share/zabbix/alertscripts|自定义告警脚本位置（取决于编译时安装变量*datadir*）。| |AllowRoot|否| |0|允许服务器以 “root” 权限运行。如果禁用此项，以“root” 权限启动服务器时，服务器将尝试切换到 “zabbix” 用户。如果在普通用户下启动，则不受影响。<br>0 - 不允许；<br>1 - 允许。| |AllowUnsupportedDBVersions|否| |0|允许服务器使用不受支持的数据库版本。<br>0 - 不允许；<br>1 - 允许。| |CacheSize|否|128K-64G|32M|配置缓存大小，以字节为单位。<br>存储主机、监控项和触发器数据的共享内存大小。| |CacheUpdateFrequency|否|1-3600|60|Zabbix执行配置缓存更新的频率，以秒为单位。<br>另请参阅 [运行时控制](/manual/concepts/server#server_process) 选项。| |DBHost|否| |localhost|数据库主机名。<br><br>针对 MySQL 用户，设置为 localhost 或者空字符串会尝试使用本地套接字；<br>针对 PostgreSQL 用户，仅设置为空字符串会尝试使用本地套接字；<br>针对 [Oracle](/manual/appendix/install/oracle#connection_set_up) 用户，设置为空字符串会使用网络服务名称连接，此类情况可以考虑使用 TNS\_ADMIN 环境变量来指定 tnsnames.ora 文件所在目录。| |DBName|是| | |数据库名称。<br>针对 [Oracle](/manual/appendix/install/oracle#connection_set_up) 用户，如果使用了网络服务名称连接方式，请在 tnsnames.ora 中指定服务名称，或设置为空字符串；如果 DBName 设置为空，需要设置 TWO\_TASK 环境变量。| |DBPassword|否| | |数据库密码。<br>如果未使用密码，注释掉此行即可。| |DBPort|否|1024-65535| |数据库端口（未使用本地套接字）<br>针对 [Oracle](/manual/appendix/install/oracle#connection_set_up) 用户，如果使用网络服务名称连接方式，该参数将被忽略，系统会使用 tnsnames.ora 文件中的端口号。| |DBSchema|否| | |模式名称。用于 PostgreSQL 数据库。| |DBSocket|否| | |MySQL套接字文件路径。| |DBUser|否| | |数据库用户。| |DBTLSConnect|否| | |设置此选项强制使用 TLS 连接到数据库：<br>*required* - 使用 TLS 连接；<br>*verify\_ca* - 使用 TLS 连接并验证证书；<br>*verify\_full* - 使用 TLS 连接，验证证书，并验证 DBHost 指定的数据库标识是否与其证书匹配。<br><br>自 5.7.11 版本起，MySQL 和 PostgreSQL 开始支持 "required", "verify\_ca", "verify\_full" 参数。自 10.2.6 版本起，MariaDB 开始支持 "required" 和 "verify\_full" 参数。<br>默认情况不会配置该项，具体使用取决于数据库配置。<br><br>自 Zabbix 5.0.0 版本起开始支持此参数。| |DBTLSCAFile|否<br>（是，适用于 DBTLSConnect 设置为以下其 CA 中值：verify\_ca, verify\_full）| | |用于数据库证书验证的顶级 CA（s）证书文件的完整路径名。<br>自 Zabbix 5.0.0 版本起开始支持此参数。| |DBTLSCertFile|否| | |用于数据库身份验证的 Zabbix 服务器证书文件的完整路径名。<br>自 Zabbix 5.0.0 版本起开始支持此参数。| |DBTLSKeyFile|否| | |用于数据库身份验证的私钥文件的完整路径名。<br>自 Zabbix 5.0.0 版本起开始支持此参数。| |DBTLSCipher|否| | |Zabbix 服务器允许 TLS（TLSv1.2）协议使用的加密密码套件列表。<br>仅支持 MySQL。<br>自 Zabbix 5.0.0 版本起开始支持此参数。| |DBTLSCipher13|否| | |Zabbix 服务器允许 TLSv1.3 协议使用的加密密码套件列表。<br>仅支持 8.0.16 及更高版本 MySQL。<br>自 Zabbix 5.0.0 版本起开始支持此参数。| |DebugLevel|否|0-5|3|指定调试级别：<br>0 - 关于启动和停止 Zabbix 进程的基本信息。<br>1 - 严重信息；<br>2 - 错误信息；<br>3 - 警告信息；<br>4 - 用于调试（产生大量信息）；<br>5 - 扩展调试（产生更多信息）；<br>另请参阅 [运行时控制](/manual/concepts/server#server_process) 选项。| |ExportDir|否| | |由换行符分隔的 JSON 格式所记录的事件、历史和趋势的 [实时导出](/manual/appendix/install/real_time_export) 目录。如果设置此项，则启用实时导出。<br>自 Zabbix 4.0.0 版本起开始支持此参数。| |ExportFileSize|否|1M-1G|1G|每个导出文件的最大大小（字节）。 仅在 ExportDir 设置后用于轮询。<br>自 Zabbix 4.0.0 版本起开始支持此参数。| |ExportType|否| | |用于 [实时导出](/manual/appendix/install/real_time_export) 的由逗号分隔的实体类列表（事件、历史、趋势）(默认情况下为所有类型)。仅当设置了 ExportDir 时生效。<br>*请注意* 如果指定了 ExportType，但没有指定 ExportDir，服务器将因配置错误无法启动。<br>示例：<br>ExportType=history,trends - 仅导出历史和趋势。<br>ExportType=events - 仅导出事件。| |ExternalScripts|否| |/usr/local/share/zabbix/externalscripts|外部脚本位置（取决于编译时安装变量*datadir*）。| |Fping6Location|否| |/usr/sbin/fping6|fping6 位置。<br>确保 fping6 二进制文件设置了 root 所有权和 SUID 标志。<br>如果 fping 应用程序能够处理 IPv6 地址，请将其设为空（“Fping6Location=”）。| |FpingLocation|否| |/usr/sbin/fping|fping 位置。<br>确保 fping 二进制文件设置了 root 所有权和 SUID 标志。| |HANodeName|否| | |高可用机群节点名称。<br>当为空时，服务器为单机模式工作，并创建一个名称为空的节点。| |HistoryCacheSize|否|128K-2G|16M|历史缓存的大小，以字节为单位。<br>用于存储历史数据的共享内存大小。| |HistoryIndexCacheSize|否|128K-2G|4M|历史索引缓存的大小，以字节为单位。<br>用于索引存储在历史缓存中的历史数据的共享内存大小。<br>索引缓存一个监控项大约需要 100 字节。<br>自 Zabbix 3.0.0 版本起开始支持此参数。| |HistoryStorageDateIndex|否| |0|启用历史存储中历史值的预处理，基于不同日期在索引中的存储值：<br>0 - 禁用；<br>1 - 启用。| |HistoryStorageURL|否| | |HTTP\[S\] URL 历史记录。<br>此参数用于 [Elasticsearch](/manual/appendix/install/elastic_search_setup) 设置。| |HistoryStorageTypes|否| |uint,dbl,str,log,text|发送到历史记录存储的值（类型为逗号分隔的列表）。<br>此参数用于 [Elasticsearch](/manual/appendix/install/elastic_search_setup) 设置。| |HousekeepingFrequency|否|0-24|1|Zabbix 执行清理的频率（以小时为单位）。<br>执行清理会从数据库中删除过时的信息。<br>*注意*：为了防止负载过高（例如，当历史和趋势周期大大缩短），在一个周期内，每个监控项删除的过期信息的时间不能超过清理频率（小时）的 4 倍。也就是，如果 HousekeepingFrequency 为 1，则每个周期删除的过期信息的时间（从最早的条目开始）不能超过 4 小时。<br>*注意*：为了降低服务器启动时的负载，服务器启动后执行清理将推迟 30 分钟。也就是，如果 HousekeepingFrequency 为 1，服务器启动后的第一个执行清理过程将在 30 分钟后运行，并在此后延迟一小时重复执行。<br>自 Zabbix 3.0.0 起，可以通过将 HousekeepingFrequency 设置为 0 来禁用自动清理。在这种情况下，清理程序只能通过 *housekeeper\_execute* 运行时控制选项启动，一个清理周期中删除过期信息的时间是自上一个清理周期以来时间的 4 倍，但不能少于 4 小时，且不能超过 4 天。<br>请参阅 [运行时控制](/manual/concepts/server#server_process) 选项|。 |Include|否| | |您可以在配置文件中加载单个文件或目录中的所有文件。<br>仅在指定目录中包含相关文件，模式匹配支持星号通配符。示例：`/absolute/path/to/config/files/*.conf` 。<br>请参阅 [特殊说明](special_notes_include) 关于某些限制说明。| |JavaGateway|否| | |Zabbix Java gateway 的 IP 地址（或主机名）。<br>仅在启动 Java pollers 轮询时器需要设置。| |JavaGatewayPort|否|1024-32767|10052|Zabbix Java gateway 监听端口。| |ListenBacklog|否|0 - INT\_MAX|SOMAXCONN|TCP 队列中挂起的最大连接数。<br>默认值是一个硬编码常量，具体取决于系统。<br>支持的最大值取决于系统，过高的值可能会被自动截断为'implementation-specified maximum' 的值。| |ListenIP|no| |0.0.0.0|Tarpper 采集器监听目标（逗号分隔）的 IP 地址列表。<br>如果缺少此参数，Trapper 将监听所有网络接口。| |ListenPort|no|1024-32767|10051|Trapper 监听端口。| |LoadModule|no| | |要在服务器启动时加载的模块。模块用于扩展服务器的其他功能。<br>格式：<br>LoadModule=<module.so><br>LoadModule=<path/module.so><br>LoadModule=</abs\_path/module.so><br>模块必须位于 LoadModulePath 指定的目录中，或者路径必须位于模块名称之前。如果前面的路径是绝对路径（以 “/” 开头），则忽略 LoadModulePath。<br>允许包含多个 LoadModule 参数。| |LoadModulePath|no| | |服务器模块位置的完整路径<br>默认值取决于编译时的选项。| |LogFile|是，先决条件是 LogType 设置为 *file* ；<br>否| | |日志文件的名称。| |LogFileSize|no|0-1024|1|日志文件的最大大小（MB）。<br>0 - 禁用日志自动轮询。<br>*注意*：如果达到日志文件大小限制且文件轮询失败，无论出于何种原因，现有日志文件都将被截断并重新启动记录。| |LogType|no| |file|日志输出类型：<br>*file* - 将日志写入 LogFile 参数指定的文件；<br>*system* - 将日志写入 syslog；<br>*console* - 将日志写入到标准输出。<br>自 Zabbix 3.0.0 版本起开始支持此参数。| |LogSlowQueries|no|0-3600000|0|数据库慢查询记录时间（以毫秒为单位）。<br>0 - 不记录慢查询。<br>此选项从 DebugLevel=3 开始启用。| |MaxHousekeeperDelete|no|0-1000000|5000|在一个清理周期内，每个任务最多只能删除 “MaxHousekeeperDelete” 行。(对应 \[tablename\], \[field\], \[value\])。<br>如果设置为 0，则不使用限制。在这种情况下，您必须知道自己在做什么，以免 [数据库过载！](zabbix_server#footnotes) **^[2](zabbix_server#footnotes)^ **<br>此参数仅适用于删除已删除监控项的历史记录和趋势。| |NodeAddress|no| | |IP 或主机名，带有可选端口，以覆盖前端应连接到的服务器。<br>格式：<address>\[:port\]<br>前端用于指定服务器地址的地址的优先级为： NodeAddress (1); ListenIP (非设置为 0.0.0.0 or ::) (2); localhost (默认) (3)<br>请查阅： HANodeName parameter| |PidFile|no| |/tmp/zabbix\_server.pid|PID 文件的名称。| |ProxyConfigFrequency|否|1-604800|3600|Zabbix 服务器向 Zabbix 代理发送配置数据的频率（秒）。仅用于被动模式下的代理。| |ProblemHousekeepingFrequency|否| 1-3600|60|确定 Zabbix 以秒为单位删除已删除触发器问题的频率。| |ProxyDataFrequency|否|1-3600|1|Zabbix 服务器从 Zabbix 代理请求历史数据的频率（秒）。仅用于被动模式下的代理。| |ServiceManagerSyncFrequency|否|1-3600|60| 确定 Zabbix 以秒为单位同步服务管理器配置的频率。| |SNMPTrapperFile|否| |/tmp/zabbix\_traps.tmp|用于将数据从 SNMP 捕获守护进程传递到服务器的临时文件。<br>必须与 zabbix\_trap\_receiver.pl 或 SNMPTT 配置文件相同。| |SocketDir|否| |/tmp|存储内部 Zabbix 服务使用的 IPC 套接字的目录。<br>自 Zabbix 3.4.0 版本起开始支持此参数。| |SourceIP|否| | |源IP地址：<br>- Zabbix proxy 和 Zabbix agent 的传出连接；<br>- 无代理连接 (VMware, SSH, JMX, SNMP, Telnet 和 simple checks)；<br>- HTTP agent 连接；<br>- 脚本监控项 JavaScript HTTP 请求；<br>- 预处理 JavaScript HTTP requests；<br>- 发送通知邮件（连接到SMTP服务器）；<br>- webhook 通知（JavaScript HTTP 连接）；<br>- 与保管库的连接。| |SSHKeyLocation|否| | |SSH 检查和操作的公钥和私钥的位置。| |SSLCertLocation|否| | |用于客户端身份验证的 SSL 客户端证书文件的位置。<br>此参数仅用于 web 监控。| |SSLKeyLocation|否| | |用于客户端身份验证的 SSL 私钥文件的位置。<br>此参数仅用于 web 监控。| |SSLCALocation|否| | |覆盖用于 SSL 服务器证书验证的证书颁发机构（CA）文件的位置。如果未设置，将使用系统的目录。<br>请注意，此参数的值将设置为 libcurl 选项 CURLOPT\_CAPATH。对于 7.42.0 之前版本的 libcurl，仅在 libcurl 编译为使用 OpenSSL 时有效。更多信息请参阅 [cURL 网页](http://curl.haxx.se/libcurl/c/CURLOPT_CAPATH.html)。<br>自 Zabbix 2.4.0 版本起开始支持此参数用于 web 监控，自 Zabbix 3.0.0 版本起开始支持此参数用于 SMTP 身份验证| |StartAlerters|否|1-100|3|[告警程序](/manual/concepts/server#server_process_types)的 pre-forked（预分配）实例数量。<br>自 Zabbix 3.4.0 版本起开始支持此参数。| |StartDBSyncers|否|1-100|4|[历史同步程序](/manual/concepts/server#server_process_types)的 pre-forked（预分配）实例数量。<br>*注意*：更改此值时要小心，增加此值可能弊大于利。通常情况下，默认值足以处理多达 4000 NVPS。| |StartDiscoverers|否|0-250|1|[发现程序](/manual/concepts/server#server_process_types)的 pre-forked（预分配）实例数量。| |StartEscalators|否|1-100|1|[扩容程序](/manual/concepts/server#server_process_types)的 pre-forked（预分配）实例数量。<br>自 Zabbix 3.0.0 版本起开始支持此参数。| |StartHistoryPollers|否|0-1000|5|[历史轮询器](/manual/concepts/server#server_process_types)的 pre-forked（预分配）实例数量。<br>自 Zabbix 5.4.0 版本起开始支持此参数。| |StartHTTPPollers|否|0-1000|1|[HTTP 轮询器](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^** 的 pre-forked（预分配）实例数量。| |StartIPMIPollers|否|0-1000|0|[IPMI 轮询器](/manual/concepts/server#server_process_types)的 pre-forked（预分配）实例数量。| |StartJavaPollers|否|0-1000|0|[Java 轮询器](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^** 的 pre-forked（预分配）实例数量。| |StartLLDProcessors|否|1-100|2|low-level discovery (LLD) [工作线程](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)** 的 pre-forked（预分配）实例数量。<br>LLD worker 工作线程启动时，LLD manager 管理进程将自动启动。<br>自 Zabbix 4.2.0 版本起开始支持此参数。| |StartODBCPollers|否|0-1000|1|[ODBC 轮询器](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^** 的 pre-forked（预分配）实例数量。| |StartPingers|否|0-1000|1|[ICMP pingers 监控](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^** 的 pre-forked（预分配）实例数量。| |StartPollersUnreachable|否|0-1000|1|[不可达主机轮询器](/manual/concepts/server#server_process_types) (包括 IPMI 和 Java)**^[1](zabbix_server#footnotes)^** 的 pre-forked（预分配）实例数量。<br>如果启动了常规、IPMI 或 Java轮询器，则必须至少运行一个无法访问主机的轮询器。| |StartPollers|否|0-1000|5|[轮询器](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^** 的 pre-forked（预分配）实例数量。| |StartPreprocessors|否|1-1000|3|预处理[工作线程](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^** 的 pre-forked（预分配）实例数量。<br>预处理工作线程启动时，预处理管理进程将自动启动。<br>自 Zabbix 3.4.0 版本起开始支持此参数。| |StartProxyPollers|否|0-250|1|[passive proxies 被动代理轮询器 ](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^** 的 pre-forked（预分配）实例数量。| |StartReportWriters|否|0-100|0|[报告生成程序](/manual/concepts/server#server_process_types)的 pre-forked（预分配）实例数量。<br>如果设置为 0，则禁用计划的报告生成。<br>启动报告生成线程时，报告管理进程将自动启动。<br>自 Zabbix 5.4.0 版本起开始支持此参数。| |StartSNMPTrapper|否|0-1|0|设置为 1, 即启动 [SNMP trapper 捕获程序](/manual/concepts/server#server_process_types) 进程。| |StartTimers|否|1-1000|1|[定时器](/manual/concepts/server#server_process_types)的 pre-forked（预分配）实例数量。<br>定时器处理维护周期。| |StartTrappers|否|0-1000|5|[trappers捕获程序](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^** 的 pre-forked（预分配）实例数量。<br>捕获程序接受来自 Zabbix sender、处于工作状态的 agent 和 proxy 的传入连接。| |StartVMwareCollectors|否|0-250|0|[VMware collector 收集程序 ](/manual/concepts/server#server_process_types) 的 pre-forked（预分配）实例数量。| |StatsAllowedIP|否| | |逗号分隔的 IP 地址列表（可选CIDR表示法）或外部 Zabbix 实例的 DNS 名称。仅接受此处列出的地址的状态请求。如果未设置此参数，则不会接受任何状态请求。<br>如开启 IPv6 支持，'127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1' 会视为等同。 '::/0' 允许任意 IPv4 或 IPv6 地址。'0.0.0.0/0' 仅用作允许任意 IPv4 地址。<br>示例：StatsAllowedIP=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com<br>自 Zabbix 4.2.0 版本起开始支持此参数。| |Timeout|否|1-30|3|指定等待 agent 代理、SNMP 设备或外部检查的时间（秒）。| |TLSCAFile|否| | |用于对等证书验证的顶级 CA 证书的文件的完整路径名，用于 Zabbix 组件之间的加密通信。<br>自 Zabbix 3.0.0 版本起开始支持此参数。| |TLSCertFile|否| | |服务器证书或证书链的文件的完整路径名，用于 Zabbix 组件之间的加密通信。<br>自 Zabbix 3.0.0 版本起开始支持此参数。| |TLSCipherAll|否| | |GnuTLS 优先级字符串或 OpenSSL（TLS 1.2）密码字符串。覆盖基于证书和 PSK 的加密的默认密码套件选择标准。<br>E示例：TLS\_AES\_256\_GCM\_SHA384:TLS\_CHACHA20\_POLY1305\_SHA256:TLS\_AES\_128\_GCM\_SHA256<br>自 Zabbix 4.4.7 版本起开始支持此参数。| |TLSCipherAll13|否| | |TLS 1.3 中 OpenSSL 1.1.1 或更新版本的密码字符串。覆盖基于证书和 PSK 的加密的默认密码套件选择标准。<br>GnuTLS 示例：NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL::+SIGN-ALL:+CTYPE-X.509<br>OpenSSL 示例： EECDH+aRSA+AES128:RSA+aRSA+AES128:kECDHEPSK+AES128:kPSK+AES128<br>自 Zabbix 4.4.7 版本起开始支持此参数。| |TLSCipherCert|否| | |GnuTLS 优先级字符串或 OpenSSL（TLS 1.2）密码字符串。覆盖基于证书的加密的默认密码套件选择标准。<br>GnuTLS示例：NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL:+CTYPE-X.509<br>OpenSSL示例： EECDH+aRSA+AES128:RSA+aRSA+AES128<br>自 Zabbix 4.4.7 版本起开始支持此参数。| |TLSCipherCert13|否| | |TLS 1.3 中 OpenSSL 1.1.1 或更新版本的密码字符串。覆盖基于证书的加密的默认密码套件选择标准。<br>自 Zabbix 4.4.7 版本起开始支持此参数。| |TLSCipherPSK|否| | |GnuTLS 优先级字符串或 OpenSSL（TLS 1.2）密码字符串。覆盖基于 PSK 的加密的默认密码套件选择标准。<br>GnuTLS 示例：NONE:+VERS-TLS1.2:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL<br>OpenSSL 示例：kECDHEPSK+AES128:kPSK+AES128<br>自 Zabbix 4.4.7 版本起开始支持此参数。| |TLSCipherPSK13|否| | |TLS 1.3 中 OpenSSL 1.1.1 或更新版本的密码字符串。覆盖基于 PSK 的加密的默认密码套件选择标准。<br>示例：TLS\_CHACHA20\_POLY1305\_SHA256:TLS\_AES\_128\_GCM\_SHA256<br>自 Zabbix 4.4.7 版本起开始支持此参数。| |TLSCRLFile|否| | |已吊销证书的文件的完整路径名。此参数用于 Zabbix 组件之间的加密通信。<br>自 Zabbix 3.0.0 版本起开始支持此参数。| |TLSKeyFile|否| | |服务器私钥的文件的完整路径名，用于 Zabbix 组件之间的加密通信。<br>自 Zabbix 3.0.0 版本起开始支持此参数。| |TmpDir|否| |/tmp|临时目录。| |TrapperTimeout|否|1-300|300|指定 trapper 捕获程序处理新数据可能花费的秒数。| |TrendCacheSize|否|128K-2G|4M|趋势缓存的大小，以字节为单位。<br>用于存储趋势数据的共享内存大小。| |TrendFunctionCacheSize|否|128K-2G|4M|趋势函数缓存的大小，以字节为单位。<br>用于缓存计算的趋势函数数据的共享内存大小。| |UnavailableDelay|否|1-3600|60|在[不可用](/manual/appendix/items/unreachability#unavailable_host) 期间检查主机可用性的频率，以秒为单位。| |UnreachableDelay|no|1-3600|15|在[不可达](/manual/appendix/items/unreachability#unreachable_host) 期间检查主机可用性的频率，以秒为单位。| |UnreachablePeriod|no|1-3600|45|经过几秒的[不可达](/manual/appendix/items/unreachability#unreachable_host) 后，将主机视为不可用。| |User|否|zabbix|删除系统上特定现有用户的权限。<br>仅在禁用“以 root 权限运行”和 AllowRoot 时才生效。| |ValueCacheSize|否|0,128K-64G|8M|历史值缓存的大小，以字节为单位。<br>用于缓存监控项历史数据请求的共享内存大小。<br>设置为 0 将禁用缓存（不推荐）。<br>当值缓存耗尽共享内存时，每 5 分钟会向服务器日志写入一条告警消息。| |VaultDBPath|否| | |通过“密码”和“用户名”关键字检索数据库凭据的 Vault 保管库路径。<br>示例： secret/zabbix/database<br>仅在未指定 DBUser 和 DBPassword 时，才能使用此选项。<br>自 Zabbix 5.2.0 版本起开始支持此参数。| |VaultToken|否| | |专门为 Zabbix 服务器生成的 Vault 保管库身份验证令牌，该令牌对 [Vault macros 保管库宏](/manual/config/macros/user_macros#configuration) 中指定的路径具有只读权限，并对可选 Vault DbPath 配置参数中指定的路径具有只读权限。<br>如果同时定义 VaultToken 和 VAULT\_TOKEN 环境变量会报错。<br>自 Zabbix 5.2.0 版本起开始支持此参数。| |VaultURL|否| |https://127.0.0.1:8200|保管库服务器 HTTP\[S\] URL。如果未指定 SSLCALocation，则将使用系统的 CA 证书目录。<br>自 Zabbix 5.2.0 版本起开始支持此参数。| |VMwareCacheSize|否|256K-2G|8M|用于存储 VMware 数据的共享内存大小。<br>VMware 内部检查 zabbix\[VMware，buffer，…\] 可用于监控 VMware 缓存的使用情况 (参阅 [内部检查](/manual/config/items/itemtypes/internal) )。<br>请注意，如果没有配置为启动的 vmware collector 收集器实例，则不会分配共享内存。| |VMwareFrequency|否|10-86400|60|从单个 VMware 服务收集数据之间的延迟（秒）。<br>此延迟应设置为任何 VMware 监控项的最小更新间隔。| |VMwarePerfFrequency|否|10-86400|60|从单个 VMware 服务检索性能计数器统计信息之间的延迟（秒）。<br>此延迟应设置为使用 VMware 性能计数器的任何 VMware monitoring [监控项](/manual/config/items/itemtypes/simple_checks/vmware_keys#footnotes) 的最小更新间隔| |VMwareTimeout|否|1-300|10|Vware collector 等待 vmware 服务（vCenter或ESX hypervisor）响应的最大秒数。| |WebServiceURL|否| | |用于访问 Zabbix web 服务的 HTTP\[S\] URL，格式为： `<host:port>/report`。示例： `http://localhost:10053/report`<br>自 Zabbix 5.4.0 版本起开始支持此参数。|

en-us	#### Parameters  |Parameter|Mandatory|Range|Default|Description| |---------|---------|-----|-------|-----------| |AlertScriptsPath|no| |/usr/local/share/zabbix/alertscripts|Location of custom alert scripts (depends on compile-time installation variable *datadir*).| |AllowRoot|no| |0|Allow the server to run as 'root'. If disabled and the server is started by 'root', the server will try to switch to the 'zabbix' user instead. Has no effect if started under a regular user.<br>0 - do not allow<br>1 - allow| |AllowUnsupportedDBVersions|no| |0|Allow the server to work with unsupported database versions.<br>0 - do not allow<br>1 - allow| |CacheSize|no|128K-64G|8M|Size of configuration cache, in bytes.<br>Shared memory size for storing host, item and trigger data.| |CacheUpdateFrequency|no|1-3600|60|How often Zabbix will perform update of configuration cache, in seconds.<br>See also [runtime control](/manual/concepts/server#server_process) options.| |DBHost|no| |localhost|Database host name.<br>In case of MySQL localhost or empty string results in using a socket. In case of PostgreSQL<br>only empty string results in attempt to use socket.<br>In case of [Oracle](/manual/appendix/install/oracle#connection_set_up) empty string results in using the Net Service Name connection method; in this case consider using the TNS\_ADMIN environment variable to specify the directory of the tnsnames.ora file.| |DBName|yes| | |Database name.<br>In case of [Oracle](/manual/appendix/install/oracle#connection_set_up) if the Net Service Name connection method is used, specify the service name from tnsnames.ora or set to empty string; set the TWO\_TASK environment variable if DBName is set to empty string.| |DBPassword|no| | |Database password.<br>Comment this line if no password is used.| |DBPort|no|1024-65535| |Database port when not using local socket.<br>In case of [Oracle](/manual/appendix/install/oracle#connection_set_up) if the Net Service Name connection method is used this parameter will be ignored; the port number from the tnsnames.ora file will be used instead.| |DBSchema|no| | |Schema name. Used for PostgreSQL.| |DBSocket|no| | |Path to MySQL socket file.| |DBUser|no| | |Database user.| |DBTLSConnect|no| | |Setting this option enforces to use TLS connection to database:<br>*required* - connect using TLS<br>*verify\_ca* - connect using TLS and verify certificate<br>*verify\_full* - connect using TLS, verify certificate and verify that database identity specified by DBHost matches its certificate<br><br>On MySQL starting from 5.7.11 and PostgreSQL the following values are supported: "required", "verify\_ca", "verify\_full". On MariaDB starting from version 10.2.6 "required" and "verify\_full" values are supported.<br>By default not set to any option and the behavior depends on database configuration.<br><br>This parameter is supported since Zabbix 5.0.0.| |DBTLSCAFile|no<br>(yes, if DBTLSConnect set to one of: verify\_ca, verify\_full)| | |Full pathname of a file containing the top-level CA(s) certificates for database certificate verification.<br>This parameter is supported since Zabbix 5.0.0.| |DBTLSCertFile|no| | |Full pathname of file containing Zabbix server certificate for authenticating to database.<br>This parameter is supported since Zabbix 5.0.0.| |DBTLSKeyFile|no| | |Full pathname of file containing the private key for authenticating to database.<br>This parameter is supported since Zabbix 5.0.0.| |DBTLSCipher|no| | |The list of encryption ciphers that Zabbix server permits for TLS protocols up through TLSv1.2.<br>Supported only for MySQL.<br>This parameter is supported since Zabbix 5.0.0.| |DBTLSCipher13|no| | |The list of encryption ciphersuites that Zabbix server permits for TLSv1.3 protocol.<br>Supported only for MySQL, starting from version 8.0.16.<br>This parameter is supported since Zabbix 5.0.0.| |DebugLevel|no|0-5|3|Specifies debug level:<br>0 - basic information about starting and stopping of Zabbix processes<br>1 - critical information<br>2 - error information<br>3 - warnings<br>4 - for debugging (produces lots of information)<br>5 - extended debugging (produces even more information)<br>See also [runtime control](/manual/concepts/server#server_process) options.| |ExportDir|no| | |Directory for [real-time export](/manual/appendix/install/real_time_export) of events, history and trends in newline-delimited JSON format. If set, enables real-time export.<br>This parameter is supported since Zabbix 4.0.0.| |ExportFileSize|no|1M-1G|1G|Maximum size per export file in bytes. Only used for rotation if ExportDir is set.<br>This parameter is supported since Zabbix 4.0.0.| |ExportType|no| | |List of comma-delimited entity types (events, history, trends) for [real-time export](/manual/appendix/install/real_time_export) (all types by default). Valid only if ExportDir is set.<br>*Note* that if ExportType is specified, but ExportDir is not, then this is a configuration error and the server will not start.<br>e.g.:<br>ExportType=history,trends - export history and trends only<br>ExportType=events - export events only| |ExternalScripts|no| |/usr/local/share/zabbix/externalscripts|Location of external scripts (depends on compile-time installation variable *datadir*).| |Fping6Location|no| |/usr/sbin/fping6|Location of fping6.<br>Make sure that fping6 binary has root ownership and SUID flag set.<br>Make empty ("Fping6Location=") if your fping utility is capable to process IPv6 addresses.| |FpingLocation|no| |/usr/sbin/fping|Location of fping.<br>Make sure that fping binary has root ownership and SUID flag set!| |HANodeName|no| | |The high availability cluster node name.<br>When empty the server is working in standalone mode and a node with empty name is created.| |HistoryCacheSize|no|128K-2G|16M|Size of history cache, in bytes.<br>Shared memory size for storing history data.| |HistoryIndexCacheSize|no|128K-2G|4M|Size of history index cache, in bytes.<br>Shared memory size for indexing history data stored in history cache.<br>The index cache size needs roughly 100 bytes to cache one item.<br>This parameter is supported since Zabbix 3.0.0.| |HistoryStorageDateIndex|no| |0|Enable preprocessing of history values in history storage to store values in different indices based on date:<br>0 - disable<br>1 - enable| |HistoryStorageURL|no| | |History storage HTTP\[S\] URL.<br>This parameter is used for [Elasticsearch](/manual/appendix/install/elastic_search_setup) setup.| |HistoryStorageTypes|no| |uint,dbl,str,log,text|Comma separated list of value types to be sent to the history storage.<br>This parameter is used for [Elasticsearch](/manual/appendix/install/elastic_search_setup) setup.| |HousekeepingFrequency|no|0-24|1|How often Zabbix will perform housekeeping procedure (in hours).<br>Housekeeping is removing outdated information from the database.<br>*Note*: To prevent housekeeper from being overloaded (for example, when history and trend periods are greatly reduced), no more than 4 times HousekeepingFrequency hours of outdated information are deleted in one housekeeping cycle, for each item. Thus, if HousekeepingFrequency is 1, no more than 4 hours of outdated information (starting from the oldest entry) will be deleted per cycle.<br>*Note*: To lower load on server startup housekeeping is postponed for 30 minutes after server start. Thus, if HousekeepingFrequency is 1, the very first housekeeping procedure after server start will run after 30 minutes, and will repeat with one hour delay thereafter.<br>Since Zabbix 3.0.0 it is possible to disable automatic housekeeping by setting HousekeepingFrequency to 0. In this case the housekeeping procedure can only be started by *housekeeper\_execute* runtime control option and the period of outdated information deleted in one housekeeping cycle is 4 times the period since the last housekeeping cycle, but not less than 4 hours and not greater than 4 days.<br>See also [runtime control](/manual/concepts/server#server_process) options.| |Include|no| | |You may include individual files or all files in a directory in the configuration file.<br>To only include relevant files in the specified directory, the asterisk wildcard character is supported for pattern matching. For example: `/absolute/path/to/config/files/*.conf`.<br>See [special notes](special_notes_include) about limitations.| |JavaGateway|no| | |IP address (or hostname) of Zabbix Java gateway.<br>Only required if Java pollers are started.| |JavaGatewayPort|no|1024-32767|10052|Port that Zabbix Java gateway listens on.| |ListenBacklog|no|0 - INT\_MAX|SOMAXCONN|The maximum number of pending connections in the TCP queue.<br>Default value is a hard-coded constant, which depends on the system.<br>Maximum supported value depends on the system, too high values may be silently truncated to the 'implementation-specified maximum'.| |ListenIP|no| |0.0.0.0|List of comma delimited IP addresses that the trapper should listen on.<br>Trapper will listen on all network interfaces if this parameter is missing.| |ListenPort|no|1024-32767|10051|Listen port for trapper.| |LoadModule|no| | |Module to load at server startup. Modules are used to extend functionality of the server.<br>Formats:<br>LoadModule=<module.so><br>LoadModule=<path/module.so><br>LoadModule=</abs\_path/module.so><br>Either the module must be located in directory specified by LoadModulePath or the path must precede the module name. If the preceding path is absolute (starts with '/') then LoadModulePath is ignored.<br>It is allowed to include multiple LoadModule parameters.| |LoadModulePath|no| | |Full path to location of server modules.<br>Default depends on compilation options.| |LogFile|yes, if LogType is set to *file*, otherwise<br>no| | |Name of log file.| |LogFileSize|no|0-1024|1|Maximum size of log file in MB.<br>0 - disable automatic log rotation.<br>*Note*: If the log file size limit is reached and file rotation fails, for whatever reason, the existing log file is truncated and started anew.| |LogType|no| |file|Log output type:<br>*file* - write log to file specified by LogFile parameter,<br>*system* - write log to syslog,<br>*console* - write log to standard output.<br>This parameter is supported since Zabbix 3.0.0.| |LogSlowQueries|no|0-3600000|0|How long a database query may take before being logged (in milliseconds).<br>0 - don't log slow queries.<br>This option becomes enabled starting with DebugLevel=3.| |MaxHousekeeperDelete|no|0-1000000|5000|No more than 'MaxHousekeeperDelete' rows (corresponding to \[tablename\], \[field\], \[value\]) will be deleted per one task in one housekeeping cycle.<br>If set to 0 then no limit is used at all. In this case you must know what you are doing, so as not to [overload the database!](zabbix_server#footnotes) **^[2](zabbix_server#footnotes)^**<br>This parameter applies only to deleting history and trends of already deleted items.| |NodeAddress|no| | |IP or hostname with optional port to override how the frontend should connect to the server.<br>Format: <address>\[:port\]<br>The priority of addresses used by the frontend to specify the server address is: NodeAddress (1); ListenIP (if not 0.0.0.0 or ::) (2); localhost (default) (3)<br>See also: HANodeName parameter| |PidFile|no| |/tmp/zabbix\_server.pid|Name of PID file.| |ProxyConfigFrequency|no|1-604800|3600|How often Zabbix server sends configuration data to a Zabbix proxy in seconds. Used only for proxies in a passive mode.| |ProxyDataFrequency|no|1-3600|1|How often Zabbix server requests history data from a Zabbix proxy in seconds. Used only for proxies in a passive mode.| |SNMPTrapperFile|no| |/tmp/zabbix\_traps.tmp|Temporary file used for passing data from SNMP trap daemon to the server.<br>Must be the same as in zabbix\_trap\_receiver.pl or SNMPTT configuration file.| |SocketDir|no| |/tmp|Directory to store IPC sockets used by internal Zabbix services.<br>This parameter is supported since Zabbix 3.4.0.| |SourceIP|no| | |Source IP address for:<br>- outgoing connections to Zabbix proxy and Zabbix agent;<br>- agentless connections (VMware, SSH, JMX, SNMP, Telnet and simple checks);<br>- HTTP agent connections;<br>- script item JavaScript HTTP requests;<br>- preprocessing JavaScript HTTP requests;<br>- sending notification emails (connections to SMTP server);<br>- webhook notifications (JavaScript HTTP connections);<br>- connections to the Vault| |SSHKeyLocation|no| | |Location of public and private keys for SSH checks and actions| |SSLCertLocation|no| | |Location of SSL client certificate files for client authentication.<br>This parameter is used in web monitoring only.| |SSLKeyLocation|no| | |Location of SSL private key files for client authentication.<br>This parameter is used in web monitoring only.| |SSLCALocation|no| | |Override the location of certificate authority (CA) files for SSL server certificate verification. If not set, system-wide directory will be used.<br>Note that the value of this parameter will be set as libcurl option CURLOPT\_CAPATH. For libcurl versions before 7.42.0, this only has effect if libcurl was compiled to use OpenSSL. For more information see [cURL web page](http://curl.haxx.se/libcurl/c/CURLOPT_CAPATH.html).<br>This parameter is used in web monitoring since Zabbix 2.4.0 and in SMTP authentication since Zabbix 3.0.0.| |StartAlerters|no|1-100|3|Number of pre-forked instances of [alerters](/manual/concepts/server#server_process_types).<br>This parameter is supported since Zabbix 3.4.0.| |StartDBSyncers|no|1-100|4|Number of pre-forked instances of [history syncers](/manual/concepts/server#server_process_types).<br>*Note*: Be careful when changing this value, increasing it may do more harm than good. Roughly, the default value should be enough to handle up to 4000 NVPS.| |StartDiscoverers|no|0-250|1|Number of pre-forked instances of [discoverers](/manual/concepts/server#server_process_types).| |StartEscalators|no|1-100|1|Number of pre-forked instances of [escalators](/manual/concepts/server#server_process_types).<br>This parameter is supported since Zabbix 3.0.0.| |StartHistoryPollers|no|0-1000|5|Number of pre-forked instances of [history pollers](/manual/concepts/server#server_process_types).<br>This parameter is supported since Zabbix 5.4.0.| |StartHTTPPollers|no|0-1000|1|Number of pre-forked instances of [HTTP pollers](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^**.| |StartIPMIPollers|no|0-1000|0|Number of pre-forked instances of [IPMI pollers](/manual/concepts/server#server_process_types).| |StartJavaPollers|no|0-1000|0|Number of pre-forked instances of [Java pollers](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^**.| |StartLLDProcessors|no|1-100|2|Number of pre-forked instances of low-level discovery (LLD) [workers](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^**.<br>The LLD manager process is automatically started when an LLD worker is started.<br>This parameter is supported since Zabbix 4.2.0.| |StartODBCPollers|no|0-1000|1|Number of pre-forked instances of [ODBC pollers](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^**.| |StartPingers|no|0-1000|1|Number of pre-forked instances of [ICMP pingers](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^**.| |StartPollersUnreachable|no|0-1000|1|Number of pre-forked instances of [pollers for unreachable hosts](/manual/concepts/server#server_process_types) (including IPMI and Java)**^[1](zabbix_server#footnotes)^**.<br>At least one poller for unreachable hosts must be running if regular, IPMI or Java pollers are started.| |StartPollers|no|0-1000|5|Number of pre-forked instances of [pollers](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^**.| |StartPreprocessors|no|1-1000|3|Number of pre-forked instances of preprocessing [workers](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^**.<br>The preprocessing manager process is automatically started when a preprocessor worker is started.<br>This parameter is supported since Zabbix 3.4.0.| |StartProxyPollers|no|0-250|1|Number of pre-forked instances of [pollers for passive proxies](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^**.| |StartReportWriters|no|0-100|0|Number of pre-forked instances of [report writers](/manual/concepts/server#server_process_types).<br>If set to 0, scheduled report generation is disabled.<br>The report manager process is automatically started when a report writer is started.<br>This parameter is supported since Zabbix 5.4.0.| |StartSNMPTrapper|no|0-1|0|If set to 1, [SNMP trapper](/manual/concepts/server#server_process_types) process will be started.| |StartTimers|no|1-1000|1|Number of pre-forked instances of [timers](/manual/concepts/server#server_process_types).<br>Timers process maintenance periods.| |StartTrappers|no|0-1000|5|Number of pre-forked instances of [trappers](/manual/concepts/server#server_process_types)**^[1](zabbix_server#footnotes)^**.<br>Trappers accept incoming connections from Zabbix sender, active agents and active proxies.| |StartVMwareCollectors|no|0-250|0|Number of pre-forked [VMware collector](/manual/concepts/server#server_process_types) instances.| |StatsAllowedIP|no| | |List of comma delimited IP addresses, optionally in CIDR notation, or DNS names of external Zabbix instances. Stats request will be accepted only from the addresses listed here. If this parameter is not set no stats requests will be accepted.<br>If IPv6 support is enabled then '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1' are treated equally and '::/0' will allow any IPv4 or IPv6 address. '0.0.0.0/0' can be used to allow any IPv4 address.<br>Example: StatsAllowedIP=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com<br>This parameter is supported since Zabbix 4.2.0.| |Timeout|no|1-30|3|Specifies how long we wait for agent, SNMP device or external check (in seconds).| |TLSCAFile|no| | |Full pathname of a file containing the top-level CA(s) certificates for peer certificate verification, used for encrypted communications between Zabbix components.<br>This parameter is supported since Zabbix 3.0.0.| |TLSCertFile|no| | |Full pathname of a file containing the server certificate or certificate chain, used for encrypted communications between Zabbix components.<br>This parameter is supported since Zabbix 3.0.0.| |TLSCipherAll|no| | |GnuTLS priority string or OpenSSL (TLS 1.2) cipher string. Override the default ciphersuite selection criteria for certificate- and PSK-based encryption.<br>Example: TLS\_AES\_256\_GCM\_SHA384:TLS\_CHACHA20\_POLY1305\_SHA256:TLS\_AES\_128\_GCM\_SHA256<br>This parameter is supported since Zabbix 4.4.7.| |TLSCipherAll13|no| | |Cipher string for OpenSSL 1.1.1 or newer in TLS 1.3. Override the default ciphersuite selection criteria for certificate- and PSK-based encryption.<br>Example for GnuTLS: NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL::+SIGN-ALL:+CTYPE-X.509<br>Example for OpenSSL: EECDH+aRSA+AES128:RSA+aRSA+AES128:kECDHEPSK+AES128:kPSK+AES128<br>This parameter is supported since Zabbix 4.4.7.| |TLSCipherCert|no| | |GnuTLS priority string or OpenSSL (TLS 1.2) cipher string. Override the default ciphersuite selection criteria for certificate-based encryption.<br>Example for GnuTLS: NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL:+CTYPE-X.509<br>Example for OpenSSL: EECDH+aRSA+AES128:RSA+aRSA+AES128<br>This parameter is supported since Zabbix 4.4.7.| |TLSCipherCert13|no| | |Cipher string for OpenSSL 1.1.1 or newer in TLS 1.3. Override the default ciphersuite selection criteria for certificate-based encryption.<br>This parameter is supported since Zabbix 4.4.7.| |TLSCipherPSK|no| | |GnuTLS priority string or OpenSSL (TLS 1.2) cipher string. Override the default ciphersuite selection criteria for PSK-based encryption.<br>Example for GnuTLS: NONE:+VERS-TLS1.2:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL<br>Example for OpenSSL: kECDHEPSK+AES128:kPSK+AES128<br>This parameter is supported since Zabbix 4.4.7.| |TLSCipherPSK13|no| | |Cipher string for OpenSSL 1.1.1 or newer in TLS 1.3. Override the default ciphersuite selection criteria for PSK-based encryption.<br>Example: TLS\_CHACHA20\_POLY1305\_SHA256:TLS\_AES\_128\_GCM\_SHA256<br>This parameter is supported since Zabbix 4.4.7.| |TLSCRLFile|no| | |Full pathname of a file containing revoked certificates. This parameter is used for encrypted communications between Zabbix components.<br>This parameter is supported since Zabbix 3.0.0.| |TLSKeyFile|no| | |Full pathname of a file containing the server private key, used for encrypted communications between Zabbix components.<br>This parameter is supported since Zabbix 3.0.0.| |TmpDir|no| |/tmp|Temporary directory.| |TrapperTimeout|no|1-300|300|Specifies how many seconds trapper may spend processing new data.| |TrendCacheSize|no|128K-2G|4M|Size of trend cache, in bytes.<br>Shared memory size for storing trends data.| |TrendFunctionCacheSize|no|128K-2G|4M|Size of trend function cache, in bytes.<br>Shared memory size for caching calculated trend function data.| |UnavailableDelay|no|1-3600|60|How often host is checked for availability during the [unavailability](/manual/appendix/items/unreachability#unavailable_host) period, in seconds.| |UnreachableDelay|no|1-3600|15|How often host is checked for availability during the [unreachability](/manual/appendix/items/unreachability#unreachable_host) period, in seconds.| |UnreachablePeriod|no|1-3600|45|After how many seconds of [unreachability](/manual/appendix/items/unreachability#unreachable_host) treat a host as unavailable.| |User|no| |zabbix|Drop privileges to a specific, existing user on the system.<br>Only has effect if run as 'root' and AllowRoot is disabled.| |ValueCacheSize|no|0,128K-64G|8M|Size of history value cache, in bytes.<br>Shared memory size for caching item history data requests.<br>Setting to 0 disables value cache (not recommended).<br>When value cache runs out of the shared memory a warning message is written to the server log every 5 minutes.| |VaultDBPath|no| | |Vault path from where credentials for database will be retrieved by keys 'password' and 'username'.<br>Example: secret/zabbix/database<br>This option can only be used if DBUser and DBPassword are not specified.<br>This parameter is supported since Zabbix 5.2.0.| |VaultToken|no| | |Vault authentication token that should have been generated exclusively for Zabbix server with read-only permission to the paths specified in [Vault macros](/manual/config/macros/user_macros#configuration) and read-only permission to the path specified in the optional VaultDBPath configuration parameter.<br>It is an error if VaultToken and VAULT\_TOKEN environment variable are defined at the same time.<br>This parameter is supported since Zabbix 5.2.0.| |VaultURL|no| |https://127.0.0.1:8200|Vault server HTTP\[S\] URL. System-wide CA certificates directory will be used if SSLCALocation is not specified.<br>This parameter is supported since Zabbix 5.2.0.| |VMwareCacheSize|no|256K-2G|8M|Shared memory size for storing VMware data.<br>A VMware internal check zabbix\[vmware,buffer,...\] can be used to monitor the VMware cache usage (see [Internal checks](/manual/config/items/itemtypes/internal)).<br>Note that shared memory is not allocated if there are no vmware collector instances configured to start.| |VMwareFrequency|no|10-86400|60|Delay in seconds between data gathering from a single VMware service.<br>This delay should be set to the least update interval of any VMware monitoring item.| |VMwarePerfFrequency|no|10-86400|60|Delay in seconds between performance counter statistics retrieval from a single VMware service.<br>This delay should be set to the least update interval of any VMware monitoring [item](/manual/config/items/itemtypes/simple_checks/vmware_keys#footnotes) that uses VMware performance counters.| |VMwareTimeout|no|1-300|10|The maximum number of seconds vmware collector will wait for a response from VMware service (vCenter or ESX hypervisor).| |WebServiceURL|no| | |HTTP\[S\] URL to Zabbix web service in the format `<host:port>/report`. For example: `http://localhost:10053/report`<br>This parameter is supported since Zabbix 5.4.0.|  
zh-cn	#### 参数  |参数|必需|范围|默认|说明| |---------|---------|-----|-------|-----------| |AlertScriptsPath | no | |/usr/local/share/zabbix/alertscripts |自定义警报脚本的位置（取决于编译时安装变量*datadir*）| |AllowRoot | no | | 0 |允许服务器以“root”身份运行。如果禁用，并且服务器由“root”启动，服务器将尝试切换到“zabbix”用户。如果在普通用户下启动，则无效<br>0-不允许<br>1-允许| |AllowUnsupportedDBVersions | no | | 0 |允许服务器使用不受支持的数据库版本<br>0-不允许<br>1-允许| |CacheSize | no | 128K-64G | 8M |配置缓存的大小，以字节为单位<br>用于存储主机、项目和触发器数据的共享内存大小| |CacheUpdateFrequency | no | 1-3600 | 60 | Zabbix执行配置缓存更新的频率，以秒为单位<br>另请参见[运行时控制]（/manual/concepts/server#server_process）选项| |DBHost | no | | localhost |数据库主机名<br>如果是MySQL localhost或空字符串，则会导致使用套接字。在PostgreSQL的情况下，只有空字符串会导致尝试使用套接字<br>如果是[Oracle]（/manual/appendix/install/Oracle#connection _set _up）空字符串，则会导致使用网络服务名称连接方法；在这种情况下，考虑使用TNS\AuthAdmin环境变量来指定TNSNAMS的目录。ora文件| |DBName| yes | | |数据库名<br>如果使用[Oracle]（/manual/appendix/install/Oracle#connection_set_up）如果使用了网络服务名称连接方法，请从tnsnames中指定服务名称。或设置为空字符串；如果DBName设置为空字符串，则设置两个\\u任务环境变量| |DBPassword| no | | |数据库密码<br>如果未使用密码，请对此行进行注释| |DBPort | no | 1024-65535 | |数据库端口，不使用本地套接字时<br>如果使用[Oracle]（/manual/appendix/install/Oracle#connection _set _up），如果使用网络服务名称连接方法，该参数将被忽略；tnsnames中的端口号。将使用ora文件| |DBSchema | no | | |模式名称。用于PostgreSQL| |DBSocket | no | | | MySQL套接字文件的路径| |DBUser| no | | |数据库用户| |DBTLSConnect| no | | |设置此选项强制使用TLS连接到数据库：<br>*必需*-使用TLS连接<br>*验证\_ca*-使用TLS连接并验证证书<br>*验证\_完整*-使用TLS连接，验证证书并验证DBHost指定的数据库标识是否与其从5.7.11开始的MySQL和PostgreSQL上的证书相匹配。支持以下值：“必需”、“验证\\u ca”、“验证\\u full”。从10.2.6版开始，MariaDB支持“必需”和“验证\_完整”值<br>默认情况下不设置为任何选项，行为取决于数据库配置<br><br>自Zabbix 5.0.0以来，此参数受支持| |DBTLSCAFile | no <br>（是，如果DBTLSConnect设置为以下之一：verify\_ca，verify\_full）| | |包含用于数据库证书验证的顶级ca证书的文件的完整路径名<br>自Zabbix 5.0.0以来支持此参数| |DBTLSCertFile | no | | | |包含用于对数据库进行身份验证的Zabbix服务器证书的文件的完整路径名<br>自Zabbix 5.0.0以来支持此参数| |DBTLSKeyFile | no | | | |包含用于对数据库进行身份验证的私钥的文件的完整路径名<br>自Zabbix 5.0.0以来支持此参数| |DBTLSCipher | no | | | | | Zabbix服务器通过TLSv1允许TLS协议使用的加密密码列表。2.<br>仅支持MySQL<br>自Zabbix 5.0.0以来支持此参数| |DBTLSCipher13 | no | | | Zabbix服务器允许TLSv1使用的加密密码套件列表。3.协议<br>从8.0.16版开始，仅支持MySQL<br>自Zabbix 5.0.0以来支持此参数| |DebugLevel | no | 0-5 | 3 |指定调试级别：<br>0-关于启动和停止Zabbix进程的基本信息<br>1-关键信息<br>2-错误信息<br>3-警告<br>4-用于调试（产生大量信息）<br>5-扩展调试（产生更多信息）<br>另请参见[运行时控制]（/manual/concepts/server#server_process）选项| |ExportDir | no | | |目录，用于以换行符分隔的JSON格式记录事件、历史和趋势的[实时导出]（/manual/appendix/install/real_-time_-export）。如果设置，则启用实时导出<br>自Zabbix 4.0.0以来支持此参数| |ExportFileSize | no | 1M-1G | 1G |每个导出文件的最大大小（字节）。仅在设置ExportDir时用于旋转<br>自Zabbix 4.0.0以来支持此参数| |ExportType | no | | |用于[实时导出]（/manual/appendix/install/real_-time_-export）（默认情况下所有类型）的逗号分隔实体类型（事件、历史记录、趋势）列表。仅当设置了ExportDir时有效<br>*注意*如果指定了ExportType，但没有指定ExportDir，则这是一个配置错误，服务器将无法启动<br>例如：<br>导出类型=历史、趋势-仅导出历史和趋势<br>导出类型=事件-仅导出事件| |ExternalScripts| no | |/usr/local/share/zabbix/ExternalScripts |外部脚本的位置（取决于编译时安装变量*datadir*）| |Fping6Location|编号| |/usr/sbin/fping6 | fping6的位置<br>确保fping6二进制文件设置了根所有权和SUID标志<br>如果fping实用程序能够处理IPv6地址，则将其设为空（“Fping6Location=“）| |FpingLocation | no | | |/usr/sbin/fping | fping的位置<br>确保fping二进制文件设置了根所有权和SUID标志| |HANodeName | no | | |高可用性集群节点名称<br>清空时，服务器在独立模式下工作，并创建一个名称为空的节点| |HistoryCacheSize | no | 128K-2G | 16M |历史缓存大小，以字节为单位<br>用于存储历史数据的共享内存大小| |HistoryIndexCacheSize | no | 128K-2G | 4M |历史索引缓存的大小，以字节为单位<br>用于索引存储在历史缓存中的历史数据的共享内存大小<br>索引缓存大小大约需要100字节来缓存一个项目<br>自Zabbix 3.0.0以来支持此参数| |HistoryStorageDateIndex | no | | 0 |启用历史存储中历史值的预处理，以根据日期存储不同索引中的值：<br>0-禁用<br>1-启用| |HistoryStorageURL | no | | |历史存储HTTP\[S\]URL<br>此参数用于[Elasticsearch]（/manual/appendix/install/elastic_search_setup）设置| |HistoryStorageTypes | no | | uint、dbl、str、log、text |要发送到历史存储的值类型的逗号分隔列表<br>此参数用于[Elasticsearch]（/manual/appendix/install/elastic_search_setup）设置| |HousekeepingFrequency| no | 0-24 | 1 | Zabbix执行管家程序的频率（小时）<br>内务管理正在从数据库中删除过时的信息<br>*注*：为了防止管家负担过重（例如，当历史和趋势周期大大缩短时），在一个管家周期内，每个项目删除的过期信息不超过管家频率的4倍小时。因此，如果HousekeepingFrequency为1，则每个周期删除的过期信息（从最早的条目开始）不超过4小时<br>*注意*：为了降低服务器启动时的负载，服务器启动后内务管理将延迟30分钟。因此，如果HousekeepingFrequency为1，服务器启动后的第一个内务处理过程将在30分钟后运行，并在此后延迟一小时重复<br>自Zabbix 3.0.0以来，可以通过将HousekeepingFrequency设置为0来禁用自动客房管理。在这种情况下，内务管理程序只能通过*House keeper\\u execute*运行时控制选项启动，一个内务管理周期中删除过期信息的时间是自上一个内务管理周期以来时间的4倍，但不少于4小时，不超过4天<br>另请参见[运行时控制]（/manual/concepts/server#server_process）选项| |Include | no | | | |您可以在配置文件中包含目录中的单个文件或所有文件<br>要仅包括指定目录中的相关文件，模式匹配支持星号通配符。例如：`/absolute/path/to/config/files/*。形态`<br>有关限制，请参见[特别注意事项]（特别注意事项包括）| |JavaGateway | no | | Zabbix Java gateway的IP地址（或主机名）<br>仅当Java轮询器启动时才需要| |JavaGatewayPort | no | 1024-32767 | 10052 | Zabbix Java gateway监听的端口| |ListenBacklog | no | 0-INT\|u MAX | SOMAXCONN | TCP队列中挂起的最大连接数<br>默认值是一个硬编码常量，具体取决于系统<br>支持的最大值取决于系统，过高的值可能会被自动截断为“实现指定的最大值”| |ListenIP | no | | 0.0.0 |陷阱器应该监听的逗号分隔的IP地址列表<br>如果缺少此参数，Trapper将侦听所有网络接口| |ListenPort | no | 1024-32767 | 10051 |捕捉器的侦听端口| |LoadModule | no | | |要在服务器启动时加载的模块。模块用于扩展服务器的功能<br>格式：<br>加载模块=<module。所以><br>加载模块=<path/module。所以><br>加载模块=</abs\\u路径/模块。因此><br>模块必须位于LoadModulePath指定的目录中，或者路径必须位于模块名称之前。如果前面的路径是绝对路径（以“/”开头），则忽略LoadModulePath<br>允许包含多个LoadModule参数| |LoadModulePath | no | | |服务器模块位置的完整路径<br>默认值取决于编译选项| |日志文件| yes ，如果LogType设置为*file*，否则<br>否| | |日志文件的名称| |日志文件大小| no | 0-1024 | 1 |日志文件的最大大小（MB）<br>0-禁用自动日志旋转<br>*注意*：如果达到日志文件大小限制且文件旋转失败，无论出于何种原因，现有日志文件将被截断并重新启动| |日志类型| no |文件|日志输出类型：<br>*文件*-将日志写入日志文件参数指定的文件，<br>*系统*-将日志写入系统日志，<br>*控制台*-将日志写入标准输出<br>自Zabbix 3.0.0以来支持此参数| |LogSlowQueries | no | 0-3600000 | 0 |记录数据库查询可能需要多长时间（毫秒）<br>0-不要记录慢速查询<br>此选项从DebugLevel=3开始启用| |MaxHousekeeperDelete | no | 0-1000000 | 5000 |在一个整理周期内，每个任务将删除不超过“MaxHousekeeperDelete”行（对应于\[tablename\]、\[field\]、\[value\]）<br>如果设置为0，则根本不使用限制。在这种情况下，您必须知道自己在做什么，以免[数据库过载！]（zabbix_服务器#脚注）**^[2]（zabbix_服务器#脚注）^**<br>此参数仅适用于删除已删除项目的历史记录和趋势| |NodeAddress | no | | | | | IP或带有可选端口的主机名，用于覆盖前端应如何连接到服务器<br>格式：<address>\[：port\]<br>前端用于指定服务器地址的地址的优先级为：NodeAddress（1）；ListNip（如果不是0.0.0.0或：）（2）；localhost（默认值）（3）<br>另请参见：HANodeName参数| |PidFile | no | | |/tmp/zabbix\_服务器。pid | pid文件的名称| |ProxyConfigFrequency | no | 1-604800 | 3600 | Zabbix服务器在几秒钟内向Zabbix代理发送配置数据的频率。仅用于被动模式下的代理| |ProxyDataFrequency | no | 1-3600 | 1 | Zabbix服务器从Zabbix代理请求历史数据的频率（秒）。仅用于被动模式下的代理| |snmptrapperpile | no | |/tmp/zabbix\_陷阱。tmp |用于将数据从SNMP陷阱守护程序传递到服务器的临时文件<br>必须与zabbix \\u陷阱\\u接收器中的相同。pl或SNMPTT配置文件| |SocketDir | no | |/tmp |目录，用于存储内部Zabbix服务使用的IPC套接字<br>自Zabbix 3.4.0以来，支持此参数| |SourceIP | no | | |源IP地址：<br>-到Zabbix代理和Zabbix代理的传出连接<br>-无代理连接（VMware、SSH、JMX、SNMP、Telnet和简单检查）<br>-HTTP代理连接<br>-脚本项JavaScript HTTP请求<br>-预处理JavaScript HTTP请求<br>-发送通知电子邮件（连接到SMTP服务器）<br>-webhook通知（JavaScript HTTP连接）<br>-与保险库的连接| |SSHKeyLocation | no | | |用于SSH检查和操作的公钥和私钥的位置| |SSLCertLocation | no | | |用于客户端身份验证的SSL客户端证书文件的位置<br>此参数仅用于网络监控| |SSLKeyLocation | no | | |用于客户端身份验证的SSL私钥文件的位置<br>此参数仅用于网络监控| |SSLCALocation | no | | | |覆盖用于SSL服务器证书验证的证书颁发机构（CA）文件的位置。如果未设置，将使用系统范围的目录<br>请注意，此参数的值将设置为libcurl option CURLOPT\\u CAPATH。对于7.42.0之前的libcurl版本，这仅在libcurl编译为使用OpenSSL时有效。有关更多信息，请参阅[cURL网页](http://curl.haxx.se/libcurl/c/CURLOPT_CAPATH.html).<br>自Zabbix 2.4.0以来，此参数用于web监控，自Zabbix 3.0.0以来，此参数用于SMTP身份验证| |StartAlerters | no | 1-100 | 3 |预分叉的[alerters]实例数（/manual/concepts/server#server#process_type）<br>自Zabbix 3.4.0以来，支持此参数| |StartDBSyncers | no | 1-100 | 4 |预分叉的[历史同步器]（/manual/concepts/server#server#process _type）实例数<br>*注意*：更改此值时要小心，增加此值可能弊大于利。大致来说，默认值应该足以处理多达4000个NVPS| |StartDiscoveryr | no | 0-250 | 1 |预分叉的[发现者]实例数（/manual/concepts/server#server#process_type）| |StartScalators | no | 1-100 | 1 |预分叉的[自动扶梯]实例数（/manual/concepts/server#server#process_type）<br>自Zabbix 3.0.0以来支持此参数| |StartHistoryPollers | no | 0-1000 | 5 |预分叉的[历史轮询器]（/manual/concepts/server#server#process_type）实例数<br>自Zabbix 5.4.0以来，支持此参数| |StartHTTPPollers | no | 0-1000 | 1 |[HTTP轮询器]（/manual/concepts/server#server#process_types）**[1]（zabbix_server#脚注）^**| |StartIPMI轮询器| no | 0-1000 | 0 |预分叉的[IPMI轮询器]（/manual/concepts/server#server#process_type）实例数| |StartJavaPollers | no | 0-1000 | 0 |预分叉的[Java pollers]实例数（/manual/concepts/server#server#process_types）**[1]（zabbix#server#脚注）^**| |startldprocessors | no | 1-100 | 2 |低级发现（LLD）的预分叉实例数[workers]（/manual/concepts/server#server#process_types）**[1]（zabbix#server#脚注）^**<br>启动LLD worker时，LLD manager进程将自动启动<br>自Zabbix 4.2.0以来，支持此参数| |StarToDBPollers | no | 0-1000 | 1 |[ODBC pollers]的预分叉实例数（/manual/concepts/server#server#process_types）**[1]（zabbix#server#脚注）^**| |StartPingers | no | 0-1000 | 1 |[ICMP Pinger]的预分叉实例数（/manual/concepts/server#server#process _types）**[1]（zabbix#server#脚注）^**| |StartPollersUnreachable | no | 0-1000 | 1 |[无法访问主机的轮询器]（/manual/concepts/server#server#process_types）（包括IPMI和Java）**[1]（zabbix#server#脚注）^**<br>如果启动了常规、IPMI或Java轮询器，则必须至少运行一个无法访问主机的轮询器| |StartPollers | no | 0-1000 | 5 |预分叉的[pollers]实例数（/manual/concepts/server#server#process_types）**[1]（zabbix#server#脚注）^**| |StartPreprocessors | no | 1-1000 | 3 |预处理的预分叉实例数[工作者]（/manual/concepts/server#server#process_types）**[1]（zabbix#server#脚注）^**<br>启动预处理器工作程序时，预处理管理器进程将自动启动<br>自Zabbix 3.4.0以来，支持此参数| |StartProxyPollers | no | 0-250 | 1 |[被动代理轮询器]（/manual/concepts/server#server#process_types）**[1]（zabbix#server#脚注）^**| |StartReportWriter | no | 0-100 | 0 |预分叉的[report Writer]实例数（/manual/concepts/server#server#process_type）<br>如果设置为0，则禁用计划报告生成<br>启动报表编写器时，报表管理器进程将自动启动<br>自Zabbix 5.4.0以来，支持此参数| |StartSNMPTrapper | no | 0-1 | 0 |如果设置为1，[SNMP trapper]（/manual/concepts/server#server#process_types）进程将启动| |StartTimers | no | 1-1000 | 1 |预分叉的[Timer]实例数（/manual/concepts/server#server#process_type）<计时器处理维护周期| |StartTrappers | no | 0-1000 | 5 |预分叉的[trappers]实例数（/manual/concepts/server#server#process_type）**[1]（zabbix_server#脚注）^**<br>陷阱器接受来自Zabbix发送方、活动代理和活动代理的传入连接| |StartVMwareCollectors | no | 0-250 | 0 |预分叉的[VMware collector]（/manual/concepts/server#server#process_type）实例数| |StatsAllowedIP | no | | | |以逗号分隔的IP地址列表（可选CIDR表示法）或外部Zabbix实例的DNS名称。只接受此处列出的地址的统计数据请求。如果未设置此参数，则不会接受任何统计数据请求<br>如果启用了IPv6支持，则“127.0.0.1”、“127.0.0.1”、“127:ffff:127.0.0.1”将被同等对待，并且“：：/0”将允许任何IPv4或IPv6地址0.0.0.0/0'可用于允许任何IPv4地址<br>示例：StatsAllowedIP=127.0.0.1192.168.1.0/24，：：12001:db8:：/32，zabbix。实例com<br>自Zabbix 4.2.0以来，支持此参数| |超时| no | 1-30 | 3 |指定我们等待代理、SNMP设备或外部检查的时间（秒）| |TLSCAFile | no | | | |包含顶级CA（s）证书的文件的完整路径名，用于对等证书验证，用于Zabbix组件之间的加密通信<br>自Zabbix 3.0.0以来支持此参数| |TLSCertFile | no | | | |包含服务器证书或证书链的文件的完整路径名，用于Zabbix组件之间的加密通信<br>自Zabbix 3.0.0以来支持此参数| |TLSCipherAll | no | | | GnuTLS优先级字符串或OpenSSL（TLS 1.2）密码字符串。覆盖基于证书和PSK的加密的默认密码套件选择标准<br>示例：TLS\\ U AES\\ U 256\\ U GCM\\ U SHA384:TLS\\ U CHACHA20\\ U POLY1305\\ U SHA256:TLS\\ U AES\\ U 128\\ U GCM\\ U SHA256<br>自Zabbix 4.4.7以来支持此参数| |TLS 1.3中OpenSSL 1.1.1或更新版本的TLSCipherAll13 | no | | | |密码字符串。覆盖基于证书和PSK的加密的默认密码套件选择标准<GNUTL示例：无：+VERS-TLS1。2:+ECDHE-RSA:+RSA:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:：+SIGN-ALL:+CTYPE-X.509<br>OpenSSL示例：EECDH+aRSA+AES128:RSA+AES128:kECDHEPSK+AES128:kPSK+AES128<br>自Zabbix 4.4.7以来，该参数一直受支持| |TLSCipherCert | no | | | | GnuTLS优先级字符串或OpenSSL（TLS 1.2）密码字符串。覆盖基于证书的加密的默认密码套件选择标准<GNUTL示例：无：+VERS-TLS1。2:+ECDHE-RSA:+RSA:+AES-128-GCM:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL:+CTYPE-X.509<br>OpenSSL示例：EECDH+aRSA+AES128:RSA+aRSA+AES128<br>自Zabbix 4.4.7以来，该参数一直受支持| |TLS 1.3中OpenSSL 1.1.1或更新版本的TLSChipherCert13 | no | | | |密码字符串。覆盖基于证书的加密的默认密码套件选择标准<br>自Zabbix 4.4.7以来，支持此参数| |TLSCipherPSK | no | | | GnuTLS优先级字符串或OpenSSL（TLS 1.2）密码字符串。覆盖基于PSK的加密的默认密码套件选择标准<GNUTL示例：无：+VERS-TLS1。2:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL<br>OpenSSL示例：kECDHEPSK+AES128:kPSK+AES128<br>自Zabbix 4.4.7以来，该参数一直受支持| |TLS 1.3中OpenSSL 1.1.1或更新版本的TLSCipherPSK13 | no | | | |密码字符串。覆盖基于PSK的加密的默认密码套件选择标准<br>示例：TLS\\u CHACHA20\\u POLY1305\\u SHA256:TLS\\u AES\\u 128\\u GCM\\u SHA256<br>自Zabbix 4.4.7以来支持此参数| |TLSCRLFile | no | | |包含已吊销证书的文件的完整路径名。此参数用于Zabbix组件之间的加密通信<br>自Zabbix 3.0.0以来支持此参数| |TLSKeyFile | no | | | |包含服务器私钥的文件的完整路径名，用于Zabbix组件之间的加密通信<br>自Zabbix 3.0.0以来支持此参数| |TmpDir | no | |/tmp |临时目录| |TrapperTimeout | no | 1-300 | 300 |指定trapper处理新数据的时间| |TrendCacheSize | no | 128K-2G | 4M |趋势缓存大小，以字节为单位<br>用于存储趋势数据的共享内存大小| |TrendFunctionCacheSize| no | 128K-2G | 4M |趋势函数缓存大小，以字节为单位<br>用于缓存计算的趋势函数数据的共享内存大小| |UnavailableDelay| no | 1-3600 | 60 |在[不可用]（/手册/附录/项目/无法访问#不可用_主机）期间检查主机可用性的频率，以秒为单位| |UnreachableDelay| no | 1-3600 | 15 |在[无法访问]（/手册/附录/项目/无法访问#无法访问_主机）期间检查主机可用性的频率，以秒为单位| |UnreachablePeriod| no | 1-3600 | 45 |在[无法访问]（/手册/附录/项目/无法访问#无法访问|主机）处理主机多少秒后| |User| no | | zabbix |删除系统上特定现有用户的权限<br>仅当“以root身份运行”和AllowRoot被禁用时才有效| |ValueCacheSize | no | 0128K-64G | 8M |历史值缓存的大小，以字节为单位<br>用于缓存项目历史数据请求的共享内存大小<br>设置为0将禁用值缓存（不推荐）<br>当值缓存耗尽共享内存时，每5分钟会向服务器日志写入一条警告消息| |VaultDBPath| no | | | | Vault路径，通过“密码”和“用户名”键从中检索数据库凭据<br>示例：secret/zabbix/database<br>只有在未指定DBUser和DBPassword的情况下，才能使用此选项<br>自Zabbix 5.2.0以来，支持此参数| |VaultToken | no | | | | Vault身份验证令牌，该令牌本应专门为Zabbix服务器生成，对[Vault macros]（/manual/config/macros/user_macros#configuration）中指定的路径具有只读权限，并对可选的VaultDBPath配置参数中指定的路径具有只读权限<br>如果同时定义VAULT TOKEN和VAULT\\u TOKEN环境变量，则会出错<br>自Zabbix 5.2.0以来，支持此参数| |VaultURL| no ||https://127.0.0.1:8200|Vault服务器HTTP\[S\]URL。如果未指定SSLCAPLOCATION，则将使用系统范围的CA证书目录<br>自Zabbix 5.2.0以来，支持此参数| |VMwareCacheSize | no | 256K-2G | 8M |用于存储VMware数据的共享内存大小<br>可以使用VMware内部检查zabbix\[VMware，buffer，…\]来监视VMware缓存的使用情况（请参阅[内部检查]（/manual/config/items/itemtypes/internal））<br>请注意，如果没有配置为启动的vmware collector实例，则不会分配共享内存| |VMwareFrequency | no | 10-86400 | 60 |从单个VMware服务收集数据之间的延迟（秒）<br>此延迟应设置为任何VMware监视项目的最小更新间隔| |VMwarePerfFrequency | no | 10-86400 | 60 |从单个VMware服务检索性能计数器统计数据之间的延迟（秒）<br>此延迟应设置为使用VMware性能计数器的任何VMware monitoring[item]（/manual/config/items/itemtypes/simple_checks/VMware_keys#footnotes）的最小更新间隔| |VMwareTimeout | no | 1-300 | 10 | vmware collector等待vmware服务（vCenter或ESX hypervisor）响应的最长秒数| |WebServiceURL | no | | | HTTP\[S\]URL，以“<host:port>/report”格式指向Zabbix web服务。例如：`http://localhost:10053/report`<br>自Zabbix 5.4.0以来，支持此参数|  