[comment]: # translation:outdated [comment]: # ({2485e0f7-2485e0f7}) # user.get [comment]: # ({/2485e0f7-2485e0f7}) [comment]: # ({36f89e39-36f89e39}) ### Opis `integer/array user.get(object parameters)` Metoda umożliwia pobranie użytkowników zgodnie z podanymi parametrami. ::: noteclassic Ta metoda jest dostępna dla użytkowników dowolnego typu. Uprawnienia do jej wywołania mogą zostać cofnięte w ustawieniach ról użytkownika. Zobacz [Role użytkowników](/manual/web_interface/frontend_sections/administration/user_roles) , aby uzyskać więcej informacji. ::: [comment]: # ({/36f89e39-36f89e39}) [comment]: # ({c8d70767-888512e9}) ### Parametry `(object)` Parametry definiujące żądany wynik. Metoda obsługuje następujące parametry. |Parametr|[Typ](/manual/api/reference_commentary#data_types)|Opis| |--|--|------| |mediaids|string/array|Zwraca tylko użytkowników korzystających z podanych mediów.| |mediatypeids|string/array|Zwraca tylko użytkowników korzystających z podanych typów mediów.| |userids|string/array|Zwraca tylko użytkowników o podanych identyfikatorach.| |usrgrpids|string/array|Zwraca tylko użytkowników należących do podanych grup użytkowników.| |getAccess|flag|Dodaje dodatkowe informacje na temat uprawnień użytkownika.

