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)|
fa	###پارامتر ها   `(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)|

en-us	### Parameters  `(object)` Authentication properties to be updated.
fa	### پارامترها  `(شیء)` ویژگی های احراز هویت به روز می شود.

en-us	### Parameters  `(object)` Autoregistration properties to be updated.
fa	### پارامترها  `(شیء)` ویژگی های ثبت نام خودکار به روز می شود.

en-us	### Parameters  `(object)` Housekeeping properties to be updated.
fa	### پارامتر ها   `(object)` Housekeeping properties to be updated.

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`, templates that are not linked to the host or template being imported, but are present in the imported data, will be linked; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, templates that are linked to the host or template being imported, but are not present in the imported data, will be unlinked without removing entities (items, triggers, etc.) inherited from the unlinked templates; 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`.|
fa	### پارامتر ها    `(شیء)` پارامترهای شامل  داده برای وارد کردن و قوانین  داده ها باید مدیریت شود .  |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |**قالب**<br>(الزامی)|رشته|قالب رشته سریال شده.<br><br>مقادیر ممکن:<br>`yaml` - YAML;<br>`xml` - XML;<br >`json` - JSON.| |**منبع**<br>(لازم)|رشته|رشته سریالی حاوی داده های پیکربندی.| |**قوانین**<br>(لازم)|شیء|قوانین نحوه وارد کردن اشیاء جدید و موجود.<br><br>پارامتر "قوانین" به تفصیل در جدول زیر توضیح داده شده است.|  ::: یادداشت اگر هیچ قانونی داده نشود، پیکربندی انجام نخواهد شد به روز شد. :::  شی "قوانین" از پارامترهای زیر پشتیبانی می کند.  |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |discoveryRules|object|قوانین نحوه وارد کردن قوانین LLD.<br><br>پارامترهای پشتیبانی شده:<br>"createMissing" - "(بولی)" اگر روی "true" تنظیم شود، قوانین LLD جدید ایجاد خواهد شد. پیش‌فرض: «نادرست»؛<br>«به‌روزرسانی موجود» - «(بولی)» اگر روی «درست» تنظیم شود، قوانین LLD موجود به‌روزرسانی خواهند شد. پیش‌فرض: «نادرست»؛<br>«حذف گمشده» - «(بولی)» اگر روی «true» تنظیم شود، قوانین LLD که در داده‌های وارد شده وجود ندارند، از پایگاه داده حذف خواهند شد. پیش فرض: "نادرست".| |graphs|object|قوانین نحوه وارد کردن نمودارها.<br><br>پارامترهای پشتیبانی شده:<br>"createMissing" - "(Boolean)" اگر روی "true" تنظیم شود، نمودارهای جدید ایجاد خواهند شد. پیش فرض: "نادرست"؛<br>"به روز رسانی موجود" - "(بولی)" اگر روی "درست" تنظیم شود، نمودارهای موجود به روز می شوند. پیش‌فرض: «نادرست»؛<br>«حذف گمشده» - «(بولی)» اگر روی «true» تنظیم شود، نمودارهایی که در داده‌های وارد شده وجود ندارند از پایگاه داده حذف می‌شوند. پیش فرض: "نادرست".| |groups|object|قوانین نحوه وارد کردن گروه های میزبان.<br><br>پارامترهای پشتیبانی شده:<br>`createMissing` - `(Boolean)` اگر روی "true" تنظیم شود، گروه های میزبان جدید ایجاد خواهند شد. پیش‌فرض: «نادرست»؛<br>«به‌روزرسانی موجود» - «(بولی)» اگر روی «درست» تنظیم شود، گروه‌های میزبان موجود به‌روزرسانی خواهند شد. پیش فرض: "نادرست".| |hosts|object|قوانین نحوه وارد کردن هاست.<br><br>پارامترهای پشتیبانی شده:<br>"createMissing" - "(Boolean)" اگر روی "true" تنظیم شود، میزبان های جدید ایجاد می شود. پیش‌فرض: «نادرست»؛<br>«به‌روزرسانی موجود» - «(بولی)» اگر روی «درست» تنظیم شود، میزبان‌های موجود به‌روزرسانی خواهند شد. پیش فرض: "نادرست".| |httptests|object|قوانین نحوه وارد کردن سناریوهای وب.<br><br>پارامترهای پشتیبانی شده:<br>"createMissing" - "(بولی)" اگر روی "true" تنظیم شود، سناریوهای وب جدید ایجاد می شود. پیش‌فرض: «نادرست»؛<br>«به‌روزرسانی موجود» - «(بولی)» اگر روی «درست» تنظیم شود، سناریوهای وب موجود به‌روزرسانی خواهند شد. پیش‌فرض: «نادرست»؛<br>«حذف گمشده» - «(بولی)» اگر روی «درست» تنظیم شود، سناریوهای وب که در داده‌های وارد شده وجود ندارند از پایگاه داده حذف خواهند شد. پیش فرض: "نادرست".| |images|object|قوانین نحوه وارد کردن تصاویر.<br><br>پارامترهای پشتیبانی شده:<br>"createMissing" - "(boolean)" اگر روی "true" تنظیم شود، تصاویر جدید ایجاد خواهند شد. پیش‌فرض: «نادرست»؛<br>«به‌روزرسانی موجود» - «(بولی)» اگر روی «درست» تنظیم شود، تصاویر موجود به‌روزرسانی خواهند شد. پیش فرض: "نادرست".| |items|object|قوانین نحوه وارد کردن اقلام.<br><br>پارامترهای پشتیبانی شده:<br>"createMissing" - "(Boolean)" اگر روی "true" تنظیم شود، موارد جدید ایجاد خواهند شد. پیش‌فرض: «نادرست»؛<br>«به‌روزرسانی موجود» - «(بولی)» اگر روی «درست» تنظیم شود، موارد موجود به‌روزرسانی خواهند شد. پیش‌فرض: «نادرست»؛<br>«حذف گمشده» - «(بولی)» اگر روی «true» تنظیم شود، مواردی که در داده‌های وارد شده وجود ندارند از پایگاه داده حذف می‌شوند. پیش فرض: "نادرست".| |maps|object|قوانین نحوه وارد کردن نقشه ها.<br><br>پارامترهای پشتیبانی شده:<br>"createMissing" - "(Boolean)" اگر روی "true" تنظیم شود، نقشه های جدید ایجاد خواهند شد. پیش‌فرض: «نادرست»؛<br>«به‌روزرسانی موجود» - «(بولی)» اگر روی «درست» تنظیم شود، نقشه‌های موجود به‌روزرسانی خواهند شد. پیش فرض: "نادرست".| |mediaTypes|object|قوانین نحوه وارد کردن انواع رسانه.<br><br>پارامترهای پشتیبانی شده:<br>`createMissing` - `(boolean)` اگر روی "true" تنظیم شود، انواع رسانه های جدید ایجاد خواهند شد. پیش‌فرض: «نادرست»؛<br>«به‌روزرسانی موجود» - «(بولی)» اگر روی «درست» تنظیم شود، انواع رسانه‌های موجود به‌روزرسانی خواهند شد. پیش فرض: "نادرست".| |templateLinkage|شیء|قوانین نحوه وارد کردن پیوندهای الگو.<br><br>پارامترهای پشتیبانی شده:<br>«createMissing» - «(بولی)» اگر روی «true» تنظیم شود، پیوندهای جدیدی بین الگوها و میزبان ایجاد خواهد شد. ; پیش‌فرض: «نادرست»؛<br>«حذف گمشده» - «(بولی)» اگر روی «true» تنظیم شود، پیوندهای قالبی که در داده‌های وارد شده وجود ندارند از پایگاه داده حذف خواهند شد. پیش فرض: "نادرست".| |templates|object|قوانین نحوه وارد کردن الگوها.<br><br>پارامترهای پشتیبانی شده:<br>"createMissing" - "(Boolean)" اگر روی "true" تنظیم شود، الگوهای جدیدی ایجاد خواهند شد. پیش‌فرض: «نادرست»؛<br>«به‌روزرسانی موجود» - «(بولی)» اگر روی «درست» تنظیم شود، الگوهای موجود به‌روزرسانی خواهند شد. پیش فرض: "نادرست".| |templateDashboards|object|قوانین نحوه وارد کردن داشبوردهای الگو.<br><br>پارامترهای پشتیبانی شده:<br>"createMissing" - "(بولی)" اگر روی "true" تنظیم شود، داشبوردهای قالب جدید ایجاد خواهند شد. پیش‌فرض: «نادرست»؛<br>«به‌روزرسانی موجود» - «(بولی)» اگر روی «درست» تنظیم شود، داشبوردهای قالب موجود به‌روزرسانی خواهند شد. پیش‌فرض: «نادرست»؛<br>«حذف گمشده» - «(بولی)» اگر روی «درست» تنظیم شود، داشبوردهای قالبی که در داده‌های وارد شده وجود ندارند از پایگاه داده حذف می‌شوند. پیش فرض: "نادرست".| |triggers|object|قوانین نحوه وارد کردن تریگرها.<br><br>پارامترهای پشتیبانی شده:<br>"createMissing" - "(بولی)" اگر روی "true" تنظیم شود، تریگرهای جدید ایجاد خواهند شد. پیش‌فرض: «نادرست»؛<br>«به‌روزرسانی موجود» - «(بولی)» اگر روی «درست» تنظیم شود، محرک‌های موجود به‌روزرسانی خواهند شد. پیش‌فرض: «نادرست»؛<br>«حذف گمشده» - «(بولی)» اگر روی «true» تنظیم شود، تریگرهایی که در داده‌های وارد شده وجود ندارند از پایگاه داده حذف می‌شوند. پیش فرض: "نادرست".| |valueMaps|object|قوانین نحوه وارد کردن نقشه های ارزش میزبان یا الگو.<br><br>پارامترهای پشتیبانی شده:<br>`createMissing` - `(بولی)` اگر روی "true" تنظیم شود، نقشه های ارزش جدیدی ایجاد خواهند شد. ; پیش‌فرض: «نادرست»؛<br>«به‌روزرسانی موجود» - «(بولی)» اگر روی «درست» تنظیم شود، نقشه‌های مقدار موجود به‌روزرسانی خواهند شد. پیش‌فرض: «نادرست»؛<br>«حذف گمشده» - «(بولی)» اگر روی «true» تنظیم شود، نقشه‌های مقداری که در داده‌های وارد شده وجود ندارند از پایگاه داده حذف خواهند شد. پیش فرض: "نادرست".|

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.|
fa	###پارامتر ها   `(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.|

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.|
fa	### پارامتر ها   `(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.|

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.|
fa	###پارامتر ها  `(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.|

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.|
fa	###پارامتر ها  `(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.|

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.|
fa	پارامتر ها 

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.|
fa	### پارامتر ها   `(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.|

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|
fa	### پارامتر ها  `(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|

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.|
fa	###پارامتر ها   `(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.|

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.|
fa	### پارامتر ها   `(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.|

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.|
fa	###پارامتر ها   `(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.|

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).|
fa	###پارامتر ها   `(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.|

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.|
fa	### پارامتر ها   `(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.|

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`, templates that are not linked to the host or template being imported, but are present in the imported data, will be linked; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, templates that are linked to the host or template being imported, but are not present in the imported data, will be unlinked without removing entities (items, triggers, etc.) inherited from the unlinked templates; 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`.|
fa	### پارامتر ها    شی پارامتر ها شمال اطلاعات ممکن برای وارد کردن و قوانین مدیریت کردن اطلاعات است .   |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`.|

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).|
fa	### پارامترها   `(شیء)` پارامترهای تعیین کننده خروجی مورد نظراست .  این روش تنها از یک پارامتر پشتیبانی می کند.  |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |output|query|این پارامتر برای همه روش‌های «get» که در [تفسیر مرجع] توضیح داده شده مشترک است (/manual/api/reference_commentary#common_get_method_parameters).|

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).|
fa	### پارامترها   `(شیء)` پارامترهای تعیین کننده خروجی مورد نظراست .  این روش تنها از یک پارامتر پشتیبانی می کند.  |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |output|query|این پارامتر برای همه روش‌های «get» که در [تفسیر مرجع] توضیح داده شده مشترک است (/manual/api/reference_commentary#common_get_method_parameters).|

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).|
fa	### پارامترها   `(شیء)` پارامترهای تعیین کننده خروجی مورد نظراست .  این روش تنها از یک پارامتر پشتیبانی می کند.  |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |output|query|این پارامتر برای همه روش‌های «get» که در [تفسیر مرجع] توضیح داده شده مشترک است (/manual/api/reference_commentary#common_get_method_parameters).|

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|^|
fa	### مولفه های  `(شیء)` پارامترهای تعیین کننده خروجی مورد نظر.  این روش از پارامترهای زیر پشتیبانی می کند.  |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |فعال|پرچم|برگرداندن فقط نمونه‌های اولیه ماشه فعال که متعلق به میزبان‌های نظارت شده است.| |discoveryids|string/array|فقط نمونه‌های اولیه ماشه‌ای را برمی‌گرداند که متعلق به قوانین LLD هستند.| |functions|string/array|فقط تریگرهایی را برمی گرداند که از توابع داده شده استفاده می کنند.<br><br>برای لیستی از توابع پشتیبانی شده به صفحه [عملکردهای پشتیبانی شده](/manual/appendix/functions) مراجعه کنید.| |group|string|فقط نمونه‌های اولیه ماشه‌ای را که متعلق به میزبان‌های گروه‌های میزبان با نام داده شده است، برگرداند.| |groupids|string/array|فقط نمونه‌های اولیه ماشه‌ای را برمی‌گرداند که متعلق به میزبان‌های گروه‌های میزبان معین است.| |host|string|فقط نمونه‌های اولیه ماشه‌ای را که به میزبان‌هایی با نام داده شده تعلق دارند برمی‌گرداند.| |hostids|string/array|فقط نمونه‌های اولیه ماشه‌ای را برمی‌گرداند که متعلق به میزبان‌های داده شده است.| |به ارث رسیده|بولی|اگر روی "true" تنظیم شود، فقط نمونه های اولیه را که از یک الگو به ارث رسیده اند را باز می گرداند.| |maintenance|boolean|اگر روی "true" تنظیم شود، فقط نمونه‌های اولیه ماشه‌ای را فعال می‌کند که متعلق به میزبان در تعمیر و نگهداری است.| |min\_severity|عدد صحیح|برگردان فقط نمونه‌های اولیه ماشه با شدت بیشتر یا مساوی از شدت داده‌شده.| |monitored|flag|فقط نمونه‌های اولیه راه‌انداز فعال را برگرداند که به میزبان‌های نظارت شده تعلق دارند و فقط حاوی موارد فعال هستند.| |templated|boolean|اگر روی "true" تنظیم شود، فقط نمونه های اولیه را که به قالب ها تعلق دارند را فعال کنید.| |templateids|string/array|برگرداندن فقط نمونه های اولیه تریگر که متعلق به الگوهای داده شده هستند.| |triggerids|string/array|برگرداندن فقط نمونه های اولیه تریگر با شناسه های داده شده.| |expandExpression|flag| توابع و ماکروها را در عبارت ماشه گسترش دهید.| |selectDependencies|query|پرتوتایپ‌های تریگر و تریگرهایی را که نمونه اولیه ماشه در ویژگی «وابستگی» به آن‌ها وابسته است، برگردانید.| |selectDiscoveryRule|query|قانون [LLD](/manual/api/reference/discoveryrule/object) را که نمونه اولیه ماشه به آن تعلق دارد، برگردانید.| |selectFunctions|پرس و جو|برگرداندن توابع استفاده شده در نمونه اولیه ماشه در ویژگی 'functions'.<br><br>اشیاء تابع توابع استفاده شده در عبارت ماشه را نشان می دهند و دارای ویژگی های زیر هستند:<br>`functionid` - * (رشته)* شناسه تابع؛<br>`itemid` - *(رشته)* شناسه مورد استفاده شده در تابع؛<br>`تابع` - *(رشته)* نام تابع؛<br> "پارامتر" - پارامتر *(string)* به تابع ارسال شد. پارامتر پرس و جو با نماد `$` در رشته برگشتی جایگزین می شود.| |selectGroups|query|گروه‌های میزبانی را که نمونه اولیه ماشه به آنها تعلق دارد در ویژگی [گروه‌ها](/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` - شناسه میزبانی که نمونه اولیه ماشه به آن تعلق دارد.| |limitSelects|عدد صحیح|تعداد رکوردهای برگردانده شده توسط انتخاب‌های فرعی را محدود می‌کند.<br><br>برای انتخاب‌های فرعی زیر اعمال می‌شود:<br>«selectHosts» - نتایج بر اساس «میزبان» مرتب می‌شوند.| |sortfield|string/array|نتیجه را بر اساس ویژگی های داده شده مرتب کنید.<br><br>مقادیر ممکن عبارتند از: "triggerid"، "description"، "وضعیت" و "اولویت".| |countOutput|boolean|این پارامترها که برای همه روش‌های «get» مشترک هستند به تفصیل در [تفسیر مرجع] توضیح داده شده‌اند(/manual/api/reference_commentary#common_get_method_parameters).| |قابل ویرایش|بولی|^| |excludeSearch|بولی|^| |حد |عدد صحیح|^| |خروجی|پرس و جو|^| |preservekeys|بولی|^| |جستجو|شیء|^| |searchByAny|بولی|^| |searchWildcardsEnabled|بولی|^| |مرتب |رشته/آرایه|^| |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| |--|--|------| |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|^|
fa	### مولفه های  `(شیء)` پارامترهای تعیین کننده خروجی مورد نظر.  این روش از پارامترهای زیر پشتیبانی می کند.  |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |alertids|string/array|فقط هشدارها را با شناسه های داده شده برمی گرداند.| |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>برای لیستی از رویداد ["object"](/manual/api/reference/event/object#event) را مشاهده کنید. انواع شی پشتیبانی شده.<br><br>پیش‌فرض: 0 - ماشه.| |eventsource|integer|فقط هشدارهای ایجاد شده توسط رویدادهای نوع معین را برگرداند.<br><br>برای لیستی از انواع رویدادهای پشتیبانی شده، رویداد ["source"](/manual/api/reference/event/object#event) را مشاهده کنید. .<br><br>پیش‌فرض: 0 - رویدادهای ماشه‌ای.| |time\_from|timestamp|فقط هشدارهایی را برمی‌گرداند که پس از زمان معین ایجاد شده‌اند.| |time\_till|timestamp|فقط هشدارهایی را برمی‌گرداند که قبل از زمان معین ایجاد شده‌اند.| |selectHosts|پرس و جو|یک ویژگی [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#common_get_method_parameters).| |قابل ویرایش|بولی|^| |excludeSearch|بولی|^| |فیلتر|شیء|^| |حد |عدد صحیح|^| |خروجی|پرس و جو|^| |preservekeys|بولی|^| |جستجو|شیء|^| |searchByAny|بولی|^| |searchWildcardsEnabled|بولی|^| |مرتب |رشته/آرایه|^| |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| |--|--|------| |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|^|
fa	### مولفه های  `(شیء)` پارامترهای تعیین کننده خروجی مورد نظر.  این روش از پارامترهای زیر پشتیبانی می کند.  |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |correlationids|string/array|فقط همبستگی ها را با شناسه های داده شده برمی گرداند.| |selectFilter|query|یک ویژگی [filter](/manual/api/reference/correlation/object#correlation_filter) را با شرایط همبستگی برگردانید.| |selectOperations|query|یک ویژگی [operations](/manual/api/reference/correlation/object#correlation_operation) را با عملیات همبستگی برگردانید.| |sortfield|string/array|نتیجه را بر اساس ویژگی های داده شده مرتب کنید.<br><br>مقادیر ممکن عبارتند از: `correlationid`, `name` و `status`.| |countOutput|boolean|این پارامترها که برای همه روش‌های «get» مشترک هستند در [تفسیر مرجع] توضیح داده شده‌اند(/manual/api/reference_commentary#common_get_method_parameters).| |قابل ویرایش|بولی|^| |excludeSearch|بولی|^| |فیلتر|شیء|^| |حد |عدد صحیح|^| |خروجی|پرس و جو|^| |preservekeys|بولی|^| |جستجو|شیء|^| |searchByAny|بولی|^| |searchWildcardsEnabled|بولی|^| |مرتب |رشته/آرایه|^| |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| |--|--|------| |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|^|
fa	### پارامتر ها   پارامتر ها خروجی مطلوب را تعریف می کنند .   روش مذکور پارامترهای زیر را پشتیبانی می کند .  |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|^|

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|^|
fa	`(object)` Parameters defining the desired output.The method supports the following parameters.|Parameter|[Type](/manual/api/reference_commentary#data_types)|Description||--|--|------||imageids|string/array|Return only images with the given IDs.||sysmapids|string/array|Return images that are used on the given maps.||select\_image|flag|Return an `image` property with the Base64 encoded image.||sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `imageid` and `name`.||countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).||editable|boolean|^||excludeSearch|boolean|^||filter|object|^||limit|integer|^||output|query|^||preservekeys|boolean|^||search|object|^||searchByAny|boolean|^||searchWildcardsEnabled|boolean|^||sortorder|string/array|^||startSearch|boolean|^|

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|^|
fa	### پارامتر ها   `(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|^|

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|^|
fa	### پارامتر ها   `(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|^|

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|^|
fa	### پارامترها   `(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|^|

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|^|
fa	### پارامتر ها   `(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|^|

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 item prototypes that belong to the given LLD rules.| |graphids|string/array|Return only item prototypes that are used in the given graph prototypes.| |hostids|string/array|Return only item prototypes that belong to the given hosts.| |inherited|boolean|If set to `true` return only item prototypes inherited from a template.| |itemids|string/array|Return only item prototypes with the given IDs.| |monitored|boolean|If set to `true` return only enabled item prototypes that belong to monitored hosts.| |templated|boolean|If set to `true` return only item prototypes that belong to templates.| |templateids|string/array|Return only item prototypes that belong to the given templates.| |triggerids|string/array|Return only item prototypes that are used in the given trigger prototypes.| |selectDiscoveryRule|query|Return a [discoveryRule](/manual/api/reference/discoveryrule/object#lld_rule) property with the low-level discovery rule that the item prototype belongs to.| |selectGraphs|query|Return a [manual/api/reference/graphprototype/object\#graph\_prototype](/manual/api/reference/graphprototype/object#graph_prototype) property with graph prototypes that the item prototype is used in.<br><br>Supports `count`.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with an array of hosts that the item prototype belongs to.| |selectTags|query|Return the item prototype tags in [tags](/manual/api/reference/itemprototype/object#Item_prototype_tag) property.| |selectTriggers|query|Return a [triggers](/manual/api/reference/triggerprototype/object#trigger_prototype) property with trigger prototypes that the item prototype is used in.<br><br>Supports `count`.| |selectPreprocessing|query|Return a [preprocessing](/manual/api/reference/item/object#item_preprocessing) property with item preprocessing options.<br><br>It has the following properties:<br>`type` - `(string)` The preprocessing option type:<br>1 - Custom multiplier;<br>2 - Right trim;<br>3 - Left trim;<br>4 - Trim;<br>5 - Regular expression matching;<br>6 - Boolean to decimal;<br>7 - Octal to decimal;<br>8 - Hexadecimal to decimal;<br>9 - Simple change;<br>10 - Change per second;<br>11 - XML XPath;<br>12 - JSONPath;<br>13 - In range;<br>14 - Matches regular expression;<br>15 - Does not match regular expression;<br>16 - Check for error in JSON;<br>17 - Check for error in XML;<br>18 - Check for error using regular expression;<br>19 - Discard unchanged;<br>20 - Discard unchanged with heartbeat;<br>21 - JavaScript;<br>22 - Prometheus pattern;<br>23 - Prometheus to JSON;<br>24 - CSV to JSON;<br>25 - Replace;<br>26 - Check for not supported value;<br>27- XML to JSON.<br><br>`params` - `(string)` Additional parameters used by preprocessing option. Multiple parameters are separated by LF (\\n)character.<br>`error_handler` - `(string)` Action type used in case of preprocessing step failure:<br>0 - Error message is set by Zabbix server;<br>1 - Discard value;<br>2 - Set custom value;<br>3 - Set custom error message.<br><br>`error_handler_params` - `(string)` Error handler parameters.| |selectValueMap|query|Return a [valuemap](/manual/api/reference/valuemap/object) property with item prototype value map.| |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 item prototype belongs to.| |limitSelects|integer|Limits the number of records returned by subselects.<br><br>Applies to the following subselects:<br>`selectGraphs` - results will be sorted by `name`;<br>`selectTriggers` - results will be sorted by `description`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `itemid`, `name`, `key_`, `delay`, `type` and `status`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
fa	### مولفه های  `(شیء)` پارامترهای تعیین کننده خروجی مورد نظر.  این روش از پارامترهای زیر پشتیبانی می کند.  |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |discoveyids|string/array|فقط نمونه های اولیه اقلامی را که به قوانین LLD داده شده تعلق دارند را برمی گرداند.| |graphids|string/array|فقط نمونه‌های اولیه موردی را که در نمونه‌های اولیه گراف استفاده می‌شوند را برگرداند.| |hostids|string/array|فقط نمونه‌های اولیه موردی را که به میزبان‌های داده شده تعلق دارند برمی‌گرداند.| |وارث شده|بولی|اگر روی "true" تنظیم شود، فقط نمونه های اولیه مورد به ارث رسیده از یک الگو را برمی گرداند.| |itemids|string/array|فقط نمونه های اولیه مورد را با شناسه های داده شده برمی گرداند.| |monitored|boolean|اگر روی "true" تنظیم شود، فقط نمونه‌های اولیه آیتم‌های فعال شده را که متعلق به میزبان‌های نظارت شده هستند، برمی‌گرداند.| |templated|boolean|اگر روی "true" تنظیم شود فقط نمونه های اولیه موردی را که به قالب ها تعلق دارند برمی گرداند.| |templateids|string/array|فقط نمونه های اولیه موردی را که به قالب های داده شده تعلق دارند برمی گرداند.| |triggerids|string/array|فقط نمونه‌های اولیه موردی را که در نمونه‌های اولیه ماشه استفاده می‌شوند را برمی‌گرداند.| |selectDiscoveryRule|query|یک ویژگی [discoveryRule](/manual/api/reference/discoveryrule/object#lld_rule) را با قانون کشف سطح پایین که نمونه اولیه مورد به آن تعلق دارد، برگردانید.| |selectGraphs|query|یک ویژگی [manual/api/reference/graphprototype/object\#graph\_prototype](/manual/api/reference/graphprototype/object#graph_prototype) را با نمونه های اولیه گراف که نمونه اولیه مورد در آن استفاده می شود، برگردانید.< br><br>از «تعداد» پشتیبانی می کند.| |selectHosts|پرس و جو|یک ویژگی [host](/manual/api/reference/host/object) را با آرایه‌ای از میزبان‌ها که نمونه اولیه مورد به آن تعلق دارد، برگردانید.| |selectTags|query|برچسب های نمونه اولیه مورد را در ویژگی [tags](/manual/api/reference/iteprototype/object#Item_prototype_tag) برگردانید.| |selectTriggers|query|یک ویژگی [triggers](/manual/api/reference/triggerprototype/object#trigger_prototype) را با نمونه‌های اولیه ماشه‌ای که نمونه اولیه مورد در آن استفاده می‌شود، برگردانید.<br><br>از «شمارش» پشتیبانی می‌کند.| |selectPreprocessing|پرس و جو|یک ویژگی [preprocessing](/manual/api/reference/item/object#item_preprocessing) را با گزینه های پیش پردازش مورد برگردانید.<br><br>این ویژگی دارای ویژگی های زیر است:<br>`type` - ` (رشته)` نوع گزینه پیش پردازش:<br>1 - ضرب سفارشی؛<br>2 - برش راست؛<br>3 - برش چپ؛<br>4 - برش؛<br>5 - تطبیق عبارت منظم؛< br>6 - بولی تا اعشاری؛<br>7 - اکتال به اعشار؛<br>8 - هگزادسیمال تا اعشاری؛<br>9 - تغییر ساده؛<br>10 - تغییر در ثانیه؛<br>11 - XML XPath ;<br>12 - JSONPath;<br>13 - در محدوده؛<br>14 - مطابق با عبارت منظم؛<br>15 - با عبارت معمولی مطابقت ندارد؛<br>16 - بررسی خطا در JSON؛<br> 17 - بررسی خطا در XML؛<br>18 - بررسی خطا با استفاده از عبارت منظم؛<br>19 - صرف‌نظر کردن بدون تغییر؛<br>20 - صرف‌نظر کردن بدون تغییر با ضربان قلب؛<br>21 - JavaScript؛<br>22 - الگوی Prometheus؛<br>23 - Prometheus به JSON؛<br>24 - CSV به JSON؛<br>25 - جایگزین کردن؛<br>26 - بررسی مقدار پشتیبانی نشده؛<br>27- XML به JSON.<br> <br>«پارامز» - «(رشته)» پارامترهای اضافی که توسط گزینه پیش پردازش استفاده می شود. چندین پارامتر با نویسه LF (\\n) از هم جدا می شوند.<br>`error_handler` - `(string)` نوع اقدام مورد استفاده در صورت شکست مرحله پیش پردازش:<br>0 - پیام خطا توسط سرور Zabbix تنظیم شده است؛<br >1 - صرفنظر از مقدار؛<br>2 - تنظیم مقدار سفارشی؛<br>3 - تنظیم پیام خطای سفارشی.<br><br>`error_handler_params` - `(رشته)` پارامترهای کنترل کننده خطا.| |selectValueMap|پرس و جو|یک ویژگی [valuemap](/manual/api/reference/valuemap/object) را با نقشه مقدار نمونه اولیه مورد برگردانید.| |filter|object|فقط نتایجی را برمی‌گرداند که دقیقاً با فیلتر داده شده مطابقت دارند.<br><br>آرایه‌ای را می‌پذیرد، که در آن کلیدها نام ویژگی‌ها هستند و مقادیر یا یک مقدار واحد یا آرایه‌ای از مقادیر هستند که باید با آنها مطابقت داشته باشند. <br><br>پشتیبانی از فیلترهای اضافی:<br>`host` - نام فنی میزبانی که نمونه اولیه مورد به آن تعلق دارد.| |limitSelects|عدد صحیح|تعداد رکوردهای برگردانده شده توسط انتخاب‌های فرعی را محدود می‌کند.<br><br>برای انتخاب‌های فرعی زیر اعمال می‌شود:<br>«selectGraphs» - نتایج بر اساس «نام» مرتب می‌شوند؛<br>«selectTriggers» - نتایج بر اساس 'توضیح' مرتب خواهد شد.| |sortfield|string/array|نتیجه را بر اساس ویژگی های داده شده مرتب کنید.<br><br>مقادیر ممکن عبارتند از: "itemid"، "name"، "key_"، "تاخیر"، "نوع" و "وضعیت".| |countOutput|boolean|این پارامترها که برای همه روش‌های «get» مشترک هستند به تفصیل در [تفسیر مرجع] توضیح داده شده‌اند(/manual/api/reference_commentary#common_get_method_parameters).| |قابل ویرایش|بولی|^| |excludeSearch|بولی|^| |حد |عدد صحیح|^| |خروجی|پرس و جو|^| |preservekeys|بولی|^| |جستجو|شیء|^| |searchByAny|بولی|^| |searchWildcardsEnabled|بولی|^| |مرتب |رشته/آرایه|^| |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| |--|--|------| |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|^|
fa	### پارامتر ها   `(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|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |eventids|string/array|Return only events with the given IDs.| |groupids|string/array|Return only events created by objects that belong to the given host groups.| |hostids|string/array|Return only events created by objects that belong to the given hosts.| |objectids|string/array|Return only events created by the given objects.| |source|integer|Return only events with the given type.<br><br>Refer to the [event object page](object#event) for a list of supported event types.<br><br>Default: 0 - trigger events.| |object|integer|Return only events created by objects of the given type.<br><br>Refer to the [event object page](object#event) for a list of supported object types.<br><br>Default: 0 - trigger.| |acknowledged|boolean|If set to `true` return only acknowledged events.| |suppressed|boolean|`true` - return only suppressed events;<br>`false` - return events in the normal state.| |severities|integer/array|Return only events with given event severities. Applies only if object is trigger.| |evaltype|integer|Rules for tag searching.<br><br>Possible values:<br>0 - (default) And/Or;<br>2 - Or.| |tags|array of objects|Return only events with given tags. Exact match by tag and case-insensitive search by value and operator.<br>Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>An empty array returns all events.<br><br>Possible operator types:<br>0 - (default) Like;<br>1 - Equal;<br>2 - Not like;<br>3 - Not equal<br>4 - Exists;<br>5 - Not exists.| |eventid\_from|string|Return only events with IDs greater or equal to the given ID.| |eventid\_till|string|Return only events with IDs less or equal to the given ID.| |time\_from|timestamp|Return only events that have been created after or at the given time.| |time\_till|timestamp|Return only events that have been created before or at the given time.| |problem\_time\_from|timestamp|Returns only events that were in the problem state starting with `problem_time_from`. Applies only if the source is trigger event and object is trigger. Mandatory if `problem_time_till` is specified.| |problem\_time\_till|timestamp|Returns only events that were in the problem state until `problem_time_till`. Applies only if the source is trigger event and object is trigger. Mandatory if `problem_time_from` is specified.| |value|integer/array|Return only events with the given values.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with hosts containing the object that created the event. Supported only for events generated by triggers, items or LLD rules.| |selectRelatedObject|query|Return a `relatedObject` property with the object that created the event. The type of object returned depends on the event type.| |select\_alerts|query|Return an [alerts](/manual/api/reference/alert/object) property with alerts generated by the event. Alerts are sorted in reverse chronological order.| |select\_acknowledges|query|Return an `acknowledges` property with event updates. Event updates are sorted in reverse chronological order.<br><br>The event update object has the following properties:<br>`acknowledgeid` - `(string)` acknowledgment's ID;<br>`userid` - `(string)` ID of the user that updated the event;<br>`eventid` - `(string)` ID of the updated event;<br>`clock` - `(timestamp)` time when the event was updated;<br>`message` - `(string)` text of the message;<br>`action` - `(integer)` update action that was performed see [event.acknowledge](/manual/api/reference/event/acknowledge);<br>`old_severity` - `(integer)` event severity before this update action;<br>`new_severity` - `(integer)` event severity after this update action;<br>`username` - `(string)` username of the user that updated the event;<br>`name` - `(string)` name of the user that updated the event;<br>`surname` - `(string)` surname of the user that updated the event.<br><br>Supports `count`.| |selectTags|query|Return a [tags](/manual/api/reference/event/object#Event_tag) property with event tags.| |selectSuppressionData|query|Return a `suppression_data` property with the list of maintenances:<br>`maintenanceid` - `(string)` ID of the maintenance;<br>`suppress_until` - `(integer)` time until the event is suppressed.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `eventid`, `objectid` and `clock`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
fa	### پارامتر ها   `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |eventids|string/array|Return only events with the given IDs.| |groupids|string/array|Return only events created by objects that belong to the given host groups.| |hostids|string/array|Return only events created by objects that belong to the given hosts.| |objectids|string/array|Return only events created by the given objects.| |source|integer|Return only events with the given type.<br><br>Refer to the [event object page](object#event) for a list of supported event types.<br><br>Default: 0 - trigger events.| |object|integer|Return only events created by objects of the given type.<br><br>Refer to the [event object page](object#event) for a list of supported object types.<br><br>Default: 0 - trigger.| |acknowledged|boolean|If set to `true` return only acknowledged events.| |suppressed|boolean|`true` - return only suppressed events;<br>`false` - return events in the normal state.| |severities|integer/array|Return only events with given event severities. Applies only if object is trigger.| |evaltype|integer|Rules for tag searching.<br><br>Possible values:<br>0 - (default) And/Or;<br>2 - Or.| |tags|array of objects|Return only events with given tags. Exact match by tag and case-insensitive search by value and operator.<br>Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>An empty array returns all events.<br><br>Possible operator types:<br>0 - (default) Like;<br>1 - Equal;<br>2 - Not like;<br>3 - Not equal<br>4 - Exists;<br>5 - Not exists.| |eventid\_from|string|Return only events with IDs greater or equal to the given ID.| |eventid\_till|string|Return only events with IDs less or equal to the given ID.| |time\_from|timestamp|Return only events that have been created after or at the given time.| |time\_till|timestamp|Return only events that have been created before or at the given time.| |problem\_time\_from|timestamp|Returns only events that were in the problem state starting with `problem_time_from`. Applies only if the source is trigger event and object is trigger. Mandatory if `problem_time_till` is specified.| |problem\_time\_till|timestamp|Returns only events that were in the problem state until `problem_time_till`. Applies only if the source is trigger event and object is trigger. Mandatory if `problem_time_from` is specified.| |value|integer/array|Return only events with the given values.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with hosts containing the object that created the event. Supported only for events generated by triggers, items or LLD rules.| |selectRelatedObject|query|Return a `relatedObject` property with the object that created the event. The type of object returned depends on the event type.| |select\_alerts|query|Return an [alerts](/manual/api/reference/alert/object) property with alerts generated by the event. Alerts are sorted in reverse chronological order.| |select\_acknowledges|query|Return an `acknowledges` property with event updates. Event updates are sorted in reverse chronological order.<br><br>The event update object has the following properties:<br>`acknowledgeid` - `(string)` acknowledgment's ID;<br>`userid` - `(string)` ID of the user that updated the event;<br>`eventid` - `(string)` ID of the updated event;<br>`clock` - `(timestamp)` time when the event was updated;<br>`message` - `(string)` text of the message;<br>`action` - `(integer)` update action that was performed see [event.acknowledge](/manual/api/reference/event/acknowledge);<br>`old_severity` - `(integer)` event severity before this update action;<br>`new_severity` - `(integer)` event severity after this update action;<br>`username` - `(string)` username of the user that updated the event;<br>`name` - `(string)` name of the user that updated the event;<br>`surname` - `(string)` surname of the user that updated the event.<br><br>Supports `count`.| |selectTags|query|Return a [tags](/manual/api/reference/event/object#Event_tag) property with event tags.| |selectSuppressionData|query|Return a `suppression_data` property with the list of maintenances:<br>`maintenanceid` - `(string)` ID of the maintenance;<br>`suppress_until` - `(integer)` time until the event is suppressed.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `eventid`, `objectid` and `clock`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |eventids|string/array|Return only problems with the given IDs.| |groupids|string/array|Return only problems created by objects that belong to the given host groups.| |hostids|string/array|Return only problems created by objects that belong to the given hosts.| |objectids|string/array|Return only problems created by the given objects.| |source|integer|Return only problems with the given type.<br><br>Refer to the [problem event object page](object#problem) for a list of supported event types.<br><br>Default: 0 - problem created by a trigger.| |object|integer|Return only problems created by objects of the given type.<br><br>Refer to the [problem event object page](object#problem) for a list of supported object types.<br><br>Default: 0 - trigger.| |acknowledged|boolean|`true` - return acknowledged problems only;<br>`false` - unacknowledged only.| |suppressed|boolean|`true` - return only suppressed problems;<br>`false` - return problems in the normal state.| |severities|integer/array|Return only problems with given event severities. Applies only if object is trigger.| |evaltype|integer|Rules for tag searching.<br><br>Possible values:<br>0 - (default) And/Or;<br>2 - Or.| |tags|array of objects|Return only problems with given tags. Exact match by tag and case-insensitive search by value and operator.<br>Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>An empty array returns all problems.<br><br>Possible operator types:<br>0 - (default) Like;<br>1 - Equal;<br>2 - Not like;<br>3 - Not equal<br>4 - Exists;<br>5 - Not exists.| |recent|boolean|`true` - return PROBLEM and recently RESOLVED problems (depends on Display OK triggers for N seconds)<br>Default: `false` - UNRESOLVED problems only| |eventid\_from|string|Return only problems with IDs greater or equal to the given ID.| |eventid\_till|string|Return only problems with IDs less or equal to the given ID.| |time\_from|timestamp|Return only problems that have been created after or at the given time.| |time\_till|timestamp|Return only problems that have been created before or at the given time.| |selectAcknowledges|query|Return an `acknowledges` property with the problem updates. Problem updates are sorted in reverse chronological order.<br><br>The problem update object has the following properties:<br>`acknowledgeid` - `(string)` update's ID;<br>`userid` - `(string)` ID of the user that updated the event;<br>`eventid` - `(string)` ID of the updated event;<br>`clock` - `(timestamp)` time when the event was updated;<br>`message` - `(string)` text of the message;<br>`action` - `(integer)`type of update action (see [event.acknowledge](/manual/api/reference/event/acknowledge));<br>`old_severity` - `(integer)` event severity before this update action;<br>`new_severity` - `(integer)` event severity after this update action;<br><br>Supports `count`.| |selectTags|query|Return a [tags](/manual/api/reference/problem/object#problem_tag) property with the problem tags. Output format: `[{"tag": "<tag>", "value": "<value>"}, ...]`.| |selectSuppressionData|query|Return a `suppression_data` property with the list of maintenances:<br>`maintenanceid` - `(string)` ID of the maintenance;<br>`suppress_until` - `(integer)` time until the problem is suppressed.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `eventid`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
fa	### مولفه های  `(شیء)` پارامترهای تعیین کننده خروجی مورد نظر.  این روش از پارامترهای زیر پشتیبانی می کند.  |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |eventids|string/array|فقط مشکلات مربوط به شناسه های داده شده را برمی گرداند.| |groupids|string/array|فقط مشکلات ایجاد شده توسط اشیاء متعلق به گروه های میزبان داده شده را برمی گرداند.| |hostids|string/array|فقط مشکلات ایجاد شده توسط اشیاء متعلق به میزبان های داده شده را برمی گرداند.| |objectids|string/array|فقط مشکلات ایجاد شده توسط اشیاء داده شده را برمی گرداند.| |source|integer|فقط مشکلات مربوط به نوع داده شده را برمی‌گرداند.<br><br>برای لیستی از انواع رویدادهای پشتیبانی شده، به [صفحه شی رویداد مشکل](object#problem) مراجعه کنید.<br><br>پیش‌فرض: 0 - مشکل ایجاد شده توسط یک ماشه.| |object|integer|فقط مشکلات ایجاد شده توسط اشیاء از نوع داده شده را برمی گرداند.<br><br>برای لیستی از انواع شیء پشتیبانی شده به [problem event page object](object#problem) مراجعه کنید.<br><br> پیش فرض: 0 - ماشه.| |تأیید شد|بولی|«درست» - فقط مشکلات تأیید شده را برگردانید؛<br>«نادرست» - فقط تأیید نشده.| |suppressed|boolean|`true` - فقط مشکلات سرکوب شده را برمی گرداند؛<br>`false` - مشکلات برگشتی در حالت عادی.| |severities|عدد صحیح/آرایه|فقط مشکلات را با شدت رویدادهای داده شده برمی گرداند. فقط در صورتی اعمال می شود که شی ماشه باشد.| |evaltype|عدد صحیح|قوانین جستجوی برچسب.<br><br>مقادیر ممکن:<br>0 - (پیش‌فرض) And/Or;<br>2 - Or.| |برچسب|آرایه از اشیاء|فقط مشکلات مربوط به برچسب های داده شده را برمی گرداند. مطابقت دقیق با برچسب و جستجوی بدون حروف بزرگ و کوچک بر اساس مقدار و عملگر.<br>قالب: `[{"tag": "<tag>"، "value": "<value>"، "operator": "<operator> "}، ...]`.<br>یک آرایه خالی همه مشکلات را برمی گرداند.<br><br>انواع عملگرهای ممکن:<br>0 - (پیش فرض) مانند;<br>1 - برابر؛<br>2 - نه مانند؛<br>3 - برابر نیست<br>4 - وجود دارد؛<br>5 - وجود ندارد.| |recent|boolean|`true` - مشکلات PROBLEM و اخیراً RESOLVED را برمی‌گرداند (بستگی به راه‌اندازهای نمایش OK برای N ثانیه دارد)<br>پیش‌فرض: "نادرست" - فقط مشکلات UNRESOLVED| |eventid\_from|string|فقط مشکلات با شناسه های بزرگتر یا مساوی با شناسه داده شده را برمی گرداند.| |eventid\_till|string|فقط مشکلات با شناسه‌های کمتر یا مساوی با شناسه داده شده را برمی‌گرداند.| |time\_from|timestamp|فقط مشکلاتی را که پس از یا در زمان معین ایجاد شده اند برمی گرداند.| |time\_till|timestamp|فقط مشکلاتی را که قبلا یا در زمان معین ایجاد شده اند برمی گرداند.| |selectAcknowledges|پرس و جو|یک ویژگی «تأیید می‌کند» را با به‌روزرسانی‌های مشکل برگردانید. به‌روزرسانی‌های مشکل به ترتیب زمانی معکوس مرتب می‌شوند.<br><br>شیء به‌روزرسانی مشکل دارای ویژگی‌های زیر است:<br>`Acknowledgeid` - `(string)` ID's update;<br>`userid` - `(string) « شناسه کاربری که رویداد را به‌روزرسانی کرده است؛<br>«رویداد» - «(رشته)» شناسه رویداد به‌روزشده؛<br>«ساعت» - «(مهر زمانی)» زمانی که رویداد به‌روزرسانی شد؛<br> «پیام» - «(رشته)» متن پیام؛<br>«عمل» - «(عدد صحیح)» نوع اقدام به‌روزرسانی (به [event.acknowledge](/manual/api/reference/event/acknowledge) مراجعه کنید) ;<br>«شدت_قدیمی» - «(عدد صحیح)» شدت رویداد قبل از این اقدام به‌روزرسانی؛<br>«شدت_جدید» - شدت رویداد «(عدد صحیح)» پس از این اقدام به‌روزرسانی؛<br><br>از «شمارش» پشتیبانی می‌کند. | |selectTags|query|یک ویژگی [tags](/manual/api/reference/problem/object#problem_tag) را با برچسب‌های مشکل برگردانید. فرمت خروجی: `[{"tag": "<tag>"، "value": "<value>"}، ...]`.| |selectSuppressionData|پرس و جو|برگرداندن ویژگی "suppression_data" با لیست نگهداری ها:<br>"maintenanceid" - "(رشته)" شناسه نگهداری؛<br>"suppress_until" - زمان "(عدد صحیح)" تا زمان مشکل سرکوب شده است.| |sortfield|string/array|نتیجه را بر اساس ویژگی های داده شده مرتب کنید.<br><br>مقادیر ممکن عبارتند از: `eventid`.| |countOutput|boolean|این پارامترها که برای همه روش‌های «get» مشترک هستند، به تفصیل در صفحه [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) توضیح داده شده‌اند.| |قابل ویرایش|بولی|^| |excludeSearch|بولی|^| |فیلتر|شیء|^| |حد |عدد صحیح|^| |خروجی|پرس و جو|^| |preservekeys|بولی|^| |جستجو|شیء|^| |searchByAny|بولی|^| |searchWildcardsEnabled|بولی|^| |مرتب |رشته/آرایه|^| |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| |--|--|------| |globalmacro|flag|Return global macros instead of host macros.| |globalmacroids|string/array|Return only global macros with the given IDs.| |groupids|string/array|Return only host macros that belong to hosts or templates from the given host groups.| |hostids|string/array|Return only macros that belong to the given hosts or templates.| |hostmacroids|string/array|Return only host macros with the given IDs.| |inherited|boolean|If set to `true` return only host prototype user macros inherited from a template.| |selectGroups|query|Return host groups that the host macro belongs to in the [groups](/manual/api/reference/hostgroup/object) property.<br><br>Used only when retrieving host macros.| |selectHosts|query|Return hosts that the host macro belongs to in the [hosts](/manual/api/reference/host/object) property.<br><br>Used only when retrieving host macros.| |selectTemplates|query|Return templates that the host macro belongs to in the [templates](/manual/api/reference/template/object) property.<br><br>Used only when retrieving host macros.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible value: `macro`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
fa	### مولفه های  `(شیء)` پارامترهای تعیین کننده خروجی مورد نظر.  این روش از پارامترهای زیر پشتیبانی می کند.  |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |globalmacro|flag|به جای ماکروهای میزبان، ماکروهای جهانی را برگردانید.| |globalmacroids|string/array|فقط ماکروهای جهانی با شناسه های داده شده را برمی گرداند.| |groupids|string/array|فقط ماکروهای میزبانی که متعلق به میزبان ها یا الگوهای گروه های میزبان داده شده هستند را برمی گرداند.| |hostids|string/array|فقط ماکروهایی را که به میزبان ها یا قالب های داده شده تعلق دارند برمی گرداند.| |hostmacroids|string/array|فقط ماکروهای میزبان با شناسه داده شده را برمی گرداند.| |وارث شده|بولی|اگر روی "true" تنظیم شود، فقط ماکروهای کاربر نمونه اولیه میزبان را که از یک الگو به ارث برده شده است، بازگردانید.| |selectGroups|query|برگرداندن گروه‌های میزبانی که ماکرو میزبان به آنها تعلق دارد در ویژگی [groups](/manual/api/reference/hostgroup/object).<br><br>فقط هنگام بازیابی ماکروهای میزبان استفاده می‌شود.| |selectHosts|query|بازگرداندن میزبانهایی که ماکرو میزبان به آنها تعلق دارد در ویژگی [hosts](/manual/api/reference/host/object).<br><br>فقط هنگام بازیابی ماکروهای میزبان استفاده می‌شود.| |selectTemplates|query|الگوهایی را که ماکرو میزبان به آنها تعلق دارد در ویژگی [templates](/manual/api/reference/template/object) برگردانید.<br><br>فقط هنگام بازیابی ماکروهای میزبان استفاده می‌شود.| |sortfield|string/array|نتیجه را بر اساس ویژگی های داده شده مرتب کنید.<br><br>مقدار احتمالی: `macro`.| |countOutput|بولی|این پارامترها که برای همه روش‌های «get» مشترک هستند، به طور مفصل در صفحه [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) توضیح داده شده است.| |قابل ویرایش|بولی|^| |excludeSearch|بولی|^| |فیلتر|شیء|^| |حد |عدد صحیح|^| |خروجی|پرس و جو|^| |preservekeys|بولی|^| |جستجو|شیء|^| |searchByAny|بولی|^| |searchWildcardsEnabled|بولی|^| |مرتب |رشته/آرایه|^| |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| |--|--|------| |graphids|string/array|Return only graph items that belong to the given graphs.| |itemids|string/array|Return only graph items with the given item IDs.| |type|integer|Return only graph items with the given type.<br><br>Refer to the [graph item object page](object#graph_item) for a list of supported graph item types.| |selectGraphs|query|Return a [graphs](/manual/api/reference/graph/object) property with an array of graphs that the item belongs to.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `gitemid`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |sortorder|string/array|^|
fa	### پارامتر ها   `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |graphids|string/array|Return only graph items that belong to the given graphs.| |itemids|string/array|Return only graph items with the given item IDs.| |type|integer|Return only graph items with the given type.<br><br>Refer to the [graph item object page](object#graph_item) for a list of supported graph item types.| |selectGraphs|query|Return a [graphs](/manual/api/reference/graph/object) property with an array of graphs that the item belongs to.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `gitemid`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |sortorder|string/array|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |graphids|string/array|Return only graphs with the given IDs.| |groupids|string/array|Return only graphs that belong to hosts in the given host groups.| |templateids|string/array|Return only graph that belong to the given templates.| |hostids|string/array|Return only graphs that belong to the given hosts.| |itemids|string/array|Return only graphs that contain the given items.| |templated|boolean|If set to `true` return only graphs that belong to templates.| |inherited|boolean|If set to `true` return only graphs inherited from a template.| |expandName|flag|Expand macros in the graph name.| |selectGroups|query|Return a [groups](/manual/api/reference/hostgroup/object) property with the host groups that the graph belongs to.| |selectTemplates|query|Return a [templates](/manual/api/reference/template/object) property with the templates that the graph belongs to.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with the hosts that the graph belongs to.| |selectItems|query|Return an [items](/manual/api/reference/item/object) property with the items used in the graph.| |selectGraphDiscovery|query|Return a `graphDiscovery` property with the graph discovery object. The graph discovery objects links the graph to a graph prototype from which it was created.<br><br>It has the following properties:<br>`graphid` - `(string)` ID of the graph;<br>`parent_graphid` - `(string)` ID of the graph prototype from which the graph has been created.| |selectGraphItems|query|Return a [gitems](/manual/api/reference/graphitem/object) property with the items used in the graph.| |selectDiscoveryRule|query|Return a [discoveryRule](/manual/api/reference/drule/object) property with the low-level discovery rule that created the graph.| |filter|object|Return only those results that exactly match the given filter.<br><br>Accepts an array, where the keys are property names, and the values are either a single value or an array of values to match against.<br><br>Supports additional filters:<br>`host` - technical name of the host that the graph belongs to;<br>`hostid` - ID of the host that the graph belongs to.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `graphid`, `name` and `graphtype`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
fa	###پارامتر ها   `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |graphids|string/array|Return only graphs with the given IDs.| |groupids|string/array|Return only graphs that belong to hosts in the given host groups.| |templateids|string/array|Return only graph that belong to the given templates.| |hostids|string/array|Return only graphs that belong to the given hosts.| |itemids|string/array|Return only graphs that contain the given items.| |templated|boolean|If set to `true` return only graphs that belong to templates.| |inherited|boolean|If set to `true` return only graphs inherited from a template.| |expandName|flag|Expand macros in the graph name.| |selectGroups|query|Return a [groups](/manual/api/reference/hostgroup/object) property with the host groups that the graph belongs to.| |selectTemplates|query|Return a [templates](/manual/api/reference/template/object) property with the templates that the graph belongs to.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with the hosts that the graph belongs to.| |selectItems|query|Return an [items](/manual/api/reference/item/object) property with the items used in the graph.| |selectGraphDiscovery|query|Return a `graphDiscovery` property with the graph discovery object. The graph discovery objects links the graph to a graph prototype from which it was created.<br><br>It has the following properties:<br>`graphid` - `(string)` ID of the graph;<br>`parent_graphid` - `(string)` ID of the graph prototype from which the graph has been created.| |selectGraphItems|query|Return a [gitems](/manual/api/reference/graphitem/object) property with the items used in the graph.| |selectDiscoveryRule|query|Return a [discoveryRule](/manual/api/reference/drule/object) property with the low-level discovery rule that created the graph.| |filter|object|Return only those results that exactly match the given filter.<br><br>Accepts an array, where the keys are property names, and the values are either a single value or an array of values to match against.<br><br>Supports additional filters:<br>`host` - technical name of the host that the graph belongs to;<br>`hostid` - ID of the host that the graph belongs to.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `graphid`, `name` and `graphtype`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |graphids|string/array|Return only host groups that contain hosts or templates with the given graphs.| |groupids|string/array|Return only host groups with the given host group IDs.| |hostids|string/array|Return only host groups that contain the given hosts.| |maintenanceids|string/array|Return only host groups that are affected by the given maintenances.| |monitored\_hosts|flag|Return only host groups that contain monitored hosts.| |real\_hosts|flag|Return only host groups that contain hosts.| |templated\_hosts|flag|Return only host groups that contain templates.| |templateids|string/array|Return only host groups that contain the given templates.| |triggerids|string/array|Return only host groups that contain hosts or templates with the given triggers.| |with\_graphs|flag|Return only host groups that contain hosts with graphs.| |with\_graph\_prototypes|flag|Return only host groups that contain hosts with graph prototypes.| |with\_hosts\_and\_templates|flag|Return only host groups that contain hosts *or* templates.| |with\_httptests|flag|Return only host groups that contain hosts with web checks.<br><br>Overrides the `with_monitored_httptests` parameter.| |with\_items|flag|Return only host groups that contain hosts or templates with items.<br><br>Overrides the `with_monitored_items` and `with_simple_graph_items` parameters.| |with\_item\_prototypes|flag|Return only host groups that contain hosts with item prototypes.<br><br>Overrides the `with_simple_graph_item_prototypes` parameter.| |with\_simple\_graph\_item\_prototypes|flag|Return only host groups that contain hosts with item prototypes, which are enabled for creation and have numeric type of information.| |with\_monitored\_httptests|flag|Return only host groups that contain hosts with enabled web checks.| |with\_monitored\_items|flag|Return only host groups that contain hosts or templates with enabled items.<br><br>Overrides the `with_simple_graph_items` parameter.| |with\_monitored\_triggers|flag|Return only host groups that contain hosts with enabled triggers. All of the items used in the trigger must also be enabled.| |with\_simple\_graph\_items|flag|Return only host groups that contain hosts with numeric items.| |with\_triggers|flag|Return only host groups that contain hosts with triggers.<br><br>Overrides the `with_monitored_triggers` parameter.| |selectDiscoveryRule|query|Return a [discoveryRule](/manual/api/reference/drule/object) property with the LLD rule that created the host group.| |selectGroupDiscovery|query|Return a `groupDiscovery` property with the host group discovery object.<br><br>The host group discovery object links a discovered host group to a host group prototype and has the following properties:<br>`groupid` - `(string)` ID of the discovered host group;<br>`lastcheck` - `(timestamp)` time when the host group was last discovered;<br>`name` - `(string)` name of the host group prototype;<br>`parent_group_prototypeid` - `(string)` ID of the host group prototype from which the host group has been created;<br>`ts_delete` - `(timestamp)` time when a host group that is no longer discovered will be deleted.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with the hosts that belong to the host group.<br><br>Supports `count`.| |selectTemplates|query|Return a [templates](/manual/api/reference/template/object) property with the templates that belong to the host group.<br><br>Supports `count`.| |limitSelects|integer|Limits the number of records returned by subselects.<br><br>Applies to the following subselects:<br>`selectHosts` - results will be sorted by `host`;<br>`selectTemplates` - results will be sorted by `host`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `groupid`, `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
fa	### پارامتر ها   `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |graphids|string/array|Return only host groups that contain hosts or templates with the given graphs.| |groupids|string/array|Return only host groups with the given host group IDs.| |hostids|string/array|Return only host groups that contain the given hosts.| |maintenanceids|string/array|Return only host groups that are affected by the given maintenances.| |monitored\_hosts|flag|Return only host groups that contain monitored hosts.| |real\_hosts|flag|Return only host groups that contain hosts.| |templated\_hosts|flag|Return only host groups that contain templates.| |templateids|string/array|Return only host groups that contain the given templates.| |triggerids|string/array|Return only host groups that contain hosts or templates with the given triggers.| |with\_graphs|flag|Return only host groups that contain hosts with graphs.| |with\_graph\_prototypes|flag|Return only host groups that contain hosts with graph prototypes.| |with\_hosts\_and\_templates|flag|Return only host groups that contain hosts *or* templates.| |with\_httptests|flag|Return only host groups that contain hosts with web checks.<br><br>Overrides the `with_monitored_httptests` parameter.| |with\_items|flag|Return only host groups that contain hosts or templates with items.<br><br>Overrides the `with_monitored_items` and `with_simple_graph_items` parameters.| |with\_item\_prototypes|flag|Return only host groups that contain hosts with item prototypes.<br><br>Overrides the `with_simple_graph_item_prototypes` parameter.| |with\_simple\_graph\_item\_prototypes|flag|Return only host groups that contain hosts with item prototypes, which are enabled for creation and have numeric type of information.| |with\_monitored\_httptests|flag|Return only host groups that contain hosts with enabled web checks.| |with\_monitored\_items|flag|Return only host groups that contain hosts or templates with enabled items.<br><br>Overrides the `with_simple_graph_items` parameter.| |with\_monitored\_triggers|flag|Return only host groups that contain hosts with enabled triggers. All of the items used in the trigger must also be enabled.| |with\_simple\_graph\_items|flag|Return only host groups that contain hosts with numeric items.| |with\_triggers|flag|Return only host groups that contain hosts with triggers.<br><br>Overrides the `with_monitored_triggers` parameter.| |selectDiscoveryRule|query|Return a [discoveryRule](/manual/api/reference/drule/object) property with the LLD rule that created the host group.| |selectGroupDiscovery|query|Return a `groupDiscovery` property with the host group discovery object.<br><br>The host group discovery object links a discovered host group to a host group prototype and has the following properties:<br>`groupid` - `(string)` ID of the discovered host group;<br>`lastcheck` - `(timestamp)` time when the host group was last discovered;<br>`name` - `(string)` name of the host group prototype;<br>`parent_group_prototypeid` - `(string)` ID of the host group prototype from which the host group has been created;<br>`ts_delete` - `(timestamp)` time when a host group that is no longer discovered will be deleted.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with the hosts that belong to the host group.<br><br>Supports `count`.| |selectTemplates|query|Return a [templates](/manual/api/reference/template/object) property with the templates that belong to the host group.<br><br>Supports `count`.| |limitSelects|integer|Limits the number of records returned by subselects.<br><br>Applies to the following subselects:<br>`selectHosts` - results will be sorted by `host`;<br>`selectTemplates` - results will be sorted by `host`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `groupid`, `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groupids|string/array|Return only maintenances that are assigned to the given host groups.| |hostids|string/array|Return only maintenances that are assigned to the given hosts.| |maintenanceids|string/array|Return only maintenances with the given IDs.| |selectGroups|query|Return a [groups](/manual/api/reference/hostgroup/object) property with host groups assigned to the maintenance.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with hosts assigned to the maintenance.| |selectTags|query|Return a [tags](/manual/api/reference/maintenance/object#problem_tag) property with problem tags of the maintenance.| |selectTimeperiods|query|Return a [timeperiods](/manual/api/reference/maintenance/object#Time_period) property with time periods of the maintenance.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `maintenanceid`, `name` and `maintenance_type`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
fa	### مولفه های  `(شیء)` پارامترهای تعیین کننده خروجی مورد نظر.  این روش از پارامترهای زیر پشتیبانی می کند.  |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |groupids|string/array|فقط نگهداری هایی که به گروه های میزبان داده شده اختصاص داده شده اند را برمی گرداند.| |hostids|string/array|فقط تعمیراتی را که به هاست های داده شده اختصاص داده شده است برمی گرداند.| |maintenanceids|string/array|فقط تعمیرات را با شناسه های داده شده برمی گرداند.| |selectGroups|query|یک ویژگی [groups](/manual/api/reference/hostgroup/object) با گروه های میزبان اختصاص داده شده به تعمیر و نگهداری را برگردانید.| |selectHosts|پرس و جو|یک ویژگی [host](/manual/api/reference/host/object) را با میزبان هایی که به تعمیر و نگهداری اختصاص داده شده است، برگردانید.| |selectTags|query|یک ویژگی [tags](/manual/api/reference/maintenance/object#problem_tag) با برچسب‌های مشکل نگهداری را برگردانید.| |selectTimeperiods|پرس و جو|یک ویژگی [timeperiods](/manual/api/reference/maintenance/object#Time_period) را با دوره های زمانی نگهداری برمی گرداند.| |sortfield|string/array|نتیجه را بر اساس ویژگی های داده شده مرتب کنید.<br><br>مقادیر ممکن عبارتند از: "maintenanceid"، "name" و "maintenance_type".| |countOutput|boolean|این پارامترها که برای همه روش‌های «get» مشترک هستند به تفصیل در [تفسیر مرجع] توضیح داده شده‌اند(/manual/api/reference_commentary#common_get_method_parameters).| |قابل ویرایش|بولی|^| |excludeSearch|بولی|^| |فیلتر|شیء|^| |حد |عدد صحیح|^| |خروجی|پرس و جو|^| |preservekeys|بولی|^| |جستجو|شیء|^| |searchByAny|بولی|^| |searchWildcardsEnabled|بولی|^| |مرتب |رشته/آرایه|^| |startSearch|بولی|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groupids|string/array|Return only web scenarios that belong to the given host groups.| |hostids|string/array|Return only web scenarios that belong to the given hosts.| |httptestids|string/array|Return only web scenarios with the given IDs.| |inherited|boolean|If set to `true` return only web scenarios inherited from a template.| |monitored|boolean|If set to `true` return only enabled web scenarios that belong to monitored hosts.| |templated|boolean|If set to `true` return only web scenarios that belong to templates.| |templateids|string/array|Return only web scenarios that belong to the given templates.| |expandName|flag|Expand macros in the name of the web scenario.| |expandStepName|flag|Expand macros in the names of scenario steps.| |evaltype|integer|Rules for tag searching.<br><br>Possible values:<br>0 - (default) And/Or;<br>2 - Or.| |tags|array of objects|Return only web scenarios with given tags. Exact match by tag and case-sensitive or case-insensitive search by tag value depending on operator value.<br>Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>An empty array returns all web scenarios.<br><br>Possible operator types:<br>0 - (default) Like;<br>1 - Equal;<br>2 - Not like;<br>3 - Not equal<br>4 - Exists;<br>5 - Not exists.| |selectHosts|query|Return the hosts that the web scenario belongs to as an array in the [hosts](/manual/api/reference/host/object) property.| |selectSteps|query|Return web scenario steps in the [steps](/manual/api/reference/httptest/object#scenario_step) property.<br><br>Supports `count`.| |selectTags|query|Return the web scenario tags in [tags](/manual/api/reference/httptest/object#web_scenario_tag) property.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `httptestid` and `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
fa	###پارامتر ها   `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groupids|string/array|Return only web scenarios that belong to the given host groups.| |hostids|string/array|Return only web scenarios that belong to the given hosts.| |httptestids|string/array|Return only web scenarios with the given IDs.| |inherited|boolean|If set to `true` return only web scenarios inherited from a template.| |monitored|boolean|If set to `true` return only enabled web scenarios that belong to monitored hosts.| |templated|boolean|If set to `true` return only web scenarios that belong to templates.| |templateids|string/array|Return only web scenarios that belong to the given templates.| |expandName|flag|Expand macros in the name of the web scenario.| |expandStepName|flag|Expand macros in the names of scenario steps.| |evaltype|integer|Rules for tag searching.<br><br>Possible values:<br>0 - (default) And/Or;<br>2 - Or.| |tags|array of objects|Return only web scenarios with given tags. Exact match by tag and case-sensitive or case-insensitive search by tag value depending on operator value.<br>Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>An empty array returns all web scenarios.<br><br>Possible operator types:<br>0 - (default) Like;<br>1 - Equal;<br>2 - Not like;<br>3 - Not equal<br>4 - Exists;<br>5 - Not exists.| |selectHosts|query|Return the hosts that the web scenario belongs to as an array in the [hosts](/manual/api/reference/host/object) property.| |selectSteps|query|Return web scenario steps in the [steps](/manual/api/reference/httptest/object#scenario_step) property.<br><br>Supports `count`.| |selectTags|query|Return the web scenario tags in [tags](/manual/api/reference/httptest/object#web_scenario_tag) property.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `httptestid` and `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |ha\_nodeids|string/array|Return only nodes with the given node IDs.| |filter|object|Return only those results that exactly match the given filter.<br><br>Accepts an array, where the keys are property names, and the values are either a single value or an array of values to match against.<br><br>Allows filtering by the node properties: `name`, `address`, `status`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `name`, `lastaccess`, `status`.| |countOutput|flag|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |sortorder|string/array|^|
fa	### پارامتر ها   `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |ha\_nodeids|string/array|Return only nodes with the given node IDs.| |filter|object|Return only those results that exactly match the given filter.<br><br>Accepts an array, where the keys are property names, and the values are either a single value or an array of values to match against.<br><br>Allows filtering by the node properties: `name`, `address`, `status`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `name`, `lastaccess`, `status`.| |countOutput|flag|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |sortorder|string/array|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |history|integer|History object types to return.<br><br>Possible values:<br>0 - numeric float;<br>1 - character;<br>2 - log;<br>3 - numeric unsigned;<br>4 - text.<br><br>Default: 3.| |hostids|string/array|Return only history from the given hosts.| |itemids|string/array|Return only history from the given items.| |time\_from|timestamp|Return only values that have been received after or at the given time.| |time\_till|timestamp|Return only values that have been received before or at the given time.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `itemid` and `clock`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
fa	###پارامتر ها   `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |history|integer|History object types to return.<br><br>Possible values:<br>0 - numeric float;<br>1 - character;<br>2 - log;<br>3 - numeric unsigned;<br>4 - text.<br><br>Default: 3.| |hostids|string/array|Return only history from the given hosts.| |itemids|string/array|Return only history from the given items.| |time\_from|timestamp|Return only values that have been received after or at the given time.| |time\_till|timestamp|Return only values that have been received before or at the given time.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `itemid` and `clock`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |iconmapids|string/array|Return only icon maps with the given IDs.| |sysmapids|string/array|Return only icon maps that are used in the given maps.| |selectMappings|query|Return a [mappings](/manual/api/reference/iconmap/object#icon_mapping) property with the icon mappings used.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `iconmapid` and `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
fa	### پارامتر ها   `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |iconmapids|string/array|Return only icon maps with the given IDs.| |sysmapids|string/array|Return only icon maps that are used in the given maps.| |selectMappings|query|Return a [mappings](/manual/api/reference/iconmap/object#icon_mapping) property with the icon mappings used.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `iconmapid` and `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |imageids|string/array|Return only images with the given IDs.| |sysmapids|string/array|Return images that are used on the given maps.| |select\_image|flag|Return an `image` property with the Base64 encoded image.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `imageid` and `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
fa	### پارامتر ها   `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |ha\_nodeids|string/array|Return only nodes with the given node IDs.| |filter|object|Return only those results that exactly match the given filter.<br><br>Accepts an array, where the keys are property names, and the values are either a single value or an array of values to match against.<br><br>Allows filtering by the node properties: `name`, `address`, `status`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `name`, `lastaccess`, `status`.| |countOutput|flag|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |sortorder|string/array|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |itemids|string/array|Return only items with the given IDs.| |groupids|string/array|Return only items that belong to the hosts from the given groups.| |templateids|string/array|Return only items that belong to the given templates.| |hostids|string/array|Return only items that belong to the given hosts.| |proxyids|string/array|Return only items that are monitored by the given proxies.| |interfaceids|string/array|Return only items that use the given host interfaces.| |graphids|string/array|Return only items that are used in the given graphs.| |triggerids|string/array|Return only items that are used in the given triggers.| |webitems|flag|Include web items in the result.| |inherited|boolean|If set to `true` return only items inherited from a template.| |templated|boolean|If set to `true` return only items that belong to templates.| |monitored|boolean|If set to `true` return only enabled items that belong to monitored hosts.| |group|string|Return only items that belong to a group with the given name.| |host|string|Return only items that belong to a host with the given name.| |evaltype|integer|Rules for tag searching.<br><br>Possible values:<br>0 - (default) And/Or;<br>2 - Or.| |tags|array of objects|Return only items with given tags. Exact match by tag and case-sensitive or case-insensitive search by tag value depending on operator value.<br>Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>An empty array returns all items.<br><br>Possible operator types:<br>0 - (default) Like;<br>1 - Equal;<br>2 - Not like;<br>3 - Not equal<br>4 - Exists;<br>5 - Not exists.| |with\_triggers|boolean|If set to `true` return only items that are used in triggers.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with an array of hosts that the item belongs to.| |selectInterfaces|query|Return an [interfaces](/manual/api/reference/hostinterface/object) property with an array of host interfaces used by the item.| |selectTriggers|query|Return a [triggers](/manual/api/reference/trigger/object) property with the triggers that the item is used in.<br><br>Supports `count`.| |selectGraphs|query|Return a [graphs](/manual/api/reference/graph/object) property with the graphs that contain the item.<br><br>Supports `count`.| |selectDiscoveryRule|query|Return a [discoveryRule](/manual/api/reference/discoveryrule/object) property with the LLD rule that created the item.| |selectItemDiscovery|query|Return an `itemDiscovery` property with the item discovery object. The item discovery object links the item to an item prototype from which it was created.<br><br>It has the following properties:<br>`itemdiscoveryid` - `(string)` ID of the item discovery;<br>`itemid` - `(string)` ID of the discovered item;<br>`parent_itemid` - `(string)` ID of the item prototype from which the item has been created;<br>`key_` - `(string)` key of the item prototype;<br>`lastcheck` - `(timestamp)` time when the item was last discovered;<br>`ts_delete` - `(timestamp)` time when an item that is no longer discovered will be deleted.| |selectPreprocessing|query|Return a [preprocessing](/manual/api/reference/item/object#item_preprocessing) property with item preprocessing options.<br><br>It has the following properties:<br>`type` - `(string)` The preprocessing option type:<br>1 - Custom multiplier;<br>2 - Right trim;<br>3 - Left trim;<br>4 - Trim;<br>5 - Regular expression matching;<br>6 - Boolean to decimal;<br>7 - Octal to decimal;<br>8 - Hexadecimal to decimal;<br>9 - Simple change;<br>10 - Change per second;<br>11 - XML XPath;<br>12 - JSONPath;<br>13 - In range;<br>14 - Matches regular expression;<br>15 - Does not match regular expression;<br>16 - Check for error in JSON;<br>17 - Check for error in XML;<br>18 - Check for error using regular expression;<br>19 - Discard unchanged;<br>20 - Discard unchanged with heartbeat;<br>21 - JavaScript;<br>22 - Prometheus pattern;<br>23 - Prometheus to JSON;<br>24 - CSV to JSON;<br>25 - Replace;<br>26 - Check for not supported value;<br>27 - XML to JSON.<br><br>`params` - `(string)` Additional parameters used by preprocessing option. Multiple parameters are separated by LF (\\n)character.<br>`error_handler` - `(string)` Action type used in case of preprocessing step failure:<br>0 - Error message is set by Zabbix server;<br>1 - Discard value;<br>2 - Set custom value;<br>3 - Set custom error message.<br><br>`error_handler_params` - `(string)` Error handler parameters.| |selectTags|query|Return the item tags in [tags](/manual/api/reference/item/object#Item_tag) property.| |selectValueMap|query|Return a [valuemap](/manual/api/reference/valuemap/object) property with item value map.| |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 item belongs to.| |limitSelects|integer|Limits the number of records returned by subselects.<br><br>Applies to the following subselects:<br>`selectGraphs` - results will be sorted by `name`;<br>`selectTriggers` - results will be sorted by `description`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `itemid`, `name`, `key_`, `delay`, `history`, `trends`, `type` and `status`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
fa	### مولفه های  `(شیء)` پارامترهای تعیین کننده خروجی مورد نظر.  این روش از پارامترهای زیر پشتیبانی می کند.  |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |itemids|string/array|فقط موارد با شناسه های داده شده را برمی گرداند.| |groupids|string/array|فقط مواردی را که متعلق به میزبان‌های گروه‌های داده شده است برمی‌گرداند.| |templateids|string/array|فقط مواردی که متعلق به الگوهای داده شده هستند را برمی گرداند.| |hostids|string/array|فقط مواردی را که به میزبان های داده شده تعلق دارند برمی گرداند.| |proxyids|string/array|فقط مواردی را برمی گرداند که توسط پراکسی های داده شده نظارت می شوند.| |interfaceids|string/array|فقط مواردی را برمی گرداند که از رابط های میزبان داده شده استفاده می کنند.| |graphids|string/array|فقط مواردی را که در نمودارهای داده شده استفاده شده است را برمی گرداند.| |triggerids|string/array|فقط مواردی را برمی گرداند که در تریگرهای داده شده استفاده می شوند.| |webitems|flag|شامل موارد وب در نتیجه.| |وارث شده|بولی|اگر روی "true" تنظیم شود فقط مواردی را که از یک الگو به ارث برده اند برمی گرداند.| |templated|boolean|اگر روی "true" تنظیم شود فقط مواردی را که متعلق به الگوها هستند برمی‌گرداند.| |monitored|boolean|اگر روی "true" تنظیم شود، فقط موارد فعالی را که به میزبان های نظارت شده تعلق دارند برمی گرداند.| |group|string|فقط مواردی را که به گروهی با نام داده شده تعلق دارند برمی گرداند.| |host|string|فقط مواردی را که به میزبانی با نام داده شده تعلق دارند برمی گرداند.| |evaltype|عدد صحیح|قوانین جستجوی برچسب.<br><br>مقادیر ممکن:<br>0 - (پیش‌فرض) And/Or;<br>2 - Or.| |برچسب|آرایه اشیاء|فقط مواردی را با تگ های داده شده برمی گرداند. مطابقت دقیق با برچسب و جستجوی حساس به حروف بزرگ یا بزرگ و کوچک بر اساس مقدار برچسب بسته به مقدار اپراتور.<br>قالب: `[{"برچسب": "<tag>"، "مقدار": "<value>"، " operator": "<operator>"}، ...]`.<br>یک آرایه خالی همه موارد را برمی گرداند.<br><br>انواع عملگرهای ممکن:<br>0 - (پیش فرض) مانند;<br>1 - برابر؛<br>2 - مانند نیست؛<br>3 - مساوی نیست<br>4 - موجود است؛<br>5 - وجود ندارد.| |with\_triggers|boolean|اگر روی "true" تنظیم شود فقط مواردی را که در تریگرها استفاده می شود برمی گرداند.| |selectHosts|query|یک ویژگی [host](/manual/api/reference/host/object) را با آرایه‌ای از میزبان‌ها که مورد به آن تعلق دارد، برگردانید.| |selectInterfaces|query|یک ویژگی [interfaces](/manual/api/reference/hostinterface/object) را با آرایه‌ای از رابط‌های میزبان مورد استفاده مورد برگردانید.| |selectTriggers|query|یک ویژگی [triggers](/manual/api/reference/trigger/object) را با محرک‌هایی که مورد در آنها استفاده می‌شود، برگردانید.<br><br>از «شمارش» پشتیبانی می‌کند.| |selectGraphs|پرس و جو|یک ویژگی [graphs](/manual/api/reference/graph/object) را با نمودارهایی که حاوی آیتم هستند، برگردانید.<br><br>از «count» پشتیبانی می‌کند.| |selectDiscoveryRule|query|یک ویژگی [discoveryRule](/manual/api/reference/discoveryrule/object) را با قانون LLD که مورد را ایجاد کرده است، برگردانید.| |selectItemDiscovery|پرس و جو|یک ویژگی "itemDiscovery" را با شی کشف مورد برگردانید. شی کشف مورد، مورد را به نمونه اولیه موردی که از آن ایجاد شده است، پیوند می‌دهد.<br><br>این ویژگی دارای ویژگی‌های زیر است:<br>`itemdiscoveryid` - ID of the item finded;<br> "itemid" - "(رشته)" شناسه مورد کشف شده؛<br>"parent_itemid" - "(رشته)" شناسه نمونه اولیه موردی که مورد از آن ایجاد شده است؛<br>`key_` - `(رشته )` کلید نمونه اولیه مورد؛<br>`lastcheck` - `(مهر زمانی)` زمانی که مورد آخرین بار کشف شد؛<br>`ts_delete` - زمان زمانی که موردی که دیگر کشف نشده است حذف شود.| |selectPreprocessing|پرس و جو|یک ویژگی [preprocessing](/manual/api/reference/item/object#item_preprocessing) را با گزینه های پیش پردازش مورد برگردانید.<br><br>این ویژگی دارای ویژگی های زیر است:<br>`type` - ` (رشته)` نوع گزینه پیش پردازش:<br>1 - ضرب سفارشی؛<br>2 - برش راست؛<br>3 - برش چپ؛<br>4 - برش؛<br>5 - تطبیق عبارت منظم؛< br>6 - بولی تا اعشاری؛<br>7 - اکتال به اعشار؛<br>8 - هگزادسیمال تا اعشاری؛<br>9 - تغییر ساده؛<br>10 - تغییر در ثانیه؛<br>11 - XML XPath ;<br>12 - JSONPath;<br>13 - در محدوده؛<br>14 - مطابق با عبارت منظم؛<br>15 - با عبارت معمولی مطابقت ندارد؛<br>16 - بررسی خطا در JSON؛<br> 17 - بررسی خطا در XML؛<br>18 - بررسی خطا با استفاده از عبارت منظم؛<br>19 - صرف‌نظر کردن بدون تغییر؛<br>20 - صرف‌نظر کردن بدون تغییر با ضربان قلب؛<br>21 - JavaScript؛<br>22 - الگوی Prometheus؛<br>23 - Prometheus به JSON؛<br>24 - CSV به JSON؛<br>25 - جایگزین کردن؛<br>26 - بررسی مقدار پشتیبانی نشده؛<br>27 - XML به JSON.<br> <br>«پارامز» - «(رشته)» پارامترهای اضافی که توسط گزینه پیش پردازش استفاده می شود. چندین پارامتر با نویسه LF (\\n) از هم جدا می شوند.<br>`error_handler` - `(string)` نوع اقدام مورد استفاده در صورت شکست مرحله پیش پردازش:<br>0 - پیام خطا توسط سرور Zabbix تنظیم شده است؛<br >1 - صرفنظر از مقدار؛<br>2 - تنظیم مقدار سفارشی؛<br>3 - تنظیم پیام خطای سفارشی.<br><br>`error_handler_params` - `(رشته)` پارامترهای کنترل کننده خطا.| |selectTags|query|برچسب های مورد را در ویژگی [tags](/manual/api/reference/item/object#Item_tag) برگردانید.| |selectValueMap|پرس و جو|یک ویژگی [valuemap](/manual/api/reference/valuemap/object) با نقشه مقدار مورد را برگردانید.| |filter|object|فقط نتایجی را برمی‌گرداند که دقیقاً با فیلتر داده شده مطابقت دارند.<br><br>آرایه‌ای را می‌پذیرد، که در آن کلیدها نام ویژگی‌ها هستند، و مقادیر یا یک مقدار واحد یا آرایه‌ای از مقادیر هستند که با آنها مطابقت دارد. <br><br>پشتیبانی از فیلترهای اضافی:<br>`host` - نام فنی میزبانی که مورد به آن تعلق دارد.| |limitSelects|عدد صحیح|تعداد رکوردهای بازگردانده شده توسط انتخاب‌های فرعی را محدود می‌کند.<br><br>برای انتخاب‌های فرعی زیر اعمال می‌شود:<br>`selectGraphs` - نتایج بر اساس «نام» مرتب می‌شوند؛<br>«selectTriggers» - نتایج بر اساس 'توضیح' مرتب خواهد شد.| |sortfield|string/array|نتیجه را بر اساس ویژگی های داده شده مرتب کنید.<br><br>مقادیر ممکن عبارتند از: "itemid"، "name"، "key_"، "تاخیر"، "history"، "Trends"، ` نوع» و «وضعیت».| |countOutput|بولی|این پارامترها که برای همه روش‌های «get» مشترک هستند، به طور مفصل در صفحه [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) توضیح داده شده است.| |قابل ویرایش|بولی|^| |excludeSearch|بولی|^| |حد |عدد صحیح|^| |خروجی|پرس و جو|^| |preservekeys|بولی|^| |جستجو|شیء|^| |searchByAny|بولی|^| |searchWildcardsEnabled|بولی|^| |مرتب |رشته/آرایه|^| |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| |--|--|------| |regexpids|string/array|Return only regular expressions with the given IDs.| |selectExpressions|query|Return a [expressions](/manual/api/reference/regexp/object#expressions) property.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `regexpid` 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|^|
fa	`(object)` Parameters defining the desired output.The method supports the following parameters.|Parameter|[Type](/manual/api/reference_commentary#data_types)|Description||--|--|------||imageids|string/array|Return only images with the given IDs.||sysmapids|string/array|Return images that are used on the given maps.||select\_image|flag|Return an `image` property with the Base64 encoded image.||sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `imageid` and `name`.||countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).||editable|boolean|^||excludeSearch|boolean|^||filter|object|^||limit|integer|^||output|query|^||preservekeys|boolean|^||search|object|^||searchByAny|boolean|^||searchWildcardsEnabled|boolean|^||sortorder|string/array|^||startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |roleids|string/array|Return only roles with the given IDs.| |selectRules|query|Return role rules in the [rules](/manual/api/reference/role/object#role_rules) property.| |selectUsers|query|Select [users](/manual/api/reference/user/object) this role is assigned to.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `roleid`, `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
fa	`(object)` Parameters defining the desired output.The method supports the following parameters.|Parameter|[Type](/manual/api/reference_commentary#data_types)|Description||--|--|------||imageids|string/array|Return only images with the given IDs.||sysmapids|string/array|Return images that are used on the given maps.||select\_image|flag|Return an `image` property with the Base64 encoded image.||sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `imageid` and `name`.||countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).||editable|boolean|^||excludeSearch|boolean|^||filter|object|^||limit|integer|^||output|query|^||preservekeys|boolean|^||search|object|^||searchByAny|boolean|^||searchWildcardsEnabled|boolean|^||sortorder|string/array|^||startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  | Parameter               | [Type](/manual/api/reference_commentary#data_types) | Description                                                                                                                                                               | |-------------------------|-----------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | slaids                  | string/array                                        | Return only SLAs with the given IDs.                                                                                                                                      | | serviceids              | string/array                                        | Return only SLAs matching the specific services.                                                                                                                          | | selectSchedule          | query                                               | Return a `schedule` property with SLA schedules.<br><br>Supports `count`.                                                                                                 | | selectExcludedDowntimes | query                                               | Return an `excluded_downtimes` property with SLA excluded downtimes.<br><br>Supports `count`.                                                                             | | selectServiceTags       | query                                               | Return a `service_tags` property with SLA service tags.<br><br>Supports `count`.                                                                                          | | sortfield               | string/array                                        | Sort the result by the given properties.<br><br>Possible values are: `slaid`, `name`, `period`, `slo`, `effective_date`, `timezone`, `status` and `description`.          | | countOutput             | boolean                                             | These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters). | | editable                | boolean                                             | ^                                                                                                                                                                         | | excludeSearch           | boolean                                             | ^                                                                                                                                                                         | | filter                  | object                                              | ^                                                                                                                                                                         | | limit                   | integer                                             | ^                                                                                                                                                                         | | output                  | query                                               | ^                                                                                                                                                                         | | preservekeys            | boolean                                             | ^                                                                                                                                                                         | | search                  | object                                              | ^                                                                                                                                                                         | | searchByAny             | boolean                                             | ^                                                                                                                                                                         | | searchWildcardsEnabled  | boolean                                             | ^                                                                                                                                                                         | | sortorder               | string/array                                        | ^                                                                                                                                                                         | | startSearch             | boolean                                             | ^                                                                                                                                                                         |
fa	### مولفه های  `(شیء)` پارامترهای تعیین کننده خروجی مورد نظر.  این روش از پارامترهای زیر پشتیبانی می کند.  | پارامتر | [Type](/manual/api/reference_commentary#data_types) | توضیحات | |------------------------------------------------ -------------------------------------------------- ------------------------------------------------ ------------------------------------------------ ------------------------------------------------ --| | اسلاید | رشته/آرایه | فقط SLA ها را با شناسه های داده شده برگردانید. | | خدمات | رشته/آرایه | فقط SLA های مطابق با سرویس های خاص را برگردانید. | | انتخاب زمانبندی | پرس و جو | یک ویژگی «زمان‌بندی» را با زمان‌بندی‌های SLA برگردانید.<br><br>از «شمارش» پشتیبانی می‌کند. | | انتخاب ExcludedDowntimes | پرس و جو | یک ویژگی «excluded_downtimes» را با زمان‌های خرابی استثنا شده SLA برگردانید.<br><br>از «شمارش» پشتیبانی می‌کند. | | SelectServiceTags | پرس و جو | یک ویژگی «service_tags» را با برچسب‌های سرویس SLA برگردانید.<br><br>از «شمارش» پشتیبانی می‌کند. | | مرتب سازی | رشته/آرایه | نتیجه را بر اساس ویژگی های داده شده مرتب کنید.<br><br>مقادیر ممکن عبارتند از: "slaid"، "name"، "period"، "slo"، "تاریخ_اثربخش"، "منطقه زمانی"، "وضعیت" و "توضیح". | | countOutput | بولی | این پارامترها که برای همه روش‌های «get» مشترک هستند، به تفصیل در [reference commentary] (/manual/api/reference_commentary#common_get_method_parameters) توضیح داده شده‌اند. | | قابل ویرایش | بولی | ^ | | excludeSearch | بولی | ^ | | فیلتر | شی | ^ | | حد | عدد صحیح | ^ | | خروجی | پرس و جو | ^ | | کلیدهای حفاظتی | بولی | ^ | | جستجو | شی | ^ | | SearchByAny | بولی | ^ | | SearchWildcardsEnabled | بولی | ^ | | مرتب کننده | رشته/آرایه | ^ | | شروع جستجو | بولی | ^ |

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |status|integer|Return only user groups with the given status.<br><br>Refer to the [user group page](object#user_group) for a list of supported statuses.| |userids|string/array|Return only user groups that contain the given users.| |usrgrpids|string/array|Return only user groups with the given IDs.| |selectTagFilters|query|Return user group tag based permissions in the [tag\_filters](/manual/api/reference/usergroup/object#tag_based_permission) property.<br><br>It has the following properties:<br>`groupid` - (string) ID of the host group;<br>`tag` - (string) tag name;<br>`value` - (string) tag value.| |selectUsers|query|Return the users from the user group in the [users](/manual/api/reference/user/object#user) property.| |selectRights|query|Return user group rights in the [rights](/manual/api/reference/usergroup/object#permission) property.<br><br>It has the following properties:<br>`permission` - (integer) access level to the host group;<br>`id` - (string) ID of the host group.<br><br>Refer to the [user group page](object#permission) for a list of access levels to host groups.| |limitSelects|integer|Limits the number of records returned by subselects.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `usrgrpid`, `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
fa	### مولفه های  `(شیء)` پارامترهای تعیین کننده خروجی مورد نظر.  این روش از پارامترهای زیر پشتیبانی می کند.  |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |status|integer|فقط گروه‌های کاربری با وضعیت داده شده را برگردانید.<br><br>برای فهرستی از وضعیت‌های پشتیبانی شده به [صفحه گروه کاربر](object#user_group) مراجعه کنید.| |userids|string/array|فقط گروه های کاربری که شامل کاربران معین هستند را برمی گرداند.| |usrgrpids|string/array|فقط گروه های کاربری با شناسه های داده شده را برمی گرداند.| |selectTagFilters|پرس و جو|بازگرداندن مجوزهای مبتنی بر برچسب گروه کاربر در ویژگی [tag\_filters](/manual/api/reference/usergroup/object#tag_based_permission).<br><br>این ویژگی‌ها را دارد:<br>` groupid` - (رشته) شناسه گروه میزبان؛<br>`tag` - (رشته) نام برچسب؛<br>`value` - (رشته) مقدار برچسب.| |selectUsers|query|کاربران را از گروه کاربری در ویژگی [users](/manual/api/reference/user/object#user) برگردانید.| |selectRights|پرس و جو|برگرداندن حقوق گروه کاربر در ویژگی [rights](/manual/api/reference/usergroup/object#permission).<br><br>این ویژگی دارای ویژگی‌های زیر است:<br>«مجوز» - ( عدد صحیح) سطح دسترسی به گروه میزبان؛<br>`id` - (رشته) شناسه گروه میزبان.<br><br>برای فهرستی از سطوح دسترسی به [صفحه گروه کاربر](object#permission) مراجعه کنید. به میزبان گروه ها.| |limitSelects|عدد صحیح|تعداد رکوردهای برگردانده شده توسط زیرمجموعه ها را محدود می کند.| |sortfield|string/array|نتیجه را بر اساس ویژگی های داده شده مرتب کنید.<br><br>مقادیر ممکن عبارتند از: `usrgrpid`, `name`.| |countOutput|boolean|این پارامترها که برای همه روش‌های «get» مشترک هستند به تفصیل در [تفسیر مرجع] توضیح داده شده‌اند(/manual/api/reference_commentary#common_get_method_parameters).| |قابل ویرایش|بولی|^| |excludeSearch|بولی|^| |فیلتر|شیء|^| |حد |عدد صحیح|^| |خروجی|پرس و جو|^| |preservekeys|بولی|^| |جستجو|شیء|^| |searchByAny|بولی|^| |searchWildcardsEnabled|بولی|^| |مرتب |رشته/آرایه|^| |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| |--|--|------| |templateids|string/array|Return only templates with the given template IDs.| |groupids|string/array|Return only templates that belong to the given host groups.| |parentTemplateids|string/array|Return only templates that are parent to the given templates.| |hostids|string/array|Return only templates that are linked to the given hosts/templates.| |graphids|string/array|Return only templates that contain the given graphs.| |itemids|string/array|Return only templates that contain the given items.| |triggerids|string/array|Return only templates that contain the given triggers.| |with\_items|flag|Return only templates that have items.| |with\_triggers|flag|Return only templates that have triggers.| |with\_graphs|flag|Return only templates that have graphs.| |with\_httptests|flag|Return only templates that have web scenarios.| |evaltype|integer|Rules for tag searching.<br><br>Possible values:<br>0 - (default) And/Or;<br>2 - Or.| |tags|object/array|Return only templates with given tags. Exact match by tag and case-sensitive or case-insensitive search by tag value depending on operator value.<br>Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>An empty array returns all templates.<br><br>Possible operator values:<br>0 - (default) Contains;<br>1 - Equals;<br>2 - Not like;<br>3 - Not equal<br>4 - Exists;<br>5 - Not exists.| |selectGroups|query|Return the host groups that the template belongs to in the [groups](/manual/api/reference/hostgroup/object) property.| |selectTags|query|Return template tags in the [tags](/manual/api/reference/template/object#template_tag) property.| |selectHosts|query|Return the hosts that are linked to the template in the [hosts](/manual/api/reference/host/object) property.<br><br>Supports `count`.| |selectTemplates|query|Return templates to which the template is a child, in the [`templates`](/manual/api/reference/template/object) property.<br><br>Supports `count`.| |selectParentTemplates|query|Return templates to which the template is a parent, in the `parentTemplates` property.<br><br>Supports `count`.| |selectHttpTests|query|Return the web scenarios from the template in the [httpTests](/manual/api/reference/httptest/object) property.<br><br>Supports `count`.| |selectItems|query|Return items from the template in the [items](/manual/api/reference/item/object) property.<br><br>Supports `count`.| |selectDiscoveries|query|Return low-level discoveries from the template in the `discoveries` property.<br><br>Supports `count`.| |selectTriggers|query|Return triggers from the template in the [triggers](/manual/api/reference/trigger/object) property.<br><br>Supports `count`.| |selectGraphs|query|Return graphs from the template in the [graphs](/manual/api/reference/graph/object) property.<br><br>Supports `count`.| |selectMacros|query|Return the macros from the template in the `macros` property..| |selectDashboards|query|Return dashboards from the template in the [dashboards](/manual/api/reference/templatedashboard/object) property.<br><br>Supports `count`.| |selectValueMaps|query|Return a [valuemaps](/manual/api/reference/valuemap/object) property with template value maps.| |limitSelects|integer|Limits the number of records returned by subselects.<br><br>Applies to the following subselects:<br>`selectTemplates` - results will be sorted by `name`;<br>`selectHosts` - sorted by `host`;<br>`selectParentTemplates` - sorted by `host`;<br>`selectItems` - sorted by `name`;<br>`selectDiscoveries` - sorted by `name`;<br>`selectTriggers` - sorted by `description`;<br>`selectGraphs` - sorted by `name`;<br>`selectDashboards` - sorted by `name`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `hostid`, `host`, `name`, `status`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
fa	### مولفه های  `(شیء)` پارامترهای تعیین کننده خروجی مورد نظر.  این روش از پارامترهای زیر پشتیبانی می کند.  |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |templateids|string/array|فقط الگوهایی را با شناسه های الگوی داده شده برمی گرداند.| |groupids|string/array|فقط الگوهایی را برمی گرداند که به گروه های میزبان داده شده تعلق دارند.| |parentTemplateids|string/array|فقط الگوهایی را که والد هستند به الگوهای داده شده برمی گرداند.| |hostids|string/array|فقط الگوهایی را برمی گرداند که به میزبان/قالب های داده شده پیوند دارند.| |graphids|string/array|فقط الگوهایی را که حاوی نمودارهای داده شده هستند برمی گرداند.| |itemids|string/array|فقط الگوهایی را برمی گرداند که حاوی موارد داده شده هستند.| |triggerids|string/array|فقط الگوهایی را برمی گرداند که حاوی محرک های داده شده هستند.| |with\_items|flag|فقط الگوهایی را برگردانید که دارای موارد هستند.| |with\_triggers|flag|فقط الگوهایی را برگردانید که دارای محرک هستند.| |with\_graphs|flag|فقط الگوهایی را برگردانید که دارای نمودار هستند.| |with\_httptests|flag|فقط الگوهایی را برگردانید که دارای سناریوهای وب هستند.| |evaltype|عدد صحیح|قوانین جستجوی برچسب.<br><br>مقادیر ممکن:<br>0 - (پیش‌فرض) And/Or;<br>2 - Or.| |برچسب|شیء/آرایه|فقط الگوهایی با برچسب های داده شده را برمی گرداند. مطابقت دقیق با برچسب و جستجوی حساس به حروف بزرگ یا بزرگ و کوچک بر اساس مقدار برچسب بسته به مقدار اپراتور.<br>قالب: `[{"برچسب": "<tag>"، "مقدار": "<value>"، " operator": "<operator>"}، ...]`.<br>یک آرایه خالی همه الگوها را برمی گرداند.<br><br>مقادیر عملگر ممکن:<br>0 - (پیش فرض) شامل؛<br>1 - برابر است؛<br>2 - شبیه نیست؛<br>3 - مساوی نیست<br>4 - وجود دارد؛<br>5 - وجود ندارد.| |selectGroups|query|گروه‌های میزبانی که الگو به آنها تعلق دارد را در ویژگی [گروه‌ها](/manual/api/reference/hostgroup/object) برگردانید.| |selectTags|query|برگرداندن برچسب‌های الگو در ویژگی [tags](/manual/api/reference/template/object#template_tag).| |selectHosts|query|میزبان‌هایی را که به الگو در ویژگی [hosts](/manual/api/reference/host/object) پیوند داده شده‌اند، برگردانید.<br><br>از «count» پشتیبانی می‌کند.| |selectTemplates|پرس و جو|الگوهایی را که الگوی آنها فرزند است، در ویژگی ['templates'](/manual/api/reference/template/object) برگردانید.<br><br>پشتیبانی از 'count'.| |selectParentTemplates|پرس و جو|الگوهایی را که الگو در آنها والد است، در ویژگی "parentTemplates" برگردانید.<br><br>از "تعداد" پشتیبانی می کند.| |selectHttpTests|پرس و جو|سناریوهای وب را از الگو در ویژگی [httpTests](/manual/api/reference/httptest/object) برگردانید.<br><br>از «count» پشتیبانی می‌کند.| |selectItems|پرس و جو|موارد را از الگو در ویژگی [Items](/manual/api/reference/item/object) برگردانید.<br><br>از «count» پشتیبانی می‌کند.| |selectDiscoveries|پرس و جو|بازگرداندن اکتشافات سطح پایین از الگو در ویژگی «کشف».<br><br>از «تعداد» پشتیبانی می‌کند.| |selectTriggers|پرس و جو|بازگرداندن محرک‌ها از الگو در ویژگی [triggers](/manual/api/reference/trigger/object).<br><br>از «count» پشتیبانی می‌کند.| |selectGraphs|پرس و جو|برگرداندن نمودارها از الگو در ویژگی [graphs](/manual/api/reference/graph/object).<br><br>از «count» پشتیبانی می‌کند.| |selectMacros|پرس و جو|بازگرداندن ماکروها از الگو در ویژگی `macros`..| |selectDashboards|پرس و جو|برگرداندن داشبوردها از الگو در ویژگی [dashboards](/manual/api/reference/templatedashboard/object).<br><br>از «count» پشتیبانی می‌کند.| |selectValueMaps|پرس و جو|یک ویژگی [valuemaps](/manual/api/reference/valuemap/object) را با نقشه‌های ارزش الگو برگردانید.| |limitSelects|عدد صحیح|تعداد رکوردهای برگردانده شده توسط انتخاب‌های فرعی را محدود می‌کند.<br><br>در مورد زیرمجموعه‌های زیر اعمال می‌شود:<br>«selectTemplates» - نتایج بر اساس «نام» مرتب می‌شوند؛<br>«selectHosts» - مرتب‌شده توسط `host`;<br>`selectParentTemplates` - مرتب شده بر اساس `host`;<br>`selectItems` - مرتب شده بر اساس `name`;<br>`selectDiscoveries` - مرتب شده بر اساس`` name`;<br>`selectTriggers` - مرتب شده بر اساس "توضیح"؛<br>"selectGraphs" - مرتب شده بر اساس "نام"؛<br>"selectDashboards" - مرتب شده بر اساس "نام".| |sortfield|string/array|نتیجه را بر اساس ویژگی های داده شده مرتب کنید.<br><br>مقادیر ممکن عبارتند از: `hostid`, `host`, `name`, `status`.| |countOutput|boolean|این پارامترها که برای همه روش‌های «get» مشترک هستند به تفصیل در [تفسیر مرجع] توضیح داده شده‌اند(/manual/api/reference_commentary#common_get_method_parameters).| |قابل ویرایش|بولی|^| |excludeSearch|بولی|^| |فیلتر|شیء|^| |حد |عدد صحیح|^| |خروجی|پرس و جو|^| |preservekeys|بولی|^| |جستجو|شیء|^| |searchByAny|بولی|^| |searchWildcardsEnabled|بولی|^| |مرتب |رشته/آرایه|^| |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| |--|--|------| |valuemapids|string/array|Return only value maps with the given IDs.| |selectMappings|query|Return the value mappings for current value map in the [mappings](/manual/api/reference/valuemap/object#value_mappings) property.<br><br>Supports `count`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `valuemapid`, `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
fa	`(object)` Parameters defining the desired output.The method supports the following parameters.|Parameter|[Type](/manual/api/reference_commentary#data_types)|Description||--|--|------||imageids|string/array|Return only images with the given IDs.||sysmapids|string/array|Return images that are used on the given maps.||select\_image|flag|Return an `image` property with the Base64 encoded image.||sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `imageid` and `name`.||countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).||editable|boolean|^||excludeSearch|boolean|^||filter|object|^||limit|integer|^||output|query|^||preservekeys|boolean|^||search|object|^||searchByAny|boolean|^||searchWildcardsEnabled|boolean|^||sortorder|string/array|^||startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the LLD rules to copy and the target hosts.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |discoveryids|array|IDs of the LLD rules to be copied.| |hostids|array|IDs of the hosts to copy the LLD rules to.|
fa	### پارامترها  `(object)` Parameters defining the LLD rules to copy and the target hosts.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |discoveryids|array|IDs of the LLD rules to be copied.| |hostids|array|IDs of the hosts to copy the LLD rules to.|

en-us	### Parameters  `(object)` Parameters defining the objects to be exported and the format to use.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**format**<br>(required)|string|Format in which the data must be exported.<br><br>Possible values:<br>`yaml` - YAML;<br>`xml` - XML;<br>`json` - JSON;<br>`raw` - unprocessed PHP array.| |prettyprint|boolean|Make the output more human readable by adding indentation.<br><br>Possible values:<br>`true` - add indentation;<br>`false` - *(default)* do not add indentation.| |**options**<br>(required)|object|Objects to be exported.<br><br>The `options` object has the following parameters:<br>`groups` - `(array)` IDs of host groups to export;<br>`hosts` - `(array)` IDs of hosts to export;<br>`images` - `(array)` IDs of images to export;<br>`maps` - `(array)` IDs of maps to export;<br>`mediaTypes` - `(array)` IDs of media types to export;<br>`templates` - `(array)` IDs of templates to export.<br>|
fa	### پارامتر ها    "(object)" پارامترهایی که اشیاء صادر شده و قالب را برای استفاده تعیین می کنند .  |پارامتر|[نوع](/manual/api/reference_commentary#data_types)|توضیحات| |--|--|------| |**قالب**<br>(الزامی)|رشته|قالبی که داده ها باید در آن صادر شوند.<br><br>مقادیر ممکن:<br>`yaml` - YAML;<br>`xml` - XML ;<br>`json` - JSON;<br>`raw` - آرایه PHP پردازش نشده.| |prettyprint|boolean|با افزودن تورفتگی، خروجی را خواناتر کنید .| |**گزینه ها**<br>(لازم)|شیء|اشیاء برای صادر شدن.<br><br>شیء «گزینه» دارای پارامترهای زیر است:<br>«گروه ها» - «(آرایه)» شناسه های گروه‌های میزبان برای صادرات؛<br>«میزبان‌ها» - «(آرایه)» شناسه‌های میزبان برای صادرات؛<br>«تصاویر» - «(آرایه)» شناسه‌های تصاویر برای صادرات؛<br>«نقشه‌ها» - «( آرایه)` شناسه‌های نقشه‌ها برای صادرات؛<br>«انواع رسانه» - «(آرایه)» شناسه‌های انواع رسانه برای صادرات؛<br>«الگوها» - «(آرایه)» شناسه‌های الگوهایی برای صادرات.<br>|

en-us	### Parameters  `(object)` Settings properties to be updated.
fa	### پارامتر ها   `(object)` Housekeeping properties to be updated.

en-us	### Parameters  The following parameters are supported for the *Data overview* widget.  |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Refresh interval*|<|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - *(default)* 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - 15 minutes.| |*Host groups*|<|2|groupids|[Host group](/manual/api/reference/hostgroup/get) ID.<br><br>Note: To configure multiple host groups, create a dashboard widget field object for each host group.| |*Hosts*|<|3|hostids|[Host](/manual/api/reference/host/get) ID.<br><br>Note: To configure multiple hosts, create a dashboard widget field object for each host. For multiple hosts, the parameter *Host groups* must either be not configured at all or configured with at least one host group that the configured hosts belong to.| |*Tags* (the number in the property name (e.g. tags.tag.0) references tag order in the tag evaluation list)|<|<|<|<| |<|*Evaluation type*|0|evaltype|0 - *(default)* And/Or;<br>2 - Or.| |^|*Tag name*|1|tags.tag.0|Any string value.<br><br>Parameter *Tag name* required if configuring *Tags*.| |^|*Operator*|0|tags.operator.0|0 - Contains;<br>1 - Equals;<br>2 - Does not contain;<br>3 - Does not equal;<br>4 - Exists;<br>5 - Does not exist.<br><br>Parameter *Operator* required if configuring *Tags*.| |^|*Tag value*|1|tags.value.0|Any string value.<br><br>Parameter *Tag value* required if configuring *Tags*.| |*Show suppressed problems*|<|0|show_suppressed|0 - *(default)* Disabled;<br>1 - Enabled.| |*Hosts location*|<|0|style|0 - *(default)* Left;<br>1 - Top.|
fa	### مولفه های  پارامترهای زیر برای ویجت *نمای کلی داده* پشتیبانی می شوند.  |پارامتر|<|[نوع](/manual/api/reference/dashboard/object#dashboard-widget-field)|نام|مقدار| |-|--------|--|--------|------------------------- -----| |*فاصله بازخوانی*|<|0|rf_rate|0 - بدون بازخوانی؛<br>10 - 10 ثانیه؛<br>30 - 30 ثانیه؛<br>60 - *(پیش‌فرض)* 1 دقیقه؛<br>120 - 2 دقیقه؛<br>600 - 10 دقیقه؛<br>900 - 15 دقیقه.| |*گروه میزبان*|<|2|گروه|[گروه میزبان](/manual/api/reference/hostgroup/get).<br><br>توجه: برای پیکربندی چند گروه میزبان، یک شی فیلد ویجت داشبورد ایجاد کنید برای هر گروه میزبان.| |*Hosts*|<|3|hostids|[Host](/manual/api/reference/host/get) ID.<br><br>توجه: برای پیکربندی چندین میزبان، یک شی فیلد ویجت داشبورد برای هر میزبان ایجاد کنید. . برای چندین میزبان، پارامتر *گروه های میزبان* باید یا اصلاً پیکربندی نشده باشد یا حداقل با یک گروه میزبان که میزبان های پیکربندی شده به آن تعلق دارند، پیکربندی شود. |*برچسب*ها (تعداد در نام دارایی (به عنوان مثال tags.tag.0) ارجاع به ترتیب برچسب در لیست ارزیابی برچسب)|<|<|<|<| |<|*نوع ارزیابی*|0|evaltype|0 - *(پیش فرض)* And/Or;<br>2 - Or.| |^|*نام برچسب*|1|tags.tag.0|هر مقدار رشته.<br><br>پارامتر *نام برچسب* در صورت پیکربندی *برچسب*ها لازم است.| |^|*اپراتور*|0|tags.operator.0|0 - شامل؛<br>1 - برابر است؛<br>2 - حاوی نیست؛<br>3 - برابر نیست؛<br>4 - وجود دارد ;<br>5 - وجود ندارد.<br><br>در صورت پیکربندی *برچسب*ها، پارامتر *اپراتور* مورد نیاز است.| |^|*مقدار برچسب*|1|tags.value.0|هر مقدار رشته.<br><br>پارامتر *مقدار برچسب* در صورت پیکربندی *برچسب*ها لازم است.| |*نمایش مشکلات سرکوب شده*|<|0|show_suppressed|0 - *(پیش فرض)* غیرفعال شده؛<br>1 - فعال است.| |*مکان میزبان*|<|0|سبک|0 - *(پیش فرض)* سمت چپ؛<br>1 - بالا.|

en-us	### Parameters  The following parameters are supported for the *Top Hosts* widget.  |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Refresh interval*|<|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - *(default)* 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - 15 minutes.| |*Host groups*|<|2|groupids|[Host group](/manual/api/reference/hostgroup/get) ID.<br><br>Note: To configure multiple host groups, create a dashboard widget field object for each host group.| |*Hosts*|<|3|hostids|[Host](/manual/api/reference/host/get) ID.<br><br>Note: To configure multiple hosts, create a dashboard widget field object for each host. For multiple hosts, the parameter *Host groups* must either be not configured at all or configured with at least one host group that the configured hosts belong to.| |*Host Tags* (the number in the property name (e.g. tags.tag.0) references tag order in the tag evaluation list)|<|<|<|<| |<|*Evaluation type*|0|evaltype|0 - *(default)* And/Or;<br>2 - Or.| |^|*Tag name*|1|tags.tag.0|Any string value.<br><br>Parameter *Tag name* required if configuring *Tags*.| |^|*Operator*|0|tags.operator.0|0 - Contains;<br>1 - Equals;<br>2 - Does not contain;<br>3 - Does not equal;<br>4 - Exists;<br>5 - Does not exist.<br><br>Parameter *Operator* required if configuring *Tags*.| |^|*Tag value*|1|tags.value.0|Any string value.<br><br>Parameter *Tag value* required if configuring *Tags*.| |*Columns* (see below)|<|<|<|<| |*Order*|<|0|order|2 - *(default)* Top N;<br>3 - Bottom N.| |*Order column*|<|0|column|Column numeric value from the configured columns.| |*Host count*|<|0|count|Valid values range from 1-100.<br><br>Default: 10.|
fa	### مولفه های  پارامترهای زیر برای ویجت *Top Hosts* پشتیبانی می شوند.  |پارامتر|<|[نوع](/manual/api/reference/dashboard/object#dashboard-widget-field)|نام|مقدار| |-|--------|--|--------|------------------------- -----| |*فاصله بازخوانی*|<|0|rf_rate|0 - بدون بازخوانی؛<br>10 - 10 ثانیه؛<br>30 - 30 ثانیه؛<br>60 - *(پیش‌فرض)* 1 دقیقه؛<br>120 - 2 دقیقه؛<br>600 - 10 دقیقه؛<br>900 - 15 دقیقه.| |*گروه میزبان*|<|2|گروه|[گروه میزبان](/manual/api/reference/hostgroup/get).<br><br>توجه: برای پیکربندی چندین گروه میزبان، یک شی فیلد ویجت داشبورد ایجاد کنید برای هر گروه میزبان.| |*Hosts*|<|3|hostids|[Host](/manual/api/reference/host/get) ID.<br><br>توجه: برای پیکربندی چندین میزبان، یک شی فیلد ویجت داشبورد برای هر میزبان ایجاد کنید. . برای چندین میزبان، پارامتر *گروه های میزبان* باید یا اصلاً پیکربندی نشده باشد یا حداقل با یک گروه میزبان که میزبان های پیکربندی شده به آن تعلق دارند، پیکربندی شود. |*برچسب های میزبان* (تعداد در نام ویژگی (به عنوان مثال tags.tag.0) ارجاع به ترتیب برچسب در لیست ارزیابی برچسب)|<|<|<|<| |<|*نوع ارزیابی*|0|evaltype|0 - *(پیش فرض)* And/Or;<br>2 - Or.| |^|*نام برچسب*|1|tags.tag.0|هر مقدار رشته.<br><br>پارامتر *نام برچسب* در صورت پیکربندی *برچسب*ها لازم است.| |^|*اپراتور*|0|tags.operator.0|0 - شامل؛<br>1 - برابر است؛<br>2 - حاوی نیست؛<br>3 - برابر نیست؛<br>4 - وجود دارد ;<br>5 - وجود ندارد.<br><br>در صورت پیکربندی *برچسب*ها، پارامتر *اپراتور* مورد نیاز است.| |^|*مقدار برچسب*|1|tags.value.0|هر مقدار رشته ای.<br><br>پارامتر *مقدار برچسب* در صورت پیکربندی *برچسب*ها لازم است.| |*ستون* (به زیر مراجعه کنید)|<|<|<|<| |*سفارش*|<|0|سفارش|2 - *(پیش فرض)* N بالا؛<br>3 - N. پایین| |*دستور ستون*|<|0|ستون|مقدار عددی ستون از ستون های پیکربندی شده.| |*تعداد میزبان*|<|0|تعداد|مقادیر معتبر از 1 تا 100 متغیر است.<br><br>پیش‌فرض: 10.|

en-us	##### Passive and active checks  Zabbix agents can perform passive and active checks.  In a [passive check](/manual/appendix/items/activepassive#passive_checks) the agent responds to a data request. Zabbix server (or proxy) asks for data, for example, CPU load, and Zabbix agent sends back the result.  [Active checks](/manual/appendix/items/activepassive#active_checks) require more complex processing. The agent must first retrieve a list of items from Zabbix server for independent processing. Then it will periodically send new values to the server.  Whether to perform passive or active checks is configured by selecting the respective monitoring [item type](/manual/config/items/itemtypes/zabbix_agent). Zabbix agent processes items of type 'Zabbix agent' or 'Zabbix agent (active)'.
fa	##### چک های غیرفعال و فعال  عوامل Zabbix می توانند بررسی های غیرفعال و فعال را انجام دهند.  در یک [منفعل بررسی کنید](/دستی/ضمیمه/items/activepassive#passive_checks) عامل به درخواست داده پاسخ می دهد. سرور Zabbix (یا پروکسی) داده ها را برای به عنوان مثال، بارگذاری CPU، و عامل Zabbix نتیجه را پس می‌فرستد.  [بررسی‌های فعال](/دستی/ضمیمه/آیتم/فعال منفعل#چک_فعال) نیاز به پردازش پیچیده تری دارد. عامل ابتدا باید لیستی از موارد از سرور Zabbix برای پردازش مستقل. سپس آن را انجام خواهد داد به صورت دوره ای مقادیر جدید را به سرور ارسال کنید.  انجام بررسی های غیرفعال یا فعال با انتخاب پیکربندی می شود نظارت مربوطه [مورد type](/manual/config/items/itemtypes/zabbix_agent). نماینده Zabbix مواردی از نوع "عامل Zabbix" یا "عامل Zabbix (فعال)" را پردازش می کند.

en-us	#### Passive proxy
fa	#### پراکسی غیرفعال

en-us	##### Payload data definition  ###### Common data  These parameters are present in all requests/responses:  |Name|Type|Comments| |-----|--------|----------| |id   |uint32|For requests - the incrementing identifier used to link requests with responses. Unique within a request direction (i.e. from agent to plugin or from plugin to agent).<br>For responses - ID of the corresponding request.| |type|uint32|The request type.|
fa	##### تعریف داده های بار  ###### داده های رایج  این پارامترها در همه درخواست‌ها/پاسخ‌ها وجود دارند:  |نام|نوع|نظر| |-----|--------|----------| |id |uint32|برای درخواست ها - شناسه افزایشی مورد استفاده برای پیوند درخواست ها با پاسخ ها. منحصر به فرد در جهت درخواست (یعنی از یک عامل به افزونه یا از یک افزونه به یک عامل).<br>برای پاسخ - شناسه درخواست مربوطه.| |type|uint32|نوع درخواست.|

en-us	 ### Payload data  |Type|Size|Comments| |-----|-----|----------| |Byte| Defined by the *Size* field |JSON formatted data.|
fa	 ### داده های بار  |نوع|اندازه|نظرات| |-----|-----|----------| |بایت| توسط فیلد *Size* |داده های فرمت JSON.| تعریف شده است

en-us	## Plugins
fa	## پلاگین

en-us	## Plugins
fa	## پلاگین

en-us	### PostgreSQL  Export and import must be performed in tmux/screen to ensure that the session isn't dropped. For installations with TimescaleDB, skip this section and proceed to [PostgreSQL + TimescaleDB](#postgresql-timescaledb).  See also: [Important notes](#important-notes)  #### Table upgrade  * Rename tables using `history_pk_prepare.sql`:  ``` {.bash} sudo -u zabbix psql zabbix < /usr/share/zabbix-sql-scripts/postgresql/history_pk_prepare.sql ```  #### Migration with stopped server  * Export current history, import it to the temp table,  then insert the data into new tables while ignoring duplicates:  ``` {.sql} INSERT INTO history SELECT * FROM history_old ON CONFLICT (itemid,clock,ns) DO NOTHING;  INSERT INTO history_uint SELECT * FROM history_uint_old ON CONFLICT (itemid,clock,ns) DO NOTHING;  INSERT INTO history_str SELECT * FROM history_str_old ON CONFLICT (itemid,clock,ns) DO NOTHING;  INSERT INTO history_log SELECT * FROM history_log_old ON CONFLICT (itemid,clock,ns) DO NOTHING;  INSERT INTO history_text SELECT * FROM history_text_old ON CONFLICT (itemid,clock,ns) DO NOTHING; ```  See tips for improving INSERT performance: [PostgreSQL: Bulk Loading Huge Amounts of Data](https://www.cybertec-postgresql.com/en/postgresql-bulk-loading-huge-amounts-of-data), [Checkpoint Distance and Amount of WAL](https://www.cybertec-postgresql.com/en/checkpoint-distance-and-amount-of-wal).  * Follow [post-migration instructions](#post-migration) to drop the old tables.
fa	### PostgreSQL  صادرات و واردات باید در tmux/screen انجام شود تا اطمینان حاصل شود که جلسه حذف نشده است. برای نصب با TimescaleDB، از این بخش رد شده و به [PostgreSQL + TimescaleDB] (#postgresql-timescaledb) بروید.  همچنین ببینید: [یادداشت های مهم] (#important-notes)  #### ارتقای جدول  * تغییر نام جداول با استفاده از `history_pk_prepare.sql`:  ``` {.bash} sudo -u zabbix psql zabbix < /usr/share/zabbix-sql-scripts/postgresql/history_pk_prepare.sql ```  #### مهاجرت با سرور متوقف شده  * تاریخچه فعلی را صادر کنید، آن را به جدول موقت وارد کنید، سپس داده ها را در جداول جدید وارد کنید و در عین حال موارد تکراری را نادیده بگیرید:  ``` {.sql} INSERT INTO history SELECT * FROM history_old ON CONFLICT (itemid,clock,ns) هیچ کاری نکنید.  INSERT INTO history_uint SELECT * FROM history_uint_old ON CONFLICT (itemid,clock,ns) هیچ کاری نکنید.  INSERT INTO history_str SELECT * FROM history_str_old ON CONFLICT (itemid,clock,ns) هیچ کاری نکنید.  INSERT INTO history_log SELECT * FROM history_log_old ON CONFLICT (itemid,clock,ns) هیچ کاری نکنید.  INSERT INTO history_text SELECT * FROM history_text_old ON CONFLICT (itemid,clock,ns) هیچ کاری نکنید. ```  نکاتی را برای بهبود عملکرد INSERT ببینید: [PostgreSQL: Bulk Loading Huge Amounts of Data](https://www.cybertec-postgresql.com/en/postgresql-bulk-loading-huge-amounts-of-data)، [Checkpoint Distance and Amount of WAL](https://www.cybertec-postgresql.com/en/checkpoint-distance-and-amount-of-wal).  * [دستورالعمل‌های پس از مهاجرت] (#post-migration) را برای حذف جداول قدیمی دنبال کنید.

en-us	 ### PostgreSQL + TimescaleDB  Export and import must be performed in tmux/screen to ensure that the session isn't dropped. Zabbix server should be down during the upgrade.  See also: [Important notes](#important-notes)  * Rename tables using `history_pk_prepare.sql`.  ``` {.bash} sudo -u zabbix psql zabbix < /usr/share/zabbix-sql-scripts/postgresql/history_pk_prepare.sql ```  ::: noteimportant The path to `history_pk_prepare.sql` has been [changed](/manual/introduction/whatsnew609#packages) since Zabbix 6.0.9. For versions older than 6.0.9, the following command should be used:<br><br>  ``` {.bash} sudo -u zabbix psql zabbix < /usr/share/doc/zabbix-sql-scripts/postgresql/history_pk_prepare.sql ``` :::  * Run TimescaleDB hypertable migration scripts (compatible with both TSDB v2.x and v1.x version) based on compression settings:   * If compression is enabled (on default installation), run scripts from `/usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression`:     ``` {.bash}     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk_uint.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk_log.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk_str.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk_text.sql | sudo -u zabbix psql zabbix     ```   * If compression is disabled, run scripts from `/usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression`:     ``` {.bash}     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk_uint.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk_log.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk_str.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk_text.sql | sudo -u zabbix psql zabbix     ```  See also: [Tips](https://blog.timescale.com/blog/13-tips-to-improve-postgresql-insert-performance/) for improving INSERT performance.  * Follow [post-migration instructions](#post-migration) to drop the old tables.
fa	 ### PostgreSQL + TimescaleDB  صادرات و واردات باید در tmux/screen انجام شود تا اطمینان حاصل شود که جلسه حذف نشده است. سرور Zabbix باید در حین ارتقاء از کار بیفتد.  همچنین ببینید: [یادداشت های مهم] (#important-notes)  * تغییر نام جداول با استفاده از `history_pk_prepare.sql`.  ``` {.bash} sudo -u zabbix psql zabbix < /usr/share/zabbix-sql-scripts/postgresql/history_pk_prepare.sql ```  ::: نکته مهم مسیر "history_pk_prepare.sql" از Zabbix 6.0.9 [تغییر] (/manual/introduction/whatsnew609#packages) شده است. برای نسخه های قدیمی تر از 6.0.9 باید از دستور زیر استفاده کرد:<br><br>  ``` {.bash} sudo -u zabbix psql zabbix < /usr/share/doc/zabbix-sql-scripts/postgresql/history_pk_prepare.sql ``` :::  * اسکریپت های مهاجرت hypertable TimescaleDB (سازگار با هر دو نسخه TSDB v2.x و v1.x) را بر اساس تنظیمات فشرده سازی اجرا کنید:   * اگر فشرده‌سازی فعال است (در نصب پیش‌فرض)، اسکریپت‌ها را از «/usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression» اجرا کنید:     ``` {.bash}     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk_uint.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk_log.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk_str.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk_text.sql | sudo -u zabbix psql zabbix     ```   * اگر فشرده‌سازی غیرفعال است، اسکریپت‌ها را از «/usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression» اجرا کنید:     ``` {.bash}     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk_uint.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk_log.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk_str.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk_text.sql | sudo -u zabbix psql zabbix     ```  همچنین ببینید: [نکاتی] (https://blog.timescale.com/blog/13-tips-to-improve-postgresql-insert-performance/) برای بهبود عملکرد INSERT.  * [دستورالعمل‌های پس از مهاجرت] (#post-migration) را برای حذف جداول قدیمی دنبال کنید.

en-us	#### PostgreSQL  You need to have database user with permissions to create database objects.   If you are installing from Zabbix **packages**, proceed to the [instructions](https://www.zabbix.com/download) for your platform.  If you are installing Zabbix from sources:  * Create a database user.  The following shell command will create user `zabbix`. Specify a password when prompted and repeat the password (note, you may first be asked for `sudo` password):  ```bash sudo -u postgres createuser --pwprompt zabbix ```  * Create a database.  The following shell command will create the database `zabbix` (last parameter) with the previously created user as the owner (`-O zabbix`).  ```bash sudo -u postgres createdb -O zabbix -E Unicode -T template0 zabbix ```  * Import the initial schema and data (assuming you are in the root directory of Zabbix sources).   For a Zabbix proxy database, only `schema.sql` should be imported (no images.sql nor data.sql).  ```bash cd database/postgresql cat schema.sql | sudo -u zabbix psql zabbix # stop here if you are creating database for Zabbix proxy cat images.sql | sudo -u zabbix psql zabbix cat data.sql | sudo -u zabbix psql zabbix ```  ::: noteimportant The above commands are provided as an example that will work in most of GNU/Linux installations. You can use different commands depending on how your system/database is configured, for example: <br><br> `psql -U <username>` <br><br> If you have any trouble setting up the database, please consult your Database administrator.  :::
fa	#### PostgreSQL  برای ایجاد پایگاه داده باید کاربر پایگاه داده با مجوز داشته باشید اشیاء.  اگر از Zabbix **packages** نصب می کنید، به [دستورالعمل ها] (https://www.zabbix.com/download) بروید. پلت فرم شما  اگر Zabbix را از منابع نصب می کنید:  * یک کاربر پایگاه داده ایجاد کنید.  دستور پوسته زیر کاربر 'zabbix' را ایجاد می کند. مشخص كردن هنگامی که از شما خواسته شد یک رمز عبور و تکرار رمز عبور (توجه داشته باشید، ممکن است ابتدا از شما خواسته شود برای رمز عبور sudo):  ``باش sudo -u postgres createuser --pwprompt zabbix ```  * ایجاد پایگاه داده  دستور پوسته زیر پایگاه داده 'zabbix' (آخرین پارامتر) را با کاربر قبلاً به عنوان مالک ایجاد شده است (`-O zabbix`).  ``باش sudo -u postgres createb -O zabbix -E Unicode -T template0 zabbix ```  * طرحواره و داده های اولیه را وارد کنید (با فرض اینکه در فهرست اصلی منابع Zabbix هستید).  برای پایگاه داده پروکسی Zabbix، فقط «schema.sql» باید باشد وارد شده (بدون images.sql و نه data.sql).  ``باش دیتابیس سی دی/postgresql cat schema.sql | sudo -u zabbix psql zabbix اگر در حال ایجاد پایگاه داده برای پروکسی Zabbix هستید، در اینجا توقف کنید cat images.sql | sudo -u zabbix psql zabbix cat data.sql | sudo -u zabbix psql zabbix ```  ::: نکته مهم دستورات بالا به عنوان نمونه ارائه شده اند که در اکثر نصب های گنو/لینوکس کار می کنند. بسته به نحوه پیکربندی سیستم/پایگاه داده شما می توانید از دستورات مختلفی استفاده کنید، به عنوان مثال: <br><br> "psql -U <username>". <br><br> اگر مشکلی در راه اندازی پایگاه داده دارید، لطفاً با مدیر پایگاه داده خود مشورت کنید. :::

en-us	 ### Post-migration  For all databases, once the migration is completed, do the following:  * Verify that everything works as expected.  * Drop old tables:  ``` {.sql} DROP TABLE history_old; DROP TABLE history_uint_old; DROP TABLE history_str_old; DROP TABLE history_log_old; DROP TABLE history_text_old; ```
fa	 ### پس از مهاجرت  برای همه پایگاه‌های داده، پس از تکمیل مهاجرت، موارد زیر را انجام دهید:  * بررسی کنید که همه چیز همانطور که انتظار می رود کار می کند.  * میزهای قدیمی را رها کنید:  ``` {.sql} DROP TABLE history_old; DROP TABLE history_uint_old; DROP TABLE history_str_old; DROP TABLE history_log_old; DROP TABLE history_text_old; ```

en-us	##### Preparation  Zabbix agent is distributed as a zip archive. After you download the archive you need to unpack it. Choose any folder to store Zabbix agent and the configuration file, e. g.      C:\zabbix  Copy bin\\zabbix\_agentd.exe and conf\\zabbix\_agentd.conf files to c:\\zabbix.  Edit the c:\\zabbix\\zabbix\_agentd.conf file to your needs, making sure to specify a correct "Hostname" parameter.
fa	##### آماده سازی  عامل Zabbix به عنوان یک آرشیو فشرده توزیع می شود. بعد از دانلود بایگانی باید آن را باز کنید. هر پوشه ای را برای ذخیره عامل Zabbix انتخاب کنید و فایل پیکربندی، e. g.      ج:\zabbix  فایل های bin\\zabbix\_agentd.exe و conf\\zabbix\_agentd.conf را در ج:\\zabbix.  فایل c:\\zabbix\\zabbix\_agentd.conf را مطابق با نیاز خود ویرایش کنید، مطمئن شوید برای تعیین یک پارامتر صحیح "Hostname".

en-us	##### Preparing frontend  Make sure that Zabbix server address:port is **not defined** in the  frontend configuration (found in `conf/zabbix.conf.php` of the frontend  files directory).  ![](../../../../assets/en/manual/config/frontend_conf_server_port.png){width="600"}  Zabbix frontend will autodetect the active node by reading settings  from the nodes table in Zabbix database. Node address of the active node  will be used as the Zabbix server address.
fa	##### آماده سازی فرانت اند  مطمئن شوید که آدرس سرور Zabbix:پورت **در قسمت تعریف نشده** باشد پیکربندی frontend (در «conf/zabbix.conf.php» از frontend یافت می شود دایرکتوری فایل ها).  ![](../../../../assets/en/manual/config/frontend_conf_server_port.png){width="600"}  Zabbix frontend با خواندن تنظیمات، گره فعال را به صورت خودکار شناسایی می کند از جدول گره ها در پایگاه داده Zabbix. آدرس گره گره فعال به عنوان آدرس سرور Zabbix استفاده خواهد شد.

en-us	#### Preprocessing  The **Preprocessing** tab allows to define transformation rules to apply to the result of discovery. One or several transformations are possible in this step. Transformations are executed in the order in which they are defined. All preprocessing is done by Zabbix server.  See also:  -   [Preprocessing     details](/manual/config/items/preprocessing/preprocessing_details) -   [Preprocessing testing](/manual/config/items/preprocessing#testing)  ![](../../../assets/en/manual/discovery/low_level_discovery/lld_fs_b.png)   |Type|<|<| |-|----------|----------------------------------------| | |*Transformation*|Description| |Text|<|<| |<|*Regular expression*|Match the received value to the <pattern> regular expression and replace value with the extracted <output>. The regular expression supports extraction of maximum 10 captured groups with the \\N sequence.<br>Parameters:<br>**pattern** - regular expression<br>**output** - output formatting template. An \\N (where N=1…9) escape sequence is replaced with the Nth matched group. A \\0 escape sequence is replaced with the matched text.<br>If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value or set a specified error message.| |^|*Replace*|Find the search string and replace it with another (or nothing). All occurrences of the search string will be replaced.<br>Parameters:<br>**search string** - the string to find and replace, case-sensitive (required)<br>**replacement** - the string to replace the search string with. The replacement string may also be empty effectively allowing to delete the search string when found.<br>It is possible to use escape sequences to search for or replace line breaks, carriage return, tabs and spaces "\\n \\r \\t \\s"; backslash can be escaped as "\\\\" and escape sequences can be escaped as "\\\\n". Escaping of line breaks, carriage return, tabs is automatically done during low-level discovery.<br>Supported since 5.0.0.| |Structured data|<|<| |<|*JSONPath*|Extract value or fragment from JSON data using [JSONPath functionality](/manual/config/items/preprocessing/jsonpath_functionality).<br>If you mark the Custom on fail checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value or set a specified error message.| |<|*XML XPath*|Extract value or fragment from XML data using XPath functionality.<br>For this option to work, Zabbix server must be compiled with libxml support.<br>Examples:<br>`number(/document/item/value)` will extract `10` from `<document><item><value>10</value></item></document>`<br>`number(/document/item/@attribute)` will extract `10` from `<document><item attribute="10"></item></document>`<br>`/document/item` will extract `<item><value>10</value></item>` from `<document><item><value>10</value></item></document>`<br>Note that namespaces are not supported.<br>Supported since 4.4.0.<br>If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value or set a specified error message.| |<|*CSV to JSON*|Convert CSV file data into JSON format.<br>For more information, see: [CSV to JSON preprocessing](/manual/config/items/preprocessing/csv_to_json#csv_header_processing).<br>Supported since 4.4.0.| |^|*XML to JSON*|Convert data in XML format to JSON.<br>For more information, see: [Serialization rules](/manual/config/items/preprocessing/javascript/javascript_objects#serialization_rules).<br>If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value or set a specified error message.| |Custom scripts|<|<| |<|*JavaScript*|Enter JavaScript code in the block that appears when clicking in the parameter field or on the pencil icon.<br>Note that available JavaScript length depends on the [database used](/manual/config/items/item#custom_script_limit).<br>For more information, see: [Javascript preprocessing](/manual/config/items/preprocessing/javascript)| |Validation|<|<| |<|*Does not match regular expression*|Specify a regular expression that a value must not match.<br>E.g. `Error:(.*?)\.`<br>If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value or set a specified error message.| |^|*Check for error in JSON*|Check for an application-level error message located at JSONPath. Stop processing if succeeded and message is not empty; otherwise continue processing with the value that was before this preprocessing step. Note that these external service errors are reported to user as is, without adding preprocessing step information.<br>E.g. `$.errors`. If a JSON like `{"errors":"e1"}` is received, the next preprocessing step will not be executed.<br>If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value or set a specified error message.| |^|*Check for error in XML*|Check for an application-level error message located at xpath. Stop processing if succeeded and message is not empty; otherwise continue processing with the value that was before this preprocessing step. Note that these external service errors are reported to user as is, without adding preprocessing step information.<br>No error will be reported in case of failing to parse invalid XML.<br>Supported since 4.4.0.<br>If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value or set a specified error message.| |Throttling|<|<| |<|*Discard unchanged with heartbeat*|Discard a value if it has not changed within the defined time period (in seconds).<br>Positive integer values are supported to specify the seconds (minimum - 1 second). Time suffixes can be used in this field (e.g. 30s, 1m, 2h, 1d). User macros and low-level discovery macros can be used in this field.<br>Only one throttling option can be specified for a discovery item.<br>E.g. `1m`. If identical text is passed into this rule twice within 60 seconds, it will be discarded.<br>*Note*: Changing item prototypes does not reset throttling. Throttling is reset only when preprocessing steps are changed.| |Prometheus|<|<| |<|*Prometheus to JSON*|Convert required Prometheus metrics to JSON.<br>See [Prometheus checks](/manual/config/items/itemtypes/prometheus) for more details.|  Note that if the discovery rule has been applied to the host via template then the content of this tab is read-only.
fa	#### پیش پردازش  برگه **پیش پردازش** اجازه می دهد تا قوانین تبدیل را برای اعمال تعریف کنید به نتیجه کشف یک یا چند تغییر ممکن است در این مرحله تبدیل ها به ترتیبی که انجام می شوند انجام می شوند تعریف شده اند. تمام پیش پردازش ها توسط سرور Zabbix انجام می شود.  همچنین ببینید:  - [پیش پردازش     جزئیات](/دستی/پیکربندی/ایتم/پیش پردازش/پیش پردازش_جزئیات) - [آزمایش پیش پردازش] (/دستی/تنظیم/تست/پیش پردازش#تست)  ![](../../../assets/en/manual/discovery/low_level_discovery/lld_fs_b.png)   |نوع|<|<| |-|----------|----------------------------------- ----| | |*تحول*|توضیحات| |متن|<|<| |<|*عبارت منظم*|مقدار دریافتی را با عبارت منظم <pattern> مطابقت دهید و مقدار را با <output> استخراج شده جایگزین کنید. عبارت منظم از استخراج حداکثر 10 گروه گرفته شده با دنباله \\N پشتیبانی می کند.<br>پارامترها:<br>**الگوی** - عبارت منظم<br>**خروجی** - قالب قالب بندی خروجی. یک دنباله فرار \\N (که در آن N=1…9) با Nامین گروه همسان جایگزین می شود. یک دنباله فرار \\ 0 با متن منطبق جایگزین می‌شود.<br>اگر کادر *Custom on fail* را علامت بزنید، می‌توانید گزینه‌های سفارشی رسیدگی به خطا را مشخص کنید: یا برای صرف‌نظر کردن مقدار، تنظیم مقدار مشخص یا تنظیم یک پیام خطای مشخص شده.| |^|*Replace*|رشته جستجو را پیدا کنید و آن را با دیگری (یا هیچ چیز) جایگزین کنید. همه تکرارهای رشته جستجو جایگزین خواهند شد.<br>پارامترها:<br>**رشته جستجو** - رشته برای یافتن و جایگزینی، حساس به حروف بزرگ و کوچک (الزامی)<br>**جایگزینی** - رشته به رشته جستجو را جایگزین کنید. رشته جایگزین ممکن است به طور موثری خالی باشد و امکان حذف رشته جستجو در صورت یافتن را فراهم کند.<br>این امکان وجود دارد که از دنباله‌های فرار برای جستجو یا جایگزینی شکسته‌های خط، بازگشت کالا، برگه‌ها و فاصله‌های "\\n \\r \\ استفاده کنید. t \\s"؛ اسلش را می توان به صورت "\\\\" و دنباله های فرار را می توان به عنوان "\\\\n" فرار کرد. فرار از شکستگی خط، بازگشت کالسکه، برگه ها به طور خودکار در هنگام کشف سطح پایین انجام می شود.<br>پشتیبانی شده از نسخه 5.0.0.| |داده های ساختاریافته|<|<| |<|*JSONPath*|استخراج مقدار یا قطعه از داده های JSON با استفاده از [عملکرد JSONPath](/manual/config/items/preprocessing/jsonpath_functionality).<br>اگر کادر تأیید سفارشی روی شکست را علامت بزنید، می‌توانید سفارشی را مشخص کنید. گزینه های رسیدگی به خطا: یا برای رد کردن مقدار، یک مقدار مشخص یا تنظیم یک پیام خطای مشخص.| |<|*XML XPath*|مقدار یا قطعه را از داده های XML با استفاده از عملکرد XPath استخراج کنید.<br>برای اینکه این گزینه کار کند، سرور Zabbix باید با پشتیبانی libxml کامپایل شود.<br>مثال:<br>`number(/document /item/value) «10» را از «<document><item><value>10</value></item></document>»<br>«شماره(/document/item/@attribute) استخراج می‌کند. ` «10» را از «<document><item attribute="10"></item></document><br>`/document/item` استخراج می کند، «<item><value>10</value» را استخراج می کند. </item>` از `<document><item><value>10</value></item></document>`<br>توجه داشته باشید که فضاهای نام پشتیبانی نمی شوند.<br>از نسخه 4.4.0 پشتیبانی می شود. <br>اگر کادر *Custom on fail* را علامت بزنید، می‌توانید گزینه‌های سفارشی رسیدگی به خطا را مشخص کنید: یا برای صرف‌نظر کردن مقدار، تنظیم یک مقدار مشخص یا تنظیم یک پیام خطای مشخص.| |<|*CSV به JSON*|داده‌های فایل CSV را به فرمت JSON تبدیل کنید.<br>برای اطلاعات بیشتر، رجوع کنید به: [CSV to JSON preprocessing](/manual/config/items/preprocessing/csv_to_json#csv_header_processing).<br> پشتیبانی از 4.4.0.| |^|*XML به JSON*|تبدیل داده ها در قالب XML به JSON.<br>برای اطلاعات بیشتر، به [Serialization قواعد](/manual/config/items/preprocessing/javascript/javascript_objects#serialization_rules) مراجعه کنید.<br> اگر کادر *Custom on fail* را علامت بزنید، می‌توانید گزینه‌های سفارشی رسیدگی به خطا را مشخص کنید: یا برای صرف‌نظر کردن مقدار، تنظیم یک مقدار مشخص یا تنظیم یک پیام خطای مشخص.| |اسکریپت های سفارشی|<|<| |<|*جاوا اسکریپت*|کد جاوا اسکریپت را در بلوکی که هنگام کلیک کردن در قسمت پارامتر یا نماد مداد ظاهر می شود، وارد کنید.<br>توجه داشته باشید که طول جاوا اسکریپت موجود بستگی به [پایگاه داده استفاده شده] دارد(/manual/config/items/ item#custom_script_limit).<br>برای اطلاعات بیشتر، رجوع کنید به: [پیش پردازش جاوا اسکریپت](/manual/config/items/preprocessing/javascript)| | اعتبارسنجی|<|<| |<|*با عبارت منظم مطابقت ندارد*|یک عبارت منظم را مشخص کنید که یک مقدار نباید مطابقت داشته باشد.<br>به عنوان مثال. `خطا:(.*?)\.`<br>اگر کادر *Custom on fail* را علامت بزنید، می‌توانید گزینه‌های سفارشی رسیدگی به خطا را مشخص کنید: یا برای صرف‌نظر کردن مقدار، تنظیم یک مقدار مشخص یا تنظیم یک مقدار مشخص. پیغام خطا.| |^|*بررسی خطا در JSON*|پیام خطای سطح برنامه واقع در JSONPath را بررسی کنید. در صورت موفقیت آمیز بودن و خالی نبودن پیام، پردازش را متوقف کنید. در غیر این صورت پردازش را با مقداری که قبل از این مرحله پیش پردازش بود ادامه دهید. توجه داشته باشید که این خطاهای سرویس خارجی بدون افزودن اطلاعات مرحله پیش پردازش به کاربر همانطور که هست گزارش می شود.<br>به عنوان مثال. "$.errors". اگر JSON مانند `{"errors":"e1"}` دریافت شود، مرحله پیش پردازش بعدی اجرا نخواهد شد.<br>اگر کادر انتخاب *Custom on fail* را علامت بزنید، می‌توانید مدیریت خطای سفارشی را مشخص کنید. گزینه ها: یا برای حذف مقدار، مقدار مشخصی را تنظیم کنید یا یک پیام خطای مشخص را تنظیم کنید.| |^|*بررسی خطا در XML*|پیام خطای سطح برنامه واقع در xpath را بررسی کنید. در صورت موفقیت آمیز بودن و خالی نبودن پیام، پردازش را متوقف کنید. در غیر این صورت پردازش را با مقداری که قبل از این مرحله پیش پردازش بود ادامه دهید. توجه داشته باشید که این خطاهای سرویس خارجی بدون افزودن اطلاعات مرحله پیش پردازش به کاربر همانطور که هست گزارش می شود.<br>در صورت شکست در تجزیه XML نامعتبر هیچ خطایی گزارش نمی شود.<br>از نسخه 4.4.0 پشتیبانی می شود.<br>اگر شما کادر انتخاب *Custom on fail* را علامت بزنید، می‌توانید گزینه‌های سفارشی رسیدگی به خطا را مشخص کنید: یا برای صرف‌نظر کردن مقدار، تنظیم یک مقدار مشخص یا تنظیم یک پیام خطای مشخص.| |دریچه گاز|<|<| |<|*عدم تغییر با ضربان قلب*|اگر مقداری در بازه زمانی تعریف شده (بر حسب ثانیه) تغییر نکرده است، صرف نظر کنید.<br>مقادیر صحیح مثبت برای تعیین ثانیه ها (حداقل - 1 ثانیه) پشتیبانی می شوند. پسوندهای زمانی را می توان در این زمینه استفاده کرد (به عنوان مثال 30s، 1m، 2h، 1d). ماکروهای کاربر و ماکروهای اکتشاف سطح پایین را می توان در این زمینه استفاده کرد.<br>فقط یک گزینه throttling را می توان برای یک مورد کشف مشخص کرد.<br>به عنوان مثال. "1 متر". اگر متن یکسان دو بار در عرض 60 ثانیه به این قانون منتقل شود، از آن دور می‌افتد.<br>*توجه*: تغییر نمونه‌های اولیه مورد، throttling را بازنشانی نمی‌کند. تنها زمانی که مراحل پیش‌پردازش تغییر کرده باشد، throttling بازنشانی می‌شود.| |پرومته|<|<| |<|*Prometheus به JSON*|تبدیل معیارهای Prometheus مورد نیاز به JSON.<br>برای جزئیات بیشتر به [Prometheus checks](/manual/config/items/itemtypes/prometheus) مراجعه کنید.|  توجه داشته باشید که اگر قانون کشف برای میزبان از طریق اعمال شده باشد سپس محتوای این برگه فقط خواندنی است.

en-us	### Pre-requisites  Install MySQL database from the [official repository](https://dev.mysql.com/downloads/repo/yum/).  See [MySQL documentation](https://dev.mysql.com/doc/mysql-yum-repo-quick-guide/en/) for details on how to use MySQL repo.  MySQL server is ready to accept secure connections using a self-signed certificate.  To see, which users are using an encrypted connection, run the following query (Performance Schema should be turned ON):      mysql> SELECT sbt.variable_value AS tls_version, t2.variable_value AS cipher, processlist_user AS user, processlist_host AS host              FROM performance_schema.status_by_thread  AS sbt             JOIN performance_schema.threads AS t ON t.thread_id = sbt.thread_id             JOIN performance_schema.status_by_thread AS t2 ON t2.thread_id = t.thread_id             WHERE sbt.variable_name = 'Ssl_version' and t2.variable_name = 'Ssl_cipher'             ORDER BY tls_version;
fa	### پیش نیازها  پایگاه داده MySQL را از [official مخزن] (https://dev.mysql.com/downloads/repo/yum/).  [MySQL مستندات](https://dev.mysql.com/doc/mysql-yum-repo-quick-guide/en/) برای جزئیات در مورد نحوه استفاده از MySQL repo.  سرور MySQL آماده پذیرش اتصالات امن با استفاده از خود امضا شده است گواهی  برای مشاهده اینکه کدام کاربران از اتصال رمزگذاری شده استفاده می کنند، موارد زیر را اجرا کنید پرس و جو (شما عملکرد باید روشن شود):      mysql> SELECT sbt.variable_value AS tls_version، t2.variable_value AS cipher، processlist_user AS کاربر، processlist_host AS میزبان             FROM performance_schema.status_by_thread AS sbt             به performance_schema.threads AS t در t.thread_id = sbt.thread_id بپیوندید             به performance_schema.status_by_thread AS t2 در t2.thread_id = t.thread_id بپیوندید             WHERE sbt.variable_name = 'Ssl_version' و t2.variable_name = 'Ssl_cipher'             سفارش توسط tls_version;

en-us	### Pre-requisites  Install the PostgreSQL database using the [official repository](https://www.postgresql.org/download/linux/redhat/).  PostgreSQL is not configured to accept TLS connections out-of-the-box. Please follow instructions from PostgreSQL documentation for [certificate preparation with postgresql.conf](https://www.postgresql.org/docs/13/ssl-tcp.html) and also for [user access control](https://www.postgresql.org/docs/13/auth-pg-hba-conf.html) through ph\_hba.conf.  By default, the PostgreSQL socket is binded to the localhost, for the network remote connections allow to listen on the real network interface.  PostgreSQL settings for all [modes](/manual/appendix/install/db_encrypt#terminology) can look like this:  **/var/lib/pgsql/13/data/postgresql.conf:**      ...     ssl = on     ssl_ca_file = 'root.crt'     ssl_cert_file = 'server.crt'     ssl_key_file = 'server.key'     ssl_ciphers = 'HIGH:MEDIUM:+3DES:!aNULL'     ssl_prefer_server_ciphers = on     ssl_min_protocol_version = 'TLSv1.3'     ...  For access control adjust */var/lib/pgsql/13/data/pg\_hba.conf*:      ...     ### require     hostssl all all 0.0.0.0/0 md5      ### verify CA     hostssl all all 0.0.0.0/0 md5 clientcert=verify-ca      ### verify full     hostssl all all 0.0.0.0/0 md5 clientcert=verify-full     ...
fa	### پیش نیازها  پایگاه داده PostgreSQL را با استفاده از [official مخزن] (https://www.postgresql.org/download/linux/redhat/).  PostgreSQL برای پذیرش اتصالات TLS خارج از جعبه پیکربندی نشده است. لطفاً دستورالعمل‌های مستندات PostgreSQL را دنبال کنید [تهیه گواهی با postgresql.conf](https://www.postgresql.org/docs/13/ssl-tcp.html) و همچنین برای [دسترسی کاربر کنترل](https://www.postgresql.org/docs/13/auth-pg-hba-conf.html) از طریق ph\_hba.conf.  به طور پیش فرض، سوکت PostgreSQL به لوکال هاست متصل است اتصالات راه دور شبکه امکان گوش دادن در شبکه واقعی را فراهم می کند رابط.  تنظیمات PostgreSQL برای همه [modes](/manual/appendix/install/db_encrypt#terminology) می تواند شبیه این:  **/var/lib/pgsql/13/data/postgresql.conf:**      ...     ssl = روشن     ssl_ca_file = 'root.crt'     ssl_cert_file = 'server.crt'     ssl_key_file = 'server.key'     ssl_ciphers = 'HIGH:MEDIUM:+3DES:!aNULL'     ssl_prefer_server_ciphers = روشن است     ssl_min_protocol_version = 'TLSv1.3'     ...  برای کنترل دسترسی، */var/lib/pgsql/13/data/pg\_hba.conf* را تنظیم کنید:      ...     ### نیاز     hostssl همه همه 0.0.0.0/0 md5      ### CA را تأیید کنید     hostssl همه 0.0.0.0/0 md5 clientcert=verify-ca      ### تایید کامل     hostssl همه همه 0.0.0.0/0 md5 clientcert=verify-full     ...

en-us	#### Problem events  A problem event is created:  -   when a trigger expression evaluates to TRUE if the trigger is in OK     state; -   each time a trigger expression evaluates to TRUE if multiple problem     event generation is enabled for the trigger.
fa	#### رویدادهای مشکل  یک رویداد مشکل ایجاد می شود:  - هنگامی که یک عبارت ماشه به TRUE ارزیابی می شود اگر ماشه در حالت OK باشد     حالت؛ - هر بار که یک عبارت ماشه در صورت وجود چندین مشکل به TRUE ارزیابی می شود     تولید رویداد برای ماشه فعال است.

en-us	# problem.get
fa	دریافت حذف قانون جست و جو 

en-us	##### Problem update window  If a problem arises for a trigger with the *Manual close* flag, you can open the [problem update](/manual/acknowledges#updating_problems) popup window of that problem and close the problem manually.  To close the problem, check the *Close problem* option in the form and click on *Update*.  ![](../../../../assets/en/manual/config/close_problem1.png)  All mandatory input fields are marked with a red asterisk.  The request is processed by Zabbix server. Normally it will take a few seconds to close the problem. During that process *CLOSING* is displayed in *Monitoring* → *Problems* as the status of the problem.
fa	##### پنجره به روز رسانی مشکل  اگر برای یک ماشه با پرچم *دستی بسته* مشکلی پیش آمد، می توانید باز کردن پنجره [به روز رسانی مشکل](/manual/acknowledges#updating_problems) پنجره آن مشکل را ببندید و مشکل را به صورت دستی ببندید.  برای بستن مشکل، گزینه *بستن مشکل* را در فرم و تیک بزنید روی *به روز رسانی* کلیک کنید.  ![](../../../../assets/en/manual/config/close_problem1.png)  تمام فیلدهای ورودی اجباری با یک ستاره قرمز مشخص شده اند.  درخواست توسط سرور Zabbix پردازش می شود. به طور معمول چند مورد طول می کشد چند ثانیه برای بستن مشکل در طی آن فرآیند *CLOSING* نمایش داده می شود در *مانیتورینگ* → *مشکلات* به عنوان وضعیت مشکل.

en-us	##### Process data  |Item key|<|<|<| |--|--|------|------| |Description|Return value|Parameters|Comments| |**proc.cpu.util**\[<name>,<user>,<type>,<cmdline>,<mode>,<zone>\]|<|<|<| |Process CPU utilization percentage.|Float|**name** - process name (default is *all processes*)<br>**user** - user name (default is *all users*)<br>**type** - CPU utilization type:<br>*total* (default), *user*, *system*<br>**cmdline** - filter by command line (it is a regular [expression](/manual/regular_expressions#overview))<br>**mode** - data gathering mode: *avg1* (default), *avg5*, *avg15*<br>**zone** - target zone: *current* (default), *all*. This parameter is supported on Solaris only.|Examples:<br>=> proc.cpu.util\[,root\] → CPU utilization of all processes running under the "root" user<br>=> proc.cpu.util\[zabbix\_server,zabbix\] → CPU utilization of all zabbix\_server processes running under the zabbix user<br><br>The returned value is based on single CPU core utilization percentage. For example CPU utilization of a process fully using two cores is 200%.<br><br>The process CPU utilization data is gathered by a collector which supports the maximum of 1024 unique (by name, user and command line) queries. Queries not accessed during the last 24 hours are removed from the collector.<br><br>*Note* that when setting the `zone` parameter to *current* (or default) in case the agent has been compiled on a Solaris without zone support, but running on a newer Solaris where zones are supported, then the agent will return NOTSUPPORTED (the agent cannot limit results to only the current zone). However, *all* is supported in this case.<br><br>This key is supported since Zabbix 3.0.0 and is available on several platforms (see [Items supported by platform](/manual/appendix/items/supported_by_platform)).| |**proc.mem**\[<name>,<user>,<mode>,<cmdline>,<memtype>\]|<|<|<| |Memory used by process in bytes.|Integer - with `mode` as *max*, *min*, *sum*<br><br>Float - with `mode` as *avg*|**name** - process name (default is *all processes*)<br>**user** - user name (default is *all users*)<br>**mode** - possible values:<br>*avg*, *max*, *min*, *sum* (default)<br>**cmdline** - filter by command line (it is a regular [expression](/manual/regular_expressions#overview))<br>**memtype** - [type of memory](/manual/appendix/items/proc_mem_notes) used by process|Examples:<br>=> proc.mem\[,root\] → memory used by all processes running under the "root" user<br>=> proc.mem\[zabbix\_server,zabbix\] → memory used by all zabbix\_server processes running under the zabbix user<br>=> proc.mem\[,oracle,max,oracleZABBIX\] → memory used by the most memory-hungry process running under oracle having oracleZABBIX in its command line<br><br>*Note*: When several processes use shared memory, the sum of memory used by processes may result in large, unrealistic values.<br><br>See [notes](/manual/appendix/items/proc_mem_num_notes) on selecting processes with `name` and `cmdline` parameters (Linux-specific).<br><br>When this item is invoked from the command line and contains a command line parameter (e.g. using the agent test mode: `zabbix_agentd -t proc.mem[,,,apache2]`), one extra process will be counted, as the agent will count itself.<br><br>The `memtype` parameter is supported on several [platforms](/manual/appendix/items/supported_by_platform) since Zabbix 3.0.0.| |**proc.num**\[<name>,<user>,<state>,<cmdline>,<zone>\]|<|<|<| |The number of processes.|Integer|**name** - process name (default is *all processes*)<br>**user** - user name (default is *all users*)<br>**state** (*disk* and *trace* options since version 3.4.0) - possible values:<br>*all* (default),<br>*disk* - uninterruptible sleep,<br>*run* - running,<br>*sleep* - interruptible sleep,<br>*trace* - stopped,<br>*zomb* - zombie<br>**cmdline** - filter by command line (it is a regular [expression](/manual/regular_expressions#overview))<br>**zone** - target zone: *current* (default), *all*. This parameter is supported on Solaris only.|Examples:<br>=> proc.num\[,mysql\] → number of processes running under the mysql user<br>=> proc.num\[apache2,www-data\] → number of apache2 processes running under the www-data user<br>=> proc.num\[,oracle,sleep,oracleZABBIX\] → number of processes in sleep state running under oracle having oracleZABBIX in its command line<br><br>See [notes](/manual/appendix/items/proc_mem_num_notes) on selecting processes with `name` and `cmdline` parameters (Linux-specific).<br><br>On Windows, only the `name` and `user` parameters are supported.<br><br>When this item is invoked from the command line and contains a command line parameter (e.g. using the agent test mode: `zabbix_agentd -t proc.num[,,,apache2]`), one extra process will be counted, as the agent will count itself.<br><br>*Note* that when setting the `zone` parameter to *current* (or default) in case the agent has been compiled on a Solaris without zone support, but running on a newer Solaris where zones are supported, then the agent will return NOTSUPPORTED (the agent cannot limit results to only the current zone). However, *all* is supported in this case.|
fa	##### پردازش داده ها  |کلید مورد|<|<|<| |--|--|------|------| |توضیحات|مقدار بازگشتی|پارامترها|نظرات| |**proc.cpu.util**\[<name>,<user>,<type>,<cmdline>,<mode>,<zone>\]|<|<|<| |درصد استفاده از CPU فرآیند.|Float|**نام** - نام فرآیند (پیش‌فرض *همه فرآیندها*)<br>**کاربر** - نام کاربری (پیش‌فرض *همه کاربران*) است<br>**نوع ** - نوع استفاده از CPU:<br>*total* (پیش‌فرض)، *user*، *system*<br>**cmdline** - فیلتر بر اساس خط فرمان (این یک [عبارت] معمولی است (/manual/regular_expressions #نمای کلی))<br>**حالت** - حالت جمع آوری داده: *avg1* (پیش‌فرض)، *avg5*، *avg15*<br>**منطقه** - منطقه هدف: *جریان* (پیش‌فرض)، *همه*. این پارامتر فقط در Solaris پشتیبانی می‌شود.|مثال:<br>=> proc.cpu.util\[,root\] → استفاده از CPU از تمام فرآیندهایی که تحت کاربر "root" اجرا می‌شوند<br>=> proc.cpu.util \[zabbix\_server,zabbix\] → استفاده از CPU از تمام فرآیندهای zabbix\_server که تحت کاربر zabbix در حال اجرا هستند<br><br>مقدار برگشتی بر اساس درصد استفاده از هسته واحد CPU است. به عنوان مثال، استفاده از CPU از یک فرآیند به طور کامل با استفاده از دو هسته 200٪ است.<br><br>داده‌های استفاده از CPU فرآیند توسط یک جمع‌آوری جمع‌آوری می‌شود که حداکثر 1024 پرس‌وجو منحصر به فرد (بر اساس نام، کاربر و خط فرمان) را پشتیبانی می‌کند. جستارهایی که در 24 ساعت گذشته به آنها دسترسی پیدا نکرده اند از جمع کننده حذف می شوند.<br><br>*توجه داشته باشید که هنگام تنظیم پارامتر "zone" بر روی *current* (یا پیش فرض) در صورتی که عامل در سولاریس بدون کامپایل شده باشد. پشتیبانی از ناحیه، اما در یک سولاریس جدیدتر که مناطق پشتیبانی می‌شوند، اجرا می‌شود، سپس عامل NOTSUPPORTED برمی‌گردد (عامل نمی‌تواند نتایج را فقط به منطقه فعلی محدود کند). با این حال، *all* در این مورد پشتیبانی می‌شود.<br><br>این کلید از زمان Zabbix 3.0.0 پشتیبانی می‌شود و در چندین پلتفرم در دسترس است (به [موارد پشتیبانی شده توسط پلتفرم] مراجعه کنید (/manual/appendix/items/supported_by_platform) ).| |**proc.mem**\[<name>,<user>,<mode>,<cmdline>,<memtype>\]|<|<|<| |حافظه استفاده شده توسط پردازش در بایت.|عدد صحیح - با "حالت" به عنوان *max*، *min*، *sum*<br><br>Float - با "mode" به عنوان *avg*|**name** - نام فرآیند (پیش‌فرض *همه فرآیندها* است)<br>**user** - نام کاربری (پیش‌فرض *همه کاربران*)<br>**حالت** - مقادیر ممکن:<br>*avg*, *max *، *دقیقه*، *جمع* (پیش‌فرض)<br>**cmdline** - فیلتر بر اساس خط فرمان (این یک [عبارت] معمولی است(/manual/regular_expressions#overview))<br>**memtype** - [نوع حافظه](/manual/appendix/items/proc_mem_notes) مورد استفاده فرآیند|مثال‌ها:<br>=> proc.mem\[,root\] → حافظه مورد استفاده همه پردازش‌هایی که تحت کاربر "root" اجرا می‌شوند< br>=> proc.mem\[zabbix\_server,zabbix\] → حافظه مورد استفاده همه پردازشهای zabbix\_server که تحت کاربر zabbix اجرا می شوند<br>=> proc.mem\[,oracle,max,oracleZABBIX\] → حافظه مورد استفاده توسط پرحافظه‌ترین فرآیندی که تحت اوراکل اجرا می‌شود و دارای oracleZABBIX در خط فرمان آن است<br><br>*نکته*: وقتی چندین فرآیند از حافظه مشترک استفاده می‌کنند، مجموع حافظه استفاده شده توسط فرآیندها ممکن است به مقادیر بزرگ و غیر واقعی منجر شود.< br><br>به [notes](/manual/appendix/items/proc_mem_num_notes) برای انتخاب فرآیندهایی با پارامترهای «name» و «cmdline» (مخصوص لینوکس) مراجعه کنید.<br><br>وقتی این مورد از خط فرمان و شامل یک پارامتر خط فرمان (به عنوان مثال با استفاده از حالت آزمایش عامل: `zabbix_agentd -t proc.mem[,,,apache2]`، یک فرآیند اضافی شمارش می‌شود، زیرا عامل خودش را محاسبه می‌کند.<br><br>پارامتر «memtype» در چندین [پلتفرم](/دستی/ضمیمه/item/supported_by_platform) از Zabbix 3.0.0.| |**proc.num**\[<name>,<user>,<state>,<cmdline>,<zone>\]|<|<|<| |تعداد فرآیندها.|عدد صحیح|**نام** - نام فرآیند (پیش‌فرض *همه فرآیندها*) <br>**کاربر** - نام کاربری (پیش‌فرض *همه کاربران* است)<br>**وضعیت ** (گزینه‌های *disk* و *trace* از نسخه 3.4.0) - مقادیر ممکن:<br>*all* (پیش‌فرض)،<br>*disk* - خواب بدون وقفه،<br>*run* - در حال اجرا، <br>*sleep* - خواب قابل وقفه،<br>*trace* - متوقف شده،<br>*zomb* - zombie<br>**cmdline** - فیلتر بر اساس خط فرمان (این یک [عبارت] معمولی است)(/ manual/regular_expressions#overview))<br>**zone** - منطقه هدف: *current* (پیش فرض)، *all*. این پارامتر فقط در Solaris پشتیبانی می‌شود.|مثال:<br>=> proc.num\[,mysql\] → تعداد فرآیندهایی که تحت کاربر mysql اجرا می‌شوند<br>=> proc.num\[apache2,www-data\ ] ← تعداد فرآیندهای apache2 که تحت کاربر www-data اجرا می‌شوند<br>=> proc.num\[,oracle,sleep,oracleZABBIX\] → تعداد پردازش‌هایی که در حالت خواب تحت اوراکل اجرا می‌شوند دارای oracleZABBIX در خط فرمان آن هستند<br> <br>به [notes](/manual/appendix/items/proc_mem_num_notes) برای انتخاب فرآیندهایی با پارامترهای «name» و «cmdline» (مخصوص لینوکس) مراجعه کنید.<br><br>در ویندوز، فقط «نام» و پارامترهای «کاربر» پشتیبانی می‌شوند.<br><br>وقتی این مورد از خط فرمان فراخوانی می‌شود و حاوی یک پارامتر خط فرمان است (مثلاً با استفاده از حالت آزمایش عامل: «zabbix_agentd -t proc.num[,,,apache2]». )، یک فرآیند اضافی شمارش می‌شود، زیرا عامل خودش را محاسبه می‌کند.<br><br>*توجه داشته باشید* که هنگام تنظیم پارامتر "zone" روی *current* (یا پیش‌فرض) در صورتی که عامل در یک کامپایل شده باشد. سولاریس بدون پشتیبانی از ناحیه، اما روی یک سولاریس جدیدتر اجرا می‌شود که در آن زون‌ها پشتیبانی می‌شوند، سپس عامل NOTSUPPORTED برمی‌گردد (عامل نمی‌تواند نتایج را فقط به منطقه فعلی محدود کند). با این حال، *all* در این مورد پشتیبانی می شود.|

en-us	#### Process user  Zabbix agent on UNIX is designed to run as a non-root user. It will run as whatever non-root user it is started as. So you can run agent as any non-root user without any issues.  If you will try to run it as 'root', it will switch to a hardcoded 'zabbix' user, which must be present on your system. You can only run agent as 'root' if you modify the 'AllowRoot' parameter in the agent configuration file accordingly.
fa	#### کاربر پردازش  عامل Zabbix در یونیکس برای اجرا به عنوان یک کاربر غیر ریشه طراحی شده است. اجرا خواهد شد به عنوان هر کاربر غیر ریشه ای به عنوان شروع می شود. بنابراین شما می توانید عامل را به عنوان هر عاملی اجرا کنید کاربر غیر روت بدون هیچ مشکلی.  اگر سعی کنید آن را به عنوان "ریشه" اجرا کنید، به یک کد سخت تبدیل می شود کاربر 'zabbix'، که باید در سیستم شما وجود داشته باشد. شما فقط می توانید بدوید اگر پارامتر "AllowRoot" را در عامل تغییر دهید، عامل به عنوان "ریشه" است فایل پیکربندی بر این اساس

en-us	##### Process user  Zabbix proxy is designed to run as a non-root user. It will run as whatever non-root user it is started as. So you can run proxy as any non-root user without any issues.  If you will try to run it as 'root', it will switch to a hardcoded 'zabbix' user, which must be present on your system. You can only run proxy as 'root' if you modify the 'AllowRoot' parameter in the proxy configuration file accordingly.
fa	#### کاربر پردازش  عامل Zabbix در یونیکس برای اجرا به عنوان یک کاربر غیر ریشه طراحی شده است. اجرا خواهد شد به عنوان هر کاربر غیر ریشه ای به عنوان شروع می شود. بنابراین شما می توانید عامل را به عنوان هر عاملی اجرا کنید کاربر غیر روت بدون هیچ مشکلی.  اگر سعی کنید آن را به عنوان "ریشه" اجرا کنید، به یک کد سخت تبدیل می شود کاربر 'zabbix'، که باید در سیستم شما وجود داشته باشد. شما فقط می توانید بدوید اگر پارامتر "AllowRoot" را در عامل تغییر دهید، عامل به عنوان "ریشه" است فایل پیکربندی بر این اساس

en-us	##### Process user  Zabbix server is designed to run as a non-root user. It will run as whatever non-root user it is started as. So you can run server as any non-root user without any issues.  If you will try to run it as 'root', it will switch to a hardcoded 'zabbix' user, which must be [present](/manual/installation/install) on your system. You can only run server as 'root' if you modify the 'AllowRoot' parameter in the server configuration file accordingly.  If Zabbix server and [agent](agent) are run on the same machine it is recommended to use a different user for running the server than for running the agent. Otherwise, if both are run as the same user, the agent can access the server configuration file and any Admin level user in Zabbix can quite easily retrieve, for example, the database password.
fa	##### کاربر پردازش  سرور Zabbix برای اجرا به عنوان یک کاربر غیر ریشه طراحی شده است. به صورت اجرا خواهد شد هر کاربر غیر ریشه ای به عنوان شروع می شود. بنابراین شما می توانید سرور را به عنوان هر سرور اجرا کنید کاربر غیر روت بدون هیچ مشکلی  اگر سعی کنید آن را به عنوان "ریشه" اجرا کنید، به یک کد سخت تبدیل می شود کاربر 'zabbix'، که باید [present](/manual/installation/install) در سیستم شما فقط در صورتی می توانید سرور را به عنوان "ریشه" اجرا کنید که آن را تغییر دهید پارامتر "AllowRoot" در فایل پیکربندی سرور بر این اساس.  اگر سرور Zabbix و [agent](agent) روی یک دستگاه اجرا شوند، همان‌طور است توصیه می شود برای اجرای سرور از یک کاربر متفاوت از کاربر استفاده کنید عامل را اجرا می کند در غیر این صورت، اگر هر دو به عنوان یک کاربر اجرا شوند، عامل می تواند به فایل پیکربندی سرور و هر کاربر سطح مدیریت دسترسی داشته باشد در Zabbix می تواند به راحتی، به عنوان مثال، رمز عبور پایگاه داده را بازیابی کند.

en-us	#### Property labels  Some of the objects properties are marked with short labels to describe their behavior. The following labels are used:  -   *readonly* - the value of the property is set automatically and     cannot be defined or changed by the client; -   *constant* - the value of the property can be set when creating an     object, but cannot be changed after.
fa	#### برچسب های اموال  برخی از ویژگی های اشیا با برچسب های کوتاه برای توصیف مشخص شده اند رفتار آنها. از برچسب های زیر استفاده می شود:  - *readonly* - مقدار ویژگی به صورت خودکار تنظیم می شود و     توسط مشتری قابل تعریف یا تغییر نیست. - *constant* - مقدار ویژگی را می توان هنگام ایجاد یک شیء تنظیم کرد    اما پس از آن قابل تغییر نیست.

en-us	| Property                       | [Type](/manual/api/reference_commentary#data_types) | Description                                                                           | |--------------------------------|-----------------------------------------------------|---------------------------------------------------------------------------------------| | **name**<br>(required)         | string                                              | Name of the excluded downtime.                                                        | | **period\_from**<br>(required) | integer                                             | Starting time of the excluded downtime (inclusive).<br><br>Possible values: timestamp. | | **period\_to**<br>(required)   | integer                                             | Ending time of the excluded downtime (exclusive).<br><br>Possible values: timestamp.  |
fa	| اموال | [Type](/manual/api/reference_commentary#data_types) | توضیحات | |------------------------------------------------ --------------------------------------------------- ------------------------------------------------ ------------------------------------------------ ---------------------| | **دوره\_از**<br>(الزامی) | عدد صحیح | زمان شروع دوره زمانی هفتگی مکرر (شامل).<br><br>مقادیر ممکن: تعداد ثانیه (شمارش از یکشنبه). | | **دوره\_تا**<br>(الزامی) | عدد صحیح | زمان پایان دوره زمانی هفتگی مکرر (انحصاری).<br><br>مقادیر ممکن: تعداد ثانیه ها (از یکشنبه شمارش می شود). |

en-us	| Property                       | [Type](/manual/api/reference_commentary#data_types) | Description                                                                                                                         | |--------------------------------|-----------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------| | **period\_from**<br>(required) | integer                                             | Starting time of the recurrent weekly period of time (inclusive).<br><br>Possible values: number of seconds (counting from Sunday). | | **period\_to**<br>(required)   | integer                                             | Ending time of the recurrent weekly period of time (exclusive).<br><br>Possible values: number of seconds (counting from Sunday).   |
fa	| اموال | [Type](/manual/api/reference_commentary#data_types) | توضیحات | |------------------------------------------------ --------------------------------------------------- ------------------------------------------------ ------------------------------------------------ ---------------------| | **دوره\_از**<br>(الزامی) | عدد صحیح | زمان شروع دوره زمانی هفتگی مکرر (شامل).<br><br>مقادیر ممکن: تعداد ثانیه (شمارش از یکشنبه). | | **دوره\_تا**<br>(الزامی) | عدد صحیح | زمان پایان دوره زمانی هفتگی مکرر (انحصاری).<br><br>مقادیر ممکن: تعداد ثانیه ها (از یکشنبه شمارش می شود). |