Obiekt użytkownika

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

Użytkownik

Obiekt użytkownika ma następujące właściwości.

Property Type Description
userid ID ID użytkownika.

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

Zachowanie właściwości:
- wymagana w operacjach 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”), aprowizowanie w katalogu użytkowników jest włączone (provision_status obiektu User directory ma wartość „1”), a uwierzytelnianie dla całego aprowizowania LDAP lub SAML jest włączone (ldap_jit_status obiektu Authentication ma wartość „Enabled for configured LDAP IdPs” lub saml_jit_status obiektu Authentication 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 Zabbix tylko przy użyciu uwierzytelniania LDAP lub SAML, pod warunkiem że ich informacje LDAP/SAML odpowiadają mapowaniom grup użytkowników skonfigurowanym w Zabbix.
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 Określa, 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 liczbę sekund (np. 1, 60, 300) lub wartość z przyrostkiem czasu (np. 30s, 1m, 2h). Jeśli ustawiono 0s, sesja nigdy nie wygaśnie.

Domyślnie: 15m.
default_maintenance_period string Domyślny okres utrzymania dla utrzymania utworzonego za pomocą skrótu. Akceptuje sekundy lub jednostkę czasu z przyrostkiem (300s, 5m, 1h, 1d, 1w). Podana wartość zostanie zaokrąglona w dół do pełnych minut.

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

Domyślnie: default - domyślny język systemu.
name string Imię użytkownika.
provisioned integer Określa, czy użytkownik został aprovisionowany.

Możliwe wartości:
0 - nieaprovisionowany;
1 - aprovisionowany.

Zachowanie właściwości:
- tylko do odczytu
refresh string Automatyczny okres odświeżania. Akceptuje liczbę sekund (np. 1, 60, 300) lub wartość z przyrostkiem czasu (np. 30s, 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 motyw systemu;
blue-theme - niebieski;
blue-classic-theme - niebieski (klasyczny);
dark-theme - ciemny;
dark-blue-theme - ciemnoniebieski;
dark-classic-theme - ciemny (klasyczny);
hc-light - jasny, o wysokim kontraście;
hc-dark - ciemny, o wysokim kontraście.
ts_provisioned timestamp Czas wykonania najnowszej operacji aprowizowania.

Zachowanie właściwości:
- tylko do odczytu
- obsługiwana dla użytkowników typu Super admin
url string URL strony, na którą użytkownik zostanie przekierowany po zalogowaniu.
userdirectoryid ID ID katalogu użytkowników, z którym powiązany jest użytkownik.

Używane do aprowizowania (tworzenia lub aktualizowania), 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ługiwana dla użytkowników typu Super admin
timezone string Strefa czasowa użytkownika, na przykład Europe/London, UTC.

Domyślnie: default - domyślna strefa czasowa systemu.

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 media 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 właściwość type obiektu Media type ma wartość „Email” lub „Push”, wartości są reprezentowane jako tablica. W przypadku „Push” tablica może zawierać symbol wieloznaczny (*) albo co najmniej jeden identyfikator urządzenia mobilnego.

Jeśli właściwość type obiektu Media type ma wartość „Script”, „SMS” lub „Webhook”, wartość jest reprezentowana jako ciąg znaków.

Zachowanie właściwości:
- wymagane
active integer Określa, czy media są włączone.

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

Możliwe wartości bitmapy:
1 - Niesklasyfikowane;
2 - Informacyjne;
4 - Ostrzeżenie;
8 - Średnie;
16 - Wysokie;
32 - Katastrofalne.

To pole jest maską bitową; dopuszczalna jest dowolna suma możliwych wartości bitmapy (na przykład 48 dla poziomów Średnie, Wysokie i Katastrofalne).

Wartość domyślna: 63.
period string Czas, w którym można wysyłać powiadomienia, określony jako okres czasu lub makra użytkownika rozdzielone średnikiem.

Wartość domyślna: 1-7,00:00-24:00.
provisioned integer Określa, czy użytkownik został zainicjowany.

Możliwe wartości:
0 - niezainicjowany;
1 - zainicjowany.
userdirectory_mediaid ID ID mapowania media w katalogu użytkowników dla zainicjowanych mediów.

Zachowanie właściwości:
- tylko do odczytu
- obsługiwane w przypadku użytkowników typu Super admin