[comment]: # aside: 1
[comment]: # translation:outdated
[comment]: # ({70c23b61-2135842b})
# Rollen-Objekt
Die folgenden Objekte stehen in direktem Zusammenhang mit der `role` API.
[comment]: # ({/70c23b61-2135842b})
[comment]: # ({4c760d03-1708e020})
### Rolle
Das Rollenobjekt hat die folgenden Eigenschaften:
|Eigenschaft|[Typ](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|roleid|ID|ID der Rolle.
[Eigenschaftsverhalten](/manual/api/reference_commentary#property-behavior):
- *schreibgeschützt*
- *erforderlich* für Aktualisierungsvorgänge|
|name|string|Name der Rolle.
[Eigenschaftsverhalten](/manual/api/reference_commentary#property-behavior):
- *erforderlich* für Erstellungsvorgänge|
|type|integer|Benutzertyp.
Mögliche Werte:
1 - *(Standard)* Benutzer;
2 - Admin;
3 - Super-Admin.
[Eigenschaftsverhalten](/manual/api/reference_commentary#property-behavior):
- *erforderlich* für Erstellungsvorgänge|
|readonly|integer|Gibt an, ob die Rolle schreibgeschützt ist.
Mögliche Werte:
0 - *(Standard)* Nein;
1 - Ja.
[Eigenschaftsverhalten](/manual/api/reference_commentary#property-behavior):
- *schreibgeschützt*|
[comment]: # ({/4c760d03-1708e020})
[comment]: # ({28862318-8a9b3008})
### Rollenregeln
Das Objekt für Rollenregeln hat die folgenden Eigenschaften:
|Eigenschaft|[Typ](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|ui|array|Array der Objekte vom Typ [UI-Element](object#ui-element).|
|ui.default\_access|integer|Gibt an, ob der Zugriff auf neue UI-Elemente aktiviert ist.
Mögliche Werte:
0 - Deaktiviert;
1 - *(Standard)* Aktiviert.|
|services.read.mode|integer|Schreibgeschützter Zugriff auf Services.
Mögliche Werte:
0 - Schreibgeschützter Zugriff auf die Services, die durch die Eigenschaften `services.read.list` angegeben oder durch `services.read.tag` abgeglichen werden;
1 - *(Standard)* Schreibgeschützter Zugriff auf alle Services.|
|services.read.list|array|Array von [Service](object#service)-Objekten.
Den angegebenen Services, einschließlich untergeordneter Services, wird für die Benutzerrolle schreibgeschützter Zugriff gewährt. Schreibgeschützter Zugriff überschreibt keinen Lese-/Schreibzugriff auf die Services.
[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):
- *unterstützt*, wenn `services.read.mode` auf "0" gesetzt ist|
|services.read.tag|object|Array von [Service-Tag](object#service-tag)-Objekten.
Den über Tags abgeglichenen Services, einschließlich untergeordneter Services, wird für die Benutzerrolle schreibgeschützter Zugriff gewährt. Schreibgeschützter Zugriff überschreibt keinen Lese-/Schreibzugriff auf die Services.
[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):
- *unterstützt*, wenn `services.read.mode` auf "0" gesetzt ist|
|services.write.mode|integer|Lese-/Schreibzugriff auf Services.
Mögliche Werte:
0 - *(Standard)* Lese-/Schreibzugriff auf die Services, die durch die Eigenschaften `services.write.list` angegeben oder durch `services.write.tag` abgeglichen werden;
1 - Lese-/Schreibzugriff auf alle Services.|
|services.write.list|array|Array von [Service](object#service)-Objekten.
Den angegebenen Services, einschließlich untergeordneter Services, wird für die Benutzerrolle Lese-/Schreibzugriff gewährt. Lese-/Schreibzugriff überschreibt schreibgeschützten Zugriff auf die Services.
[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):
- *unterstützt*, wenn `services.write.mode` auf "0" gesetzt ist|
|services.write.tag|object|Array von [Service-Tag](object#service-tag)-Objekten.
Den über Tags abgeglichenen Services, einschließlich untergeordneter Services, wird für die Benutzerrolle Lese-/Schreibzugriff gewährt. Lese-/Schreibzugriff überschreibt schreibgeschützten Zugriff auf die Services.
[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):
- *unterstützt*, wenn `services.write.mode` auf "0" gesetzt ist|
|modules|array|Array der [Modul](object#module)-Objekte.|
|modules.default\_access|integer|Gibt an, ob der Zugriff auf neue Module aktiviert ist.
Mögliche Werte:
0 - Deaktiviert;
1 - *(Standard)* Aktiviert.|
|api.access|integer|Gibt an, ob der Zugriff auf die API aktiviert ist.
Mögliche Werte:
0 - Deaktiviert;
1 - *(Standard)* Aktiviert.|
|api.mode|integer|Modus für die Behandlung der in der Eigenschaft `api` aufgeführten API-Methoden.
Mögliche Werte:
0 - *(Standard)* Sperrliste;
1 - Zulassungsliste.|
|api|array|Array von API-Methoden.|
|actions|array|Array der [Aktion](object#action)-Objekte.|
|actions.default\_access|integer|Gibt an, ob der Zugriff auf neue Aktionen aktiviert ist.
Mögliche Werte:
0 - Deaktiviert;
1 - *(Standard)* Aktiviert.|
[comment]: # ({/28862318-8a9b3008})
[comment]: # ({b7519b73-006cdfb5})
#### UI-Element
Das UI-Element-Objekt hat die folgenden Eigenschaften:
|Eigenschaft|[Typ](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|name|string|Name des UI-Elements.
Mögliche Werte, wenn `type` des [Role](#role)-Objekts auf "User", "Admin" oder "Super admin" gesetzt ist:
`monitoring.dashboard` - *Dashboards*;
`monitoring.problems` - *Monitoring → Probleme*;
`monitoring.hosts` - *Monitoring → Hosts*;
`monitoring.latest_data` - *Monitoring → Letzte Daten*;
`monitoring.maps` - *Monitoring → Karten*;
`services.services` - *Services → Services*;
`services.sla_report` - *Services → SLA-Bericht*;
`inventory.overview` - *Inventar → Übersicht*;
`inventory.hosts` - *Inventar → Hosts*;
`reports.availability_report` - *Berichte → Verfügbarkeitsbericht*;
`reports.top_triggers` - *Berichte → Top 100 Auslöser*.
Mögliche Werte, wenn `type` des [Role](#role)-Objekts auf "Admin" oder "Super admin" gesetzt ist:
`monitoring.discovery` - *Monitoring → Discovery*;
`services.sla` - *Services → SLA*;
`reports.scheduled_reports` - *Berichte → Geplante Berichte*;
`reports.notifications` - *Berichte → Benachrichtigungen*;
`configuration.template_groups` - *Datenerfassung → Vorlagengruppen*;
`configuration.host_groups` - *Datenerfassung → Host-Gruppen*;
`configuration.templates` - *Datenerfassung → Vorlagen*;
`configuration.hosts` - *Datenerfassung → Hosts*;
`configuration.maintenance` - *Datenerfassung → Wartung*;
`configuration.discovery` - *Datenerfassung → Discovery*;
`configuration.trigger_actions` - *Warnmeldungen → Aktionen → Auslöser-Aktionen*;
`configuration.service_actions` - *Warnmeldungen → Aktionen → Service-Aktionen*;
`configuration.discovery_actions` - *Warnmeldungen → Aktionen → Discovery-Aktionen*;
`configuration.autoregistration_actions` - *Warnmeldungen → Aktionen → Aktionen zur automatischen Registrierung*;
`configuration.internal_actions` - *Warnmeldungen → Aktionen → Interne Aktionen*.
Mögliche Werte, wenn `type` des [Role](#role)-Objekts auf "Super admin" gesetzt ist:
`reports.system_info` - *Berichte → Systeminformationen*;
`reports.audit` - *Berichte → Auditprotokoll*;
`reports.action_log` - *Berichte → Aktionsprotokoll*;
`configuration.event_correlation` - *Datenerfassung → Ereigniskorrelation*;
`administration.media_types` - *Warnmeldungen → Medientypen*;
`administration.scripts` - *Warnmeldungen → Skripte*;
`administration.user_groups` - *Benutzer → Benutzergruppen*;
`administration.user_roles` - *Benutzer → Benutzerrollen*;
`administration.users` - *Benutzer → Benutzer*;
`administration.api_tokens` - *Benutzer → API-Tokens*;
`administration.authentication` - *Benutzer → Authentifizierung*;
`administration.general` - *Administration → Allgemein*;
`administration.audit_log` - *Administration → Auditprotokoll*;
`administration.housekeeping` - *Administration → Bereinigung*;
`administration.proxy_groups` - *Administration → Proxy-Gruppen*;
`administration.proxies` - *Administration → Proxys*;
`administration.macros` - *Administration → Makros*;
`administration.queue` - *Administration → Warteschlange*.
[Verhalten von Eigenschaften](/manual/api/reference_commentary#property-behavior):
- *erforderlich*|
|status|integer|Gibt an, ob der Zugriff auf das UI-Element aktiviert ist.
Mögliche Werte:
0 - Deaktiviert;
1 - *(Standard)* Aktiviert.|
[comment]: # ({/b7519b73-006cdfb5})
[comment]: # ({e891a8d2-ebf4bb3a})
#### Service
|Eigenschaft|[Typ](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|serviceid|ID|ID des Service.
[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):
- *erforderlich*|
[comment]: # ({/e891a8d2-ebf4bb3a})
[comment]: # ({62d78428-300e6d5b})
#### Service-Tag
|Eigenschaft|[Typ](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|tag|string|Tag-Name.
Wenn eine leere Zeichenfolge angegeben wird, wird das Service-Tag nicht für den Service-Abgleich verwendet.
[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):
- *erforderlich*|
|value|string|Tag-Wert.
Wenn kein Wert oder eine leere Zeichenfolge angegeben wird, wird nur der Tag-Name für den Service-Abgleich verwendet.|
[comment]: # ({/62d78428-300e6d5b})
[comment]: # ({bdcf5af8-f70e75e9})
#### Modul
Das Modulobjekt hat die folgenden Eigenschaften:
|Eigenschaft|[Typ](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|moduleid|ID|ID des Moduls.
[Eigenschaftsverhalten](/manual/api/reference_commentary#property-behavior):
- *erforderlich*|
|status|integer|Gibt an, ob der Zugriff auf das Modul aktiviert ist.
Mögliche Werte:
0 - Deaktiviert;
1 - *(Standard)* Aktiviert.|
[comment]: # ({/bdcf5af8-f70e75e9})
[comment]: # ({17265016-957a00bb})
#### Aktion
Das Aktionsobjekt hat die folgenden Eigenschaften:
|Eigenschaft|[Typ](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|name|string|Name der Aktion.
Mögliche Werte, wenn `type` des [Role](#role)-Objekts auf "User", "Admin" oder "Super admin" gesetzt ist:
`edit_dashboards` - Dashboards erstellen und bearbeiten;
`edit_maps` - Karten erstellen und bearbeiten;
`add_problem_comments` - Problemkommentare hinzufügen;
`change_severity` - Problemschweregrad ändern;
`acknowledge_problems` - Probleme bestätigen;
`suppress_problems` - Probleme unterdrücken;
`close_problems` - Probleme schließen;
`execute_scripts` - Skripte ausführen;
`manage_api_tokens` - API-Tokens verwalten;
`change_problem_ranking` - Die Problemrangfolge von Ursache zu Symptom und umgekehrt ändern;
`edit_own_media` - Erstellen/Bearbeiten eigener Medien erlauben.
Mögliche Werte, wenn `type` des [Role](#role)-Objekts auf "Admin" oder "Super admin" gesetzt ist:
`edit_maintenance` - Wartungen erstellen und bearbeiten;
`manage_scheduled_reports` - Geplante Berichte verwalten,
`manage_sla` - SLA verwalten.
Mögliche Werte, wenn `type` des [Role](#role)-Objekts auf "User" oder "Admin" gesetzt ist:
`invoke_execute_now` - erlaubt das Ausführen von Datenpunkt-Prüfungen für Benutzer, die nur Leseberechtigungen auf dem Host haben.
Mögliche Werte, wenn `type` des [Role](#role)-Objekts auf "Super admin" gesetzt ist:
`edit_user_media` - Erstellen/Bearbeiten von Medien für Benutzer erlauben.
[Eigenschaftsverhalten](/manual/api/reference_commentary#property-behavior):
- *erforderlich*|
|status|integer|Ob der Zugriff zum Ausführen der Aktion aktiviert ist.
Mögliche Werte:
0 - Deaktiviert;
1 - *(Standard)* Aktiviert.|
[comment]: # ({/17265016-957a00bb})