---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Anwenderrollenvererb-API

# Anwenderrollenvererb-API {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 25. Juni 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer

Die Anwenderrollenvererbung Die API stellt Endpunkte bereit, mit denen Sie die Rollen anzeigen können, die ein bestimmter Anwender geerbt hat.
Diese API erfordert das com.glide.role_management.inh_count.rest_api-Plugin „kontextbezogene Sicherheit: Rollenverwaltung V2 REST API" (Role Management), das automatisch auf neuen Instanzen ab dem Jakarta-Release aktiviert wird, oder das REST-API-Plugin „kontextbezogene Sicherheit: Rollenverwaltungserweiterungen", das ab dem Genf-Release automatisch aktiviert wird. Die REST-API „kontextbezogene Sicherheit: Rollenverwaltung V2" ist abhängig vom Plugin „kontextbezogene Sicherheit: Rollenverwaltung V2 (com.glide.role_management.inh_count)".

Die Rolle eines Anwenders kann direkt gewährt, von anderen Rollen geerbt oder von Gruppen geerbt werden. Sie müssen über die Rolle user_admin verfügen, um auf diese API zuzugreifen.

## Anwenderrollenvererbung -- GET /global/user_role_inheritance {#ariaid-title2}

Gibt die gewährten und geerbten Rollen eines angegebenen Anwenders zurück.

### URL-Format {#user_role_inher-GET__section_pg5_hds_2mb}

Versionierte URL: /api/global/{api_Version}/user_role_inheritance

Standard-URL: /api/global/user_role_inheritance  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

{#user_role_inher-GET__entry__2}{#user_role_inher-GET__version-not_optional-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 1. Pfad-Parameter]

{#user_role_inher-GET__entry__6}

| Name | Beschreibung |
|-|-|
| User_sysid | Erforderlich. SYS_ID des Anwenders, für den Rolleninformationen zurückgegeben werden sollen. |
[Tabelle : 2. Abfrageparameter]

{#user_role_inher-GET__entry__10}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 3. Anforderungstext-Parameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#user_role_inher-GET__entry__14}{#user_role_inher-GET__accept-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 4. Anforderungskopfzeilen.]

{#user_role_inher-GET__entry__18}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 5. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#user_role_inher-GET__entry__22}{#user_role_inher-GET__entry-200-status-code}{#user_role_inher-GET__entry-400-status-code}{#user_role_inher-GET__entry-401-status-code}{#user_role_inher-GET__entry-404-status-code}{#user_role_inher-GET__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 6. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#user_role_inher-GET__entry__34}

| Name | Beschreibung |
|-|-|
| From_Group | Liste der Rollen, die von Gruppen geerbt werden, die Rollen haben. Datentyp: Array |
| From_role | Liste der Rollen, die entweder direkt gewährt oder von anderen Rollen geerbt werden. Datentyp: Array |
| user_name | Vollständiger Name des Anwenders. Datentyp: Zeichenfolge |
[ ]

### Beispiel für Curl-Anforderung

    curl "https://instance.service-now.com/api/global/user_role_inheritance?user_sysid=62826bf03710200044e0bfc8bcbe5df1" \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"

    {
      "result": {
        "user_name": "abel.tuter",
        "from_group": [
          "[Azure Operators]/sn_azure.operator",
          "[Azure Operators]/sn_azure.operator/sn_azure.user"
        ],
        "from_role": [
          "/snc_internal",
          "/cloud_user",
          "/cloud_user/pa_viewer",
          "/cloud_user/sn_azure.user",
          "/cloud_user/aws_user"
        ]
      }
    }


