[comment]: # aside: 1 [comment]: # ({8f026b4a-0834cf88}) # Benutzerobjekt Die folgenden Objekte stehen in direktem Zusammenhang mit der `user` API. [comment]: # ({/8f026b4a-0834cf88}) [comment]: # ({aee2a82c-0ecc45be}) ### Benutzer Das Benutzerobjekt hat die folgenden Eigenschaften. |Eigenschaft|[Typ](/manual/api/reference_commentary#data-types)|Beschreibung| |--|--|------| |userid|ID|ID des Benutzers.

[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):
- *schreibgeschützt*
- *erforderlich* für Aktualisierungsvorgänge| |username|string|Name des Benutzers.

[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):
- *erforderlich* für Erstellungsvorgänge
- *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 gesetzt, der nicht "0" ist), und der Bereitstellungsstatus des Benutzerverzeichnisses aktiviert ist (`provision_status` des [Benutzerverzeichnisobjekts](/manual/api/reference/userdirectory/object#userdirectory) ist auf "1" gesetzt), und der Authentifizierungsstatus aller LDAP- oder SAML-Bereitstellungen aktiviert ist (`ldap_jit_status` des [Authentifizierungsobjekts](/manual/api/reference/authentication/object#authentication) ist auf "Enabled for configured LDAP IdPs" gesetzt oder `saml_jit_status` des [Authentifizierungsobjekts](/manual/api/reference/authentication/object#authentication) 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](/manual/api/reference/userdirectory/object) verknüpft ist.

[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):
- *nur schreibbar*| |roleid|ID|ID der Rolle des Benutzers.

Beachten Sie, dass Benutzer ohne Rolle sich nur mit [LDAP](/manual/web_interface/frontend_sections/users/authentication/ldap)- oder [SAML](/manual/web_interface/frontend_sections/users/authentication/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](/manual/api/reference_commentary#property-behavior):
- *schreibgeschützt*| |attempt\_failed|integer|Anzahl der letzten fehlgeschlagenen Anmeldeversuche.

[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):
- *schreibgeschützt*| |attempt\_ip|string|IP-Adresse, von der der letzte fehlgeschlagene Anmeldeversuch kam.

[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):
- *schreibgeschützt*| |autologin|integer|Gibt an, ob die automatische Anmeldung aktiviert werden soll.

Mögliche Werte:
0 - automatische Anmeldung *(Standard)* 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](/manual/api/reference/user/provision) wurde.

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

[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):
- *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;
`blue-classic-theme` - Blau (klassisch);
`dark-theme` - Dunkel;
`dark-classic-theme` - Dunkel (klassisch);
`hc-light` - Hell mit hohem Kontrast;
`hc-dark` - Dunkel mit hohem Kontrast.| |ts_provisioned|timestamp|Zeitpunkt, zu dem der letzte [Bereitstellungs](/manual/api/reference/user/provision)-Vorgang durchgeführt wurde.

[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):
- *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](/manual/api/reference/userdirectory/object), 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](/manual/api/reference/usergroup/object#user-group), denen der Benutzer angehört.

Standard: 0.

[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):
- *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](https://www.php.net/manual/en/timezones.php).| [comment]: # ({/aee2a82c-0ecc45be}) [comment]: # ({e65af01e-1ad487be}) ### Medien Das Medienobjekt hat die folgenden Eigenschaften. |Eigenschaft|Typ|Beschreibung| |--|--|------| |mediaid|ID|ID des Mediums des Benutzers.

[Verhalten von Eigenschaften](/manual/api/reference_commentary#property-behavior):
- *schreibgeschützt*| |mediatypeid|ID|ID des Medientyps, der vom Medium des Benutzers verwendet wird.

[Verhalten von Eigenschaften](/manual/api/reference_commentary#property-behavior):
- *erforderlich*| |sendto|string/array|Adresse, Benutzername oder andere Kennung des Empfängers.

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.

[Verhalten von Eigenschaften](/manual/api/reference_commentary#property-behavior):
- *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](/manual/appendix/time_period) oder durch Semikolon getrennte Benutzermakros gesendet werden können.

Standard: 1-7,00:00-24:00.| |provisioned|integer|Gibt an, ob der Benutzer [bereitgestellt](/manual/api/reference/user/provision) wurde.

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

[Verhalten von Eigenschaften](/manual/api/reference_commentary#property-behavior):
- *schreibgeschützt*
- *unterstützt* für Benutzer des Typs *Super admin*| [comment]: # ({/e65af01e-1ad487be})