en-us	### Parameters  `(object/array)` Host prototype properties to be updated.  The `hostid` property must be defined for each host prototype, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard host prototype properties](object#host_prototype), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groupLinks|array|Group [links](/manual/api/reference/hostprototype/object#group_link) to replace the current group links on the host prototype.| |groupPrototypes|array|Group [prototypes](/manual/api/reference/hostprototype/object#group_prototype) to replace the existing group prototypes on the host prototype.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to replace the current user macros.<br><br>All macros that are not listed in the request will be removed.| |tags|object/array|Host prototype [tags](/manual/api/reference/hostprototype/object#host_prototype_tag) to replace the current tags.<br><br>All tags that are not listed in the request will be removed.| |interfaces|object/array|Host prototype [custom interfaces](/manual/api/reference/hostprototype/object#custom_interface) to replace the current interfaces.<br><br>Custom interface object should contain all its parameters.<br>All interfaces that are not listed in the request will be removed.| |templates|object/array|[Templates](/manual/api/reference/template/object) to replace the currently linked templates.<br><br>The templates must have the `templateid` property defined.|
zh-cn	### 参数  `(object/array)` 要更新的主机原型属性。  必须为每个主机原型定义`hostid`属性，所有其他属性都是可选的。只有选中的属性将被更新，所有其他的属性将保持不变。 除[标准主机原型属性](object#host_prototype)外, 该方法还接受以下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |groupLinks|队列|替换当前主机原型上的组链接的组[链接](/manual/api/reference/hostprototype/object#group_link)。| |groupPrototypes|数组|替换主机原型上存在的组原型的组[原型](/manual/api/reference/hostprototype/object#group_prototype)。| |macros|对象/数组|替换当前用户宏的[用户宏](/manual/api/reference/usermacro/object)。<br><br>所有未在请求列表中宏将被删除。| |tags|对象/数组|替换当前标签的主机原型[标签](/manual/api/reference/hostprototype/object#host_prototype_tag)。<br><br>所有未在请求列表中的标签将被删除。| |interfaces|对象/数组|替换当前接口的主机原型[自定义接口](/manual/api/reference/hostprototype/object#custom_interface)。<br><br>自定义接口对象包含所有参数。<br>所有未在请求列表中的接口将被删除| |templates|对象/数组|替换当前连接模板中的[模板](/manual/api/reference/template/object)。<br><br>模板中的`templateid`属性必须被定义。|

en-us	### Parameters  `(object/array)` Host prototype properties to be updated.  The `hostid` property must be defined for each host prototype, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard host prototype properties](object#host_prototype), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |groupLinks|array|Group [links](/manual/api/reference/hostprototype/object#group_link) to replace the current group links on the host prototype.| |groupPrototypes|array|Group [prototypes](/manual/api/reference/hostprototype/object#group_prototype) to replace the existing group prototypes on the host prototype.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to replace the current user macros.<br><br>All macros that are not listed in the request will be removed.| |tags|object/array|Host prototype [tags](/manual/api/reference/hostprototype/object#host_prototype_tag) to replace the current tags.<br><br>All tags that are not listed in the request will be removed.| |interfaces|object/array|Host prototype [custom interfaces](/manual/api/reference/hostprototype/object#custom_interface) to replace the current interfaces.<br><br>Custom interface object should contain all its parameters.<br>All interfaces that are not listed in the request will be removed.| |templates|object/array|[Templates](/manual/api/reference/template/object) to replace the currently linked templates.<br><br>The templates must have the `templateid` property defined.|  
zh-cn	### 参数  `(object/array)` 要更新的主机原型属性。  必须为每个主机原型定义`hostid`属性，所有其他属性都是可选的。只有选中的属性将被更新，所有其他的属性将保持不变。 除[标准主机原型属性](object#host_prototype)外, 该方法还接受以下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |groupLinks|队列|替换当前主机原型上的组链接的组[链接](/manual/api/reference/hostprototype/object#group_link)。| |groupPrototypes|数组|替换主机原型上存在的组原型的组[原型](/manual/api/reference/hostprototype/object#group_prototype)。| |macros|对象/数组|替换当前用户宏的[用户宏](/manual/api/reference/usermacro/object)。<br><br>所有未在请求列表中宏将被删除。| |tags|对象/数组|替换当前标签的主机原型[标签](/manual/api/reference/hostprototype/object#host_prototype_tag)。<br><br>所有未在请求列表中的标签将被删除。| |interfaces|对象/数组|替换当前接口的主机原型[自定义接口](/manual/api/reference/hostprototype/object#custom_interface)。<br><br>自定义接口对象包含所有参数。<br>所有未在请求列表中的接口将被删除| |templates|对象/数组|替换当前连接模板中的[模板](/manual/api/reference/template/object)。<br><br>模板中的`templateid`属性必须被定义。|

en-us	### Parameters  `(object/array)` Host prototypes to create.  Additionally to the [standard host prototype properties](object#host_prototype), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**groupLinks**<br>(required)|array|Group [links](/manual/api/reference/hostprototype/object#group_link) to be created for the host prototype.| |**ruleid**<br>(required)|string|ID of the LLD rule that the host prototype belongs to.| |groupPrototypes|array|Group [prototypes](/manual/api/reference/hostprototype/object#group_prototype) to be created for the host prototype.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to be created for the host prototype.| |tags|object/array|Host prototype [tags](/manual/api/reference/hostprototype/object#host_prototype_tag).| |interfaces|object/array|Host prototype [custom interfaces](/manual/api/reference/hostprototype/object#custom_interface).| |templates|object/array|[Templates](/manual/api/reference/template/object) to be linked to the host prototype.<br><br>The templates must have the `templateid` property defined.|
zh-cn	### 参数  `(object/array)` 创建的主机原型  除[标准的主机原型属性](object#host_prototype)外, 该方法接受以下参数:  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |**groupLinks**<br>(必选)|数组|主机原型创建的组 [链接](/manual/api/reference/hostprototype/object#group_link)。| |**ruleid**<br>(必选)|字符串|主机原型所属的LLD规则的ID。| |groupPrototypes|数组|为主机原型创建的组[原型](/manual/api/reference/hostprototype/object#group_prototype)。| |macros|对象/数组|为主机原型创建的[用户宏](/manual/api/reference/usermacro/object)。| |tags|对象/数组|主机原型[标签](/manual/api/reference/hostprototype/object#host_prototype_tag)。| |interfaces|对象/数组|主机原型 [自定义接口](/manual/api/reference/hostprototype/object#custom_interface)。| |templates|对象/数组|连接到主机原型的[模板](/manual/api/reference/template/object)。<br><br>模板必须定义`templateid`属性。|

en-us	### Parameters  `(object/array)` Host prototypes to create.  Additionally to the [standard host prototype properties](object#host_prototype), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**groupLinks**<br>(required)|array|Group [links](/manual/api/reference/hostprototype/object#group_link) to be created for the host prototype.| |**ruleid**<br>(required)|string|ID of the LLD rule that the host prototype belongs to.| |groupPrototypes|array|Group [prototypes](/manual/api/reference/hostprototype/object#group_prototype) to be created for the host prototype.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to be created for the host prototype.| |tags|object/array|Host prototype [tags](/manual/api/reference/hostprototype/object#host_prototype_tag).| |interfaces|object/array|Host prototype [custom interfaces](/manual/api/reference/hostprototype/object#custom_interface).| |templates|object/array|[Templates](/manual/api/reference/template/object) to be linked to the host prototype.<br><br>The templates must have the `templateid` property defined.|
zh-cn	### 参数  `(object/array)` 创建的主机原型  除[标准的主机原型属性](object#host_prototype)外, 该方法接受以下参数:  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |**groupLinks**<br>(必选)|数组|主机原型创建的组 [链接](/manual/api/reference/hostprototype/object#group_link)。| |**ruleid**<br>(必选)|字符串|主机原型所属的LLD规则的ID。| |groupPrototypes|数组|为主机原型创建的组[原型](/manual/api/reference/hostprototype/object#group_prototype)。| |macros|对象/数组|为主机原型创建的[用户宏](/manual/api/reference/usermacro/object)。| |tags|对象/数组|主机原型[标签](/manual/api/reference/hostprototype/object#host_prototype_tag)。| |interfaces|对象/数组|主机原型 [自定义接口](/manual/api/reference/hostprototype/object#custom_interface)。| |templates|对象/数组|连接到主机原型的[模板](/manual/api/reference/template/object)。<br><br>模板必须定义`templateid`属性。|

en-us	### Parameters  `(object/array)` Hosts to create.  Additionally to the [standard host properties](object#host), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**groups**<br>(required)|object/array|Host [groups](/manual/api/reference/hostgroup/object) to add the host to.<br><br>The host groups must have the `groupid` property defined.| |interfaces|object/array|[Interfaces](/manual/api/reference/hostinterface/object) to be created for the host.| |tags|object/array|Host [tags](/manual/api/reference/host/object#host_tag).| |templates|object/array|[Templates](/manual/api/reference/template/object) to be linked to the host.<br><br>The templates must have the `templateid` property defined.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to be created for the host.| |inventory|object|Host [inventory](/manual/api/reference/host/object#host_inventory) properties.|
zh-cn	 ### 参数  `(对象/数组)` 要创建的主机。  另外，对于[标准的主机属性](object#host),该方法接受下列参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |**groups**<br>(必选)|object/array|把主机添加到目标[组](/manual/api/reference/hostgroup/object)。 <br><br>主机组必须已定义 `groupid` 属性。| |interfaces|object/array|为主机创建的[接口](/manual/api/reference/hostinterface/object)。| |tags|object/array|主机[标签](/manual/api/reference/host/object#host_tag)。| |templates|object/array|主机连接的[模板](/manual/api/reference/template/object)。<br><br>模板必须已定义`templateid`属性。| |macros|object/array|为主机创建的[用户宏](/manual/api/reference/usermacro/object)。 |inventory|object|主机[资产清单](/manual/api/reference/host/object#host_inventory)属性。|

en-us	### Parameters  `(object/array)` Hosts to create.  Additionally to the [standard host properties](object#host), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**groups**<br>(required)|object/array|Host [groups](/manual/api/reference/hostgroup/object) to add the host to.<br><br>The host groups must have the `groupid` property defined.| |interfaces|object/array|[Interfaces](/manual/api/reference/hostinterface/object) to be created for the host.| |tags|object/array|Host [tags](/manual/api/reference/host/object#host_tag).| |templates|object/array|[Templates](/manual/api/reference/template/object) to be linked to the host.<br><br>The templates must have the `templateid` property defined.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to be created for the host.| |inventory|object|Host [inventory](/manual/api/reference/host/object#host_inventory) properties.|
zh-cn	 ### 参数  `(对象/数组)` 要创建的主机。  另外，对于[标准的主机属性](object#host),该方法接受下列参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |**groups**<br>(必选)|object/array|把主机添加到目标[组](/manual/api/reference/hostgroup/object)。 <br><br>主机组必须已定义 `groupid` 属性。| |interfaces|object/array|为主机创建的[接口](/manual/api/reference/hostinterface/object)。| |tags|object/array|主机[标签](/manual/api/reference/host/object#host_tag)。| |templates|object/array|主机连接的[模板](/manual/api/reference/template/object)。<br><br>模板必须已定义`templateid`属性。| |macros|object/array|为主机创建的[用户宏](/manual/api/reference/usermacro/object)。 |inventory|object|主机[资产清单](/manual/api/reference/host/object#host_inventory)属性。|

en-us	### Parameters  `(object/array)` Icon map properties to be updated.  The `iconmapid` property must be defined for each icon map, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard icon map properties](object#icon_map), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |mappings|array|[Icon mappings](/manual/api/reference/iconmap/object#icon_mapping) to replace the existing icon mappings.|
zh-cn	 ### 参数  `(object/array)` 要更新的图标映射的属性。  每个图标映射的 `iconmapid` 属性都必需被定义，所有其它属性都是可选的。只有传递的属性会被更新，其余的都会保持不变。  除了[标准的图标映射属性](object#icon_map)之外，此方法还接受以下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |----|---------------------------------------------------|----| |**mappings**<br>（必需）|数组|用来替换现有图标映射关系的[图标映射](/manual/api/reference/iconmap/object#icon_mapping)。|

en-us	### Parameters  `(object/array)` Icon map properties to be updated.  The `iconmapid` property must be defined for each icon map, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard icon map properties](object#icon_map), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |mappings|array|[Icon mappings](/manual/api/reference/iconmap/object#icon_mapping) to replace the existing icon mappings.|
zh-cn	 ### 参数  `(object/array)` 要更新的图标映射的属性。  每个图标映射的 `iconmapid` 属性都必需被定义，所有其它属性都是可选的。只有传递的属性会被更新，其余的都会保持不变。  除了[标准的图标映射属性](object#icon_map)之外，此方法还接受以下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |----|---------------------------------------------------|----| |**mappings**<br>（必需）|数组|用来替换现有图标映射关系的[图标映射](/manual/api/reference/iconmap/object#icon_mapping)。|

en-us	### Parameters  `(object/array)` Icon maps to create.  Additionally to the [standard icon map properties](object#icon_map), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**mappings**<br>(required)|array|[Icon mappings](/manual/api/reference/iconmap/object#icon_mapping) to be created for the icon map.|
zh-cn	### 参数  `(object/array)` 要创建的图标映射。  除了[标准的图标映射属性](object#icon_map)之外，此方法还接受以下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |----|---------------------------------------------------|----| |**mappings**<br>（必需）|数组|为图标映射创建的[多个图标映射关系（icon mappings）](/manual/api/reference/iconmap/object#icon_mapping)。|

en-us	### Parameters  `(object/array)` Icon maps to create.  Additionally to the [standard icon map properties](object#icon_map), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**mappings**<br>(required)|array|[Icon mappings](/manual/api/reference/iconmap/object#icon_mapping) to be created for the icon map.|
zh-cn	### 参数  `(object/array)` 要创建的图标映射。  除了[标准的图标映射属性](object#icon_map)之外，此方法还接受以下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |----|---------------------------------------------------|----| |**mappings**<br>（必需）|数组|为图标映射创建的[多个图标映射关系（icon mappings）](/manual/api/reference/iconmap/object#icon_mapping)。|

en-us	### Parameters  `(object/array)` Image properties to be updated.  The `imageid` property must be defined for each image, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard image properties](object#image), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |image|string|Base64 encoded image. The maximum size of the encoded image is 1 MB. Maximum size can be adjusted by changing ZBX\_MAX\_IMAGE\_SIZE constant value.<br>Supported image formats are: PNG, JPEG, GIF.|
zh-cn	### 参数  `(object/array)` 更新的目标图像属性。  每个图象都必须定义 `imageid` 属性，其余属性为可选项。只有传递的属性将被更新，其他属性保持不变。  除了 [标准图像属性](object#图像) ，该方法同样适用以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |image|string|Base64 类型编码图像。图像大小的最大限制为 1 MB。可以通过更改 ZBX_MAX_IMAGE_size 常量来调整最大限制值。<br>支持的图像格式有：PNG、JPEG、GIF。|

en-us	### Parameters  `(object/array)` Image properties to be updated.  The `imageid` property must be defined for each image, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard image properties](object#image), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |image|string|Base64 encoded image. The maximum size of the encoded image is 1 MB. Maximum size can be adjusted by changing ZBX\_MAX\_IMAGE\_SIZE constant value.<br>Supported image formats are: PNG, JPEG, GIF.|
zh-cn	### 参数  `(object/array)` 更新的目标图像属性。  每个图象都必须定义 `imageid` 属性，其余属性为可选项。只有传递的属性将被更新，其他属性保持不变。  除了 [标准图像属性](object#图像) ，该方法同样适用以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |image|string|Base64 类型编码图像。图像大小的最大限制为 1 MB。可以通过更改 ZBX_MAX_IMAGE_size 常量来调整最大限制值。<br>支持的图像格式有：PNG、JPEG、GIF。|

en-us	### Parameters  `(object/array)` Images to create.  Additionally to the [standard image properties](object#image), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**name**<br>(required)|string|Name of the image.| |**imagetype**<br>(required)|integer|Type of image.<br><br>Possible values:<br>1 - *(default)* icon;<br>2 - background image.| |**image**<br>(required)|string|Base64 encoded image. The maximum size of the encoded image is 1 MB. Maximum size can be adjusted by changing ZBX\_MAX\_IMAGE\_SIZE constant value.<br>Supported image formats are: PNG, JPEG, GIF.|
zh-cn	### 参数  `(object/array)` 创建的目标图像。  除了 [标准图像属性](object#图像) 之外，此方法同样适用以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |**name**<br>（必需）|string|图像名称。| |**imagetype**<br>（必需）|integer|图像类型。<br><br>可用类型：<br>1 - *(默认)* icon；<br>2 - background image。| |**image**<br>（必需）|string|Base64 类型编码图像。图像大小的最大限制为 1 MB。可以通过更改 ZBX_MAX_IMAGE_size 常量来调整最大限制值。<br>支持的图像格式有：PNG、JPEG、GIF。|

en-us	### Parameters  `(object/array)` Images to create.  Additionally to the [standard image properties](object#image), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**name**<br>(required)|string|Name of the image.| |**imagetype**<br>(required)|integer|Type of image.<br><br>Possible values:<br>1 - *(default)* icon;<br>2 - background image.| |**image**<br>(required)|string|Base64 encoded image. The maximum size of the encoded image is 1 MB. Maximum size can be adjusted by changing ZBX\_MAX\_IMAGE\_SIZE constant value.<br>Supported image formats are: PNG, JPEG, GIF.|
zh-cn	### 参数  `(object/array)` 创建的目标图像。  除了 [标准图像属性](object#图像) 之外，此方法同样适用以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |**name**<br>（必需）|string|图像名称。| |**imagetype**<br>（必需）|integer|图像类型。<br><br>可用类型：<br>1 - *(默认)* icon；<br>2 - background image。| |**image**<br>（必需）|string|Base64 类型编码图像。图像大小的最大限制为 1 MB。可以通过更改 ZBX_MAX_IMAGE_size 常量来调整最大限制值。<br>支持的图像格式有：PNG、JPEG、GIF。|

en-us	### Parameters  `(object/array)` Item properties to be updated.  The `itemid` property must be defined for each item, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard item properties](object#item), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |preprocessing|array|[Item preprocessing](/manual/api/reference/item/object#item_preprocessing) options to replace the current preprocessing options.| |tags|array|Item [tags.](/manual/api/reference/item/object#item_tag)|
zh-cn	### 说明  `(object/array)` 监控项目标更新属性.  每个监控项都必须定义 `itemid` 属性，其余属性为可选项。仅传递的属性将被更新，所有其他属性将保持不变。  除了 [标准监控项属性](object#item) 之外，此方法同样适用以下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|说明| |---------|---------------------------------------------------|-----------| |preprocessing|array|[监控项预处理](/manual/api/reference/item/object#item_preprocessing) 用于替换当前预处理选项。| |tags|array|[标签](/manual/api/reference/item/object#item_tag) 用于替换当前标签。|

en-us	### Parameters  `(object/array)` Item properties to be updated.  The `itemid` property must be defined for each item, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard item properties](object#item), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |preprocessing|array|[Item preprocessing](/manual/api/reference/item/object#item_preprocessing) options to replace the current preprocessing options.| |tags|array|Item [tags.](/manual/api/reference/item/object#item_tag)|
zh-cn	### 说明  `(object/array)` 监控项目标更新属性.  每个监控项都必须定义 `itemid` 属性，其余属性为可选项。仅传递的属性将被更新，所有其他属性将保持不变。  除了 [标准监控项属性](object#item) 之外，此方法同样适用以下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|说明| |---------|---------------------------------------------------|-----------| |preprocessing|array|[监控项预处理](/manual/api/reference/item/object#item_preprocessing) 用于替换当前预处理选项。| |tags|array|[标签](/manual/api/reference/item/object#item_tag) 用于替换当前标签。|

en-us	### Parameters  `(object/array)` Item prototype properties to be updated.  The `itemid` property must be defined for each item prototype, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard item prototype properties](object#item_prototype), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |preprocessing|array|Item prototype [preprocessing](/manual/api/reference/itemprototype/object#item_prototype_preprocessing) options to replace the current preprocessing options.| |tags|array|Item prototype [tags](/manual/api/reference/itemprototype/object#item_prototype_tag).|
zh-cn	### 参数  `(object/array)`要更新的监控项的属性。  每个的监控项的`itemid`属性必须被定义，其他属性可选。只有被传递的属性才会更新，其他所有属性保持不变。  另外见[标准监控项原型](object#监控项)，此方法接受如下参数。  |参数|类型|描述| |---------|----|-----------| |applications|array| 要替换当前应用的应用的ID。| |preprocessing|array|要替换的当前监控项预处理选项。|

en-us	### Parameters  `(object/array)` Item prototype properties to be updated.  The `itemid` property must be defined for each item prototype, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard item prototype properties](object#item_prototype), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |preprocessing|array|Item prototype [preprocessing](/manual/api/reference/itemprototype/object#item_prototype_preprocessing) options to replace the current preprocessing options.| |tags|array|Item prototype [tags](/manual/api/reference/itemprototype/object#item_prototype_tag).|
zh-cn	### 参数  `(object/array)`要更新的监控项的属性。  每个的监控项的`itemid`属性必须被定义，其他属性可选。只有被传递的属性才会更新，其他所有属性保持不变。  另外见[标准监控项原型](object#监控项)，此方法接受如下参数。  |参数|类型|描述| |---------|----|-----------| |applications|array| 要替换当前应用的应用的ID。| |preprocessing|array|要替换的当前监控项预处理选项。|

en-us	### Parameters  `(object/array)` Item prototype to create.  Additionally to the [standard item prototype properties](object#item_prototype), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**ruleid**<br>(required)|string|ID of the LLD rule that the item belongs to.| |preprocessing|array|Item prototype [preprocessing](/manual/api/reference/itemprototype/object#item_prototype_preprocessing) options.| |tags|array|Item prototype [tags](/manual/api/reference/itemprototype/object#item_prototype_tag).|
zh-cn	### 参数  `(object/array)` 需要创建的监控项原型。  除[标准监控项原型](属性#监控项原型)外，该方法还接受以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |**ruleid**<br>(required)|string|监控项所属的LLD规则ID| |preprocessing|array|监控项原型[预处理](/manual/api/reference/itemprototype/object#监控项原型预处理) 选项。| |tags|array|监控项原型[标签](/manual/api/reference/itemprototype/object#监控项原型标签)。|

en-us	### Parameters  `(object/array)` Item prototype to create.  Additionally to the [standard item prototype properties](object#item_prototype), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**ruleid**<br>(required)|string|ID of the LLD rule that the item belongs to.| |preprocessing|array|Item prototype [preprocessing](/manual/api/reference/itemprototype/object#item_prototype_preprocessing) options.| |tags|array|Item prototype [tags](/manual/api/reference/itemprototype/object#item_prototype_tag).|
zh-cn	### 参数  `(object/array)` 需要创建的监控项原型。  除[标准监控项原型](属性#监控项原型)外，该方法还接受以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |**ruleid**<br>(required)|string|监控项所属的LLD规则ID| |preprocessing|array|监控项原型[预处理](/manual/api/reference/itemprototype/object#监控项原型预处理) 选项。| |tags|array|监控项原型[标签](/manual/api/reference/itemprototype/object#监控项原型标签)。|

en-us	### Parameters  `(object/array)` Items to create.  Additionally to the [standard item properties](object#host), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |preprocessing|array|Item [preprocessing](/manual/api/reference/item/object#item_preprocessing) options.| |tags|array|Item [tags.](/manual/api/reference/item/object#item_tag)|
zh-cn	### 参数  `(object/array)` 创建目标监控项。  除了 [标准监控项属性](object#host) 之外，此方法同样适用以下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|说明| |---------|---------------------------------------------------|-----------| |preprocessing|array|监控项 [预处理](/manual/api/reference/item/object#item_preprocessing) 选项。| |tags|array|监控项 [标签](/manual/api/reference/item/object#item_tag) 。|

