[comment]: # aside: 1

[comment]: # ({8f026b4a-0834cf88})
# Benutzerobjekt

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

[comment]: # ({/8f026b4a-0834cf88})

[comment]: # ({730822db-0ecc45be})
### Benutzer

Das Benutzerobjekt hat die folgenden Eigenschaften.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|userid|ID|ID des Benutzers.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *schreibgeschützt*<br>- *erforderlich* für Aktualisierungsvorgänge|
|username|string|Name des Benutzers.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich* für Erstellungsoperationen<br>- *schreibgeschützt* für [bereitgestellte Benutzer](/manual/web_interface/frontend_sections/users/authentication#default-authentication), wenn der Benutzer mit einem [Benutzerverzeichnis](/manual/api/reference/userdirectory/object) verknüpft ist (`userdirectoryid` ist auf einen gültigen Wert ungleich "0" gesetzt) und der Bereitstellungsstatus des Benutzerverzeichnisses aktiviert ist (`provision_status` des [User directory object](/manual/api/reference/userdirectory/object#userdirectory) ist auf "1" gesetzt) sowie der Authentifizierungsstatus aller LDAP- oder SAML-Bereitstellungen aktiviert ist (`ldap_jit_status` des [Authentication object](/manual/api/reference/authentication/object#authentication) ist auf "Enabled for configured LDAP IdPs" gesetzt oder `saml_jit_status` des [Authentication object](/manual/api/reference/authentication/object#authentication) ist auf "Enabled for configured SAML IdPs" gesetzt)|
|passwd|string|Passwort des Benutzers.<br><br>Der Wert dieses Parameters kann eine leere Zeichenfolge sein, wenn der Benutzer mit einem [Benutzerverzeichnis](/manual/api/reference/userdirectory/object) verknüpft ist.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *nur schreibbar*|
|roleid|ID|ID der Rolle des Benutzers.<br><br>Beachten Sie, dass Benutzer ohne Rolle sich bei Zabbix nur über [LDAP](/manual/web_interface/frontend_sections/users/authentication/ldap)- oder [SAML](/manual/web_interface/frontend_sections/users/authentication/saml)-Authentifizierung anmelden können, sofern ihre LDAP/SAML-Informationen den in Zabbix konfigurierten Zuordnungen der Benutzergruppen entsprechen.|
|attempt\_clock|timestamp|Zeit des letzten fehlgeschlagenen Anmeldeversuchs.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *schreibgeschützt*|
|attempt\_failed|integer|Anzahl der kürzlich fehlgeschlagenen Anmeldeversuche.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *schreibgeschützt*|
|attempt\_ip|string|IP-Adresse, von der der letzte fehlgeschlagene Anmeldeversuch kam.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *schreibgeschützt*|
|autologin|integer|Ob die automatische Anmeldung aktiviert werden soll.<br><br>Mögliche Werte:<br>0 - *(Standard)* automatische Anmeldung deaktiviert;<br>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.<br><br>Standard: 15m.|
|lang|string|Sprachcode der Benutzersprache, zum Beispiel `en_US`.<br><br>Standard: `default` - Systemstandard.|
|name|string|Vorname des Benutzers.|
|provisioned|integer|Ob der Benutzer [bereitgestellt](/manual/api/reference/user/provision) wurde.<br><br>Mögliche Werte:<br>0 - nicht bereitgestellt;<br>1 - bereitgestellt.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *schreibgeschützt*|
|refresh|string|Automatischer Aktualisierungszeitraum. Akzeptiert Sekunden oder Zeiteinheiten mit Suffix (z. B. 30s, 90s, 1m, 1h).<br><br>Standard: 30s.|
|rows\_per\_page|integer|Anzahl der anzuzeigenden Objektzeilen pro Seite.<br><br>Standard: 50.|
|surname|string|Nachname des Benutzers.|
|theme|string|Design des Benutzers.<br><br>Mögliche Werte:<br>`default` - *(Standard)* Systemstandard;<br>`blue-theme` - Blau;<br>`dark-theme` - Dunkel;<br>`hc-light` - Hoher Kontrast, hell;<br>`hc-dark` - Hoher Kontrast, dunkel.|
|ts_provisioned|timestamp|Zeitpunkt, zu dem die letzte [Bereitstellung](/manual/api/reference/user/provision) durchgeführt wurde.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *schreibgeschützt*<br>- *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](/manual/api/reference/userdirectory/object), mit dem der Benutzer verknüpft ist.<br><br>Wird für die Bereitstellung (Erstellen oder Aktualisieren) sowie für die Anmeldung eines Benutzers verwendet, der mit einem Benutzerverzeichnis verknüpft ist.<br><br>Bei Anmeldevorgängen hat der Wert dieser Eigenschaft Vorrang vor der Eigenschaft `userdirectoryid` der [Benutzergruppen](/manual/api/reference/usergroup/object#user-group), denen der Benutzer angehört.<br><br>Standard: 0.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *schreibgeschützt*<br>- *unterstützt* für Benutzer vom Typ *Super admin*|
|timezone|string|Zeitzone des Benutzers, zum Beispiel `Europe/London`, `UTC`.<br><br>Standard: `default` - Systemstandard.<br><br>Die vollständige Liste der unterstützten Zeitzonen finden Sie in der [PHP-Dokumentation](https://www.php.net/manual/en/timezones.php).|

[comment]: # ({/730822db-0ecc45be})

[comment]: # ({e65af01e-1ad487be})
### Medien

Das Medienobjekt hat die folgenden Eigenschaften.

|Eigenschaft|Typ|Beschreibung|
|--|--|------|
|mediaid|ID|ID des Mediums des Benutzers.<br><br>[Verhalten von Eigenschaften](/manual/api/reference_commentary#property-behavior):<br>- *schreibgeschützt*|
|mediatypeid|ID|ID des Medientyps, der vom Medium des Benutzers verwendet wird.<br><br>[Verhalten von Eigenschaften](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*|
|sendto|string/array|Adresse, Benutzername oder andere Kennung des Empfängers.<br><br>Wenn `type` des [Medientyps](/manual/api/reference/mediatype/object#mediatype) auf „Email“ gesetzt ist, werden Werte als Array dargestellt. Bei anderen Typen von [Medientypen](/manual/api/reference/mediatype/object#mediatype) wird der Wert als String dargestellt.<br><br>[Verhalten von Eigenschaften](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*|
|active|integer|Gibt an, ob das Medium aktiviert ist.<br><br>Mögliche Werte:<br>0 - *(Standard)* aktiviert;<br>1 - deaktiviert.|
|severity|integer|Auslöser-Schweregrade, für die Benachrichtigungen gesendet werden.<br><br>Mögliche Bitmap-Werte:<br>1 - Nicht klassifiziert;<br>2 - Information;<br>4 - Warnung;<br>8 - Durchschnittlich;<br>16 - Hoch;<br>32 - Katastrophe.<br><br>Dies ist ein Bitmaskenfeld; jede Summe der möglichen Bitmap-Werte ist zulässig (zum Beispiel 48 für Durchschnittlich, Hoch und Katastrophe).<br><br>Standard: 63.|
|period|string|Zeit, zu der die Benachrichtigungen als [Zeitperiode](/manual/appendix/time_period) oder durch Semikolon getrennte Benutzermakros gesendet werden können.<br><br>Standard: 1-7,00:00-24:00.|
|provisioned|integer|Gibt an, ob der Benutzer [bereitgestellt](/manual/api/reference/user/provision) wurde.<br><br>Mögliche Werte:<br>0 - nicht bereitgestellt;<br>1 - bereitgestellt.|
|userdirectory_mediaid|ID|Zuordnungs-ID des Benutzerverzeichnismediums für bereitgestellte Medien.<br><br>[Verhalten von Eigenschaften](/manual/api/reference_commentary#property-behavior):<br>- *schreibgeschützt*<br>- *unterstützt* für Benutzer des Typs *Super admin*|

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