Dodaje następujące właściwości dla każdego użytkownika:
`gui_access` - *(integer)* metoda uwierzytelniania interfejsu użytkownika. Sprawdź właściwość `gui_access` obiektu [grupa użytkowników](/manual/api/reference/usergroup/object#user_group) aby uzyskać listę możliwych wartości.
`debug_mode` - *(integer)* wskazuje, czy debugowanie jest włączone dla użytkownika. Możliwe wartości: 0 - debugowanie wyłączone, 1 - debugowanie włączone.
`users_status` - *(integer)* wskazuje, czy użytkownik jest wyłączony. Możliwe wartości: 0 - użytkownik włączony, 1 - użytkownik wyłączony.| |selectMedias|query|Zwraca media używane przez użytkownika w właściwości [medias](/manual/api/reference/user/object#media).| |selectMediatypes|query|Zwraca typy mediów używane przez użytkownika w właściwości [mediatypes](/manual/api/reference/mediatype/object).| |selectUsrgrps|query|Zwraca grupy użytkowników, do których należy użytkownik, w właściwości [usrgrps](/manual/api/reference/usergroup/object).| |selectRole|query|Zwraca rolę użytkownika w właściwości [role](/manual/api/reference/role/object#role).| |sortfield|string/array|Sortuje wynik według podanych właściwości.

Możliwe wartości to: `userid` i `username`.| |countOutput|boolean|Te parametry, które są wspólne dla wszystkich metod `get`, są opisane szczegółowo 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|^| [comment]: # ({/c8d70767-888512e9}) [comment]: # ({7223bab1-7223bab1}) ### Zwracane wartości `(integer/array)` Zwraca jedną z opcji: - tablicę obiektów; - liczbę pobranych obiektów, jeśli parametr `countOutput` został wykorzystany. [comment]: # ({/7223bab1-7223bab1}) [comment]: # ({b41637d2-b41637d2}) ### Przykłady [comment]: # ({/b41637d2-b41637d2}) [comment]: # ({bf3b0e50-7b5c610b}) #### Pobieranie użytkowników Pobierz wszystkich skonfigurowanych użytkowników. Zapytanie: ```json { "jsonrpc": "2.0", "method": "user.get", "params": { "output": "extend" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Odpowiedź: ```json { "jsonrpc": "2.0", "result": [ { "userid": "1", "username": "Admin", "name": "Zabbix", "surname": "Administrator", "url": "", "autologin": "1", "autologout": "0", "lang": "en_GB", "refresh": "0s", "theme": "default", "attempt_failed": "0", "attempt_ip": "", "attempt_clock": "0", "rows_per_page": "50", "timezone": "default", "roleid": "3" }, { "userid": "2", "username": "guest", "name": "", "surname": "", "url": "", "autologin": "0", "autologout": "15m", "lang": "default", "refresh": "30s", "theme": "default", "attempt_failed": "0", "attempt_ip": "", "attempt_clock": "0", "rows_per_page": "50", "timezone": "default", "roleid": "4" }, { "userid": "3", "username": "user", "name": "Zabbix", "surname": "User", "url": "", "autologin": "0", "autologout": "0", "lang": "ru_RU", "refresh": "15s", "theme": "dark-theme", "attempt_failed": "0", "attempt_ip": "", "attempt_clock": "0", "rows_per_page": "100", "timezone": "default", "roleid": "1" } ], "id": 1 } ``` [comment]: # ({/bf3b0e50-7b5c610b}) [comment]: # ({new-746d14f7}) #### Retrieving users as *Admin* As an *Admin* type user, retrieve detailed data about your own user and limited data for users in your user group. Request: ```json { "jsonrpc": "2.0", "method": "user.get", "params": { "output": "extend", "getAccess": true, "selectMedias": "extend", "selectMediatypes": "extend", "selectUsrgrps": "extend", "selectRole": "extend" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "userid": "1", "username": "Admin", "name": "Zabbix", "surname": "Administrator", "usrgrps": [ { "usrgrpid": "7", "name": "Zabbix administrators", "gui_access": "0", "users_status": "0", "debug_mode": "0" } ] }, { "userid": "3", "username": "database-admin", "name": "John", "surname": "Doe", "url": "", "autologin": "0", "autologout": "0", "lang": "default", "refresh": "30s", "theme": "default", "attempt_failed": "0", "attempt_ip": "", "attempt_clock": "0", "rows_per_page": "50", "timezone": "default", "roleid": "2", "gui_access": "0", "debug_mode": "0", "users_status": "0", "usrgrps": [ { "usrgrpid": "7", "name": "Zabbix administrators", "gui_access": "0", "users_status": "0", "debug_mode": "0" } ], "medias": [ { "mediaid": "2", "userid": "3", "mediatypeid": "1", "sendto": [ "john.doe@example.com" ], "active": "0", "severity": "63", "period": "1-7,00:00-24:00" } ], "mediatypes": [ { "mediatypeid": "1", "type": "0", "name": "Email", "status": "0", "description": "", "maxattempts": "3" } ], "role": { "roleid": "2", "name": "Admin role", "type": "2", "readonly": "0" } } ], "id": 1 } ``` [comment]: # ({/new-746d14f7}) [comment]: # ({b2b58125-d85f9654}) #### Pobieranie danych użytkownika Pobierz dane użytkownika o identyfikatorze "12". Zapytanie: ```json { "jsonrpc": "2.0", "method": "user.get", "params": { "output": ["userid", "username"], "selectRole": "extend", "userids": "12" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Odpowiedź: ``` {.java} { "jsonrpc": "2.0", "result": [ { "userid": "12", "username": "John", "role": { "roleid": "5", "name": "Operator", "type": "1", "readonly": "0" } } ], "id": 1 } ``` [comment]: # ({/b2b58125-d85f9654}) [comment]: # ({8d892781-8d892781}) ### Zobacz także - [Media](/manual/api/reference/user/object#media) - [Typy mediów](/manual/api/reference/mediatype/object#media_type) - [Grupa użytkowników](/manual/api/reference/usergroup/object#user_group) - [Rola](/manual/api/reference/role/object#role) [comment]: # ({/8d892781-8d892781}) [comment]: # ({842f2a42-842f2a42}) ### Źródło CUser::get() w *ui/include/classes/api/services/CUser.php*. [comment]: # ({/842f2a42-842f2a42})