[comment]: # translation:outdated [comment]: # ({2587902b-2587902b}) # service.get [comment]: # ({/2587902b-2587902b}) [comment]: # ({8223dd96-bfd5de7f}) ### Beschreibung `integer/array service.get(object parameters)` Diese Methode ermöglicht es, Services entsprechend den angegebenen Parametern abzurufen. ::: noteclassic Diese Methode ist für Benutzer aller Typen verfügbar. Berechtigungen zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle entzogen werden. Weitere Informationen finden Sie unter [Benutzerrollen](/manual/web_interface/frontend_sections/users/user_roles). ::: [comment]: # ({/8223dd96-bfd5de7f}) [comment]: # ({916c982e-e7637a1d}) ### Parameter `(object)` Parameter, die die gewünschte Ausgabe definieren. Die Methode unterstützt die folgenden Parameter. |Parameter|[Type](/manual/api/reference_commentary#data-types)|Beschreibung| |--|--|------| |serviceids|ID/array|Gibt nur Services mit den angegebenen IDs zurück.| |parentids|ID/array|Gibt nur Services zurück, die mit den angegebenen übergeordneten Services verknüpft sind.| |deep\_parentids|flag|Gibt alle direkten und indirekten untergeordneten Services zurück. Wird zusammen mit `parentids` verwendet.| |childids|ID/array|Gibt nur Services zurück, die mit den angegebenen untergeordneten Services verknüpft sind.| |evaltype|integer|Tag-[Auswertungsmethode](/manual/web_interface/frontend_sections/services/service#using-filter).

Mögliche Werte:
0 - *(Standard)* Und/Oder;
2 - Oder.| |tags|object/array|Gibt nur Services mit den angegebenen Tags zurück.
Format: `[{"tag": "", "value": "", "operator": ""}, ...]`.
Ein leeres Array gibt alle Services zurück.

