[comment]: # translation:outdated

[comment]: # ({f8d4c2e5-f8d4c2e5})
# hostgroup.get

[comment]: # ({/f8d4c2e5-f8d4c2e5})

[comment]: # ({20294517-08ff22f2})
### Opis

`integer/array hostgroup.get(object parameters)`

Ta metoda umożliwia pobieranie grup hostów zgodnie z podanymi parametrami.

::: noteclassic
Ta metoda jest dostępna dla użytkowników dowolnego typu.
Uprawnienia do wywołania tej metody mogą zostać cofnięte w ustawieniach roli użytkownika.
Więcej informacji można znaleźć w sekcji [Role użytkowników](/manual/web_interface/frontend_sections/users/user_roles).
:::

[comment]: # ({/20294517-08ff22f2})

[comment]: # ({5291ff51-7f042696})
### Parametry

`(object)` Parametry definiujące żądane dane wyjściowe.

Metoda obsługuje następujące parametry.

|Parametr|[Typ](/manual/api/reference_commentary#data-types)|Opis|
|--|--|------|
|graphids|ID/array|Zwraca tylko grupy hostów zawierające hosty z podanymi wykresami.|
|groupids|ID/array|Zwraca tylko grupy hostów o podanych identyfikatorach grup hostów.|
|hostids|ID/array|Zwraca tylko grupy hostów zawierające podane hosty.|
|maintenanceids|ID/array|Zwraca tylko grupy hostów, na które wpływają podane okresy konserwacji.|
|triggerids|ID/array|Zwraca tylko grupy hostów zawierające hosty z podanymi wyzwalaczami.|
|with\_graphs|boolean|Zwraca tylko grupy hostów zawierające hosty z wykresami.|
|with\_graph\_prototypes|boolean|Zwraca tylko grupy hostów zawierające hosty z prototypami wykresów.|
|with\_hosts|boolean|Zwraca tylko grupy hostów zawierające hosty.|
|with\_httptests|boolean|Zwraca tylko grupy hostów zawierające hosty z testami WWW.<br><br>Nadpisuje parametr `with_monitored_httptests`.|
|with\_items|boolean|Zwraca tylko grupy hostów zawierające hosty z pozycjami.<br><br>Nadpisuje parametry `with_monitored_items` i `with_simple_graph_items`.|
|with\_item\_prototypes|boolean|Zwraca tylko grupy hostów zawierające hosty z prototypami pozycji.<br><br>Nadpisuje parametr `with_simple_graph_item_prototypes`.|
|with\_simple\_graph\_item\_prototypes|boolean|Zwraca tylko grupy hostów zawierające hosty z prototypami pozycji, które są włączone do tworzenia i mają numeryczny typ informacji.|
|with\_monitored\_httptests|boolean|Zwraca tylko grupy hostów zawierające hosty z włączonymi testami WWW.|
|with\_monitored\_hosts|boolean|Zwraca tylko grupy hostów zawierające monitorowane hosty.|
|with\_monitored\_items|boolean|Zwraca tylko grupy hostów zawierające hosty z włączonymi pozycjami.<br><br>Nadpisuje parametr `with_simple_graph_items`.|
|with\_monitored\_triggers|boolean|Zwraca tylko grupy hostów zawierające hosty z włączonymi wyzwalaczami. Wszystkie pozycje używane w wyzwalaczu również muszą być włączone.|
|with\_simple\_graph\_items|boolean|Zwraca tylko grupy hostów zawierające hosty z numerycznymi pozycjami.|
|with\_triggers|boolean|Zwraca tylko grupy hostów zawierające hosty z wyzwalaczami.<br><br>Nadpisuje parametr `with_monitored_triggers`.|
|selectDiscoveryRules|query|Zwraca właściwość [`discoveryRules`](/manual/api/reference/discoveryrule/object) z regułami LLD, które wykryły grupę hostów.|
|selectDiscoveryData|query|Zwraca właściwość `discoveryData` z obiektami wykrywania grup hostów.<br><br>Każdy obiekt wykrywania grupy hostów jest prototypem grupy hostów powiązanym z wykrytą grupą hostów i ma następujące właściwości:<br>`parent_group_prototypeid` - `(ID)` identyfikator prototypu grupy hostów, z którego wykryto grupę hostów;<br>`name` - `(string)` nazwa prototypu grupy hostów;<br>`ts_delete` - `(timestamp)` czas, po którym grupa hostów, która nie jest już wykrywana, zostanie usunięta;<br>`status` - `(int)` status wykrywania grupy hostów:<br>0 - *(domyślnie)* grupa hostów jest wykryta,<br>1 - grupa hostów nie jest już wykrywana.|
|selectHostPrototypes|query|Zwraca właściwość [`hostPrototypes`](/manual/api/reference/hostprototypes/object) z prototypami hostów, które wykryły tę grupę hostów.|
|selectHosts|query|Zwraca właściwość [`hosts`](/manual/api/reference/host/object) z hostami należącymi do grupy hostów.<br><br>Obsługuje `count`.|
|limitSelects|integer|Ogranicza liczbę rekordów zwracanych przez podzapytania.<br><br>Dotyczy następujących podzapytań:<br>`selectHosts` - wyniki będą sortowane według `host`.|
|sortfield|string/array|Sortuje wynik według podanych właściwości.<br><br>Możliwe wartości: `groupid`, `name`.|
|countOutput|boolean|Te parametry opisano w [komentarzu referencyjnym](/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|^|
|selectGroupDiscoveries|query|Zwraca właściwość `groupDiscoveries` z obiektami wykrywania grup hostów.<br><br>Każdy obiekt wykrywania grupy hostów jest prototypem grupy hostów powiązanym z wykrytą grupą hostów.<br><br>To zapytanie jest **przestarzałe**; zamiast niego użyj `selectDiscoveryData`.|

[comment]: # ({/5291ff51-7f042696})

[comment]: # ({07ca11ca-7223bab1})
### Zwracane wartości

`(integer/array)` Zwraca:

-   tablicę obiektów
-   liczbę pobranych obiektów, jeśli użyto parametru `countOutput`

[comment]: # ({/07ca11ca-7223bab1})

[comment]: # ({b41637d2-b41637d2})
### Przykłady

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({6271b06c-8ed2756a})
#### Pobieranie danych według nazwy

Pobierz wszystkie dane o dwóch grupach hostów o nazwach „Zabbix servers” i „Linux servers”.

[Żądanie](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "hostgroup.get",
    "params": {
        "output": "extend",
        "filter": {
            "name": [
                "Zabbix servers",
                "Linux servers"
            ]
        }
    },
    "id": 1
}
```

Odpowiedź:

```json
{
    "jsonrpc": "2.0",
    "result": [
        {
            "groupid": "2",
            "name": "Linux servers",
            "flags": "0",
            "uuid": "dc579cd7a1a34222933f24f52a68bcd8"
        },
        {
            "groupid": "4",
            "name": "Zabbix servers",
            "flags": "0",
            "uuid": "6f6799aa69e844b4b3918f779f2abf08"
        }
    ],
    "id": 1
}
```

[comment]: # ({/6271b06c-8ed2756a})

[comment]: # ({6a994b89-e5f0abe1})
### Zobacz także

-   [Host](/manual/api/reference/host/object#host)

[comment]: # ({/6a994b89-e5f0abe1})

[comment]: # ({1e72ea39-1e72ea39})
### Źródło

CHostGroup::get() w *ui/include/classes/api/services/CHostGroup.php*.

[comment]: # ({/1e72ea39-1e72ea39})