en-us	### Parameters  `(object/array)` Items to create.  Additionally to the [standard item properties](object#host), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |preprocessing|array|Item [preprocessing](/manual/api/reference/item/object#item_preprocessing) options.| |tags|array|Item [tags.](/manual/api/reference/item/object#item_tag)|
zh-cn	### 参数  `(object/array)` 创建目标监控项。  除了 [标准监控项属性](object#host) 之外，此方法同样适用以下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|说明| |---------|---------------------------------------------------|-----------| |preprocessing|array|监控项 [预处理](/manual/api/reference/item/object#item_preprocessing) 选项。| |tags|array|监控项 [标签](/manual/api/reference/item/object#item_tag) 。|

en-us	### Parameters  `(object/array)` Maintenance properties to be updated.  The `maintenanceid` property must be defined for each maintenance, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard maintenance properties](object#maintenance), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |groupids|array|IDs of the host groups to replace the current groups.| |hostids|array|IDs of the hosts to replace the current hosts.| |timeperiods|array|Maintenance [time periods](/manual/api/reference/maintenance/object#time_period) to replace the current periods.| |tags|array|[Problem tags](/manual/api/reference/maintenance/object#problem_tag).|  ::: noteimportant At least one host or host group must be defined for each maintenance. :::  
zh-cn	### Parameters 参数  `(object/array)` Maintenance properties to be updated. `(object/array)`要更新的维护模式的属性。  The `maintenanceid` property must be defined for each maintenance, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. 每一个维护模式的`maintenanceid`属性必须被定义，其他所有属性均为可选。只有被传递的属性才会被更新，所有它属性保持不变。  Additionally to the [standard maintenance properties](object#maintenance), the method accepts the following parameters. 另外见[standard maintenance properties](/zh/object#maintenance),此方法接受如下参数。  |Parameter|Type|Description| |---------|----|-----------| |groupids|array|IDs of the host groups to replace the current groups. 要替换的当前主机组的主机组IDs。| |hostids|array|IDs of the hosts to replace the current hosts. 要替换当前主机的主机IDs。| |timeperiods|array|Maintenance time periods to replace the current periods. 要替换当前维护模式时间周期的时间周期。|  ::: noteimportant At least one host or host group must be defined for each maintenance. 每一个维护模式至少一个主机或者一个主机组被定义。 :::  

en-us	### Parameters  `(object/array)` Maintenance properties to be updated.  The `maintenanceid` property must be defined for each maintenance, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard maintenance properties](object#maintenance), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groups|object/array|Host [groups](/manual/api/reference/hostgroup/object) to replace the current groups.<br><br>The host groups must have the `groupid` property defined.| |hosts|object/array|[Hosts](/manual/api/reference/host/object) to replace the current hosts.<br><br>The hosts must have the `hostid` property defined.| |timeperiods|object/array|Maintenance [time periods](/manual/api/reference/maintenance/object#time_period) to replace the current periods.| |tags|object/array|[Problem tags](/manual/api/reference/maintenance/object#problem_tag) to replace the current tags.| |groupids<br>(deprecated)|array|This parameter is deprecated, please use `groups` instead.<br>IDs of the host groups that will undergo maintenance.| |hostids<br>(deprecated)|array|This parameter is deprecated, please use `hosts` instead.<br>IDs of the hosts that will undergo maintenance.|  ::: noteimportant At least one host or host group must be defined for each maintenance. :::
zh-cn	### 参数  `(object/array)`要更新的维护模式的属性。  每一个维护模式的`maintenanceid`属性必须被定义，其他所有属性均为可选。只有被传递的属性才会被更新，所有它属性保持不变。  另外参见[标准维护属性](/zh/object#maintenance),此方法接受如下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |----|----|----| |groups|object/array|主机 [主机组](/manual/api/reference/hostgroup/object) 以替换当前组。<br><br>主机组必须定义 `groupid` 属性。| |hosts|object/array|[主机](/manual/api/reference/host/object) 以替换当前主机。<br><br>主机必须定义 `hostid` 属性。| |timeperiods|object/array|维护 [时间段](/manual/api/reference/maintenance/object#time_period) 替换当前周期。| |tags|object/array|[问题标签](/manual/api/reference/maintenance/object#problem_tag) 替换当前标签。| |groupids<br>（已弃用）|array|此参数已弃用，请改用“groups”。<br>将进行维护的主机组的 ID。| |hostids<br>（已弃用）|array|此参数已弃用，请改用“hosts”。<br>将进行维护的主机的 ID。|  ::: 提示 每一个维护模式至少一个主机或者一个主机组被定义。 :::

en-us	### Parameters  `(object/array)` Maintenances to create.  Additionally to the [standard maintenance properties](object#maintenance), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**groupids**<br>(required)|array|IDs of the host groups that will undergo maintenance.| |**hostids**<br>(required)|array|IDs of the hosts that will undergo maintenance.| |**timeperiods**<br>(required)|array|Maintenance [time periods](/manual/api/reference/maintenance/object#time_period).| |tags|array|[Problem tags](/manual/api/reference/maintenance/object#problem_tag).<br><br>Define what problems must be suppressed.<br>If no tags are given, all active maintenance host problems will be suppressed.|  ::: noteimportant At least one host or host group must be defined for each maintenance. :::  
zh-cn	### Parameters 参数  `(object/array)` Maintenances to create.  `(object/array)`要创建的维护模式。  Additionally to the [standard maintenance properties](object#maintenance), the method accepts the following parameters. 另外见[standard maintenance properties](object#maintenance)，此方法接受如下参数。  |Parameter|Type|Description| |---------|----|-----------| |**groupids**<br>(required)|array|IDs of the host groups that will undergo maintenance. 要执行维护模式的主机组IDs。| |**hostids**<br>(required)|array|IDs of the hosts that will undergo maintenance. 要执行维护模式的主机的IDs。| |**timeperiods**<br>(required)|array|Maintenance time periods. 维护模式时间周期。|  ::: noteimportant At least one host or host group must be defined for each maintenance.每个维护模式至少一个主机或主机组被定义。 :::  

en-us	### Parameters  `(object/array)` Maintenances to create.  Additionally to the [standard maintenance properties](object#maintenance), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groups|object/array|Host [groups](/manual/api/reference/hostgroup/object) that will undergo maintenance.<br><br>The host groups must have the `groupid` property defined.<br><br>At least one object of `groups` or `hosts` must be specified.| |hosts|object/array|[Hosts](/manual/api/reference/host/object) that will undergo maintenance.<br><br>The hosts must have the `hostid` property defined.<br><br>At least one object of `groups` or `hosts` must be specified.| |**timeperiods**<br>(required)|object/array|Maintenance [time periods](/manual/api/reference/maintenance/object#time_period).| |tags|object/array|[Problem tags](/manual/api/reference/maintenance/object#problem_tag).<br><br>Define what problems must be suppressed.<br>If no tags are given, all active maintenance host problems will be suppressed.| |groupids<br>(deprecated)|array|This parameter is deprecated, please use `groups` instead.<br>IDs of the host groups that will undergo maintenance.| |hostids<br>(deprecated)|array|This parameter is deprecated, please use `hosts` instead.<br>IDs of the hosts that will undergo maintenance.|
zh-cn	### 参数  `(object/array)`要创建的维护模式。   另外见[标准维护属性](object#维护模式)，此方法接受如下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|----|-----------| |groups|对象/数组|主机 [组](/manual/api/reference/hostgroup/object) 将进行维护。<br><br>主机组必须定义“groupid”属性。<br>< br>必须指定至少一个 `主机组` 或 `主机` 对象。| |hosts|对象/数组|[主机](/manual/api/reference/host/object) 将进行维护。<br><br>主机必须定义“hostid”属性。<br><br> 至少必须指定 `主机组` 或 `主机` 中的一个对象。| |**时间段**<br>（必需）|对象/数组|维护[时间段](/manual/api/reference/maintenance/object#time_period)。| |tags|对象/数组|[问题标签](/manual/api/reference/maintenance/object#problem_tag)。<br><br>定义必须抑制的问题。<br>如果没有给出标签，则所有活动的维护主机问题都将被抑制。| |groupids<br>（已弃用）|数组|此参数已弃用，请改用“groups”。<br>将进行维护的主机组的 ID。| |hostids<br>（已弃用）|数组|此参数已弃用，请改用“hosts”。<br>将进行维护的主机的 ID。|

en-us	### Parameters  `(object/array)` Map properties to be updated.  The `mapid` property must be defined for each map, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard map properties](object#map), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |links|array|Map [links](/manual/api/reference/map/object#map_link) to replace the existing links.| |selements|array|Map [elements](/manual/api/reference/map/object#map_element) to replace the existing elements.| |urls|array|Map [URLs](/manual/api/reference/map/object#map_url) to replace the existing URLs.| |users|array|Map [user](/manual/api/reference/map/object#map_user) shares to replace the existing elements.| |userGroups|array|Map [user group](/manual/api/reference/map/object#map_user_group) shares to replace the existing elements.| |shapes|array|Map [shapes](/manual/api/reference/map/object#map_shapes) to replace the existing shapes.| |lines|array|Map [lines](/manual/api/reference/map/object#map_lines) to replace the existing lines.|  ::: notetip To create map links between new map elements you'll need to set an element's `selementid` to an arbitrary value and then use this value to reference this element in the links `selementid1` or `selementid2` properties. When the element is created, this value will be replaced with the correct ID generated by Zabbix. [See example for map.create.](create#create_a_host_map) :::
zh-cn	### 参数  `(object/array)` 要更新的拓扑图属性。  必须为每个地图定义“mapid”属性，所有其他属性是可选的。只有传递的属性会被更新，所有其他的将保持不变。  除了 [标准地图属性](object#map)，该方法 接受以下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|说明| |---------|---------------------------------------------------|-----------| |links|array|Map [links](/manual/api/reference/map/object#map_link) 来替换现有的链接。| |selements|array|Map [elements](/manual/api/reference/map/object#map_element) 替换现有元素。| |urls|array|拓扑图 [URLs](/manual/api/reference/map/object#map_url) 以替换现有的 URL。| |users|array|Map [user](/manual/api/reference/map/object#map_user) 共享以替换现有元素。| |userGroups|array|拓扑图 [用户组](/manual/api/reference/map/object#map_user_group) 共享以替换现有元素。| |shapes|array|Map [shapes](/manual/api/reference/map/object#map_shapes) 来替换现有的形状。| |lines|array|Map [lines](/manual/api/reference/map/object#map_lines) 来替换现有的行。|  :::noteclassic 要创建地图链接，您需要将地图元素 selementid 设置为任意值，然后使用此值在链接 selementid1 或 selementid2 属性中引用此元素。 创建元素时，该值将替换为 Zabbix 生成的正确 ID, [参考](create#create_a_host_map) :::

en-us	### Parameters  `(object/array)` Map properties to be updated.  The `mapid` property must be defined for each map, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard map properties](object#map), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |links|array|Map [links](/manual/api/reference/map/object#map_link) to replace the existing links.| |selements|array|Map [elements](/manual/api/reference/map/object#map_element) to replace the existing elements.| |urls|array|Map [URLs](/manual/api/reference/map/object#map_url) to replace the existing URLs.| |users|array|Map [user](/manual/api/reference/map/object#map_user) shares to replace the existing elements.| |userGroups|array|Map [user group](/manual/api/reference/map/object#map_user_group) shares to replace the existing elements.| |shapes|array|Map [shapes](/manual/api/reference/map/object#map_shapes) to replace the existing shapes.| |lines|array|Map [lines](/manual/api/reference/map/object#map_lines) to replace the existing lines.|  ::: notetip To create map links between new map elements you'll need to set an element's `selementid` to an arbitrary value and then use this value to reference this element in the links `selementid1` or `selementid2` properties. When the element is created, this value will be replaced with the correct ID generated by Zabbix. [See example for map.create.](create#create_a_host_map) :::
zh-cn	### 参数  `(object/array)` 要更新的拓扑图属性。  必须为每个地图定义“mapid”属性，所有其他属性是可选的。只有传递的属性会被更新，所有其他的将保持不变。  除了 [标准地图属性](object#map)，该方法 接受以下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|说明| |---------|---------------------------------------------------|-----------| |links|array|Map [links](/manual/api/reference/map/object#map_link) 来替换现有的链接。| |selements|array|Map [elements](/manual/api/reference/map/object#map_element) 替换现有元素。| |urls|array|拓扑图 [URLs](/manual/api/reference/map/object#map_url) 以替换现有的 URL。| |users|array|Map [user](/manual/api/reference/map/object#map_user) 共享以替换现有元素。| |userGroups|array|拓扑图 [用户组](/manual/api/reference/map/object#map_user_group) 共享以替换现有元素。| |shapes|array|Map [shapes](/manual/api/reference/map/object#map_shapes) 来替换现有的形状。| |lines|array|Map [lines](/manual/api/reference/map/object#map_lines) 来替换现有的行。|  :::noteclassic 要创建地图链接，您需要将地图元素 selementid 设置为任意值，然后使用此值在链接 selementid1 或 selementid2 属性中引用此元素。 创建元素时，该值将替换为 Zabbix 生成的正确 ID, [参考](create#create_a_host_map) :::

en-us	### Parameters  `(object/array)` Maps to create.  Additionally to the [standard map properties](object#map), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |links|array|Map [links](/manual/api/reference/map/object#map_link) to be created on the map.| |selements|array|Map [elements](/manual/api/reference/map/object#map_element) to be created on the map.| |urls|array|Map [URLs](/manual/api/reference/map/object#map_url) to be created on the map.| |users|array|Map [user](/manual/api/reference/map/object#map_user) shares to be created on the map.| |userGroups|array|Map [user group](/manual/api/reference/map/object#map_user_group) shares to be created on the map.| |shapes|array|Map [shapes](/manual/api/reference/map/object#map_shapes) to be created on the map.| |lines|array|Map [lines](/manual/api/reference/map/object#map_lines) to be created on the map.|  ::: notetip To create map links you'll need to set a map element `selementid` to an arbitrary value and then use this value to reference this element in the links `selementid1` or `selementid2` properties. When the element is created, this value will be replaced with the correct ID generated by Zabbix. [See example.](create#create_a_host_map) :::
zh-cn	### 参数  `(object/array)` 要创建的拓扑图。  除了[标准拓扑图](object#map)属性外，该方法还接受以下参数  |参数|[类型](/manual/api/reference_commentary#data_types)|说明| |---------|---------------------------------------------------|-----------| |links|array|要在拓扑图上创建的拓扑图 [links](/manual/api/reference/map/object#map_link)。| |selements|array|要在拓扑图上创建的拓扑图 [元素](/manual/api/reference/map/object#map_element)。| |urls|array|要在拓扑图上创建的拓扑图 [URLs](/manual/api/reference/map/object#map_url)。| |users|array|要在拓扑图上创建的拓扑图共享 [user](/manual/api/reference/map/object#map_user) 。| |userGroups|array|要在拓扑图上创建的拓扑图 [用户组](/manual/api/reference/map/object#map_user_group) 共享。| |shapes|array|要在拓扑图上创建的拓扑图 [shapes](/manual/api/reference/map/object#map_shapes)。| |lines|array|要在拓扑图上创建的拓扑图 [lines](/manual/api/reference/map/object#map_lines)。|  :::noteclassic 要创建地图链接，您需要将地图元素 selementid 设置为任意值，然后使用此值在链接 selementid1 或 selementid2 属性中引用此元素。 创建元素时，该值将替换为 Zabbix 生成的正确 ID, [参考](create#create_a_host_map) :::

en-us	### Parameters  `(object/array)` Maps to create.  Additionally to the [standard map properties](object#map), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |links|array|Map [links](/manual/api/reference/map/object#map_link) to be created on the map.| |selements|array|Map [elements](/manual/api/reference/map/object#map_element) to be created on the map.| |urls|array|Map [URLs](/manual/api/reference/map/object#map_url) to be created on the map.| |users|array|Map [user](/manual/api/reference/map/object#map_user) shares to be created on the map.| |userGroups|array|Map [user group](/manual/api/reference/map/object#map_user_group) shares to be created on the map.| |shapes|array|Map [shapes](/manual/api/reference/map/object#map_shapes) to be created on the map.| |lines|array|Map [lines](/manual/api/reference/map/object#map_lines) to be created on the map.|  ::: notetip To create map links you'll need to set a map element `selementid` to an arbitrary value and then use this value to reference this element in the links `selementid1` or `selementid2` properties. When the element is created, this value will be replaced with the correct ID generated by Zabbix. [See example.](create#create_a_host_map) :::
zh-cn	### 参数  `(object/array)` 要创建的拓扑图。  除了[标准拓扑图](object#map)属性外，该方法还接受以下参数  |参数|[类型](/manual/api/reference_commentary#data_types)|说明| |---------|---------------------------------------------------|-----------| |links|array|要在拓扑图上创建的拓扑图 [links](/manual/api/reference/map/object#map_link)。| |selements|array|要在拓扑图上创建的拓扑图 [元素](/manual/api/reference/map/object#map_element)。| |urls|array|要在拓扑图上创建的拓扑图 [URLs](/manual/api/reference/map/object#map_url)。| |users|array|要在拓扑图上创建的拓扑图共享 [user](/manual/api/reference/map/object#map_user) 。| |userGroups|array|要在拓扑图上创建的拓扑图 [用户组](/manual/api/reference/map/object#map_user_group) 共享。| |shapes|array|要在拓扑图上创建的拓扑图 [shapes](/manual/api/reference/map/object#map_shapes)。| |lines|array|要在拓扑图上创建的拓扑图 [lines](/manual/api/reference/map/object#map_lines)。|  :::noteclassic 要创建地图链接，您需要将地图元素 selementid 设置为任意值，然后使用此值在链接 selementid1 或 selementid2 属性中引用此元素。 创建元素时，该值将替换为 Zabbix 生成的正确 ID, [参考](create#create_a_host_map) :::

en-us	### Parameters  `(object/array)` Media type properties to be updated.  The `mediatypeid` property must be defined for each media type, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard media type properties](object#media_type), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |parameters|array|[Webhook parameters](object#webhook_parameters) to replace the current webhook parameters.| |message\_templates|array|[Message templates](object#message_template) to replace the current message templates.|
zh-cn	### 参数  `(object/array)` 需要被更新的媒介类型属性。  必须为每种媒介类型定义`mediatypeid`属性，其他所有属性都是可选的。只有传递的属性会被更新，其他所有的都将保持不变。  除了[标准媒介类型属性](object#媒介类型)外，此方法还接受以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |parameters|array|[Webhook 参数](object#webhook-参数) 用于替换当前的 webhook 参数。| |message\_templates|array|[消息模板](object#消息模板) 用于替换当前的消息模板。|

en-us	### Parameters  `(object/array)` Media type properties to be updated.  The `mediatypeid` property must be defined for each media type, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard media type properties](object#media_type), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |parameters|array|[Webhook parameters](object#webhook_parameters) to replace the current webhook parameters.| |message\_templates|array|[Message templates](object#message_template) to replace the current message templates.|
zh-cn	### 参数  `(object/array)` 需要被更新的媒介类型属性。  必须为每种媒介类型定义`mediatypeid`属性，其他所有属性都是可选的。只有传递的属性会被更新，其他所有的都将保持不变。  除了[标准媒介类型属性](object#媒介类型)外，此方法还接受以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |parameters|array|[Webhook 参数](object#webhook-参数) 用于替换当前的 webhook 参数。| |message\_templates|array|[消息模板](object#消息模板) 用于替换当前的消息模板。|

en-us	### Parameters  `(object/array)` Media types to create.  Additionally to the [standard media type properties](object#media_type), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |parameters|array|[Webhook parameters](object#webhook_parameters) to be created for the media type.| |message\_templates|array|[Message templates](object#message_template) to be created for the media type.|
zh-cn	### 参数  ` `(object/array)` 需要创建的媒介类型。  除了[标准媒介类型属性](object#媒介类型)外，该方法还接受以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |parameters|array|要为媒体类型创建的 [Webhook 参数](object#webhook-参数) 。| |message\_templates|array|为媒体类型创建的[消息模板](object#消息模板) 。|

en-us	### Parameters  `(object/array)` Media types to create.  Additionally to the [standard media type properties](object#media_type), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |parameters|array|[Webhook parameters](object#webhook_parameters) to be created for the media type.| |message\_templates|array|[Message templates](object#message_template) to be created for the media type.|
zh-cn	### 参数  ` `(object/array)` 需要创建的媒介类型。  除了[标准媒介类型属性](object#媒介类型)外，该方法还接受以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |parameters|array|要为媒体类型创建的 [Webhook 参数](object#webhook-参数) 。| |message\_templates|array|为媒体类型创建的[消息模板](object#消息模板) 。|

en-us	### Parameters  `(object/array)` Parameters containing the IDs of the events and update operations that should be performed.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**eventids**<br>(required)|string/object|IDs of the events to acknowledge.| |**action**<br>(required)|integer|Event update action(s). This is bitmask field, any combination of values is acceptable.<br><br>Possible values:<br>1 - close problem;<br>2 - acknowledge event;<br>4 - add message;<br>8 - change severity;<br>16 - unacknowledge event.| |message|string|Text of the message.<br>**Required**, if action contains 'add message' flag.| |severity|integer|New severity for events.<br>**Required**, if action contains 'change severity' flag.<br><br>Possible values:<br>0 - not classified;<br>1 - information;<br>2 - warning;<br>3 - average;<br>4 - high;<br>5 - disaster.|
zh-cn	### 参数  `(object/array)` 参数包含事件的 ID 和  和应该执行的更新操作。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |**eventids**<br>(必填)|string/object|要确认的事件的 ID。| |**action**<br>(必填)|integer|事件更新操作。这是位掩码字段，可以接受任何值组合。<br><br>可用值：<br>1 - 关闭问题；<br>2 - 确认事件；<br>4 - 添加消息；<br>8 - 更改严重性；<br>16 - 取消确认事件。| |message|string|消息的文本。<br>如果操作包含“添加消息”标志，则该字段**必填**。| |severity|integer|事件的新严重性。<br>如果操作包含“更改严重性”标志，则该字段 **必填**。<br><br>可用值：<br>0 - 未分类；<br>1 - 信息；<br>2 - 警告；<br>3 - 一般严重；<br>4 - 严重；<br>5 - 灾难。|

en-us	### Parameters  `(object/array)` Parameters containing the IDs of the events and update operations that should be performed.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**eventids**<br>(required)|string/object|IDs of the events to acknowledge.| |**action**<br>(required)|integer|Event update action(s). This is bitmask field, any combination of values is acceptable.<br><br>Possible values:<br>1 - close problem;<br>2 - acknowledge event;<br>4 - add message;<br>8 - change severity;<br>16 - unacknowledge event.| |message|string|Text of the message.<br>**Required**, if action contains 'add message' flag.| |severity|integer|New severity for events.<br>**Required**, if action contains 'change severity' flag.<br><br>Possible values:<br>0 - not classified;<br>1 - information;<br>2 - warning;<br>3 - average;<br>4 - high;<br>5 - disaster.|
zh-cn	### 参数  `(object/array)` 参数包含事件的 ID 和  和应该执行的更新操作。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |**eventids**<br>(必填)|string/object|要确认的事件的 ID。| |**action**<br>(必填)|integer|事件更新操作。这是位掩码字段，可以接受任何值组合。<br><br>可用值：<br>1 - 关闭问题；<br>2 - 确认事件；<br>4 - 添加消息；<br>8 - 更改严重性；<br>16 - 取消确认事件。| |message|string|消息的文本。<br>如果操作包含“添加消息”标志，则该字段**必填**。| |severity|integer|事件的新严重性。<br>如果操作包含“更改严重性”标志，则该字段 **必填**。<br><br>可用值：<br>0 - 未分类；<br>1 - 信息；<br>2 - 警告；<br>3 - 一般严重；<br>4 - 严重；<br>5 - 灾难。|

en-us	### Parameters  `(object/array)` Proxies to create.  Additionally to the [standard proxy properties](object#proxy), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hosts|array|[Hosts](/manual/api/reference/host/object) to be monitored by the proxy. If a host is already monitored by a different proxy, it will be reassigned to the current proxy.<br><br>The hosts must have the `hostid` property defined.| |interface|object|Host [interface](/manual/api/reference/hostinterface/object) to be created for the passive proxy.<br><br>Required for passive proxies.|
zh-cn	### 参数  `(object/array)` 创建proxy。  除了[标准proxy属性](object#proxy)，该方法还接受以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |hosts|array|由proxy监视的主机。如果一个主机已经被另一个代理监视，那么它将被重新分配给当前proxy。<br><br>此主机必须拥有`hostid`属性。| |interface|object|创建主机接口用于被动proxy。<br><br>被动proxy是必需的。|

