Benutzerobjekt

Die folgenden Objekte stehen in direktem Zusammenhang mit der user API.

Benutzer

Das Benutzerobjekt hat die folgenden Eigenschaften.

Eigenschaft Typ Beschreibung
userid ID ID des Benutzers.

Verhalten der Eigenschaft:
- schreibgeschützt
- erforderlich für Aktualisierungsvorgänge
username string Name des Benutzers.

Verhalten der Eigenschaft:
- erforderlich für Erstellungsvorgänge
- schreibgeschützt für bereitgestellte Benutzer, wenn der Benutzer mit einem Benutzerverzeichnis verknüpft ist (userdirectoryid ist auf einen gültigen Wert gesetzt, der nicht "0" ist), und der Bereitstellungsstatus des Benutzerverzeichnisses aktiviert ist (provision_status des Benutzerverzeichnisobjekts ist auf "1" gesetzt), und der Authentifizierungsstatus aller LDAP- oder SAML-Bereitstellungen aktiviert ist (ldap_jit_status des Authentifizierungsobjekts ist auf "Enabled for configured LDAP IdPs" gesetzt oder saml_jit_status des Authentifizierungsobjekts ist auf "Enabled for configured SAML IdPs" gesetzt)
passwd string Passwort des Benutzers.

Der Wert dieses Parameters kann eine leere Zeichenfolge sein, wenn der Benutzer mit einem Benutzerverzeichnis verknüpft ist.

Verhalten der Eigenschaft:
- nur schreibbar
roleid ID ID der Rolle des Benutzers.

Beachten Sie, dass Benutzer ohne Rolle sich nur mit LDAP- oder SAML-Authentifizierung bei Zabbix anmelden können, sofern ihre LDAP-/SAML-Informationen mit den in Zabbix konfigurierten Benutzergruppenzuordnungen übereinstimmen.
attempt_clock timestamp Zeit des letzten fehlgeschlagenen Anmeldeversuchs.

Verhalten der Eigenschaft:
- schreibgeschützt
attempt_failed integer Anzahl der letzten fehlgeschlagenen Anmeldeversuche.

Verhalten der Eigenschaft:
- schreibgeschützt
attempt_ip string IP-Adresse, von der der letzte fehlgeschlagene Anmeldeversuch kam.

Verhalten der Eigenschaft:
- schreibgeschützt
autologin integer Gibt an, ob die automatische Anmeldung aktiviert werden soll.

Mögliche Werte:
0 - (Standard) automatische Anmeldung deaktiviert;
1 - automatische Anmeldung aktiviert.
autologout string Lebensdauer der Benutzersitzung. Akzeptiert Sekunden und Zeiteinheiten mit Suffix. Wenn auf 0s gesetzt, läuft die Sitzung nie ab.

Standard: 15m.
lang string Sprachcode der Benutzersprache, zum Beispiel en_US.

Standard: default - Systemstandard.
name string Vorname des Benutzers.
provisioned integer Gibt an, ob der Benutzer bereitgestellt wurde.

Mögliche Werte:
0 - nicht bereitgestellt;
1 - bereitgestellt.

Verhalten der Eigenschaft:
- schreibgeschützt
refresh string Automatisches Aktualisierungsintervall. Akzeptiert Sekunden oder Zeiteinheiten mit Suffix (z. B. 30s, 90s, 1m, 1h).

Standard: 30s.
rows_per_page integer Anzahl der pro Seite anzuzeigenden Objektzeilen.

Standard: 50.
surname string Nachname des Benutzers.
theme string Theme des Benutzers.

Mögliche Werte:
default - (Standard) Systemstandard;
blue-theme - Blau;
dark-theme - Dunkel.
ts_provisioned timestamp Zeitpunkt, zu dem der letzte Bereitstellungsvorgang durchgeführt wurde.

Verhalten der Eigenschaft:
- schreibgeschützt
- unterstützt für Benutzer vom Typ Super admin
url string URL der Seite, zu der der Benutzer nach der Anmeldung weitergeleitet wird.
userdirectoryid ID ID des Benutzerverzeichnisses, mit dem der Benutzer verknüpft ist.

Wird für die Bereitstellung (Erstellen oder Aktualisieren) sowie für die Anmeldung eines Benutzers verwendet, der mit einem Benutzerverzeichnis verknüpft ist.

Bei Anmeldevorgängen hat der Wert dieser Eigenschaft Vorrang vor der Eigenschaft userdirectoryid der Benutzergruppen, denen der Benutzer angehört.

Standard: 0.

Verhalten der Eigenschaft:
- schreibgeschützt
- unterstützt für Benutzer vom Typ Super admin
timezone string Zeitzone des Benutzers, zum Beispiel Europe/London, UTC.

Standard: default - Systemstandard.

Eine vollständige Liste der unterstützten Zeitzonen finden Sie in der PHP-Dokumentation.

Medien

Das Medienobjekt hat die folgenden Eigenschaften.

Eigenschaft Typ Beschreibung
mediaid ID ID des Mediums des Benutzers.

Verhalten von Eigenschaften:
- schreibgeschützt
mediatypeid ID ID des Medientyps, der vom Medium des Benutzers verwendet wird.

Verhalten von Eigenschaften:
- erforderlich
sendto string/array Adresse, Benutzername oder andere Kennung des Empfängers.

Wenn type des Medientyps auf „Email“ gesetzt ist, werden Werte als Array dargestellt. Bei anderen Typen von Medientypen wird der Wert als String dargestellt.

Verhalten von Eigenschaften:
- erforderlich
active integer Gibt an, ob das Medium aktiviert ist.

Mögliche Werte:
0 - (Standard) aktiviert;
1 - deaktiviert.
severity integer Auslöser-Schweregrade, für die Benachrichtigungen gesendet werden.

Mögliche Bitmap-Werte:
1 - Nicht klassifiziert;
2 - Information;
4 - Warnung;
8 - Durchschnittlich;
16 - Hoch;
32 - Katastrophe.

Dies ist ein Bitmaskenfeld; jede Summe der möglichen Bitmap-Werte ist zulässig (zum Beispiel 48 für Durchschnittlich, Hoch und Katastrophe).

Standard: 63.
period string Zeit, zu der die Benachrichtigungen als Zeitperiode oder durch Semikolon getrennte Benutzermakros gesendet werden können.

Standard: 1-7,00:00-24:00.
provisioned integer Gibt an, ob der Benutzer bereitgestellt wurde.

Mögliche Werte:
0 - nicht bereitgestellt;
1 - bereitgestellt.
userdirectory_mediaid ID Zuordnungs-ID des Benutzerverzeichnismediums für bereitgestellte Medien.

Verhalten von Eigenschaften:
- schreibgeschützt
- unterstützt für Benutzer des Typs Super admin