Obiekt użytkownika

Następujące obiekty są bezpośrednio powiązane z API user.

User

Obiekt user ma następujące właściwości.

Property Type Description
userid ID ID użytkownika.

Zachowanie właściwości:
- tylko do odczytu
- wymagane dla operacji aktualizacji
username string Nazwa użytkownika.

Zachowanie właściwości:
- wymagane dla operacji tworzenia
- tylko do odczytu dla użytkowników aprowizowanych, jeśli użytkownik jest powiązany z katalogiem użytkowników (userdirectoryid ma ustawioną prawidłową wartość inną niż "0"), a stan aprowizacji katalogu użytkowników jest włączony (provision_status obiektu User directory object ma wartość "1"), oraz stan uwierzytelniania dla całej aprowizacji LDAP lub SAML jest włączony (ldap_jit_status obiektu Authentication object ma wartość "Enabled for configured LDAP IdPs" lub saml_jit_status obiektu Authentication object ma wartość "Enabled for configured SAML IdPs")
passwd string Hasło użytkownika.

Wartość tego parametru może być pustym ciągiem, jeśli użytkownik jest powiązany z katalogiem użytkowników.

Zachowanie właściwości:
- tylko do zapisu
roleid ID ID roli użytkownika.

Należy pamiętać, że użytkownicy bez roli mogą logować się do Zabbixa wyłącznie przy użyciu uwierzytelniania LDAP lub SAML, pod warunkiem że ich informacje LDAP/SAML odpowiadają mapowaniom grup użytkowników skonfigurowanym w Zabbiksie.
attempt_clock timestamp Czas ostatniej nieudanej próby logowania.

Zachowanie właściwości:
- tylko do odczytu
attempt_failed integer Liczba ostatnich nieudanych prób logowania.

Zachowanie właściwości:
- tylko do odczytu
attempt_ip string Adres IP, z którego pochodziła ostatnia nieudana próba logowania.

Zachowanie właściwości:
- tylko do odczytu
autologin integer Czy włączyć automatyczne logowanie.

Możliwe wartości:
0 - (domyślnie) automatyczne logowanie wyłączone;
1 - automatyczne logowanie włączone.
autologout string Czas życia sesji użytkownika. Akceptuje sekundy oraz jednostkę czasu z sufiksem. Jeśli ustawiono 0s, sesja nigdy nie wygaśnie.

Domyślnie: 15m.
lang string Kod języka użytkownika, na przykład en_US.

Domyślnie: default - domyślny systemowy.
name string Imię użytkownika.
provisioned integer Czy użytkownik został aprowizowany.

Możliwe wartości:
0 - nieaprowizowany;
1 - aprowizowany.

Ta właściwość jest obsługiwana od Zabbix 7.0.9.

Zachowanie właściwości:
- tylko do odczytu
refresh string Okres automatycznego odświeżania. Akceptuje sekundy lub jednostkę czasu z sufiksem (np. 30s, 90s, 1m, 1h).

Domyślnie: 30s.
rows_per_page integer Liczba wierszy obiektów wyświetlanych na stronie.

Domyślnie: 50.
surname string Nazwisko użytkownika.
theme string Motyw użytkownika.

Możliwe wartości:
default - (domyślnie) domyślny systemowy;
blue-theme - niebieski;
dark-theme - ciemny;
hc-light - wysoki kontrast, jasny;
hc-dark - wysoki kontrast, ciemny.
ts_provisioned timestamp Czas wykonania ostatniej operacji aprowizacji.

Zachowanie właściwości:
- tylko do odczytu
- obsługiwane dla użytkowników typu Super admin (od Zabbix 7.0.9)
url string Adres URL strony, na którą użytkownik ma zostać przekierowany po zalogowaniu.
userdirectoryid ID ID katalogu użytkowników, z którym powiązany jest użytkownik.

Używane do aprowizacji (tworzenia lub aktualizacji), a także do logowania użytkownika powiązanego z katalogiem użytkowników.

W przypadku operacji logowania wartość tej właściwości ma pierwszeństwo przed właściwością userdirectoryid grup użytkowników, do których należy użytkownik.

Domyślnie: 0.

Zachowanie właściwości:
- tylko do odczytu
- obsługiwane dla użytkowników typu Super admin (od Zabbix 7.0.9)
timezone string Strefa czasowa użytkownika, na przykład Europe/London, UTC.

Domyślnie: default - domyślna systemowa.

Pełną listę obsługiwanych stref czasowych można znaleźć w dokumentacji PHP.

Media

Obiekt media ma następujące właściwości.

Property Type Description
mediaid ID ID mediów użytkownika.

Zachowanie właściwości:
- tylko do odczytu
mediatypeid ID ID typu media używanego przez media użytkownika.

Zachowanie właściwości:
- wymagane
sendto string/array Adres, nazwa użytkownika lub inny identyfikator odbiorcy.

Jeśli type w Media type jest ustawiony na "Email", wartości są reprezentowane jako tablica. Dla innych typów Media types wartość jest reprezentowana jako ciąg znaków.

Zachowanie właściwości:
- wymagane
active integer Czy media jest włączone.

Możliwe wartości:
0 - (domyślnie) włączone;
1 - wyłączone.
severity integer Poziomy wyzwalacza, dla których mają być wysyłane powiadomienia.

Możliwe wartości bitmapy:
1 - Not classified;
2 - Information;
4 - Warning;
8 - Average;
16 - High;
32 - Disaster.

To pole jest maską bitową; akceptowana jest dowolna suma możliwych wartości bitmapy (na przykład 48 dla Average, High i Disaster).

Domyślnie: 63.
period string Czas, w którym powiadomienia mogą być wysyłane jako okres czasu lub makra użytkownika oddzielone średnikiem.

Domyślnie: 1-7,00:00-24:00.
provisioned integer Czy użytkownik został provisioned.

Możliwe wartości:
0 - nie provisioned;
1 - provisioned.

Ta właściwość jest obsługiwana od Zabbix 7.0.9.
userdirectory_mediaid ID ID mapowania media katalogu użytkowników dla provisioned media.

Zachowanie właściwości:
- tylko do odczytu
- obsługiwane dla użytkowników typu Super admin (od Zabbix 7.0.9)