en-us	### Parameters  `(object/array)` Proxies to create.  Additionally to the [standard proxy properties](object#proxy), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |hosts|array|[Hosts](/manual/api/reference/host/object) to be monitored by the proxy. If a host is already monitored by a different proxy, it will be reassigned to the current proxy.<br><br>The hosts must have the `hostid` property defined.| |interface|object|Host [interface](/manual/api/reference/hostinterface/object) to be created for the passive proxy.<br><br>Required for passive proxies.|
zh-cn	### 参数  `(object/array)` 创建proxy。  除了[标准proxy属性](object#proxy)，该方法还接受以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |hosts|array|由proxy监视的主机。如果一个主机已经被另一个代理监视，那么它将被重新分配给当前proxy。<br><br>此主机必须拥有`hostid`属性。| |interface|object|创建主机接口用于被动proxy。<br><br>被动proxy是必需的。|

en-us	### Parameters  `(object/array)` Proxy properties to be updated.  The `proxyid` property must be defined for each proxy, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard proxy properties](object#proxy), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hosts|array|[Hosts](/manual/api/reference/host/object) to be monitored by the proxy. If a host is already monitored by a different proxy, it will be reassigned to the current proxy.<br><br>The hosts must have the `hostid` property defined.| |interface|object|Host [interface](/manual/api/reference/hostinterface/object) to replace the existing interface for the passive proxy.|
zh-cn	### 参数  `(object/array)`待更新的proxy属性。  每个proxy必须定义`proxyid`属性，其他的所有属性都是可选的。只有传递的属性将被更新，其他的所有属性将保持不变。  除了[标准proxy属性](object#proxy)，该方法还接受以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |hosts|array|proxy监视的[主机](/manual/api/reference/host/object)。如果主机已被其他proxy监控，则会将其重新分配给当前proxy。<br><br> 主机必须定义`hostid`属性。| |interface|object|主机[接口](/manual/api/reference/hostinterface/object)替换被动proxy的现有接口。|

en-us	### Parameters  `(object/array)` Proxy properties to be updated.  The `proxyid` property must be defined for each proxy, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard proxy properties](object#proxy), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |hosts|array|[Hosts](/manual/api/reference/host/object) to be monitored by the proxy. If a host is already monitored by a different proxy, it will be reassigned to the current proxy.<br><br>The hosts must have the `hostid` property defined.| |interface|object|Host [interface](/manual/api/reference/hostinterface/object) to replace the existing interface for the passive proxy.|
zh-cn	### 参数  `(object/array)`待更新的proxy属性。  每个proxy必须定义`proxyid`属性，其他的所有属性都是可选的。只有传递的属性将被更新，其他的所有属性将保持不变。  除了[标准proxy属性](object#proxy)，该方法还接受以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |hosts|array|proxy监视的[主机](/manual/api/reference/host/object)。如果主机已被其他proxy监控，则会将其重新分配给当前proxy。<br><br> 主机必须定义`hostid`属性。| |interface|object|主机[接口](/manual/api/reference/hostinterface/object)替换被动proxy的现有接口。|

en-us	### Parameters  `(object/array)` Role properties to be updated.  The `roleid` property must be defined for each role, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard role properties](object#role) the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |rules|array|Access [rules](object#role_rules) to replace the current access rules assigned to the role.|
zh-cn	### 参数  `(object/array)` 要更新的职责属性。  The `reportid` 该属性为必要配置参数，需要为每个规划报告定义，其它属性则为可选配置。只有符合要求的属性更改才会更新，其它属性则会保持不变。  除此之外，根据[标准规划报告属性](object#report)，该方法接受如下参数。   |参数|[类型](zh/manual/api/reference_commentary#data_types)|说明| |---------|---------------------------------------------------|-----------| |rules|数组|将当前赋予该职责用户的访问规则修改为新的访问[规则](object#role_rules)。|

en-us	### Parameters  `(object/array)` Role properties to be updated.  The `roleid` property must be defined for each role, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard role properties](object#role) the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |rules|array|Access [rules](object#role_rules) to replace the current access rules assigned to the role.|
zh-cn	### 参数  `(object/array)` 要更新的职责属性。  The `reportid` 该属性为必要配置参数，需要为每个规划报告定义，其它属性则为可选配置。只有符合要求的属性更改才会更新，其它属性则会保持不变。  除此之外，根据[标准规划报告属性](object#report)，该方法接受如下参数。   |参数|[类型](zh/manual/api/reference_commentary#data_types)|说明| |---------|---------------------------------------------------|-----------| |rules|数组|将当前赋予该职责用户的访问规则修改为新的访问[规则](object#role_rules)。|

en-us	### Parameters  `(object/array)` Roles to create.  Additionally to the [standard role properties](object#role), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |rules|array|Role [rules](object#role_rules) to be created for the role.|
zh-cn	### 参数  `(object/array)` 要创建的角色用户。  除此之外，根据[标准用户角色特性](object#role), 该方式接受下列参数配置。  |参数|[类型](zh/manual/api/reference_commentary#data_types)|说明| |---------|---------------------------------------------------|-----------| |rules|数组|角色 [角色规则](object#role_rules)用于创建新的角色用户。|

en-us	### Parameters  `(object/array)` Roles to create.  Additionally to the [standard role properties](object#role), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |rules|array|Role [rules](object#role_rules) to be created for the role.|
zh-cn	### 参数  `(object/array)` 要创建的角色用户。  除此之外，根据[标准用户角色特性](object#role), 该方式接受下列参数配置。  |参数|[类型](zh/manual/api/reference_commentary#data_types)|说明| |---------|---------------------------------------------------|-----------| |rules|数组|角色 [角色规则](object#role_rules)用于创建新的角色用户。|

en-us	### Parameters  `(object/array)` [Script properties](object#script) to be updated.  The `scriptid` property must be defined for each script, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. An exception is `type` property change from 5 (Webhook) to other: the `parameters` property will be cleaned.
zh-cn	### 参数 `(object/array)` 待更新的[脚本属性](object#脚本) 。 所有脚本必须定义`scriptid`属性，其他所有属性都是可选的。只有被传递的属性会被更新，其他所有属性保持不变。例外是`type`属性会从5（Webhook）变成其他：`parameters`属性会被清除。

en-us	### Parameters  `(object/array)` Scripts to create.  The method accepts scripts with the [standard script properties](/manual/api/reference/script/object#script).
zh-cn	### 参数  `(对象/数组)` 要创建的脚本。  此方法接受具有[标准脚本属性](/manual/api/reference/script/object#脚本)的脚本。

en-us	### Parameters  `(object/array)` service properties to be updated.  The `serviceid` property must be defined for each service, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard service properties](object#service), the method accepts the following parameters.  | Parameter     | [Type](/manual/api/reference_commentary#data_types) | Description                                                                                                             | |---------------|-----------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------| | children      | array                                               | Child services to replace the current service children.<br><br>The children must have the `serviceid` property defined. | | parents       | array                                               | Parent services to replace the current service parents.<br><br>The parents must have the `serviceid` property defined.  | | tags          | array                                               | Service [tags](/manual/api/reference/service/object#service_tag) to replace the current service tags.                   | | problem\_tags | array                                               | [Problem tags](/manual/api/reference/service/object#problem_tag) to replace the current problem tags.                   | | status\_rules | array                                               | [Status rules](/manual/api/reference/service/object#status_rule) to replace the current status rules.                   |
zh-cn	 ### 参数  `(对象/数组)` 要更新的服务属性。  每个服务必须定义`serviceid`属性，其他所有的属性都是可选。只有被传入的属性会被更新，其他将保持不变。  除了[标准 服务 属性](object#服务)，此方法允许以下参数。  | 参数     | [类型](/manual/api/reference_commentary#数据_类型) | 描述                                                                                                             | |---------------|-----------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------| | children      | array                                               | 取代当前子服务的子服务。<br><br>子服务必须定义`serviceid`属性。 | | parents       | array                                               | 取代当前父服务的父服务。<br><br>父服务必须定义`serviceid`属性。  | | tags          | array                                               | 取代当前服务标记的服务[标签](/manual/api/reference/service/object#服务_标记)。                   | | problem\_tags | array                                               | 取代当前问题标记的[问题 标签](/manual/api/reference/service/object#问题_标记)。                   | | status\_rules | array                                               | 取代当前状态规则的[状态 规则](/manual/api/reference/service/object#状态_规则)。                   |

en-us	### Parameters  `(object/array)` service properties to be updated.  The `serviceid` property must be defined for each service, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard service properties](object#service), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |children|array|Child services to replace the current service children.<br><br>The children must have the `serviceid` property defined.| |parents|array|Parent services to replace the current service parents.<br><br>The parents must have the `serviceid` property defined.| |tags|array|Service [tags](/manual/api/reference/service/object#service_tag) to replace the current service tags.| |times|array|Service [times](/manual/api/reference/service/object#service_time) to replace the current service times.| |problem\_tags|array|[Problem tags](/manual/api/reference/service/object#problem_tag) to replace the current problem tags.| |status\_rules|array|[Status rules](/manual/api/reference/service/object#status_rule) to replace the current status rules.|  
zh-cn	### Parameters 参数  `(object/array)` service properties to be updated. `(object/array)`需要更新的服务属性。 The `serviceid` property must be defined for each service, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. 必须为每个服务定义`serviceid`属性，所有其他属性为可选项。只有通过的属性会被更新，所有其他属性将保持不变。 Additionally to the [standard service properties](object#service), the method accepts the following parameters. 除[standard service properties](object#service)之外，该方法接受以下参数。  |Parameter 参数   T|pe 类型       Des|ription 说明| |--------------------|-------------------|--------------| |dependencies|array 数组      S|rvice dependencies to replace the current service dependencies. 用来替换当前内容的服务依赖关系。<br><br>Each service dependency has the following parameters: 每个服务依赖项具有以下参数：<br>- `dependsOnServiceid` - *(string 字符串)* ID of an service the service depends on, that is, the child service. 依赖服务的服务，即子服务的ID。<br>- `soft` - *(integer 整数型)* type of service dependency; 服务依赖类型；refer to the [service dependency object page](object#service_dependency) for more information on dependency types. 有关依赖关系类型的更多信息，请参阅[service dependency object page](object#service_dependency)。| |parentid|string 字符串   ID|of a hard-linked parent service. 硬链接的父服务ID。| |times|array 数组      S|rvice times to replace the current service times. 用来替换当前内容的服务时间。|  

en-us	### Parameters  `(object/array)` services to create.  Additionally to the [standard service properties](object#service), the method accepts the following parameters.  | Parameter     | [Type](/manual/api/reference_commentary#data_types) | Description                                                                                                 | |---------------|-----------------------------------------------------|-------------------------------------------------------------------------------------------------------------| | children      | array                                               | Child services to be linked to the service.<br><br>The children must have the `serviceid` property defined. | | parents       | array                                               | Parent services to be linked to the service.<br><br>The parents must have the `serviceid` property defined. | | tags          | array                                               | Service [tags](/manual/api/reference/service/object#service_tag) to be created for the service.             | | problem\_tags | array                                               | [Problem tags](/manual/api/reference/service/object#problem_tag) to be created for the service.             | | status\_rules | array                                               | [Status rules](/manual/api/reference/service/object#status_rule) to be created for the service.             |
zh-cn	 ### 参数  `(对象/数组)` 要创建的服务。  除了 [标准服务属性](object#服务)，此方法接受如下参数。  | 参数     | [类型](/manual/api/reference_commentary#数据_类型) | 描述 |                                                   |---------------|-----------------------------------------------------|-------------------------------------------------------------------------------------------------------------| | children      | array  | 与服务相关联的子服务<br><br>子服务必须有已定义的`serviceid`属性。 | | parents       | array  | 与服务相关联的父服务<br><br>父服务必须有已定义的`serviceid`属性。 | | tags| array  | 服务待创建的服务[标记](/manual/api/reference/service/object#服务_标记)。 | | problem\_tags|array| 服务待创建的[问题 标记](/manual/api/reference/service/object#问题_标记)。|       | status\_rules | array  | 服务待创建的[状态 规则](/manual/api/reference/service/object#状态_规则)。|          

en-us	### Parameters  `(object/array)` services to create.  Additionally to the [standard service properties](object#service), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |children|array|Child services to be linked to the service.<br><br>The children must have the `serviceid` property defined.| |parents|array|Parent services to be linked to the service.<br><br>The parents must have the `serviceid` property defined.| |tags|array|Service [tags](/manual/api/reference/service/object#service_tag) to be created for the service.| |times|array|Service [times](/manual/api/reference/service/object#service_time) to be created for the service.| |problem\_tags|array|[Problem tags](/manual/api/reference/service/object#problem_tag) to be created for the service.| |status\_rules|array|[Status rules](/manual/api/reference/service/object#status_rule) to be created for the service.|  
zh-cn	### Parameters 参数  `(object/array)` services to create. `(object/array)`创建服务。  Additionally to the [standard service properties](object#service), the method accepts the following parameters. 除[standard service properties](object#service)之外，该方法接受以下参数。  |Parameter 参数   T|pe 类型       Des|ription 说明| |--------------------|-------------------|--------------| |dependencies|array 数组      S|rvice dependencies. 服务依赖。<br><br>Each service dependency has the following parameters: 每个服务依赖项具有以下参数:<br>- `dependsOnServiceid` - *(string 字符串)* ID of an service the service depends on, that is, the child service. 被子服务依赖的服务ID。<br>- `soft` - *(integer 整数型)* type of service dependency; refer to the [service dependency object page](object#service_dependency) for more information on dependency types. 有关依赖关系类型的更多信息，请参阅[service dependency object page](object#service_dependency)| |parentid|string 字符串   ID|of a hard-linked parent service. 硬链接的父服务的ID。| |times|array 数组      S|rvice times to be created for the service. 为服务创建的服务时间。|  

en-us	### Parameters  `(object/array)` SLA objects to create.  Additionally to the [standard SLA properties](object#sla), the method accepts the following parameters.  | Parameter                      | [Type](/manual/api/reference_commentary#data_types) | Description                                                                                                                                 | |--------------------------------|-----------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------| | **service_tags**<br>(required) | array                                               | SLA service tags to be created for the SLA.<br>At least one service tag must be specified.                                                  | | schedule                       | array                                               | SLA schedule to be created for the SLA.<br>Specifying an empty parameter will be interpreted as a 24x7 schedule.<br>Default: 24x7 schedule. | | excluded_downtimes             | array                                               | SLA excluded downtimes to be created for the SLA.                                                                                           |
zh-cn	### 参数  `(object/array)` 要创建的SLA对象  除了 [标准SLA 属性](object#sla), 该方法接受以下参数  | 参数| [类型](/manual/api/reference_commentary#data_types) | Description                                                                                                                                 | |--------------------------------|-----------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------| | **service_tags**<br>(必选) | 数组|为SLA创建的SLA服务标签.<br>必须指定至少一个服务标签                                         | | schedule                       | 数组| 为SLA创建SLA计划.<br>指定空参数将被解释为24x7计划<br>默认: 24x7 计划。 | | excluded_downtimes             | 数组|SLA排除了为SLA创建的停机时间                                                                                        |

en-us	### Parameters  `(object/array)` SLA properties to be updated.  The `slaid` property must be defined for each SLA, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard SLA properties](object#sla), the method accepts the following parameters.  | Parameter           | [Type](/manual/api/reference_commentary#data_types) | Description                                                                                                                                                            | |---------------------|-----------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | service\_tags       | array                                               | SLA [service tags](/manual/api/reference/sla/object#sla-service-tag) to replace the current SLA service tags.<br><br>At least one service tag must be specified.       | | schedule            | array                                               | SLA [schedule](/manual/api/reference/sla/object#sla-schedule) to replace the current one.<br><br>Specifying parameter as empty will be interpreted as a 24x7 schedule. | | excluded\_downtimes | array                                               | SLA [excluded downtimes](/manual/api/reference/sla/object#sla-excluded-downtime) to replace the current ones.                                                          |
zh-cn	### 参数  `(object/array)` SLA属性将被更新  必须为每个 SLA 定义 `slaid` 属性，所有其他属性是可选的。只有传递的属性会被更新，所有其他的将保持不变。  除了 [标准 SLA 属性](object#sla)，方法接受以下参数。  | 参数           | [类型](/manual/api/reference_commentary#data_types) | 描述| |---------------------|-----------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | service\_tags       | 数组|SLA [服务标签](/manual/api/reference/sla/object#sla-service-tag) 替换当前的 SLA 服务标签。<br><br>必须至少指定一个服务标签。   | | schedule            | 数组|SLA [schedule](/manual/api/reference/sla/object#sla-schedule) 替换当前的。<br><br>将参数指定为空将被解释为 24x7 计划。 | | excluded\_downtimes | 数组|SLA [排除停机时间](/manual/api/reference/sla/object#sla-excluded-downtime) 替换当前的。                                   |

en-us	### Parameters  `(object/array)` Template dashboard properties to be updated.  The `dashboardid` property must be specified for each dashboard, all other properties are optional. Only the specified properties will be updated.  Additionally to the [standard template dashboard properties](object#template_dashboard), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |pages|array|Template dashboard [pages](object#template_dashboard_page) to replace the existing dashboard pages.<br><br>Dashboard pages are updated by the `dashboard_pageid` property. New dashboard pages will be created for objects without `dashboard_pageid` property and the existing dashboard pages will be deleted if not reused. Dashboard pages will be ordered in the same order as specified. Only the specified properties of the dashboard pages will be updated. At least one dashboard page object is required for `pages` property.|
zh-cn	### 参数  `(object/array)` 要更新的模板仪表盘属性。  必须为每个仪表盘指定`dashboardid`属性，其他所有属性都是可选的。只会更新指定的属性。  除了[标准模版仪表盘属性](object#template_dashboard)外，该方法还接受以下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |--|--|------| |pages|array|模板仪表盘[页面](object#template_dashboard_page)以替换现有仪表盘页面。<br><br>仪表盘页面按`dashboard_pageid`属性更新。将为没有`dashboard_pageid`属性的对象创建新的仪表盘页面，如果不重用，现有的仪表盘页面将被删除。仪表盘页面将按指定的顺序排序。只会更新仪表盘页面的指定属性。`pages`属性至少需要一个仪表盘页面对象。|

en-us	### Parameters  `(object/array)` Template dashboards to create.  Additionally to the [standard template dashboard properties](object#template_dashboard), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**pages**<br>(required)|array|Template dashboard [pages](object#dashboard_page) to be created for the dashboard. Dashboard pages will be ordered in the same order as specified. At least one dashboard page object is required for `pages` property.|
zh-cn	### 参数  `(object/array)` 要创建的模板仪表盘。  除了 [标准模板仪表盘属性](object#template_dashboard)外，该方法还接受以下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |**pages**<br>(必须)|array| 要为仪表盘创建的模板仪表盘[页面](object#dashboard_page)。仪表盘页面按指定的顺序排序。`pages`属性至少需要一个仪表盘页面对象。|

en-us	### Parameters  `(object/array)` Template dashboards to create.  Additionally to the [standard template dashboard properties](object#template_dashboard), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**pages**<br>(required)|array|Template dashboard [pages](object#dashboard_page) to be created for the dashboard. Dashboard pages will be ordered in the same order as specified. At least one dashboard page object is required for `pages` property.|
zh-cn	### 参数  `(object/array)` 要创建的模板仪表盘。  除了 [标准模板仪表盘属性](object#template_dashboard)外，该方法还接受以下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |**pages**<br>(必须)|array| 要为仪表盘创建的模板仪表盘[页面](object#dashboard_page)。仪表盘页面按指定的顺序排序。`pages`属性至少需要一个仪表盘页面对象。|

en-us	### Parameters  `(object/array)` Template properties to be updated.  The `templateid` property must be defined for each template, all other properties are optional. Only the given properties will be updated, all others will remain unchanged.  Additionally to the [standard template properties](object#template), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groups|object/array|Host [groups](/manual/api/reference/hostgroup/object) to replace the current host groups the templates belong to.<br><br>The host groups must have the `groupid` property defined.| |tags|object/array|Template [tags](/manual/api/reference/template/object#template_tag) to replace the current template tags.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to replace the current user macros on the given templates.| |templates|object/array|[Templates](/manual/api/reference/template/object) to replace the currently linked templates. Templates that are not passed are only unlinked.<br><br>The templates must have the `templateid` property defined.| |templates\_clear|object/array|[Templates](/manual/api/reference/template/object) to unlink and clear from the given templates.<br><br>The templates must have the `templateid` property defined.|
zh-cn	### 参数  `(object/array)` 要更新的模板属性。  必须为每个模板定义`templateid`属性，其他所有属性都是可选的。只有给定的属性将被更新，所有其他属性将保持不变。  除了[标准模版属性](object#template)，该方法接受以下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |groups|object/array|用于替换模板所属的当前主机组的主机[群组](/manual/api/reference/hostgroup/object)。<br><br>主机组必须定义`groupid`属性。| |tags|object/array|替换当前模板标记的模板[标签](/manual/api/reference/template/object#template_tag)。| |macros|object/array|用户宏替换给定模板上的当前[用户宏](/manual/api/reference/usermacro/object)。| |templates|object/array|替换当前链接的模板的[模版](/manual/api/reference/template/object)。未传递的模板仅被取消链接。<br><br>模板必须定义`templateid`属性。| |templates\_clear|object/array|取消链接并清除给定模板的[模版](/manual/api/reference/template/object)。<br><br>模板必须定义`templateid`属性。|

en-us	### Parameters  `(object/array)` Template properties to be updated.  The `templateid` property must be defined for each template, all other properties are optional. Only the given properties will be updated, all others will remain unchanged.  Additionally to the [standard template properties](object#template), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |groups|object/array|Host [groups](/manual/api/reference/hostgroup/object) to replace the current host groups the templates belong to.<br><br>The host groups must have the `groupid` property defined.| |tags|object/array|Template [tags](/manual/api/reference/template/object#template_tag) to replace the current template tags.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to replace the current user macros on the given templates.| |templates|object/array|[Templates](/manual/api/reference/template/object) to replace the currently linked templates. Templates that are not passed are only unlinked.<br><br>The templates must have the `templateid` property defined.| |templates\_clear|object/array|[Templates](/manual/api/reference/template/object) to unlink and clear from the given templates.<br><br>The templates must have the `templateid` property defined.|
zh-cn	### 参数  `(object/array)` 要更新的模板属性。  必须为每个模板定义`templateid`属性，其他所有属性都是可选的。只有给定的属性将被更新，所有其他属性将保持不变。  除了[标准模版属性](object#template)，该方法接受以下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |groups|object/array|用于替换模板所属的当前主机组的主机[群组](/manual/api/reference/hostgroup/object)。<br><br>主机组必须定义`groupid`属性。| |tags|object/array|替换当前模板标记的模板[标签](/manual/api/reference/template/object#template_tag)。| |macros|object/array|用户宏替换给定模板上的当前[用户宏](/manual/api/reference/usermacro/object)。| |templates|object/array|替换当前链接的模板的[模版](/manual/api/reference/template/object)。未传递的模板仅被取消链接。<br><br>模板必须定义`templateid`属性。| |templates\_clear|object/array|取消链接并清除给定模板的[模版](/manual/api/reference/template/object)。<br><br>模板必须定义`templateid`属性。|

en-us	### Parameters  `(object/array)` Templates to create.  Additionally to the [standard template properties](object#template), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**groups**<br>(required)|object/array|Host [groups](/manual/api/reference/hostgroup/object) to add the template to.<br><br>The host groups must have the `groupid` property defined.| |tags|object/array|Template [tags](/manual/api/reference/template/object#template_tag).| |templates|object/array|[Templates](/manual/api/reference/template/object) to be linked to the template.<br><br>The templates must have the `templateid` property defined.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to be created for the template.|
zh-cn	### 参数  `(object/array)` 创建模版。  除了[标准模板属性](object#template)之外，该方法还接受以下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |**groups**<br>(必须)|object/array|将模版添加到主机 [群组](/manual/api/reference/hostgroup/object)。<br><br>主机群组必须定义`groupid` 属性。| |tags|object/array|模版 [标签](/manual/api/reference/template/object#template_tag).| |templates|object/array|[模版](/manual/api/reference/template/object) 要链接到模版。<br><br>模板必须定义`templateid`属性。| |macros|object/array|要为模版创建的[用户宏](/manual/api/reference/usermacro/object) 。|