Mögliche Werte für [operator](/manual/web_interface/frontend_sections/services/service#using-filter):
0 - *(Standard)* Enthält;
1 - Entspricht;
2 - Enthält nicht;
3 - Entspricht nicht;
4 - Existiert;
5 - Existiert nicht.| |problem\_tags|object/array|Gibt nur Services mit den angegebenen Problem-Tags zurück.
Format: `[{"tag": "", "value": "", "operator": ""}, ...]`.
Ein leeres Array gibt alle Services zurück.

Mögliche Werte für [operator](/manual/web_interface/frontend_sections/services/service#using-filter):
0 - *(Standard)* Enthält;
1 - Entspricht;
2 - Enthält nicht;
3 - Entspricht nicht;
4 - Existiert;
5 - Existiert nicht.| |without\_problem\_tags|flag|Gibt nur Services ohne Problem-Tags zurück.| |slaids|ID/array|Gibt nur Services zurück, die mit den angegebenen SLA(s) verknüpft sind.| |selectChildren|query|Gibt eine `children`-Eigenschaft mit den [untergeordneten Services](/manual/it_services/service_tree) zurück.

Unterstützt `count`.| |selectParents|query|Gibt eine `parents`-Eigenschaft mit den [übergeordneten Services](/manual/it_services/service_tree) zurück.

Unterstützt `count`.| |selectTags|query|Gibt eine [`tags`](/manual/api/reference/service/object#service-tag)-Eigenschaft mit Service-Tags zurück.

Unterstützt `count`.| |selectProblemEvents|query|Gibt eine `problem_events`-Eigenschaft mit einem Array von Problem-Event-Objekten zurück.

Das Problem-Event-Objekt hat die folgenden Eigenschaften:
`eventid` - `(ID)` Event-ID;
`severity` - `(string)` Aktueller Event-Schweregrad;
`name` - `(string)` Name des gelösten Events.

Unterstützt `count`.| |selectProblemTags|query|Gibt eine [`problem_tags`](/manual/api/reference/service/object#problem-tag)-Eigenschaft mit Problem-Tags zurück.

Unterstützt `count`.| |selectStatusRules|query|Gibt eine [`status_rules`](/manual/api/reference/service/object#status-rule)-Eigenschaft mit Statusregeln zurück.

Unterstützt `count`.| |selectStatusTimeline|object/array|Gibt eine `status_timeline`-Eigenschaft zurück, die Statusänderungen des Service für die angegebenen Zeiträume enthält.

Format `[{"period_from": "", "period_to": ""}, ...]` - wobei `period_from` ein Startdatum (einschließlich; Integer-Zeitstempel) und `period_to` ein Enddatum (ausschließlich; Integer-Zeitstempel) des gewünschten Zeitraums ist.

Gibt ein Array von Einträgen zurück, das eine `start_value`-Eigenschaft und ein [`alarms`](/manual/api/reference/service/object#service-alarm)-Array für die Statusänderungen innerhalb der angegebenen Zeiträume enthält.| |sortfield|string/array|Sortiert das Ergebnis nach den angegebenen Eigenschaften.

Mögliche Werte: `serviceid`, `name`, `status`, `sortorder`, `created_at`.| |countOutput|boolean|Diese Parameter sind in der [Referenzbeschreibung](/manual/api/reference_commentary#common-get-method-parameters) beschrieben.| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^| [comment]: # ({/916c982e-e7637a1d}) [comment]: # ({7223bab1-7223bab1}) ### Rückgabewerte `(integer/array)` Gibt entweder Folgendes zurück: - ein Array von Objekten; - die Anzahl der abgerufenen Objekte, wenn der Parameter `countOutput` verwendet wurde. [comment]: # ({/7223bab1-7223bab1}) [comment]: # ({b41637d2-b41637d2}) ### Beispiele [comment]: # ({/b41637d2-b41637d2}) [comment]: # ({61781c0a-cd4e4011}) #### Abrufen aller Services Rufen Sie alle Daten zu allen Services und ihren Abhängigkeiten ab. [Anfrage](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "service.get", "params": { "output": "extend", "selectChildren": "extend", "selectParents": ["serviceid", "name"] }, "id": 1 } ``` Antwort: ```json { "jsonrpc": "2.0", "result": [ { "serviceid": "1", "name": "Zabbix cluster", "status": "-1", "algorithm": "2", "sortorder": "0", "weight": "0", "propagation_rule": "0", "propagation_value": "0", "description": "", "uuid": "8d77bd91b62347e4b79382912eb5df95", "created_at": "1761742392", "readonly": false, "parents": [], "children": [ { "serviceid": "2", "name": "Zabbix server node 1", "status": "-1", "algorithm": "2", "sortorder": "0", "weight": "0", "propagation_rule": "0", "propagation_value": "0", "description": "", "uuid": "195911d26d7f4e218d6217079bcd5929", "created_at": "1761742623", "readonly": false }, { "serviceid": "3", "name": "Zabbix server node 2", "status": "-1", "algorithm": "2", "sortorder": "0", "weight": "0", "propagation_rule": "0", "propagation_value": "0", "description": "", "uuid": "9fc659a30fe244f690dff25fc2a9db5c", "created_at": "1761742654", "readonly": false } ] }, { "serviceid": "2", "name": "Zabbix server node 1", "status": "-1", "algorithm": "2", "sortorder": "0", "weight": "0", "propagation_rule": "0", "propagation_value": "0", "description": "", "uuid": "195911d26d7f4e218d6217079bcd5929", "created_at": "1761742623", "readonly": false, "parents": [ { "serviceid": "1", "name": "Zabbix cluster" } ], "children": [] }, { "serviceid": "3", "name": "Zabbix server node 2", "status": "-1", "algorithm": "2", "sortorder": "0", "weight": "0", "propagation_rule": "0", "propagation_value": "0", "description": "", "uuid": "9fc659a30fe244f690dff25fc2a9db5c", "created_at": "1761742654", "readonly": false, "parents": [ { "serviceid": "1", "name": "Zabbix cluster" } ], "children": [] } ], "id": 1 } ``` [comment]: # ({/61781c0a-cd4e4011}) [comment]: # ({05e3cf18-05e3cf18}) ### Quelle CService::get() in *ui/include/classes/api/services/CService.php*. [comment]: # ({/05e3cf18-05e3cf18})