en-us	### Parameters  `(object/array)` Templates to create.  Additionally to the [standard template properties](object#template), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**groups**<br>(required)|object/array|Host [groups](/manual/api/reference/hostgroup/object) to add the template to.<br><br>The host groups must have the `groupid` property defined.| |tags|object/array|Template [tags](/manual/api/reference/template/object#template_tag).| |templates|object/array|[Templates](/manual/api/reference/template/object) to be linked to the template.<br><br>The templates must have the `templateid` property defined.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to be created for the template.|
zh-cn	### 参数  `(object/array)` 创建模版。  除了[标准模板属性](object#template)之外，该方法还接受以下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |**groups**<br>(必须)|object/array|将模版添加到主机 [群组](/manual/api/reference/hostgroup/object)。<br><br>主机群组必须定义`groupid` 属性。| |tags|object/array|模版 [标签](/manual/api/reference/template/object#template_tag).| |templates|object/array|[模版](/manual/api/reference/template/object) 要链接到模版。<br><br>模板必须定义`templateid`属性。| |macros|object/array|要为模版创建的[用户宏](/manual/api/reference/usermacro/object) 。|

en-us	### Parameters  `(object/array)` Token properties to be updated.  The `tokenid` property must be defined for each token, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  The method accepts tokens with the [standard token properties](object).
zh-cn	### 参数  `(object/array)` 要更新的令牌属性。  必须为每个令牌定义 `tokenid` 属性，所有其他属性都是可选的。只有被传递的属性会被更新，所有其他的将保持不变。  此方法接受具有[标准的令牌属性](object)的的令牌。

en-us	### Parameters  `(object/array)` Tokens to create.  The method accepts tokens with the [standard token properties](object).
zh-cn	### 参数  `(object/array)` 要创建的令牌。  此方法接受令牌带有规范的令牌属性[standard token properties](object)。

en-us	### Parameters  `(object/array)` Trigger dependencies to create.  Each trigger dependency has the following parameters:  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**triggerid**<br>(required)|string|ID of the dependent trigger.| |**dependsOnTriggerid**<br>(required)|string|ID of the trigger that the trigger depends on.|
zh-cn	### 参数  `(object/array)` 需要创建的触发器依赖.  每一个触发器依赖具有以下参数:  | 参数                             | [类型](/manual/api/reference_commentary#data_types) | 描述                  | | -------------------------------- | --------------------------------------------------- | --------------------- | | **triggerid**<br>(必须)          | string                                              | 源触发器ID.           | | **dependsOnTriggerid**<br>(必须) | string                                              | 被依赖的目的触发器ID. |

en-us	### Parameters  `(object/array)` Trigger dependencies to create.  Each trigger dependency has the following parameters:  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**triggerid**<br>(required)|string|ID of the dependent trigger.| |**dependsOnTriggerid**<br>(required)|string|ID of the trigger that the trigger depends on.|
zh-cn	### 参数  `(object/array)` 需要创建的触发器依赖.  每一个触发器依赖具有以下参数:  | 参数                             | [类型](/manual/api/reference_commentary#data_types) | 描述                  | | -------------------------------- | --------------------------------------------------- | --------------------- | | **triggerid**<br>(必须)          | string                                              | 源触发器ID.           | | **dependsOnTriggerid**<br>(必须) | string                                              | 被依赖的目的触发器ID. |

en-us	### Parameters  `(object/array)` Trigger properties to be updated.  The `triggerid` property must be defined for each trigger, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard trigger properties](object#trigger) the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dependencies|array|Triggers that the trigger is dependent on.<br><br>The triggers must have the `triggerid` property defined.| |tags|array|Trigger [tags.](/manual/api/reference/trigger/object#trigger_tag)|  ::: noteimportant The trigger expression has to be given in its expanded form. :::
zh-cn	### 参数  `(object/array)` 需要更新的触发器属性.  `triggerid`属性必须在每个应用集中已定义，其他所有属性为可选项。只有传递过去的属性会被更新，其他所有属性仍然保持不变.  除了 [标准触发器属性](object#trigger) 之外， 该方法还接受以下参数.  | 参数         | [类型](/manual/api/reference_commentary#data_types) | 描述                                                         | | ------------ | --------------------------------------------------- | ------------------------------------------------------------ | | dependencies | array                                               | 依赖触发的触发器.<br><br>触发器必须已定义`triggerid`属性.    | | tags         | array                                               | 触发器 [标签.](/manual/api/reference/trigger/object#trigger_tag) |  ::: noteimportant 指定的触发器表达式必须为展开式. :::

en-us	### Parameters  `(object/array)` Trigger properties to be updated.  The `triggerid` property must be defined for each trigger, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard trigger properties](object#trigger) the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |dependencies|array|Triggers that the trigger is dependent on.<br><br>The triggers must have the `triggerid` property defined.| |tags|array|Trigger [tags.](/manual/api/reference/trigger/object#trigger_tag)|  ::: noteimportant The trigger expression has to be given in its expanded form. :::
zh-cn	### 参数  `(object/array)` 需要更新的触发器属性.  `triggerid`属性必须在每个应用集中已定义，其他所有属性为可选项。只有传递过去的属性会被更新，其他所有属性仍然保持不变.  除了 [标准触发器属性](object#trigger) 之外， 该方法还接受以下参数.  | 参数         | [类型](/manual/api/reference_commentary#data_types) | 描述                                                         | | ------------ | --------------------------------------------------- | ------------------------------------------------------------ | | dependencies | array                                               | 依赖触发的触发器.<br><br>触发器必须已定义`triggerid`属性.    | | tags         | array                                               | 触发器 [标签.](/manual/api/reference/trigger/object#trigger_tag) |  ::: noteimportant 指定的触发器表达式必须为展开式. :::

en-us	### Parameters  `(object/array)` [Trigger prototype properties](object#trigger_prototype) to be updated.  The `triggerid` property must be defined for each trigger prototype, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard trigger prototype properties](object#trigger_prototype) the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dependencies|array|Triggers and trigger prototypes that the trigger prototype is dependent on.<br><br>The triggers must have the `triggerid` property defined.| |tags|array|Trigger prototype [tags](/manual/api/reference/triggerprototype/object#trigger_prototype_tag).|  ::: noteimportant The trigger expression has to be given in its expanded form and must contain at least one item prototype. :::
zh-cn	### 参数  `(object/array)` 需要更新的[触发器原型](object#trigger_prototype)   必须在每个触发器原型中定义`triggerid`属性，其他所有属性为可选项。只有传递过去的属性会被更新，其他所有属性保持不变。  除了 [标准的触发器原型属性](object#trigger_prototype)之外 ，该方法还接受以下参数.  | 参数         | [类型](/manual/api/reference_commentary#data_types) | 描述                                                         | | ------------ | --------------------------------------------------- | ------------------------------------------------------------ | | dependencies | array                                               | 触发器原型所依赖的触发器和触发器原型.<br><br>触发器必须已定义`triggerid`属性.. | | tags         | array                                               | 触发器原型 [标签](/manual/api/reference/triggerprototype/object#trigger_prototype_tag). |  ::: noteimportant 在扩展表单中必须填入至少包含一个监控项原型的触发器表达式。 :::

en-us	### Parameters  `(object/array)` [Trigger prototype properties](object#trigger_prototype) to be updated.  The `triggerid` property must be defined for each trigger prototype, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard trigger prototype properties](object#trigger_prototype) the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |dependencies|array|Triggers and trigger prototypes that the trigger prototype is dependent on.<br><br>The triggers must have the `triggerid` property defined.| |tags|array|Trigger prototype [tags](/manual/api/reference/triggerprototype/object#trigger_prototype_tag).|  ::: noteimportant The trigger expression has to be given in its expanded form and must contain at least one item prototype. :::
zh-cn	### 参数  `(object/array)` 需要更新的[触发器原型](object#trigger_prototype)   必须在每个触发器原型中定义`triggerid`属性，其他所有属性为可选项。只有传递过去的属性会被更新，其他所有属性保持不变。  除了 [标准的触发器原型属性](object#trigger_prototype)之外 ，该方法还接受以下参数.  | 参数         | [类型](/manual/api/reference_commentary#data_types) | 描述                                                         | | ------------ | --------------------------------------------------- | ------------------------------------------------------------ | | dependencies | array                                               | 触发器原型所依赖的触发器和触发器原型.<br><br>触发器必须已定义`triggerid`属性.. | | tags         | array                                               | 触发器原型 [标签](/manual/api/reference/triggerprototype/object#trigger_prototype_tag). |  ::: noteimportant 在扩展表单中必须填入至少包含一个监控项原型的触发器表达式。 :::

en-us	### Parameters  `(object/array)` Trigger prototypes to create.  Additionally to the [standard trigger prototype properties](object#trigger_prototype) the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dependencies|array|Triggers and trigger prototypes that the trigger prototype is dependent on.<br><br>The triggers must have the `triggerid` property defined.| |tags|array|Trigger prototype [tags](/manual/api/reference/triggerprototype/object#trigger_prototype_tag).|  ::: noteimportant The trigger expression has to be given in its expanded form and must contain at least one item prototype. :::
zh-cn	### 参数  `(object/array)` 创建触发器原型.  除了 [标准触发器原型属性](object#trigger_prototype) 此方法还接受以下参数.  | 参数         | [类型](/manual/api/reference_commentary#data_types) | 描述                                                         | | ------------ | --------------------------------------------------- | ------------------------------------------------------------ | | dependencies | array                                               | 触发器原型所依赖的触发器和触发器原型.<br><br>触发器必须已定义`triggerid`属性. | | tags         | array                                               | 触发器 [标签](/manual/api/reference/triggerprototype/object#trigger_prototype_tag). |  ::: noteimportant 指定的触发器表达式必须为展开式，并且必须包含至少一个监控项原型. :::

en-us	### Parameters  `(object/array)` Trigger prototypes to create.  Additionally to the [standard trigger prototype properties](object#trigger_prototype) the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |dependencies|array|Triggers and trigger prototypes that the trigger prototype is dependent on.<br><br>The triggers must have the `triggerid` property defined.| |tags|array|Trigger prototype [tags](/manual/api/reference/triggerprototype/object#trigger_prototype_tag).|  ::: noteimportant The trigger expression has to be given in its expanded form and must contain at least one item prototype. :::
zh-cn	### 参数  `(object/array)` 创建触发器原型.  除了 [标准触发器原型属性](object#trigger_prototype) 此方法还接受以下参数.  | 参数         | [类型](/manual/api/reference_commentary#data_types) | 描述                                                         | | ------------ | --------------------------------------------------- | ------------------------------------------------------------ | | dependencies | array                                               | 触发器原型所依赖的触发器和触发器原型.<br><br>触发器必须已定义`triggerid`属性. | | tags         | array                                               | 触发器 [标签](/manual/api/reference/triggerprototype/object#trigger_prototype_tag). |  ::: noteimportant 指定的触发器表达式必须为展开式，并且必须包含至少一个监控项原型. :::

en-us	### Parameters  `(object/array)` Triggers to create.  Additionally to the [standard trigger properties](object#trigger) the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dependencies|array|Triggers that the trigger is dependent on.<br><br>The triggers must have the `triggerid` property defined.| |tags|array|Trigger [tags.](/manual/api/reference/trigger/object#trigger_tag)|  ::: noteimportant The trigger expression has to be given in its expanded form. :::
zh-cn	### 参数  `(object/array)` 要创建的触发器.  除了 [标准触发器属性](object#trigger) 之外，该方法还接受以下参数.  | 参数         | [类型](/manual/api/reference_commentary#data_types) | 描述                                                         | | ------------ | --------------------------------------------------- | ------------------------------------------------------------ | | dependencies | array                                               | 目的触发器.<br><br>目的触发器必须存在且已定义`triggerid`属性. | | tags         | array                                               | 触发器标签 [标签.](/manual/api/reference/trigger/object#trigger_tag) |  ::: noteimportant 触发器表达式必须以扩展形式给出. :::

en-us	### Parameters  `(object/array)` User groups to create.  Additionally to the [standard user group properties](object#user_group), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |rights|object/array|[Permissions](/manual/api/reference/usergroup/object#permission) to assign to the group| |tag\_filters|array|[Tag based permissions](/manual/api/reference/usergroup/object#tag_based_permission) to assign to the group| |users|object/array|[Users](/manual/api/reference/user/create) to add to the user group.<br><br>The user must have the `userid` property defined.|
zh-cn	### 参数  `(object/array)` 要创建的用户组.   除了 [标准用户组属性](object#user_group), 此方法接受如下参数.  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |rights|object/array|分配给用户组的 [权限](/manual/api/reference/usergroup/object#permission) | |tag\_filters|array|分配给用户组 [标签权限](/manual/api/reference/usergroup/object#tag_based_permission) | |users|object/array|需要添加到用户组的 [用户](/manual/api/reference/user/create).<br><br>用户必须拥有 `userid` 属性.|

en-us	### Parameters  `(object/array)` User groups to create.  Additionally to the [standard user group properties](object#user_group), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |rights|object/array|[Permissions](/manual/api/reference/usergroup/object#permission) to assign to the group| |tag\_filters|array|[Tag based permissions](/manual/api/reference/usergroup/object#tag_based_permission) to assign to the group| |users|object/array|[Users](/manual/api/reference/user/create) to add to the user group.<br><br>The user must have the `userid` property defined.|
zh-cn	### 参数  `(object/array)` 要创建的用户组.   除了 [标准用户组属性](object#user_group), 此方法接受如下参数.  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |rights|object/array|分配给用户组的 [权限](/manual/api/reference/usergroup/object#permission) | |tag\_filters|array|分配给用户组 [标签权限](/manual/api/reference/usergroup/object#tag_based_permission) | |users|object/array|需要添加到用户组的 [用户](/manual/api/reference/user/create).<br><br>用户必须拥有 `userid` 属性.|

en-us	### Parameters  `(object/array)` User properties to be updated.  The `userid` property must be defined for each user, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard user properties](object#user), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |passwd|string|User's password.<br><br>Can be empty string if user belongs to or is moved only to groups that have LDAP access.| |usrgrps|array|User [groups](/manual/api/reference/user/create) to replace existing user groups.<br><br>The user groups must have the `usrgrpid` property defined.| |medias|array|[User media](/manual/api/reference/user/object#media) to replace existing media.| |user_medias<br>(deprecated)|array|This parameter is deprecated, please use `medias` instead.<br>User [media](/manual/api/reference/user/object#media) to replace existing media.|
zh-cn	### 参数  `(object/array)` 要更新的用户属性。  必须为每个用户定义 `userid` 属性，所有其他属性都是可选的。 只会更新传递的属性，所有其他属性将保持不变。  除了 [标准用户属性](object#user)，该方法还接受以下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |--|--|------| |passwd|字符串|用户的密码。<br><br>如果用户属于或仅移动到具有 LDAP 访问权限的组，则可以为空字符串。| |usrgrps|数组|User [groups](/manual/api/reference/user/create) 以替换现有用户组。<br><br>用户组必须定义 `usrgrpid` 属性。| |medias|数组|[用户媒体](/manual/api/reference/user/object#media) 替换现有媒体。| |user_medias<br>（已弃用）|array|此参数已弃用，请改用“medias”。<br>User [media](/manual/api/reference/user/object#media) 替换现有媒体。|

en-us	### Parameters  `(object/array)` Users to create.  Additionally to the [standard user properties](object#user), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**passwd**<br>*(required)*|string|User's password.<br><br>Can be omitted if user is added only to groups that have LDAP access.| |**usrgrps**<br>(required)|array|User [groups](/manual/api/reference/user/create) to add the user to.<br><br>The user groups must have the `usrgrpid` property defined.| |medias|array|User [media](/manual/api/reference/user/object#media) to be created.| |user_medias<br>(deprecated)|array|This parameter is deprecated, please use `medias` instead.<br>User [media](/manual/api/reference/user/object#media) to be created.|
zh-cn	### 参数  `(object/array)` 用户创建。  除了 [标准用户属性](object#user)，该方法还接受以下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |--|--|------| |**passwd**<br>*（必需）*|字符串|用户的密码。<br><br>如果用户仅添加到具有 LDAP 访问权限的组，则可以省略。| |**usrgrps**<br>（必需）|数组|要将用户添加到的用户 [组](/manual/api/reference/user/create)。<br><br>用户组必须具有已定义的 ` usrgrpid` 属性。| |medias|数组|要创建的用户 [media](/manual/api/reference/user/object#media)。| |user_medias<br>（已弃用）|数组|此参数已弃用，请改用“medias”。<br>要创建的用户 [media](/manual/api/reference/user/object#media)。|

en-us	### Parameters  `(object/array)` [Value map properties](object#value_map) to be updated.  The `valuemapid` property must be defined for each value map, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.
zh-cn	 ### 参数  `(object/array)` [Value map properties](object#值映射) 更新。  每个值映射必须要定义`valuemapid`属性，其他属性都是可选的。只会更新传递的属性，其他的属性保持不变。

en-us	### Parameters  `(object/array)` Value maps to create.  The method accepts value maps with the [standard value map properties](object#value_map).
zh-cn	### 参数  `(object/array)` 需要创建的值映射。  此方法接受具有 [standard value map properties](object#值映射)的值映射。

en-us	### Parameters  `(object/array)` Web scenario properties to be updated.  The `httptestid` property must be defined for each web scenario, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard web scenario properties](object#web_scenario), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |steps|array|Scenario [steps](/manual/api/reference/httptest/object#scenario_step) to replace existing steps.| |tags|array|Web scenario [tags.](/manual/api/reference/httptest/object#web_scenario_tag)|
zh-cn	 ### 参数  `(object/array)` 需要被更新的Web场景属性。  每个Web场景必须定义`httptestid`属性，其他的所有属性是可选的。只有通过的属性将被更新，其他的属性保持不变。  除了[standard web scenario properties](object#web场景)以外，此方法接受以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |steps|array|场景[步骤](/manual/api/reference/httptest/object#场景步骤)用于替换现有步骤。| |tags|array|Web场景[标签](/manual/api/reference/httptest/object#web场景标签)。|

en-us	### Parameters  `(object/array)` Web scenario properties to be updated.  The `httptestid` property must be defined for each web scenario, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard web scenario properties](object#web_scenario), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |steps|array|Scenario [steps](/manual/api/reference/httptest/object#scenario_step) to replace existing steps.| |tags|array|Web scenario [tags.](/manual/api/reference/httptest/object#web_scenario_tag)|
zh-cn	 ### 参数  `(object/array)` 需要被更新的Web场景属性。  每个Web场景必须定义`httptestid`属性，其他的所有属性是可选的。只有通过的属性将被更新，其他的属性保持不变。  除了[standard web scenario properties](object#web场景)以外，此方法接受以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |steps|array|场景[步骤](/manual/api/reference/httptest/object#场景步骤)用于替换现有步骤。| |tags|array|Web场景[标签](/manual/api/reference/httptest/object#web场景标签)。|

en-us	### Parameters  `(object/array)` Web scenarios to create.  Additionally to the [standard web scenario properties](object#web_scenario), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**steps**<br>(required)|array|Web scenario [steps](/manual/api/reference/httptest/object#scenario_step).| |tags|array|Web scenario [tags.](/manual/api/reference/httptest/object#web_scenario_tag)|
zh-cn	 ### 参数  `(object/array)` 需要创建的Web场景。  除了 [standard web scenario properties](object#web场景)，此方法接受如下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |**steps**<br>(必填)|array|Web场景[steps](/manual/api/reference/httptest/object#场景步骤)。| |tags|array|Web场景[tags](/manual/api/reference/httptest/object#web场景标签)。|

en-us	### Parameters  `(object/array)` Web scenarios to create.  Additionally to the [standard web scenario properties](object#web_scenario), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**steps**<br>(required)|array|Web scenario [steps](/manual/api/reference/httptest/object#scenario_step).| |tags|array|Web scenario [tags.](/manual/api/reference/httptest/object#web_scenario_tag)|
zh-cn	 ### 参数  `(object/array)` 需要创建的Web场景。  除了 [standard web scenario properties](object#web场景)，此方法接受如下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |**steps**<br>(必填)|array|Web场景[steps](/manual/api/reference/httptest/object#场景步骤)。| |tags|array|Web场景[tags](/manual/api/reference/httptest/object#web场景标签)。|

en-us	### Parameters  `(object)` Authentication properties to be updated.
zh-cn	### 参数  `(object)` 要更新的认证属性。

en-us	### Parameters  `(object)` Autoregistration properties to be updated.
zh-cn	### 参数  `(object)` 要被更新的自动注册属性。

en-us	### Parameters  `(object)` Housekeeping properties to be updated.  
zh-cn	### 参数  `(object)` 管家属性将被更新。

en-us	### Parameters  `(object)` Parameters containing the data to import and rules how the data should be handled.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**format**<br>(required)|string|Format of the serialized string.<br><br>Possible values:<br>`yaml` - YAML;<br>`xml` - XML;<br>`json` - JSON.| |**source**<br>(required)|string|Serialized string containing the configuration data.| |**rules**<br>(required)|object|Rules on how new and existing objects should be imported.<br><br>The `rules` parameter is described in detail in the table below.|  ::: notetip If no rules are given, the configuration will not be updated. :::  The `rules` object supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |discoveryRules|object|Rules on how to import LLD rules.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new LLD rules will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing LLD rules will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, LLD rules not present in the imported data will be deleted from the database; default: `false`.| |graphs|object|Rules on how to import graphs.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new graphs will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing graphs will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, graphs not present in the imported data will be deleted from the database; default: `false`.| |groups|object|Rules on how to import host groups.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new host groups will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing host groups will be updated; default: `false`.| |hosts|object|Rules on how to import hosts.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new hosts will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing hosts will be updated; default: `false`.| |httptests|object|Rules on how to import web scenarios.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new web scenarios will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing web scenarios will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, web scenarios not present in the imported data will be deleted from the database; default: `false`.| |images|object|Rules on how to import images.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new images will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing images will be updated; default: `false`.| |items|object|Rules on how to import items.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new items will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing items will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, items not present in the imported data will be deleted from the database; default: `false`.| |maps|object|Rules on how to import maps.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new maps will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing maps will be updated; default: `false`.| |mediaTypes|object|Rules on how to import media types.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new media types will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing media types will be updated; default: `false`.| |templateLinkage|object|Rules on how to import template links.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new links between templates and host will be created; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, template links not present in the imported data will be deleted from the database; default: `false`.| |templates|object|Rules on how to import templates.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new templates will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing templates will be updated; default: `false`.| |templateDashboards|object|Rules on how to import template dashboards.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new template dashboards will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing template dashboards will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, template dashboards not present in the imported data will be deleted from the database; default: `false`.| |triggers|object|Rules on how to import triggers.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new triggers will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing triggers will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, triggers not present in the imported data will be deleted from the database; default: `false`.| |valueMaps|object|Rules on how to import host or template value maps.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new value maps will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing value maps will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, value maps not present in the imported data will be deleted from the database; default: `false`.|
zh-cn	 ### Parameters  `(object)` 参数包含导入的数据以及如何处理数据的规则。  |参数|[类型](/manual/api/reference_commentary#data_types)|说明| |---------|---------------------------------------------------|-----------| |**format**<br>(required)|string|序列化字符串的格式<br><br>可能的值：<br>`yaml` - YAML;<br>`xml` - XML;<br>`json` - JSON.| |**source**<br>(required)|string|包含配置数据的序列化字符串。| |**rules**<br>(required)|object|新的或现有的对象的导入规则。<br><br>`rules` 参数在下表中进行详细描述|  ::: notetip 如果没有规则，配置将不被更新。 :::  `rules` 对象支持如下参数  |参数|[类型](/manual/api/reference_commentary#data_types)|说明| |---------|---------------------------------------------------|-----------| |discoveryRules|object|导入低级别自动发现(LLD)规则的规则<br><br>支持的参数：<br>`createMissing` - `(boolean)` 如果设置为 `true`，新的低级别自动发现规则(LLD)将会被创建；默认：`false`；<br>`updateExisting` - `(boolean)`如果设置为 `true`，已有的低级别自动发现规则(LLD)将会被创建；默认：`false`；<br>`deleteMissing` - `(boolean)`如果设置为 `true`，不在导入数据中的底层自动发现规则将会从数据库中被删除；默认：`false。| |graphs|object|导入图表的规则。<br><br>支持的参数：<br>`createMissing` - `(boolean)`如果设置为 `true`，新的图表将会被创建；默认：`false`；<br>`updateExisting` - `(boolean)` 如何设置为 `true`，已有的图表将会被更新；默认：`false`；<br>`deleteMissing` - `(boolean)`如果设置为 `true`，不在导入数据中的图表将会从数据库中被删除；默认：`false`。| |groups|object|导入主机组的规则<br><br>支持的参数:<br>`createMissing` - `(boolean)` 如果设置为 `true`, 新的主机组将会被创建; 默认: `false`;<br>`updateExisting` - `(boolean)` 如果设置为 `true`, 已有的主机组将会被更新; 默认: `false`.| |hosts|object|导入主机的规则<br><br>支持的参数：<br>`createMissing` - `(boolean)`如果设置为 `true`，新的主机将会被创建；默认：`false`;<br>`updateExisting` - `(boolean)` 如果设置为`true`,现有主机将被更新；默认：`false`。| |httptests|object|导入web场景的规则<br><br>支持的参数：<br>`createMissing` - `(boolean)` 如果设置为`true`，新的web监控场景将会被创建，默认：`false`<br>`updateExisting` - `(boolean)`如果设置为 `true`，现有的web监控场景将会被更新，默认：`false`;<br>`deleteMissing` - `(boolean)` 如果设置为true`,在导入数据中没有的web场景将会从数据库中彻底删除。默认：`false`。| |images|object|导入图片的规则<br><br>支持的参数：<br>`createMissing` - `(boolean)` 如果设置为`true`，新的图片将会被创建；默认：`false`<br>`updateExisting` - `(boolean)` 如果设置为`true`, 现有的图片将会被更新; 默认：`false`| |items|object|导入监控项的规则<br><br>支持的参数：<br>`createMissing` - `(boolean)`如果设置为`true`，新的监控项将会被创建；默认：`false`;<br>`updateExisting` - `(boolean)` 已有的监控项将会被更新；默认：`false`;<br>`deleteMissing` - `(boolean)` 不在导入数据中的监控项将会从数据库中被删除；默认：`false`。 |maps|object|导入拓扑图的规则。<br><br>支持的参数：<br>`createMissing` - `(boolean)`如果设置为 `true`, 新的拓扑图将会被创建; 默认: `false`;<br>`updateExisting` - `(boolean)` 如果设置为`true`, 现有的拓扑图将被更新; 默认: `false`.| |mediaTypes|object|导入媒介类型的规则<br><br>支持参数：<br>`createMissing` - `(boolean)` 如果设置为 `true`, 新的媒介类型将被创建; 默认: `false`;<br>`updateExisting` - `(boolean)` 如果设置为`true`, 现有的媒介类型将被更新; 默认: `false`.| |templateLinkage|object|导入模板链接的规则.<br><br>支持参数：<br>`createMissing` - `(boolean)` 如果设置为`true`, 新的模板和主机之间的链接将会被创建; 默认: `false`;<br>`deleteMissing` - `(boolean)` 如果设置为`true`, 不在导入数据中的模板链接将会从数据库中被删除; 默认: `false`.| |templates|object|导入模板的规则.<br><br>支持参数:<br>`createMissing` - `(boolean)` 如果设置为 `true`, 新的模板将被创建; 默认: `false`;<br>`updateExisting` - `(boolean)` 如果设置为`true`, 已有的模板将被更新; 默认: `false`.| |templateDashboards|object|导入模板仪表板的规则.<br><br>支持的参数：<br>`createMissing` - `(boolean)` 如果设置为`true`, 新的模板仪表板将被创建; 默认: `false`;<br>`updateExisting` - `(boolean)` 如果设置为 `true`, 已有的模板仪表板将被更新; 默认: `false`;<br>`deleteMissing` - `(boolean)` 如果设置为 `true`, 不在导入数据中的模板仪表板将会从数据库中被删除; 默认: `false`.| |triggers|object|导入触发器的规则<br><br>支持的参数：<br>`createMissing` - `(boolean)`如果设置为 `true`, 新的触发器将被创建; 默认: `false`;<br>`updateExisting` - `(boolean)` 如果设置为`true`, 已有的触发器将被更新; 默认: `false`;<br>`deleteMissing` - `(boolean)` 如果设置为`true`,不在导入数据中的触发器将会从数据库中被删除; 默认: `false`.| |valueMaps|object|导入值映射的规则.<br><br>支持的参数：<br>`createMissing` - `(boolean)` 如果设置为 `true`, 新的值映射将被创建; 默认: `false`;<br>`updateExisting` - `(boolean)` 如果设置为`true`, 已有的值映射将被更新; 默认: `false`;<br>`deleteMissing` - `(boolean)` 如果设置为`true`, 不在导入数据中的值映射将会从数据库中被删除; 默认: `false`.|

en-us	### Parameters  `(object)` Parameters containing the data to import and rules how the data should be handled.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**format**<br>(required)|string|Format of the serialized string.<br><br>Possible values:<br>`yaml` - YAML;<br>`xml` - XML;<br>`json` - JSON.| |**source**<br>(required)|string|Serialized string containing the configuration data.| |**rules**<br>(required)|object|Rules on how new and existing objects should be imported.<br><br>The `rules` parameter is described in detail in the table below.|  ::: notetip If no rules are given, the configuration will not be updated. :::  The `rules` object supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |discoveryRules|object|Rules on how to import LLD rules.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new LLD rules will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing LLD rules will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, LLD rules not present in the imported data will be deleted from the database; default: `false`.| |graphs|object|Rules on how to import graphs.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new graphs will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing graphs will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, graphs not present in the imported data will be deleted from the database; default: `false`.| |groups|object|Rules on how to import host groups.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new host groups will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing host groups will be updated; default: `false`.| |hosts|object|Rules on how to import hosts.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new hosts will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing hosts will be updated; default: `false`.| |httptests|object|Rules on how to import web scenarios.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new web scenarios will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing web scenarios will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, web scenarios not present in the imported data will be deleted from the database; default: `false`.| |images|object|Rules on how to import images.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new images will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing images will be updated; default: `false`.| |items|object|Rules on how to import items.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new items will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing items will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, items not present in the imported data will be deleted from the database; default: `false`.| |maps|object|Rules on how to import maps.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new maps will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing maps will be updated; default: `false`.| |mediaTypes|object|Rules on how to import media types.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new media types will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing media types will be updated; default: `false`.| |templateLinkage|object|Rules on how to import template links.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new links between templates and host will be created; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, template links not present in the imported data will be deleted from the database; default: `false`.| |templates|object|Rules on how to import templates.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new templates will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing templates will be updated; default: `false`.| |templateDashboards|object|Rules on how to import template dashboards.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new template dashboards will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing template dashboards will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, template dashboards not present in the imported data will be deleted from the database; default: `false`.| |triggers|object|Rules on how to import triggers.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new triggers will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing triggers will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, triggers not present in the imported data will be deleted from the database; default: `false`.| |valueMaps|object|Rules on how to import host or template value maps.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new value maps will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing value maps will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, value maps not present in the imported data will be deleted from the database; default: `false`.|
zh-cn	 ### Parameters  `(object)` 参数包含导入的数据以及如何处理数据的规则。  |参数|[类型](/manual/api/reference_commentary#data_types)|说明| |---------|---------------------------------------------------|-----------| |**format**<br>(required)|string|序列化字符串的格式<br><br>可能的值：<br>`yaml` - YAML;<br>`xml` - XML;<br>`json` - JSON.| |**source**<br>(required)|string|包含配置数据的序列化字符串。| |**rules**<br>(required)|object|新的或现有的对象的导入规则。<br><br>`rules` 参数在下表中进行详细描述|  ::: notetip 如果没有规则，配置将不被更新。 :::  `rules` 对象支持如下参数  |参数|[类型](/manual/api/reference_commentary#data_types)|说明| |---------|---------------------------------------------------|-----------| |discoveryRules|object|导入低级别自动发现(LLD)规则的规则<br><br>支持的参数：<br>`createMissing` - `(boolean)` 如果设置为 `true`，新的低级别自动发现规则(LLD)将会被创建；默认：`false`；<br>`updateExisting` - `(boolean)`如果设置为 `true`，已有的低级别自动发现规则(LLD)将会被创建；默认：`false`；<br>`deleteMissing` - `(boolean)`如果设置为 `true`，不在导入数据中的底层自动发现规则将会从数据库中被删除；默认：`false。| |graphs|object|导入图表的规则。<br><br>支持的参数：<br>`createMissing` - `(boolean)`如果设置为 `true`，新的图表将会被创建；默认：`false`；<br>`updateExisting` - `(boolean)` 如何设置为 `true`，已有的图表将会被更新；默认：`false`；<br>`deleteMissing` - `(boolean)`如果设置为 `true`，不在导入数据中的图表将会从数据库中被删除；默认：`false`。| |groups|object|导入主机组的规则<br><br>支持的参数:<br>`createMissing` - `(boolean)` 如果设置为 `true`, 新的主机组将会被创建; 默认: `false`;<br>`updateExisting` - `(boolean)` 如果设置为 `true`, 已有的主机组将会被更新; 默认: `false`.| |hosts|object|导入主机的规则<br><br>支持的参数：<br>`createMissing` - `(boolean)`如果设置为 `true`，新的主机将会被创建；默认：`false`;<br>`updateExisting` - `(boolean)` 如果设置为`true`,现有主机将被更新；默认：`false`。| |httptests|object|导入web场景的规则<br><br>支持的参数：<br>`createMissing` - `(boolean)` 如果设置为`true`，新的web监控场景将会被创建，默认：`false`<br>`updateExisting` - `(boolean)`如果设置为 `true`，现有的web监控场景将会被更新，默认：`false`;<br>`deleteMissing` - `(boolean)` 如果设置为true`,在导入数据中没有的web场景将会从数据库中彻底删除。默认：`false`。| |images|object|导入图片的规则<br><br>支持的参数：<br>`createMissing` - `(boolean)` 如果设置为`true`，新的图片将会被创建；默认：`false`<br>`updateExisting` - `(boolean)` 如果设置为`true`, 现有的图片将会被更新; 默认：`false`| |items|object|导入监控项的规则<br><br>支持的参数：<br>`createMissing` - `(boolean)`如果设置为`true`，新的监控项将会被创建；默认：`false`;<br>`updateExisting` - `(boolean)` 已有的监控项将会被更新；默认：`false`;<br>`deleteMissing` - `(boolean)` 不在导入数据中的监控项将会从数据库中被删除；默认：`false`。 |maps|object|导入拓扑图的规则。<br><br>支持的参数：<br>`createMissing` - `(boolean)`如果设置为 `true`, 新的拓扑图将会被创建; 默认: `false`;<br>`updateExisting` - `(boolean)` 如果设置为`true`, 现有的拓扑图将被更新; 默认: `false`.| |mediaTypes|object|导入媒介类型的规则<br><br>支持参数：<br>`createMissing` - `(boolean)` 如果设置为 `true`, 新的媒介类型将被创建; 默认: `false`;<br>`updateExisting` - `(boolean)` 如果设置为`true`, 现有的媒介类型将被更新; 默认: `false`.| |templateLinkage|object|导入模板链接的规则.<br><br>支持参数：<br>`createMissing` - `(boolean)` 如果设置为`true`, 新的模板和主机之间的链接将会被创建; 默认: `false`;<br>`deleteMissing` - `(boolean)` 如果设置为`true`, 不在导入数据中的模板链接将会从数据库中被删除; 默认: `false`.| |templates|object|导入模板的规则.<br><br>支持参数:<br>`createMissing` - `(boolean)` 如果设置为 `true`, 新的模板将被创建; 默认: `false`;<br>`updateExisting` - `(boolean)` 如果设置为`true`, 已有的模板将被更新; 默认: `false`.| |templateDashboards|object|导入模板仪表板的规则.<br><br>支持的参数：<br>`createMissing` - `(boolean)` 如果设置为`true`, 新的模板仪表板将被创建; 默认: `false`;<br>`updateExisting` - `(boolean)` 如果设置为 `true`, 已有的模板仪表板将被更新; 默认: `false`;<br>`deleteMissing` - `(boolean)` 如果设置为 `true`, 不在导入数据中的模板仪表板将会从数据库中被删除; 默认: `false`.| |triggers|object|导入触发器的规则<br><br>支持的参数：<br>`createMissing` - `(boolean)`如果设置为 `true`, 新的触发器将被创建; 默认: `false`;<br>`updateExisting` - `(boolean)` 如果设置为`true`, 已有的触发器将被更新; 默认: `false`;<br>`deleteMissing` - `(boolean)` 如果设置为`true`,不在导入数据中的触发器将会从数据库中被删除; 默认: `false`.| |valueMaps|object|导入值映射的规则.<br><br>支持的参数：<br>`createMissing` - `(boolean)` 如果设置为 `true`, 新的值映射将被创建; 默认: `false`;<br>`updateExisting` - `(boolean)` 如果设置为`true`, 已有的值映射将被更新; 默认: `false`;<br>`deleteMissing` - `(boolean)` 如果设置为`true`, 不在导入数据中的值映射将会从数据库中被删除; 默认: `false`.|

en-us	### Parameters  `(object)` Parameters containing the host interfaces to be created on the given hosts.  The method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**hosts**<br>(required)|object/array|Hosts to be updated.<br><br>The hosts must have the `hostid` property defined.| |**interfaces**<br>(required)|object/array|[Host interfaces](/manual/api/reference/hostinterface/object) to create on the given hosts.|
zh-cn	### 参数  `(object)` 包含要在给定主机上创建的主机接口的参数  该方法接受以下参数：  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |**hosts**<br>(必选)|对象/数组|更新的主机。<br><br>主机必须已定义 `hostid`属性。| |**interfaces**<br>(必选)|对象/数组|主机上创建[主机接口](/manual/api/reference/hostinterface/object)。|

en-us	### Parameters  `(object)` Parameters containing the host interfaces to be created on the given hosts.  The method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**hosts**<br>(required)|object/array|Hosts to be updated.<br><br>The hosts must have the `hostid` property defined.| |**interfaces**<br>(required)|object/array|[Host interfaces](/manual/api/reference/hostinterface/object) to create on the given hosts.|
zh-cn	### 参数  `(object)` 包含要在给定主机上创建的主机接口的参数  该方法接受以下参数：  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |**hosts**<br>(必选)|对象/数组|更新的主机。<br><br>主机必须已定义 `hostid`属性。| |**interfaces**<br>(必选)|对象/数组|主机上创建[主机接口](/manual/api/reference/hostinterface/object)。|

en-us	### Parameters  `(object)` Parameters containing the ID of the host to be updated and the new host interfaces.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**hostid**<br>(required)|string|ID of the host to be updated.| |**interfaces**<br>(required)|object/array|[Host interfaces](/manual/api/reference/hostinterface/object) to replace the current host interfaces with.|
zh-cn	### 参数  `(object)` 包含要更新的主机ID和新主机接口的参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |**hostid**<br>(必选)|字符串|要更新的主机ID| |**interfaces**<br>(必选)|对象/数组|替换当前主机接口的[主机接口](/manual/api/reference/hostinterface/object)。|

en-us	### Parameters  `(object)` Parameters containing the ID of the host to be updated and the new host interfaces.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**hostid**<br>(required)|string|ID of the host to be updated.| |**interfaces**<br>(required)|object/array|[Host interfaces](/manual/api/reference/hostinterface/object) to replace the current host interfaces with.|
zh-cn	### 参数  `(object)` 包含要更新的主机ID和新主机接口的参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |**hostid**<br>(必选)|字符串|要更新的主机ID| |**interfaces**<br>(必选)|对象/数组|替换当前主机接口的[主机接口](/manual/api/reference/hostinterface/object)。|

en-us	### Parameters  `(object)` Parameters containing the ID of the script to run and either the ID of the host or the ID of the event.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**scriptid**<br>(required)|string|ID of the script to run.| |hostid|string|ID of the host to run the script on.| |eventid|string|ID of the event to run the script on.|
zh-cn	### 参数 `(对象)` 参数包含了运行脚本的ID，以及主机ID或者事件ID。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |**scriptid**<br>(必需)|string|运行脚本的ID。| |hostid|string|在其上运行脚本的主机ID。| |eventid|string|在其上运行脚本的事件ID。|

en-us	### Parameters  `(object)` Parameters containing the ID of the script to run and either the ID of the host or the ID of the event.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**scriptid**<br>(required)|string|ID of the script to run.| |hostid|string|ID of the host to run the script on.| |eventid|string|ID of the event to run the script on.|
zh-cn	### 参数 `(对象)` 参数包含了运行脚本的ID，以及主机ID或者事件ID。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |**scriptid**<br>(必需)|string|运行脚本的ID。| |hostid|string|在其上运行脚本的主机ID。| |eventid|string|在其上运行脚本的事件ID。|

en-us	### Parameters  `(object)` Parameters containing the IDs of the host groups to update and the objects that should be removed.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**groupids**<br>(required)|string/array|IDs of the host groups to be updated.| |hostids|string/array|Hosts to remove from all host groups.| |templateids|string/array|Templates to remove from all host groups.|
zh-cn	 ### 参数  `(对象)` 参数包含要更新的主机组id和需要删除的对象。  |参数|[类](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |**groupids**<br>(必填)|字符串/数组|需要更新的主机组id。| |hostids|字符串/数组|待从所有主机组中移除的主机。| |templateids|字符串/数组|待从所有主机组移除模板。|

en-us	### Parameters  `(object)` Parameters containing the IDs of the host groups to update and the objects that should be removed.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**groupids**<br>(required)|string/array|IDs of the host groups to be updated.| |hostids|string/array|Hosts to remove from all host groups.| |templateids|string/array|Templates to remove from all host groups.|
zh-cn	 ### 参数  `(对象)` 参数包含要更新的主机组id和需要删除的对象。  |参数|[类](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |**groupids**<br>(必填)|字符串/数组|需要更新的主机组id。| |hostids|字符串/数组|待从所有主机组中移除的主机。| |templateids|字符串/数组|待从所有主机组移除模板。|

en-us	### Parameters  `(object)` Parameters containing the IDs of the host groups to update and the objects that should be updated.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**groups**<br>(required)|object/array|Host groups to be updated.<br><br>The host groups must have the `groupid` property defined.| |**hosts**<br>(required)|object/array|Hosts to replace the current hosts on the given host groups.<br>All other hosts, except the ones mentioned, will be excluded from host groups.<br>Discovered hosts will not be affected.<br><br>The hosts must have the `hostid` property defined.| |**templates**<br>(required)|object/array|Templates to replace the current templates on the given host groups.<br>All other templates, except the ones mentioned, will be excluded from host groups.<br><br>The templates must have the `templateid` property defined.|
zh-cn	 ### 参数  `(对象)` 参数包含要更新的主机组id和应该更新的对象。  |参数|[类](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |**groups**<br>(必填)|对象/数组|待更新的主机组。<br><br>主机组必须定义了 `groupid` 属性。| |**hosts**<br>(必填)|对象/数组|主机替换给定主机组上的当前主机。<br>除上述主机外，其他所有主机将被排除在主机组之外。<br>发现的主机不受影响。<br><br>主机必须定义了 `hostid` 属性。| |**templates**<br>(必填)|对象/数组|模板用于替换给定主机组上的当前模板。<br>除以上提到的模板外，其他所有模板将被排除在主机组之外。<br><br>模板必须定义了 `templateid` 属性。|

en-us	### Parameters  `(object)` Parameters containing the IDs of the host groups to update and the objects that should be updated.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**groups**<br>(required)|object/array|Host groups to be updated.<br><br>The host groups must have the `groupid` property defined.| |**hosts**<br>(required)|object/array|Hosts to replace the current hosts on the given host groups.<br>All other hosts, except the ones mentioned, will be excluded from host groups.<br>Discovered hosts will not be affected.<br><br>The hosts must have the `hostid` property defined.| |**templates**<br>(required)|object/array|Templates to replace the current templates on the given host groups.<br>All other templates, except the ones mentioned, will be excluded from host groups.<br><br>The templates must have the `templateid` property defined.|
zh-cn	 ### 参数  `(对象)` 参数包含要更新的主机组id和应该更新的对象。  |参数|[类](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |**groups**<br>(必填)|对象/数组|待更新的主机组。<br><br>主机组必须定义了 `groupid` 属性。| |**hosts**<br>(必填)|对象/数组|主机替换给定主机组上的当前主机。<br>除上述主机外，其他所有主机将被排除在主机组之外。<br>发现的主机不受影响。<br><br>主机必须定义了 `hostid` 属性。| |**templates**<br>(必填)|对象/数组|模板用于替换给定主机组上的当前模板。<br>除以上提到的模板外，其他所有模板将被排除在主机组之外。<br><br>模板必须定义了 `templateid` 属性。|

en-us	### Parameters  `(object)` Parameters containing the IDs of the host groups to update and the objects to add to all the host groups.  The method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**groups**<br>(required)|object/array|Host groups to be updated.<br><br>The host groups must have the `groupid` property defined.| |hosts|object/array|Hosts to add to all host groups.<br><br>The hosts must have the `hostid` property defined.| |templates|object/array|Templates to add to all host groups.<br><br>The templates must have the `templateid` property defined.|
zh-cn	 ### 参数  `(对象)` 参数包含要更新的主机组id和要添加到所有主机组的对象。  该方法接受以下参数。  |参数|[类](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |**groups**<br>(必填)|对象/数组|待更新的主机组。<br><br>主机组必须定义了 `groupid` 属性。| |hosts|对象/数组|待添加给所有主机组的主机。<br><br>主机必须定义了 `hostid` 属性。| |templates|对象/数组|需要添加到所有主机组的模板。<br><br>模板必须定义了 `templateid` 属性。|

en-us	### Parameters  `(object)` Parameters containing the IDs of the host groups to update and the objects to add to all the host groups.  The method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**groups**<br>(required)|object/array|Host groups to be updated.<br><br>The host groups must have the `groupid` property defined.| |hosts|object/array|Hosts to add to all host groups.<br><br>The hosts must have the `hostid` property defined.| |templates|object/array|Templates to add to all host groups.<br><br>The templates must have the `templateid` property defined.|
zh-cn	 ### 参数  `(对象)` 参数包含要更新的主机组id和要添加到所有主机组的对象。  该方法接受以下参数。  |参数|[类](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |**groups**<br>(必填)|对象/数组|待更新的主机组。<br><br>主机组必须定义了 `groupid` 属性。| |hosts|对象/数组|待添加给所有主机组的主机。<br><br>主机必须定义了 `hostid` 属性。| |templates|对象/数组|需要添加到所有主机组的模板。<br><br>模板必须定义了 `templateid` 属性。|

en-us	### Parameters  `(object)` Parameters containing the IDs of the hosts to be updated and the interfaces to be removed.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**hostids**<br>(required)|string/array|IDs of the hosts to be updated.| |**interfaces**<br>(required)|object/array|Host interfaces to remove from the given hosts.<br><br>The host interface object must have the ip, dns and port properties defined|
zh-cn	### 参数  `(object)` 参数包含更新的主机的ID和被删除的主机接口。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |**hostids**<br>(必选)|字符串/数组|被更新的主机ID| |**interfaces**<br>(必选)|对象/数组|要删除的给定主机接口<br><br>主机接口对象必须定义ip, dns 和port属性。|

en-us	### Parameters  `(object)` Parameters containing the IDs of the hosts to be updated and the interfaces to be removed.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**hostids**<br>(required)|string/array|IDs of the hosts to be updated.| |**interfaces**<br>(required)|object/array|Host interfaces to remove from the given hosts.<br><br>The host interface object must have the ip, dns and port properties defined|
zh-cn	### 参数  `(object)` 参数包含更新的主机的ID和被删除的主机接口。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |**hostids**<br>(必选)|字符串/数组|被更新的主机ID| |**interfaces**<br>(必选)|对象/数组|要删除的给定主机接口<br><br>主机接口对象必须定义ip, dns 和port属性。|

en-us	### Parameters  `(object)` Parameters containing the IDs of the hosts to update and the objects that should be removed.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**hostids**<br>(required)|string/array|IDs of the hosts to be updated.| |groupids|string/array|Host groups to remove the given hosts from.| |interfaces|object/array|Host interfaces to remove from the given hosts.<br><br>The host interface object must have the `ip`, `dns` and `port` properties defined.| |macros|string/array|User macros to delete from the given hosts.| |templateids|string/array|Templates to unlink from the given hosts.| |templateids\_clear|string/array|Templates to unlink and clear from the given hosts.|
zh-cn	### 参数  `(对象)`  参数包含要更新的主机id和应该删除的对象。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |--|--|------| |**hostids**<br>(必填)|字符串/数组|待更新的主机id。| |groupids|字符串/数组|从主机组中移除指定主机。| |interfaces|对象/数组|要从给定主机中移除的主机接口。<br><br>主机接口对象必须定义了 `ip` 、 `dns` 和 `port` 属性。| |macros|字符串/数组|要从给定主机中删除的用户宏。| |templateids|字符串/数组|要从给定主机断开链接的模板。| |templateids\_clear|字符串/数组|要从给定主机解除链接和清除的模板。|

en-us	### Parameters  `(object)` Parameters containing the IDs of the hosts to update and the objects to add to all the hosts.  The method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**hosts**<br>(required)|object/array|Hosts to be updated.<br><br>The hosts must have the `hostid` property defined.| |groups|object/array|Host groups to add to the given hosts.<br><br>The host groups must have the `groupid` property defined.| |interfaces|object/array|[Host interfaces](/manual/api/reference/hostinterface/object) to be created for the given hosts.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to be created for the given hosts.| |templates|object/array|Templates to link to the given hosts.<br><br>The templates must have the `templateid` property defined.|
zh-cn	 ### 参数  `(对象)` 参数包含要更新的主机id和要添加到所有主机的对象。  该方法接受以下参数。  |参数|[类](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |**hosts**<br>(必填)|对象/数组|待更新的主机。<br><br>主机必须定义了 `hostid` 属性。| |groups|对象/数组|需要添加到指定主机的主机组。<br><br>主机组必须定义了 `groupid` 属性。| |interfaces|对象/数组|为给定的主机创建[主机接口](/manual/api/reference/hostinterface/object)。| |macros|对象/数组|为给定主机创建的 [用户宏](/manual/api/reference/usermacro/object)。| |templates|对象/数组|链接到给定主机的模板。<br><br>模板必须定义了 `templateid` 属性。|

en-us	### Parameters  `(object)` Parameters containing the IDs of the hosts to update and the objects to add to all the hosts.  The method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**hosts**<br>(required)|object/array|Hosts to be updated.<br><br>The hosts must have the `hostid` property defined.| |groups|object/array|Host groups to add to the given hosts.<br><br>The host groups must have the `groupid` property defined.| |interfaces|object/array|[Host interfaces](/manual/api/reference/hostinterface/object) to be created for the given hosts.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to be created for the given hosts.| |templates|object/array|Templates to link to the given hosts.<br><br>The templates must have the `templateid` property defined.|
zh-cn	 ### 参数  `(对象)` 参数包含要更新的主机id和要添加到所有主机的对象。  该方法接受以下参数。  |参数|[类](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |**hosts**<br>(必填)|对象/数组|待更新的主机。<br><br>主机必须定义了 `hostid` 属性。| |groups|对象/数组|需要添加到指定主机的主机组。<br><br>主机组必须定义了 `groupid` 属性。| |interfaces|对象/数组|为给定的主机创建[主机接口](/manual/api/reference/hostinterface/object)。| |macros|对象/数组|为给定主机创建的 [用户宏](/manual/api/reference/usermacro/object)。| |templates|对象/数组|链接到给定主机的模板。<br><br>模板必须定义了 `templateid` 属性。|

en-us	### Parameters  `(object)` Parameters containing the IDs of the hosts to update and the properties that should be updated.  Additionally to the [standard host properties](object#host), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**hosts**<br>(required)|object/array|[Hosts](/manual/api/reference/host/object) to be updated.<br><br>The hosts must have the `hostid` property defined.| |groups|object/array|Host [groups](/manual/api/reference/hostgroup/object) to replace the current host groups the hosts belong to.<br><br>The host groups must have the `groupid` property defined.| |interfaces|object/array|Host [interfaces](/manual/api/reference/hostinterface/object) to replace the current host interfaces on the given hosts.| |inventory|object|Host [inventory](/manual/api/reference/host/object#host_inventory) properties.<br><br>Host inventory mode cannot be updated using the `inventory` parameter, use `inventory_mode` instead.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to replace the current user macros on the given hosts.| |templates|object/array|[Templates](/manual/api/reference/template/object) to replace the currently linked templates on the given hosts.<br><br>The templates must have the `templateid` property defined.| |templates\_clear|object/array|[Templates](/manual/api/reference/template/object) to unlink and clear from the given hosts.<br><br>The templates must have the `templateid` property defined.|
zh-cn	 ### 参数  `(对象)` 参数包含要更新的主机id和应该更新的属性。  除了[标准主机属性](object#host)以外，此方法可以接受如下参数:  |参数|[类](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |**hosts**<br>(必填)|对象/数组|待更新的[主机](/manual/api/reference/host/object) 。<br><br>主机必须定义了 `hostid` 属性。| |groups|对象/数组|更换主机所属的主机[组](/manual/api/reference/hostgroup/object)。<br><br>主机组必须定义了 `groupid` 属性。| |interfaces|对象/数组|主机[接口](/manual/api/reference/hostinterface/object) 用于替换给定主机上的当前主机接口。| |inventory|对象|主机[清单](/manual/api/reference/host/object#host_inventory)属性。 <br><br>主机清单模式不能使用 `inventory` 参数更新, 事情 `inventory_mode` 代替。| |macros|对象/数组|[用户宏](/manual/api/reference/usermacro/object) 替换给定主机上的当前用户宏。| |templates|对象/数组|[模板](/manual/api/reference/template/object)替换给定主机上当前链接的模板。<br><br>模板必须定义了 `templateid` 属性。| |templates\_clear|对象/数组|[模板](/manual/api/reference/template/object) 断开和清除给定主机的链接。<br><br>模板必须定义了 `templateid` 属性。|

en-us	### Parameters  `(object)` Parameters containing the IDs of the hosts to update and the properties that should be updated.  Additionally to the [standard host properties](object#host), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**hosts**<br>(required)|object/array|[Hosts](/manual/api/reference/host/object) to be updated.<br><br>The hosts must have the `hostid` property defined.| |groups|object/array|Host [groups](/manual/api/reference/hostgroup/object) to replace the current host groups the hosts belong to.<br><br>The host groups must have the `groupid` property defined.| |interfaces|object/array|Host [interfaces](/manual/api/reference/hostinterface/object) to replace the current host interfaces on the given hosts.| |inventory|object|Host [inventory](/manual/api/reference/host/object#host_inventory) properties.<br><br>Host inventory mode cannot be updated using the `inventory` parameter, use `inventory_mode` instead.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to replace the current user macros on the given hosts.| |templates|object/array|[Templates](/manual/api/reference/template/object) to replace the currently linked templates on the given hosts.<br><br>The templates must have the `templateid` property defined.| |templates\_clear|object/array|[Templates](/manual/api/reference/template/object) to unlink and clear from the given hosts.<br><br>The templates must have the `templateid` property defined.|
zh-cn	 ### 参数  `(对象)` 参数包含要更新的主机id和应该更新的属性。  除了[标准主机属性](object#host)以外，此方法可以接受如下参数:  |参数|[类](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |**hosts**<br>(必填)|对象/数组|待更新的[主机](/manual/api/reference/host/object) 。<br><br>主机必须定义了 `hostid` 属性。| |groups|对象/数组|更换主机所属的主机[组](/manual/api/reference/hostgroup/object)。<br><br>主机组必须定义了 `groupid` 属性。| |interfaces|对象/数组|主机[接口](/manual/api/reference/hostinterface/object) 用于替换给定主机上的当前主机接口。| |inventory|对象|主机[清单](/manual/api/reference/host/object#host_inventory)属性。 <br><br>主机清单模式不能使用 `inventory` 参数更新, 事情 `inventory_mode` 代替。| |macros|对象/数组|[用户宏](/manual/api/reference/usermacro/object) 替换给定主机上的当前用户宏。| |templates|对象/数组|[模板](/manual/api/reference/template/object)替换给定主机上当前链接的模板。<br><br>模板必须定义了 `templateid` 属性。| |templates\_clear|对象/数组|[模板](/manual/api/reference/template/object) 断开和清除给定主机的链接。<br><br>模板必须定义了 `templateid` 属性。|

en-us	### Parameters  `(object)` Parameters containing the IDs of the templates to update and the objects that should be removed.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**templateids**<br>(required)|string/array|IDs of the templates to be updated.| |groupids|string/array|Host groups to remove the given templates from.| |macros|string/array|User macros to delete from the given templates.| |templateids\_clear|string/array|Templates to unlink and clear from the given templates (upstream).| |templateids\_link|string/array|Templates to unlink from the given templates (upstream).|
zh-cn	### 参数  `(object)` 包含要更新的模板ID和应删除的对象的参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |**templateids**<br>(必须)|string/array|要更新的模板的ID。| |groupids|string/array|从主机组中删除给定模板。| |macros|string/array|从给定模板中删除的用户宏。| |templateids\_clear|string/array|从指定模板（上游）中取消模板链接并清除数据。| |templateids\_link|string/array|从指定模板（上游）中取消模板链接。|

en-us	### Parameters  `(object)` Parameters containing the IDs of the templates to update and the objects that should be removed.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**templateids**<br>(required)|string/array|IDs of the templates to be updated.| |groupids|string/array|Host groups to remove the given templates from.| |macros|string/array|User macros to delete from the given templates.| |templateids\_clear|string/array|Templates to unlink and clear from the given templates (upstream).| |templateids\_link|string/array|Templates to unlink from the given templates (upstream).|
zh-cn	### 参数  `(object)` 包含要更新的模板ID和应删除的对象的参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |**templateids**<br>(必须)|string/array|要更新的模板的ID。| |groupids|string/array|从主机组中删除给定模板。| |macros|string/array|从给定模板中删除的用户宏。| |templateids\_clear|string/array|从指定模板（上游）中取消模板链接并清除数据。| |templateids\_link|string/array|从指定模板（上游）中取消模板链接。|

en-us	### Parameters  `(object)` Parameters containing the IDs of the templates to update and the objects to add to the templates.  The method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**templates**<br>(required)|object/array|Templates to be updated.<br><br>The templates must have the `templateid` property defined.| |groups|object/array|Host groups to add the given templates to.<br><br>The host groups must have the `groupid` property defined.| |macros|object/array|User macros to be created for the given templates.| |templates\_link|object/array|Templates to link to the given templates.<br><br>The templates must have the `templateid` property defined.|
zh-cn	### 参数  `(object)`参数包含要更新的模板ID和要添加到模板的对象的参数。    该方法接受以下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |**templates**<br>(必须)|object/array|要更新的模板。<br><br>模板必须定义`templateid`属性。| |groups|object/array|要将给定模板添加到的主机群组。<br><br>主机组必须定义`groupid`属性。| |macros|object/array|为给定模板创建的用户宏。| |templates\_link|object/array|链接到给定模板的模板。<br><br>模板必须定义`templateid`属性。|

en-us	### Parameters  `(object)` Parameters containing the IDs of the templates to update and the objects to add to the templates.  The method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**templates**<br>(required)|object/array|Templates to be updated.<br><br>The templates must have the `templateid` property defined.| |groups|object/array|Host groups to add the given templates to.<br><br>The host groups must have the `groupid` property defined.| |macros|object/array|User macros to be created for the given templates.| |templates\_link|object/array|Templates to link to the given templates.<br><br>The templates must have the `templateid` property defined.|
zh-cn	### 参数  `(object)`参数包含要更新的模板ID和要添加到模板的对象的参数。    该方法接受以下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |**templates**<br>(必须)|object/array|要更新的模板。<br><br>模板必须定义`templateid`属性。| |groups|object/array|要将给定模板添加到的主机群组。<br><br>主机组必须定义`groupid`属性。| |macros|object/array|为给定模板创建的用户宏。| |templates\_link|object/array|链接到给定模板的模板。<br><br>模板必须定义`templateid`属性。|

en-us	### Parameters  `(object)` Parameters containing the IDs of the templates to update and the objects to replace for the templates.  The method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**templates**<br>(required)|object/array|Templates to be updated.<br><br>The templates must have the `templateid` property defined.| |groups|object/array|Host groups to replace the current host groups the templates belong to.<br><br>The host groups must have the `groupid` property defined.| |macros|object/array|User macros to replace the current user macros on the given templates.| |templates\_clear|object/array|Templates to unlink and clear from the given templates.<br><br>The templates must have the `templateid` property defined.| |templates\_link|object/array|Templates to replace the currently linked templates.<br><br>The templates must have the `templateid` property defined.|
zh-cn	### 参数  `(object)` 参数包含要更新的模板ID和要替换的模板对象。  该方法接受以下参数.  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |**templates**<br>(必须)|object/array|要更新的模版。<br><br>模版必须有已定义的`templateid`属性。| |groups|object/array|用于替换模板所属的当前主机群组的主机群组。<br><br>主机群组必须有已定义的`groupid`属性。| |macros|object/array|用户宏替换给定模板上的当前用户宏。| |templates\_clear|object/array|取消链接并清除给定模板的模板。<br><br>模版必须有已定义的`templateid`属性。| |templates\_link|object/array|替换当前链接的模板的模板。<br><br>模版必须有已定义的`templateid`属性。|

en-us	### Parameters  `(object)` Parameters containing the IDs of the templates to update and the objects to replace for the templates.  The method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**templates**<br>(required)|object/array|Templates to be updated.<br><br>The templates must have the `templateid` property defined.| |groups|object/array|Host groups to replace the current host groups the templates belong to.<br><br>The host groups must have the `groupid` property defined.| |macros|object/array|User macros to replace the current user macros on the given templates.| |templates\_clear|object/array|Templates to unlink and clear from the given templates.<br><br>The templates must have the `templateid` property defined.| |templates\_link|object/array|Templates to replace the currently linked templates.<br><br>The templates must have the `templateid` property defined.|
zh-cn	### 参数  `(object)` 参数包含要更新的模板ID和要替换的模板对象。  该方法接受以下参数.  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |**templates**<br>(必须)|object/array|要更新的模版。<br><br>模版必须有已定义的`templateid`属性。| |groups|object/array|用于替换模板所属的当前主机群组的主机群组。<br><br>主机群组必须有已定义的`groupid`属性。| |macros|object/array|用户宏替换给定模板上的当前用户宏。| |templates\_clear|object/array|取消链接并清除给定模板的模板。<br><br>模版必须有已定义的`templateid`属性。| |templates\_link|object/array|替换当前链接的模板的模板。<br><br>模版必须有已定义的`templateid`属性。|

en-us	### Parameters  `(object)` Parameters containing the possible data to import and rules how the data should be handled.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**format**<br>(required)|string|Format of the serialized string.<br><br>Possible values:<br>`yaml` - YAML;<br>`xml` - XML;<br>`json` - JSON.| |**source**<br>(required)|string|Serialized string containing the configuration data.| |**rules**<br>(required)|object|Rules on how new and existing objects should be imported.<br><br>The `rules` parameter is described in detail in the table below.|  ::: notetip If no rules are given, there will be nothing to update and result will be empty. :::   ::: notetip Comparison will be done only for host groups and templates. Triggers and graphs will be compared only for imported templates, any other will be considered as "new". :::  The `rules` object supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |discoveryRules|object|Rules on how to import LLD rules.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new LLD rules will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing LLD rules will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, LLD rules not present in the imported data will be deleted from the database; default: `false`.| |graphs|object|Rules on how to import graphs.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new graphs will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing graphs will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, graphs not present in the imported data will be deleted from the database; default: `false`.| |groups|object|Rules on how to import host groups.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new host groups will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing host groups will be updated; default: `false`.| |hosts|object|Rules on how to import hosts.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new hosts will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing hosts will be updated; default: `false`.<br><br>This parameter will make no difference to the output. It is allowed only for consistency with `configuration.import`.| |httptests|object|Rules on how to import web scenarios.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new web scenarios will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing web scenarios will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, web scenarios not present in the imported data will be deleted from the database; default: `false`.| |images|object|Rules on how to import images.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new images will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing images will be updated; default: `false`.<br><br>This parameter will make no difference to the output. It is allowed only for consistency with `configuration.import`.| |items|object|Rules on how to import items.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new items will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing items will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, items not present in the imported data will be deleted from the database; default: `false`.| |maps|object|Rules on how to import maps.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new maps will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing maps will be updated; default: `false`.<br><br>This parameter will make no difference to the output. It is allowed only for consistency with `configuration.import`.| |mediaTypes|object|Rules on how to import media types.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new media types will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing media types will be updated; default: `false`.<br><br>This parameter will make no difference to the output. It is allowed only for consistency with `configuration.import`.| |templateLinkage|object|Rules on how to import template links.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new links between templates and host will be created; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, template links not present in the imported data will be deleted from the database; default: `false`.| |templates|object|Rules on how to import templates.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new templates will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing templates will be updated; default: `false`.| |templateDashboards|object|Rules on how to import template dashboards.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new template dashboards will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing template dashboards will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, template dashboards not present in the imported data will be deleted from the database; default: `false`.| |triggers|object|Rules on how to import triggers.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new triggers will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing triggers will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, triggers not present in the imported data will be deleted from the database; default: `false`.| |valueMaps|object|Rules on how to import host or template value maps.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new value maps will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing value maps will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, value maps not present in the imported data will be deleted from the database; default: `false`.|
zh-cn	 ### 参数  `(object)` 参数包含可能要导入的数据以及应如何处理数据的规则  |参数|[类型](/manual/api/reference_commentary#data_types)|说明| |---------|---------------------------------------------------|-----------| |**format**<br>(required)|string|序列化字符串的格式<br><br>可能的值：<br>`yaml` - YAML;<br>`xml` - XML;<br>`json` - JSON.| |**source**<br>(required)|string|包含配置数据的序列化字符串| |**rules**<br>(required)|object|新的或现有的对象的导入规则<br><br>`rules` 参数在下表中进行详细描述|  ::: notetip 如果没有规则，配置将不被更新且结果为空。 :::   ::: notetip 仅对主机组和模板进行比较。触发器和图表将仅对导入的模板进行比较，任何其他的部分都将被视为“新的”。 :::  `rules`支持如下参数  |参数|[类型](/manual/api/reference_commentary#data_types)|说明| |---------|---------------------------------------------------|-----------| |discoveryRules|object|导入低级别自动发现(LLD)的规则<br><br>支持的参数:<br>`createMissing` - `(boolean)` 如果设置为`true`, 新的低级别自动发现(LLD)规则将被创建; 默认: `false`;<br>`updateExisting` - `(boolean)` 如果设置为`true`, 已有的低级别自动发现规则将被更新; 默认: `false`;<br>`deleteMissing` - `(boolean)` 如果设置为 `true`, 不在导入数据中的底层自动发现规则将会从数据库中被删除; 默认: `false`.| |graphs|object|导入图表的规则<br><br>支持的参数:<br>`createMissing` - `(boolean)` 如果设置为`true`, 新的图表将会被创建; 默认: `false`;<br>`updateExisting` - `(boolean)` 如果设置为 `true`, 已有的图表将会被更新; 默认: `false`;<br>`deleteMissing` - `(boolean)` 如果设置为 `true`, 不在导入数据中的图表将会从数据库中被删除; 默认: `false`.| |groups|object|导入主机组的规则<br><br>支持的参数:<br>`createMissing` - `(boolean)` 如果设置为 `true`, 新的主机组将会被创建; 默认: `false`;<br>`updateExisting` - `(boolean)` 如果设置为 `true`, 已有的主机组将会被更新; 默认: `false`.| |hosts|object|导入主机的规则<br><br>支持的参数:<br>`createMissing` - `(boolean)` 如果设置为`true`, 新的主机将会被创建; 默认: `false`;<br>`updateExisting` - `(boolean)` 如果设置为`true`, 现有主机将被更新; 默认: `false`.<br><br>此参数对输出没有影响。它只允许与 `configuration.import`保持一致| |httptests|object|导入web场景的规则<br><br>支持的参数:<br>`createMissing` - `(boolean)`如果设置为 `true`, 新的web监控场景将会被创建; 默认: `false`;<br>`updateExisting` - `(boolean)` 如果设置为 `true`, 现有的web监控场景将会被更新; 默认: `false`;<br>`deleteMissing` - `(boolean)` 如果设置为 `true`, 在导入数据中没有的web场景将会从数据库中彻底删除; 默认: `false`.| |images|object|导入图片的规则<br><br>支持的参数:<br>`createMissing` - `(boolean)`如果设置为`true`, 新的图片将会被创建; 默认: `false`;<br>`updateExisting` - `(boolean)`如果设置为 `true`, 现有的图片将会被更新; 默认: `false`.<br><br>此参数对输出没有影响。它只允许与 `configuration.import`保持一致| |items|object|导入监控项的规则<br><br>支持的参数:<br>`createMissing` - `(boolean)` 如果设置为 `true`, 新的监控项将会被创建; 默认: `false`;<br>`updateExisting` - `(boolean)` 如果设置为 `true`, 已有的监控项将会被更新; 默认: `false`;<br>`deleteMissing` - `(boolean)` 如果设置为 `true`, 不在导入数据中的监控项将会从数据库中被删除; 默认: `false`.| |maps|object|导入拓扑图的规则<br><br>支持的参数:<br>`createMissing` - `(boolean)` 如果设置为 `true`, 新的拓扑图将会被创建; 默认: `false`;<br>`updateExisting` - `(boolean)` 如果设置为 `true`, 现有的拓扑图将被更新; 默认: `false`.<br><br>此参数对输出没有影响。它只允许与 `configuration.import`保持一致.| |mediaTypes|object|导入媒介类型的规则<br><br>支持的参数:<br>`createMissing` - `(boolean)` 如果设置为 `true`, 新的媒介类型将被创建; 默认: `false`;<br>`updateExisting` - `(boolean)` 如果设置为 `true`, 现有的媒介类型将被更新; 默认: `false`.<br><br>此参数对输出没有影响。它只允许与 `configuration.import`保持一致.| |templateLinkage|object|导入模板链接的规则<br><br>支持的参数:<br>`createMissing` - `(boolean)` 如果设置为 `true`, 新的模板和主机之间的链接将会被创建; 默认: `false`;<br>`deleteMissing` - `(boolean)` 如果设置为 `true`, 不在导入数据中的模板链接将会从数据库中被删除; 默认: `false`.| |templates|object|导入模板的规则.<br><br>支持的参数:<br>`createMissing` - `(boolean)` 如果设置为 `true`, 新的模板将被创建; 默认: `false`;<br>`updateExisting` - `(boolean)` 如果设置为 `true`, 已有的模板将被更新; 默认: `false`.| |templateDashboards|object|导入模板仪表板的规则<br><br>支持的参数:<br>`createMissing` - `(boolean)` 如果设置为 `true`, 新的模板仪表板将被创建; default: `false`;<br>`updateExisting` - `(boolean)` 如果设置为 `true`, 已有的模板仪表板将被更新; default: `false`;<br>`deleteMissing` - `(boolean)` 如果设置为 `true`, 不在导入数据中的模板仪表板将会从数据库中被删除; default: `false`.| |triggers|object|导入触发器的规则<br><br>支持的参数:<br>`createMissing` - `(boolean)` 如果设置为 `true`, 新的触发器将被创建; 默认: `false`;<br>`updateExisting` - `(boolean)` 如果设置为 `true`, 已有的触发器将被更新; 默认: `false`;<br>`deleteMissing` - `(boolean)` 如果设置为 `true`, 不在导入数据中的触发器将会从数据库中被删除; 默认: `false`.| |valueMaps|object|导入值映射的规则<br><br>支持的参数:<br>`createMissing` - `(boolean)` 如果设置为 `true`, 新的值映射将被创建; 默认: `false`;<br>`updateExisting` - `(boolean)`如果设置为 `true`, 已有的值映射将被更新; 默认: `false`;<br>`deleteMissing` - `(boolean)` 如果设置为 `true`, 不在导入数据中的值映射将会从数据库中被删除; 默认: `false`.|

en-us	### Parameters  `(object)` Parameters containing the possible data to import and rules how the data should be handled.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |**format**<br>(required)|string|Format of the serialized string.<br><br>Possible values:<br>`yaml` - YAML;<br>`xml` - XML;<br>`json` - JSON.| |**source**<br>(required)|string|Serialized string containing the configuration data.| |**rules**<br>(required)|object|Rules on how new and existing objects should be imported.<br><br>The `rules` parameter is described in detail in the table below.|  ::: notetip If no rules are given, there will be nothing to update and result will be empty. :::   ::: notetip Comparison will be done only for host groups and templates. Triggers and graphs will be compared only for imported templates, any other will be considered as "new". :::  The `rules` object supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |discoveryRules|object|Rules on how to import LLD rules.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new LLD rules will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing LLD rules will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, LLD rules not present in the imported data will be deleted from the database; default: `false`.| |graphs|object|Rules on how to import graphs.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new graphs will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing graphs will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, graphs not present in the imported data will be deleted from the database; default: `false`.| |groups|object|Rules on how to import host groups.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new host groups will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing host groups will be updated; default: `false`.| |hosts|object|Rules on how to import hosts.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new hosts will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing hosts will be updated; default: `false`.<br><br>This parameter will make no difference to the output. It is allowed only for consistency with `configuration.import`.| |httptests|object|Rules on how to import web scenarios.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new web scenarios will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing web scenarios will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, web scenarios not present in the imported data will be deleted from the database; default: `false`.| |images|object|Rules on how to import images.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new images will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing images will be updated; default: `false`.<br><br>This parameter will make no difference to the output. It is allowed only for consistency with `configuration.import`.| |items|object|Rules on how to import items.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new items will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing items will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, items not present in the imported data will be deleted from the database; default: `false`.| |maps|object|Rules on how to import maps.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new maps will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing maps will be updated; default: `false`.<br><br>This parameter will make no difference to the output. It is allowed only for consistency with `configuration.import`.| |mediaTypes|object|Rules on how to import media types.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new media types will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing media types will be updated; default: `false`.<br><br>This parameter will make no difference to the output. It is allowed only for consistency with `configuration.import`.| |templateLinkage|object|Rules on how to import template links.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new links between templates and host will be created; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, template links not present in the imported data will be deleted from the database; default: `false`.| |templates|object|Rules on how to import templates.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new templates will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing templates will be updated; default: `false`.| |templateDashboards|object|Rules on how to import template dashboards.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new template dashboards will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing template dashboards will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, template dashboards not present in the imported data will be deleted from the database; default: `false`.| |triggers|object|Rules on how to import triggers.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new triggers will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing triggers will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, triggers not present in the imported data will be deleted from the database; default: `false`.| |valueMaps|object|Rules on how to import host or template value maps.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new value maps will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing value maps will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, value maps not present in the imported data will be deleted from the database; default: `false`.|
zh-cn	 ### 参数  `(object)` 参数包含可能要导入的数据以及应如何处理数据的规则  |参数|[类型](/manual/api/reference_commentary#data_types)|说明| |---------|---------------------------------------------------|-----------| |**format**<br>(required)|string|序列化字符串的格式<br><br>可能的值：<br>`yaml` - YAML;<br>`xml` - XML;<br>`json` - JSON.| |**source**<br>(required)|string|包含配置数据的序列化字符串| |**rules**<br>(required)|object|新的或现有的对象的导入规则<br><br>`rules` 参数在下表中进行详细描述|  ::: notetip 如果没有规则，配置将不被更新且结果为空。 :::   ::: notetip 仅对主机组和模板进行比较。触发器和图表将仅对导入的模板进行比较，任何其他的部分都将被视为“新的”。 :::  `rules`支持如下参数  |参数|[类型](/manual/api/reference_commentary#data_types)|说明| |---------|---------------------------------------------------|-----------| |discoveryRules|object|导入低级别自动发现(LLD)的规则<br><br>支持的参数:<br>`createMissing` - `(boolean)` 如果设置为`true`, 新的低级别自动发现(LLD)规则将被创建; 默认: `false`;<br>`updateExisting` - `(boolean)` 如果设置为`true`, 已有的低级别自动发现规则将被更新; 默认: `false`;<br>`deleteMissing` - `(boolean)` 如果设置为 `true`, 不在导入数据中的底层自动发现规则将会从数据库中被删除; 默认: `false`.| |graphs|object|导入图表的规则<br><br>支持的参数:<br>`createMissing` - `(boolean)` 如果设置为`true`, 新的图表将会被创建; 默认: `false`;<br>`updateExisting` - `(boolean)` 如果设置为 `true`, 已有的图表将会被更新; 默认: `false`;<br>`deleteMissing` - `(boolean)` 如果设置为 `true`, 不在导入数据中的图表将会从数据库中被删除; 默认: `false`.| |groups|object|导入主机组的规则<br><br>支持的参数:<br>`createMissing` - `(boolean)` 如果设置为 `true`, 新的主机组将会被创建; 默认: `false`;<br>`updateExisting` - `(boolean)` 如果设置为 `true`, 已有的主机组将会被更新; 默认: `false`.| |hosts|object|导入主机的规则<br><br>支持的参数:<br>`createMissing` - `(boolean)` 如果设置为`true`, 新的主机将会被创建; 默认: `false`;<br>`updateExisting` - `(boolean)` 如果设置为`true`, 现有主机将被更新; 默认: `false`.<br><br>此参数对输出没有影响。它只允许与 `configuration.import`保持一致| |httptests|object|导入web场景的规则<br><br>支持的参数:<br>`createMissing` - `(boolean)`如果设置为 `true`, 新的web监控场景将会被创建; 默认: `false`;<br>`updateExisting` - `(boolean)` 如果设置为 `true`, 现有的web监控场景将会被更新; 默认: `false`;<br>`deleteMissing` - `(boolean)` 如果设置为 `true`, 在导入数据中没有的web场景将会从数据库中彻底删除; 默认: `false`.| |images|object|导入图片的规则<br><br>支持的参数:<br>`createMissing` - `(boolean)`如果设置为`true`, 新的图片将会被创建; 默认: `false`;<br>`updateExisting` - `(boolean)`如果设置为 `true`, 现有的图片将会被更新; 默认: `false`.<br><br>此参数对输出没有影响。它只允许与 `configuration.import`保持一致| |items|object|导入监控项的规则<br><br>支持的参数:<br>`createMissing` - `(boolean)` 如果设置为 `true`, 新的监控项将会被创建; 默认: `false`;<br>`updateExisting` - `(boolean)` 如果设置为 `true`, 已有的监控项将会被更新; 默认: `false`;<br>`deleteMissing` - `(boolean)` 如果设置为 `true`, 不在导入数据中的监控项将会从数据库中被删除; 默认: `false`.| |maps|object|导入拓扑图的规则<br><br>支持的参数:<br>`createMissing` - `(boolean)` 如果设置为 `true`, 新的拓扑图将会被创建; 默认: `false`;<br>`updateExisting` - `(boolean)` 如果设置为 `true`, 现有的拓扑图将被更新; 默认: `false`.<br><br>此参数对输出没有影响。它只允许与 `configuration.import`保持一致.| |mediaTypes|object|导入媒介类型的规则<br><br>支持的参数:<br>`createMissing` - `(boolean)` 如果设置为 `true`, 新的媒介类型将被创建; 默认: `false`;<br>`updateExisting` - `(boolean)` 如果设置为 `true`, 现有的媒介类型将被更新; 默认: `false`.<br><br>此参数对输出没有影响。它只允许与 `configuration.import`保持一致.| |templateLinkage|object|导入模板链接的规则<br><br>支持的参数:<br>`createMissing` - `(boolean)` 如果设置为 `true`, 新的模板和主机之间的链接将会被创建; 默认: `false`;<br>`deleteMissing` - `(boolean)` 如果设置为 `true`, 不在导入数据中的模板链接将会从数据库中被删除; 默认: `false`.| |templates|object|导入模板的规则.<br><br>支持的参数:<br>`createMissing` - `(boolean)` 如果设置为 `true`, 新的模板将被创建; 默认: `false`;<br>`updateExisting` - `(boolean)` 如果设置为 `true`, 已有的模板将被更新; 默认: `false`.| |templateDashboards|object|导入模板仪表板的规则<br><br>支持的参数:<br>`createMissing` - `(boolean)` 如果设置为 `true`, 新的模板仪表板将被创建; default: `false`;<br>`updateExisting` - `(boolean)` 如果设置为 `true`, 已有的模板仪表板将被更新; default: `false`;<br>`deleteMissing` - `(boolean)` 如果设置为 `true`, 不在导入数据中的模板仪表板将会从数据库中被删除; default: `false`.| |triggers|object|导入触发器的规则<br><br>支持的参数:<br>`createMissing` - `(boolean)` 如果设置为 `true`, 新的触发器将被创建; 默认: `false`;<br>`updateExisting` - `(boolean)` 如果设置为 `true`, 已有的触发器将被更新; 默认: `false`;<br>`deleteMissing` - `(boolean)` 如果设置为 `true`, 不在导入数据中的触发器将会从数据库中被删除; 默认: `false`.| |valueMaps|object|导入值映射的规则<br><br>支持的参数:<br>`createMissing` - `(boolean)` 如果设置为 `true`, 新的值映射将被创建; 默认: `false`;<br>`updateExisting` - `(boolean)`如果设置为 `true`, 已有的值映射将被更新; 默认: `false`;<br>`deleteMissing` - `(boolean)` 如果设置为 `true`, 不在导入数据中的值映射将会从数据库中被删除; 默认: `false`.|

en-us	### Parameters  `(object)` Parameters containing the user name and password.  The method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**password**<br>(required)|string|User password.| |**username**<br>(required)|string|User name.| |userData|flag|Return information about the authenticated user.| |user<br>(deprecated)|string|This parameter is deprecated, please use `username` instead.<br>User name.|
zh-cn	### 参数  `(object)` 包含用户名和密码的参数。  该方法接受以下参数。  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |--|--|------| |**password**<br>（必填）|字符串|用户密码。| |**username**<br>（必填）|字符串|用户名。| |userData|flag|返回关于认证用户的信息。| |user<br>(已废弃)|字符串|此参数已弃用，请改用“username”。<br>用户名。|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports only one parameter.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |output|query|This parameter being common for all `get` methods described in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).|
zh-cn	 ### 参数  `(object)` 定义需要输出的参数。  此方法只支持一个参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|说明| |---------|---------------------------------------------------|-----------| |output|query|此参数对于所有`get`方法都是通用的，在[参考说明](/manual/api/reference_commentary#通用get方法参数)中有描述。|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports only one parameter.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |output|query|This parameter being common for all `get` methods described in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).|
zh-cn	### 参数  `(object)` 定义所需输出的参数  该方法仅支持一个参数  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |output|查询|该参数对于[参考注释](/manual/api/reference_commentary#common_get_method_parameters)中所有 `get`方法都适用。|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports only one parameter.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |output|query|This parameter being common for all `get` methods described in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).|
zh-cn	### 参数  `(object)` 定义所需输出的参数。  这个方法只支持一个参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |output|query|这个参数对于所有 `get` 方法都是通用的，在 [参考说明](/manual/api/reference_commentary#通用get方法参数) 进行了描述。|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports only one parameter.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |output|query|This parameter being common for all `get` methods described in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).|
zh-cn	 ### 参数  `(对象)` 定义期望输出的参数。  此方法只支持一个参数。  |参数|[类型](/manual/api/reference_commentary#数据_类型)|描述| |---------|---------------------------------------------------|-----------| |output|query|此参数与所有 `get`方法相同，描述见[reference commentary](/manual/api/reference_commentary#共同_获取_方法_参数)。|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports only one parameter.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |output|query|This parameter being common for all `get` methods described in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).|
zh-cn	### 参数  `(object)` 定义所需输出的参数。  这个方法只支持一个参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|描述| |---------|---------------------------------------------------|-----------| |output|query|这个参数对于所有 `get` 方法都是通用的，在 [参考说明](/manual/api/reference_commentary#通用get方法参数) 进行了描述。|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports only one parameter.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |output|query|This parameter being common for all `get` methods described in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).|
zh-cn	 ### 参数  `(对象)` 定义期望输出的参数。  此方法只支持一个参数。  |参数|[类型](/manual/api/reference_commentary#数据_类型)|描述| |---------|---------------------------------------------------|-----------| |output|query|此参数与所有 `get`方法相同，描述见[reference commentary](/manual/api/reference_commentary#共同_获取_方法_参数)。|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports only one parameter.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |output|query|This parameter being common for all `get` methods described in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).|
zh-cn	 ### 参数  `(object)` 定义需要输出的参数。  此方法只支持一个参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|说明| |---------|---------------------------------------------------|-----------| |output|query|此参数对于所有`get`方法都是通用的，在[参考说明](/manual/api/reference_commentary#通用get方法参数)中有描述。|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports only one parameter.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |output|query|This parameter being common for all `get` methods described in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).|  
zh-cn	### 参数  `(object)` 定义所需输出的参数  该方法仅支持一个参数  |参数|[类型](/manual/api/reference_commentary#data_types)|描述| |---------|---------------------------------------------------|-----------| |output|查询|该参数对于[参考注释](/manual/api/reference_commentary#common_get_method_parameters)中所有 `get`方法都适用。|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |active|flag|Return only enabled trigger prototypes that belong to monitored hosts.| |discoveryids|string/array|Return only trigger prototypes that belong to the given LLD rules.| |functions|string/array|Return only triggers that use the given functions.<br><br>Refer to the [Supported functions](/manual/appendix/functions) page for a list of supported functions.| |group|string|Return only trigger prototypes that belong to hosts from the host groups with the given name.| |groupids|string/array|Return only trigger prototypes that belong to hosts from the given host groups.| |host|string|Return only trigger prototypes that belong to hosts with the given name.| |hostids|string/array|Return only trigger prototypes that belong to the given hosts.| |inherited|boolean|If set to `true` return only trigger prototypes inherited from a template.| |maintenance|boolean|If set to `true` return only enabled trigger prototypes that belong to hosts in maintenance.| |min\_severity|integer|Return only trigger prototypes with severity greater or equal than the given severity.| |monitored|flag|Return only enabled trigger prototypes that belong to monitored hosts and contain only enabled items.| |templated|boolean|If set to `true` return only trigger prototypes that belong to templates.| |templateids|string/array|Return only trigger prototypes that belong to the given templates.| |triggerids|string/array|Return only trigger prototypes with the given IDs.| |expandExpression|flag|Expand functions and macros in the trigger expression.| |selectDependencies|query|Return trigger prototypes and triggers that the trigger prototype depends on in the `dependencies` property.| |selectDiscoveryRule|query|Return the [LLD rule](/manual/api/reference/discoveryrule/object) that the trigger prototype belongs to.| |selectFunctions|query|Return functions used in the trigger prototype in the `functions` property.<br><br>The function objects represent the functions used in the trigger expression and has the following properties:<br>`functionid` - *(string)* ID of the function;<br>`itemid` - *(string)* ID of the item used in the function;<br>`function` - *(string)* name of the function;<br>`parameter` - *(string)* parameter passed to the function. Query parameter is replaced by `$` symbol in returned string.| |selectGroups|query|Return the host groups that the trigger prototype belongs to in the [groups](/manual/api/reference/hostgroup/object) property.| |selectHosts|query|Return the hosts that the trigger prototype belongs to in the [hosts](/manual/api/reference/host/object) property.| |selectItems|query|Return items and item prototypes used the trigger prototype in the [items](/manual/api/reference/item/object) property.| |selectTags|query|Return the trigger prototype tags in [tags](/manual/api/reference/triggerprototype/object#Trigger_prototype_tag) property.| |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 trigger prototype belongs to;<br>`hostid` - ID of the host that the trigger prototype belongs to.| |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`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `triggerid`, `description`, `status` and `priority`.| |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|^| |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)|描述| |--|--|------| |active|flag|仅返回属于受监控主机的已启用触发器原型。| |discoveryids|string/array|只返回属于给定 LLD 规则的触发器原型。| |functions|字符串/数组|仅返回使用给定函数的触发器。<br><br>有关支持函数的列表，请参阅[支持的函数](/manual/appendix/functions)页面。| |group|string|仅返回属于具有给定名称的主机组中的主机的触发器原型。| |groupids|string/array|仅返回属于给定主机组中主机的触发器原型。| |host|string|仅返回属于具有给定名称的主机的触发器原型。| |hostids|string/array|只返回属于给定主机的触发器原型。| |inherited|boolean|如果设置为“true”，则仅返回从模板继承的触发器原型。| |maintenance|boolean|如果设置为“true”，则仅返回属于维护中主机的已启用触发器原型。| |min\_severity|integer|仅返回严重性大于或等于给定严重性的触发器原型。| |monitored|flag|仅返回属于受监控主机且仅包含启用项目的已启用触发器原型。| |templated|boolean|如果设置为“true”，则只返回属于模板的触发器原型。| |templateids|string/array|只返回属于给定模板的触发器原型。| |triggerids|字符串/数组|仅返回具有给定ID的触发器原型。| |expandExpression|flag|展开触发器表达式中的函数和宏。| |selectDependencies|query|在`dependencies`属性中返回触发器原型和触发器原型所依赖的触发器。| |selectDiscoveryRule|query|返回触发器原型所属的[LLD规则](/manual/api/reference/discoveryrule/object)。| |selectFunctions|query|在 `functions` 属性中返回触发器原型中使用的函数。<br><br>函数对象表示触发器表达式中使用的函数，具有以下属性：<br>`functionid` - * (string)* 函数的 ID；<br>`itemid` - *(string)* 函数中使用的项目的 ID；<br>`function` - *(string)* 函数的名称；<br> `parameter` - *(string)* 传递给函数的参数。 查询参数在返回的字符串中被替换为“$”符号。| |selectGroups|query|在[groups](/manual/api/reference/hostgroup/object) 属性中返回触发器原型所属的主机组。| |selectHosts|query|在[hosts](/manual/api/reference/host/object) 属性中返回触发器原型所属的主机。| |selectItems|query|返回监控项和监控项原型使用 [items](/manual/api/reference/item/object) 属性中的触发器原型。| |selectTags|query|返回[tags](/manual/api/reference/triggerprototype/object#Trigger_prototype_tag) 属性中的触发器原型标签。| |filter|object|只返回那些与给定过滤器完全匹配的结果。<br><br>接受一个数组，其中键是属性名称，值是要匹配的单个值或值数组。 <br><br>支持额外的过滤器：<br>`host` - 触发器原型所属主机的正式名称；<br>`hostid` - 触发器原型所属主机的 ID。| |limitSelects|integer|限制子选择返回的记录数。<br><br>适用于以下子选择：<br>`selectHosts` - 结果将按 `host` 排序。| |sortfield|string/array|按给定的属性对结果进行排序。<br><br>可能的值为：`triggerid`、`description`、`status` 和 `priority`。| |countOutput|boolean|[参考评论](/manual/api/reference_commentary#common_get_method_parameters) 中详细描述了所有“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| |--|--|------| |alertids|string/array|Return only alerts with the given IDs.| |actionids|string/array|Return only alerts generated by the given actions.| |eventids|string/array|Return only alerts generated by the given events.| |groupids|string/array|Return only alerts generated by objects from the given host groups.| |hostids|string/array|Return only alerts generated by objects from the given hosts.| |mediatypeids|string/array|Return only message alerts that used the given media types.| |objectids|string/array|Return only alerts generated by the given objects| |userids|string/array|Return only message alerts that were sent to the given users.| |eventobject|integer|Return only alerts generated by events related to objects of the given type.<br><br>See event ["object"](/manual/api/reference/event/object#event) for a list of supported object types.<br><br>Default: 0 - trigger.| |eventsource|integer|Return only alerts generated by events of the given type.<br><br>See event ["source"](/manual/api/reference/event/object#event) for a list of supported event types.<br><br>Default: 0 - trigger events.| |time\_from|timestamp|Return only alerts that have been generated after the given time.| |time\_till|timestamp|Return only alerts that have been generated before the given time.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with data of hosts that triggered the action operation.| |selectMediatypes|query|Return a [mediatypes](/manual/api/reference/mediatype/object) property with an array of the media types that were used for the message alert.| |selectUsers|query|Return a [users](/manual/api/reference/user/object) property with an array of the users that the message was addressed to.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `alertid`, `clock`, `eventid`, `mediatypeid`, `sendto` and `status`.| |countOutput|boolean|These parameters being common for all `get` methods are described 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#数据类型)|描述| |---------|---------------------------------------------------|-----------| |alertids|string/array|仅返回给定 ID 的告警。| |actionids|string/array|仅返回给定动作生成的告警。| |eventids|string/array|仅返回给定事件生成的告警。| |groupids|string/array|仅返回来自指定主机组的对象生成的告警。| |hostids|string/array|仅返回来自指定主机的对象生成的告警。| |mediatypeids|string/array|仅返回使用给定媒介类型的消息告警。| |objectids|string/array|仅返回指定对象生成的告警。| |userids|string/array|仅返回发送给指定用户的消息告警。| |eventobject|integer|仅返回由与给定类型的对象相关的事件生成的告警。<br><br>参考 event ["object"](/manual/api/reference/event/object#事件) 获取受支持的对象类型列表。<br><br>默认： 0 - 触发器。| |eventsource|integer|仅返回由给定类型的事件生成的告警。<br><br>参考 event ["source"](/manual/api/reference/event/object#事件) 获取受支持的事件类型列表。<br><br>默认： 0 - 触发器事件。| |time\_from|timestamp|仅返回在给定时间之后生成的告警。| |time\_till|timestamp|仅返回在给定时间之前生成的告警。| |selectHosts|query|在 [hosts](/manual/api/reference/host/object) 属性中返回触发动作操作的主机。| |selectMediatypes|query|在 [mediatypes](/manual/api/reference/mediatype/object) 属性中以数组形式返回消息告警的媒介类型。| |selectUsers|query|在 [users](/manual/api/reference/user/object) 属性中以数组形式返回消息发送到的用户。| |sortfield|string/array|根据给定的属性排序结果。<br><br>可用值： `alertid`, `clock`, `eventid`, `mediatypeid`, `sendto` 和 `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| |---------|---------------------------------------------------|-----------| |alertids|string/array|Return only alerts with the given IDs.| |actionids|string/array|Return only alerts generated by the given actions.| |eventids|string/array|Return only alerts generated by the given events.| |groupids|string/array|Return only alerts generated by objects from the given host groups.| |hostids|string/array|Return only alerts generated by objects from the given hosts.| |mediatypeids|string/array|Return only message alerts that used the given media types.| |objectids|string/array|Return only alerts generated by the given objects| |userids|string/array|Return only message alerts that were sent to the given users.| |eventobject|integer|Return only alerts generated by events related to objects of the given type.<br><br>See event ["object"](/manual/api/reference/event/object#event) for a list of supported object types.<br><br>Default: 0 - trigger.| |eventsource|integer|Return only alerts generated by events of the given type.<br><br>See event ["source"](/manual/api/reference/event/object#event) for a list of supported event types.<br><br>Default: 0 - trigger events.| |time\_from|timestamp|Return only alerts that have been generated after the given time.| |time\_till|timestamp|Return only alerts that have been generated before the given time.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with data of hosts that triggered the action operation.| |selectMediatypes|query|Return a [mediatypes](/manual/api/reference/mediatype/object) property with an array of the media types that were used for the message alert.| |selectUsers|query|Return a [users](/manual/api/reference/user/object) property with an array of the users that the message was addressed to.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `alertid`, `clock`, `eventid`, `mediatypeid`, `sendto` and `status`.| |countOutput|boolean|These parameters being common for all `get` methods are described 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#数据类型)|描述| |---------|---------------------------------------------------|-----------| |alertids|string/array|仅返回给定 ID 的告警。| |actionids|string/array|仅返回给定动作生成的告警。| |eventids|string/array|仅返回给定事件生成的告警。| |groupids|string/array|仅返回来自指定主机组的对象生成的告警。| |hostids|string/array|仅返回来自指定主机的对象生成的告警。| |mediatypeids|string/array|仅返回使用给定媒介类型的消息告警。| |objectids|string/array|仅返回指定对象生成的告警。| |userids|string/array|仅返回发送给指定用户的消息告警。| |eventobject|integer|仅返回由与给定类型的对象相关的事件生成的告警。<br><br>参考 event ["object"](/manual/api/reference/event/object#事件) 获取受支持的对象类型列表。<br><br>默认： 0 - 触发器。| |eventsource|integer|仅返回由给定类型的事件生成的告警。<br><br>参考 event ["source"](/manual/api/reference/event/object#事件) 获取受支持的事件类型列表。<br><br>默认： 0 - 触发器事件。| |time\_from|timestamp|仅返回在给定时间之后生成的告警。| |time\_till|timestamp|仅返回在给定时间之前生成的告警。| |selectHosts|query|在 [hosts](/manual/api/reference/host/object) 属性中返回触发动作操作的主机。| |selectMediatypes|query|在 [mediatypes](/manual/api/reference/mediatype/object) 属性中以数组形式返回消息告警的媒介类型。| |selectUsers|query|在 [users](/manual/api/reference/user/object) 属性中以数组形式返回消息发送到的用户。| |sortfield|string/array|根据给定的属性排序结果。<br><br>可用值： `alertid`, `clock`, `eventid`, `mediatypeid`, `sendto` 和 `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| |--|--|------| |correlationids|string/array|Return only correlations with the given IDs.| |selectFilter|query|Return a [filter](/manual/api/reference/correlation/object#correlation_filter) property with the correlation conditions.| |selectOperations|query|Return an [operations](/manual/api/reference/correlation/object#correlation_operation) property with the correlation operations.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `correlationid`, `name` and `status`.| |countOutput|boolean|These parameters being common for all `get` methods are described 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)` 定义需要输出的参数。  此方法支持以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|说明| |---------|---------------------------------------------------|-----------| |correlationids|string/array|仅返回给定 ID 的关联。| |selectFilter|query|返回带有关联条件的[过滤](/manual/api/reference/correlation/object#关联过滤)属性。| |selectOperations|query|返回带有关联操作的[操作](/manual/api/reference/correlation/object#关联操作) 属性。| |sortfield|string/array|按照给定属性对结果进行排序。<br><br>可用值：`correlationid`，`name` 和 `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| |---------|---------------------------------------------------|-----------| |correlationids|string/array|Return only correlations with the given IDs.| |selectFilter|query|Return a [filter](/manual/api/reference/correlation/object#correlation_filter) property with the correlation conditions.| |selectOperations|query|Return an [operations](/manual/api/reference/correlation/object#correlation_operation) property with the correlation operations.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `correlationid`, `name` and `status`.| |countOutput|boolean|These parameters being common for all `get` methods are described 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)` 定义需要输出的参数。  此方法支持以下参数。  |参数|[类型](/manual/api/reference_commentary#数据类型)|说明| |---------|---------------------------------------------------|-----------| |correlationids|string/array|仅返回给定 ID 的关联。| |selectFilter|query|返回带有关联条件的[过滤](/manual/api/reference/correlation/object#关联过滤)属性。| |selectOperations|query|返回带有关联操作的[操作](/manual/api/reference/correlation/object#关联操作) 属性。| |sortfield|string/array|按照给定属性对结果进行排序。<br><br>可用值：`correlationid`，`name` 和 `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| |--|--|------| |dashboardids|string/array|Return only dashboards with the given IDs.| |selectPages|query|Return a [pages](/manual/api/reference/dashboard/object#dashboard_page) property with dashboard pages, correctly ordered.| |selectUsers|query|Return a [users](/manual/api/reference/dashboard/object#dashboard_user) property with users that the dashboard is shared with.| |selectUserGroups|query|Return a [userGroups](/manual/api/reference/dashboard/object#dashboard_user_group) property with user groups that the dashboard is shared with.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible value is: `dashboardid`.| |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#数据类型)|描述| |---------|---------------------------------------------------|-----------| |dashboardids|string/array|要获取的仪表盘ID。| |selectPages|query|返回按照正确排序的仪表盘页面的 [页面](/manual/api/reference/dashboard/object#仪表盘页面) 属性。| |selectUsers|query|返回共享仪表盘的用户的 [用户](/manual/api/reference/dashboard/object#仪表盘用户) 属性。| |selectUserGroups|query|返回共享仪表盘的用户组的 [用户组](/manual/api/reference/dashboard/object#仪表盘用户组)属性。 | |sortfield|string/array|根据给定的属性对结果进行排序。<br><br>可用值：`dashboardid`。| |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| |---------|---------------------------------------------------|-----------| |dashboardids|string/array|Return only dashboards with the given IDs.| |selectPages|query|Return a [pages](/manual/api/reference/dashboard/object#dashboard_page) property with dashboard pages, correctly ordered.| |selectUsers|query|Return a [users](/manual/api/reference/dashboard/object#dashboard_user) property with users that the dashboard is shared with.| |selectUserGroups|query|Return a [userGroups](/manual/api/reference/dashboard/object#dashboard_user_group) property with user groups that the dashboard is shared with.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible value is: `dashboardid`.| |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#数据类型)|描述| |---------|---------------------------------------------------|-----------| |dashboardids|string/array|要获取的仪表盘ID。| |selectPages|query|返回按照正确排序的仪表盘页面的 [页面](/manual/api/reference/dashboard/object#仪表盘页面) 属性。| |selectUsers|query|返回共享仪表盘的用户的 [用户](/manual/api/reference/dashboard/object#仪表盘用户) 属性。| |selectUserGroups|query|返回共享仪表盘的用户组的 [用户组](/manual/api/reference/dashboard/object#仪表盘用户组)属性。 | |sortfield|string/array|根据给定的属性对结果进行排序。<br><br>可用值：`dashboardid`。| |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| |--|--|------| |dashboardids|string/array|Return only template dashboards with the given IDs.| |templateids|string/array|Return only template dashboards that belong to the given templates.| |selectPages|query|Return a [pages](/manual/api/reference/templatedashboard/object#template_dashboard_page) property with template dashboard pages, correctly ordered.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `dashboardid` 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)|描述| |---------|---------|---------| |dashboardids|string/array|仅返回具有给定ID的模板仪表盘。| |templateids|string/arary|仅返回属于给定模板的模板仪表盘。| |selectPages|query|按正确顺序返回带有模板仪表盘页面的[pages](/manual/api/reference/templatedashboard/object#template_dashboard_page)属性。 | |sortfield|string/array|按给定属性对结果进行排序。<br><br>可能的值是： `dashboardid` and `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| |--|--|------| |dcheckids|string/array|Return only discovery checks with the given IDs.| |druleids|string/array|Return only discovery checks that belong to the given discovery rules.| |dserviceids|string/array|Return only discovery checks that have detected the given discovered services.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `dcheckid` and `druleid`.| |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#数据类型)|描述| |---------|---------------------------------------------------|-----------| |dcheckids|string/array|仅返回具有给定 ID 的发现检查。| |druleids|string/array|仅返回属于给定发现规则的发现检查。| |dserviceids|string/array|仅返回检查到给定被发现服务的发现检查。| |sortfield|string/array|按照给定属性对结果进行排序。<br><br>可用值： `dcheckid` 和 `druleid`。| |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| |---------|---------------------------------------------------|-----------| |dcheckids|string/array|Return only discovery checks with the given IDs.| |druleids|string/array|Return only discovery checks that belong to the given discovery rules.| |dserviceids|string/array|Return only discovery checks that have detected the given discovered services.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `dcheckid` and `druleid`.| |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#数据类型)|描述| |---------|---------------------------------------------------|-----------| |dcheckids|string/array|仅返回具有给定 ID 的发现检查。| |druleids|string/array|仅返回属于给定发现规则的发现检查。| |dserviceids|string/array|仅返回检查到给定被发现服务的发现检查。| |sortfield|string/array|按照给定属性对结果进行排序。<br><br>可用值： `dcheckid` 和 `druleid`。| |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| |--|--|------| |dhostids|string/array|Return only discovered hosts with the given IDs.| |druleids|string/array|Return only discovered hosts that have been created by the given discovery rules.| |dserviceids|string/array|Return only discovered hosts that are running the given services.| |selectDRules|query|Return a [drules](/manual/api/reference/drule/object) property with an array of the discovery rules that detected the host.| |selectDServices|query|Return a [dservices](/manual/api/reference/dservice/object) property with the discovered services running on the host.<br><br>Supports `count`.| |limitSelects|integer|Limits the number of records returned by subselects.<br><br>Applies to the following subselects:<br>`selectDServices` - results will be sorted by `dserviceid`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `dhostid` and `druleid`.| |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)|描述| |---------|---------------------------------------------------|-----------| |dhostids|字符串/数组|只返回给定ID的被发现的主机| |druleids|字符串/数组|只返回发现规则创建的已发现主机。| |dserviceids|字符串/数组|只返回指定服务的已发现主机。| |selectDRules|查询|返回一个[drules](/manual/api/reference/drule/object)属性，其中包括检测到主机发现规则数组。| |selectDServices|查询|返回[dservices](/manual/api/reference/dservice/object)属性，发现的服务在主机上运行。<br><br>支持 `count`。| |limitSelects|整数|限制子选项返回的记录数<br><br>用于如下的子选项:<br>`selectDServices` - 结果会按照 `dserviceid`排序。| |sortfield|字符串/数组|按照给出的属性对结果进行排序。<br><br>可能的值: `dhostid` 和 `druleid`.| |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| |---------|---------------------------------------------------|-----------| |dhostids|string/array|Return only discovered hosts with the given IDs.| |druleids|string/array|Return only discovered hosts that have been created by the given discovery rules.| |dserviceids|string/array|Return only discovered hosts that are running the given services.| |selectDRules|query|Return a [drules](/manual/api/reference/drule/object) property with an array of the discovery rules that detected the host.| |selectDServices|query|Return a [dservices](/manual/api/reference/dservice/object) property with the discovered services running on the host.<br><br>Supports `count`.| |limitSelects|integer|Limits the number of records returned by subselects.<br><br>Applies to the following subselects:<br>`selectDServices` - results will be sorted by `dserviceid`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `dhostid` and `druleid`.| |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)|描述| |---------|---------------------------------------------------|-----------| |dhostids|字符串/数组|只返回给定ID的被发现的主机| |druleids|字符串/数组|只返回发现规则创建的已发现主机。| |dserviceids|字符串/数组|只返回指定服务的已发现主机。| |selectDRules|查询|返回一个[drules](/manual/api/reference/drule/object)属性，其中包括检测到主机发现规则数组。| |selectDServices|查询|返回[dservices](/manual/api/reference/dservice/object)属性，发现的服务在主机上运行。<br><br>支持 `count`。| |limitSelects|整数|限制子选项返回的记录数<br><br>用于如下的子选项:<br>`selectDServices` - 结果会按照 `dserviceid`排序。| |sortfield|字符串/数组|按照给出的属性对结果进行排序。<br><br>可能的值: `dhostid` 和 `druleid`.| |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| |--|--|------| |dhostids|string/array|Return only discovery rules that created the given discovered hosts.| |druleids|string/array|Return only discovery rules with the given IDs.| |dserviceids|string/array|Return only discovery rules that created the given discovered services.| |selectDChecks|query|Return a [dchecks](/manual/api/reference/dcheck/object) property with the discovery checks used by the discovery rule.<br><br>Supports `count`.| |selectDHosts|query|Return a [dhosts](/manual/api/reference/dhost/object) property with the discovered hosts created by the discovery rule.<br><br>Supports `count`.| |limitSelects|integer|Limits the number of records returned by subselects.<br><br>Applies to the following subselects:<br>`selectDChecks` - results will be sorted by `dcheckid`;<br>`selectDHosts` - results will be sorted by `dhostsid`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `druleid` 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#数据类型)|描述| |---------|---------------------------------------------------|-----------| |dhostids|string/array|仅返回创建给定已发现主机的发现规则。| |druleids|string/array|仅返回具有给定 ID 的发现规则。| |dserviceids|string/array|仅返回创建给定已发现服务的发现规则。| |selectDChecks|query|返回 [dchecks](/manual/api/reference/dcheck/object) 属性，其中包含发现规则使用的发现检查。<br><br>支持 `count`。| |selectDHosts|query|返回 [dhosts](/manual/api/reference/dhost/object) 属性，其中包含由发现规则创建的已发现主机。<br><br>Supports `count`.| |limitSelects|integer|限制子选择返回的记录数。<br><br>适用于以下子选择：<br>`selectDChecks` - 结果将按照 `dcheckid` 排序；<br>`selectDHosts` - 结果将按照 `dhostsid` 排序。| |sortfield|string/array|根据给定的属性对结果进行排序。<br><br>可用值：`druleid` 和 `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| |---------|---------------------------------------------------|-----------| |dhostids|string/array|Return only discovery rules that created the given discovered hosts.| |druleids|string/array|Return only discovery rules with the given IDs.| |dserviceids|string/array|Return only discovery rules that created the given discovered services.| |selectDChecks|query|Return a [dchecks](/manual/api/reference/dcheck/object) property with the discovery checks used by the discovery rule.<br><br>Supports `count`.| |selectDHosts|query|Return a [dhosts](/manual/api/reference/dhost/object) property with the discovered hosts created by the discovery rule.<br><br>Supports `count`.| |limitSelects|integer|Limits the number of records returned by subselects.<br><br>Applies to the following subselects:<br>`selectDChecks` - results will be sorted by `dcheckid`;<br>`selectDHosts` - results will be sorted by `dhostsid`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `druleid` 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#数据类型)|描述| |---------|---------------------------------------------------|-----------| |dhostids|string/array|仅返回创建给定已发现主机的发现规则。| |druleids|string/array|仅返回具有给定 ID 的发现规则。| |dserviceids|string/array|仅返回创建给定已发现服务的发现规则。| |selectDChecks|query|返回 [dchecks](/manual/api/reference/dcheck/object) 属性，其中包含发现规则使用的发现检查。<br><br>支持 `count`。| |selectDHosts|query|返回 [dhosts](/manual/api/reference/dhost/object) 属性，其中包含由发现规则创建的已发现主机。<br><br>Supports `count`.| |limitSelects|integer|限制子选择返回的记录数。<br><br>适用于以下子选择：<br>`selectDChecks` - 结果将按照 `dcheckid` 排序；<br>`selectDHosts` - 结果将按照 `dhostsid` 排序。| |sortfield|string/array|根据给定的属性对结果进行排序。<br><br>可用值：`druleid` 和 `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| |--|--|------| |discoveryids|string/array|Return only graph prototypes that belong to the given discovery rules.| |graphids|string/array|Return only graph prototypes with the given IDs.| |groupids|string/array|Return only graph prototypes that belong to hosts in the given host groups.| |hostids|string/array|Return only graph prototypes that belong to the given hosts.| |inherited|boolean|If set to `true` return only graph prototypes inherited from a template.| |itemids|string/array|Return only graph prototypes that contain the given item prototypes.| |templated|boolean|If set to `true` return only graph prototypes that belong to templates.| |templateids|string/array|Return only graph prototypes that belong to the given templates.| |selectDiscoveryRule|query|Return a [discoveryRule](/manual/api/reference/discoveryrule/object#lld_rule) property with the LLD rule that the graph prototype belongs to.| |selectGraphItems|query|Return a [gitems](/manual/api/reference/graphitem/object) property with the graph items used in the graph prototype.| |selectGroups|query|Return a [groups](/manual/api/reference/hostgroup/object) property with the host groups that the graph prototype belongs to.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with the hosts that the graph prototype belongs to.| |selectItems|query|Return an `items` property with the [items](/manual/api/reference/item/object) and [item prototypes](/manual/api/reference/itemprototype/object) used in the graph prototype.| |selectTemplates|query|Return a [templates](/manual/api/reference/template/object) property with the templates that the graph prototype belongs to.| |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 prototype belongs to;<br>`hostid` - ID of the host that the graph prototype 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).| |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#data_types)|描述| |---------|---------------------------------------------------|-----------| |discoveryids|string/array|只返回属于给定发现规则的图表原型。| |graphids|string/array|只返回具有给定ID的图表原型。| |groupids|string/array|只返回属于给定主机组中的主机的图表原型。| |hostids|string/array|只返回属于给定主机的图表原型。| |inherited|boolean|如果设置为`true`，只返回从模板继承的图表原型。| |itemids|string/array|只返回包含给定监控项原型的图表原型。| |templated|boolean|如果设置为`true`，只返回属于模板的图表原型。| |templateids|string/array|只返回属于给定模板的图表原型。| |selectDiscoveryRule|query|返回一个[发现规则](/manual/api/reference/discoveryrule/object#lld_rule)属性，其带有图表原型所属的LLD规则。| |selectGraphItems|query|返回一个[图表项](/manual/api/reference/graphitem/object)属性，其中包含图表原型中使用的图表项目。| |selectGroups|query|返回一个[主机组](/manual/api/reference/hostgroup/object)属性，包含图表原型所属的主机组。| |selectHosts|query|返回一个[主机](/manual/api/reference/host/object)属性，包含图表原型所属的主机。| |selectItems|query|返回一个`items`属性，包含图表原型中使用的[监控项](/manual/api/reference/item/object)和[监控项原型](/manual/api/reference/itemprototype/object)。| |selectTemplates|query|返回一个[模板](/manual/api/reference/template/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#common_get_method_parameters)中有详细描述。| |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| |---------|---------------------------------------------------|-----------| |discoveryids|string/array|Return only graph prototypes that belong to the given discovery rules.| |graphids|string/array|Return only graph prototypes with the given IDs.| |groupids|string/array|Return only graph prototypes that belong to hosts in the given host groups.| |hostids|string/array|Return only graph prototypes that belong to the given hosts.| |inherited|boolean|If set to `true` return only graph prototypes inherited from a template.| |itemids|string/array|Return only graph prototypes that contain the given item prototypes.| |templated|boolean|If set to `true` return only graph prototypes that belong to templates.| |templateids|string/array|Return only graph prototypes that belong to the given templates.| |selectDiscoveryRule|query|Return a [discoveryRule](/manual/api/reference/discoveryrule/object#lld_rule) property with the LLD rule that the graph prototype belongs to.| |selectGraphItems|query|Return a [gitems](/manual/api/reference/graphitem/object) property with the graph items used in the graph prototype.| |selectGroups|query|Return a [groups](/manual/api/reference/hostgroup/object) property with the host groups that the graph prototype belongs to.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with the hosts that the graph prototype belongs to.| |selectItems|query|Return an `items` property with the [items](/manual/api/reference/item/object) and [item prototypes](/manual/api/reference/itemprototype/object) used in the graph prototype.| |selectTemplates|query|Return a [templates](/manual/api/reference/template/object) property with the templates that the graph prototype belongs to.| |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 prototype belongs to;<br>`hostid` - ID of the host that the graph prototype 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).| |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#data_types)|描述| |---------|---------------------------------------------------|-----------| |discoveryids|string/array|只返回属于给定发现规则的图表原型。| |graphids|string/array|只返回具有给定ID的图表原型。| |groupids|string/array|只返回属于给定主机组中的主机的图表原型。| |hostids|string/array|只返回属于给定主机的图表原型。| |inherited|boolean|如果设置为`true`，只返回从模板继承的图表原型。| |itemids|string/array|只返回包含给定监控项原型的图表原型。| |templated|boolean|如果设置为`true`，只返回属于模板的图表原型。| |templateids|string/array|只返回属于给定模板的图表原型。| |selectDiscoveryRule|query|返回一个[发现规则](/manual/api/reference/discoveryrule/object#lld_rule)属性，其带有图表原型所属的LLD规则。| |selectGraphItems|query|返回一个[图表项](/manual/api/reference/graphitem/object)属性，其中包含图表原型中使用的图表项目。| |selectGroups|query|返回一个[主机组](/manual/api/reference/hostgroup/object)属性，包含图表原型所属的主机组。| |selectHosts|query|返回一个[主机](/manual/api/reference/host/object)属性，包含图表原型所属的主机。| |selectItems|query|返回一个`items`属性，包含图表原型中使用的[监控项](/manual/api/reference/item/object)和[监控项原型](/manual/api/reference/itemprototype/object)。| |selectTemplates|query|返回一个[模板](/manual/api/reference/template/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#common_get_method_parameters)中有详细描述。| |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| |--|--|------| |dserviceids|string/array|Return only discovered services with the given IDs.| |dhostids|string/array|Return only discovered services that belong to the given discovered hosts.| |dcheckids|string/array|Return only discovered services that have been detected by the given discovery checks.| |druleids|string/array|Return only discovered services that have been detected by the given discovery rules.| |selectDRules|query|Return a [drules](/manual/api/reference/drule/object) property with an array of the discovery rules that detected the service.| |selectDHosts|query|Return a [dhosts](/manual/api/reference/dhost/object) property with an array the discovered hosts that the service belongs to.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with the hosts with the same IP address and proxy as the service.<br><br>Supports `count`.| |limitSelects|integer|Limits the number of records returned by subselects.<br><br>Applies to the following subselects:<br>`selectHosts` - result will be sorted by `hostid`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `dserviceid`, `dhostid` and `ip`.| |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#数据类型)|描述| |---------|---------------------------------------------------|-----------| |dserviceids|string/array|仅返回具有给定 ID 的被发现对象。| |dhostids|string/array|仅返回属于给定被发现主机的被发现对象。| |dcheckids|string/array|仅返回被给定发现检查检测出的被发现对象。| |druleids|string/array|仅返回被给定发现规则检测出的被发现对象。| |selectDRules|query|返回包含检测到服务的发现规则数组的 [drules](/manual/api/reference/drule/object) 属性。| |selectDHosts|query|返回包含服务所属的被发现主机数组的 [dhosts](/manual/api/reference/dhost/object) 属性。| |selectHosts|query|返回与服务具有相同 IP 地址和代理的主机的 [hosts](/manual/api/reference/host/object) 属性。<br><br>支持 `count`。| |limitSelects|integer|限制子选择返回的记录数。<br><br>适用于以下子选择：<br>`selectHosts` - 结果将按 `hostid` 排序。| |sortfield|string/array|按照给定属性对结果进行排序。<br><br>可用值：`dserviceid`、`dhostid` 和 `ip`。| |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| |---------|---------------------------------------------------|-----------| |dserviceids|string/array|Return only discovered services with the given IDs.| |dhostids|string/array|Return only discovered services that belong to the given discovered hosts.| |dcheckids|string/array|Return only discovered services that have been detected by the given discovery checks.| |druleids|string/array|Return only discovered services that have been detected by the given discovery rules.| |selectDRules|query|Return a [drules](/manual/api/reference/drule/object) property with an array of the discovery rules that detected the service.| |selectDHosts|query|Return a [dhosts](/manual/api/reference/dhost/object) property with an array the discovered hosts that the service belongs to.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with the hosts with the same IP address and proxy as the service.<br><br>Supports `count`.| |limitSelects|integer|Limits the number of records returned by subselects.<br><br>Applies to the following subselects:<br>`selectHosts` - result will be sorted by `hostid`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `dserviceid`, `dhostid` and `ip`.| |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#数据类型)|描述| |---------|---------------------------------------------------|-----------| |dserviceids|string/array|仅返回具有给定 ID 的被发现对象。| |dhostids|string/array|仅返回属于给定被发现主机的被发现对象。| |dcheckids|string/array|仅返回被给定发现检查检测出的被发现对象。| |druleids|string/array|仅返回被给定发现规则检测出的被发现对象。| |selectDRules|query|返回包含检测到服务的发现规则数组的 [drules](/manual/api/reference/drule/object) 属性。| |selectDHosts|query|返回包含服务所属的被发现主机数组的 [dhosts](/manual/api/reference/dhost/object) 属性。| |selectHosts|query|返回与服务具有相同 IP 地址和代理的主机的 [hosts](/manual/api/reference/host/object) 属性。<br><br>支持 `count`。| |limitSelects|integer|限制子选择返回的记录数。<br><br>适用于以下子选择：<br>`selectHosts` - 结果将按 `hostid` 排序。| |sortfield|string/array|按照给定属性对结果进行排序。<br><br>可用值：`dserviceid`、`dhostid` 和 `ip`。| |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|^|