Exportieren von Benutzerrollenzuweisungen

Exportiert einen Bericht aller Rollen und Rollenzuweisungen, die einem UiPath®-Produkt zugeordnet sind.

API-Endpunkt

GET https://cloud.uipath.com/<yourorgname>/pap_/api/userroleassignments/export

Scopes

Folgende Scopes sind erforderlich:

• PM.User

• PM.User.Read

Anforderungsheader

--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'

Hinweis: Um das {access_token} zu erhalten, stellen Sie sicher, dass Sie sich mit einer der unter Authentifizierungsmethoden beschriebenen Methoden authentifizieren.

Abfrageparameter

Abfrageparameter	Datentyp	Beschreibung
exportoutputtype (erforderlich)	string	Geben Sie eines der beiden verfügbaren Dateiformate an: .json oder .csv

Antworten

200 OK

Der Bericht der Benutzerrollen und Rollenzuweisungen wird im Format .json oder .csv auf Ihre Maschine heruntergeladen.

Beispielanforderung

curl --location -- request GET 'https://cloud.uipath.com/acmeorg/pap_/api/userroleassignments/export?exportoutputtype=json' \
--header 'Authorization: Bearer {your token}

Der folgende Antworttext steht für einen erfolgreichen Abruf der Benutzerrolle und der Rollenzuweisung:

[
    {
        "Id": "34ecc3f3-a582-4cad-9889-120d7a3ffd62",
        "RoleUniqueName": "DOCUMENTUNDERSTANDING.DU VIEWER",
        "RoleDescription": "Can view all the entities but has not rights to edit or delete them.",
        "SecurityPrincipalId": "cdc34b5b-77d2-4ae1-9744-209d21ce557d",
        "RoleAssignmentType": "BuiltIn",
        "RoleType": "BUILTIN",
        "Scope": "/",
        "OrganizationId": "feb0dd79-85b6-483b-b297-0e49a1aa5b7d",
        "TenantId": null,
        "CreatedBy": "7f36fcc2-b822-430b-ae30-5ecfbacac186",
        "CreatedOn": "2023-03-30T08:30:04.9346766+00:00"
    },
...
]

In der folgenden Tabelle werden die Headerfelder aus der exportierten Datei beschrieben:

Feld	Beschreibung
ID	Der eindeutige Bezeichner der zugewiesenen Rolle.
Ursprünglicher Rollenname	Der Rollenname, wie auf der Benutzeroberfläche angezeigt.
Rollenbeschreibung	Die Rollenbeschreibung, wie auf der Benutzeroberfläche angezeigt.
Rollenzuweisungstyp	Der Rollenzuweisungstyp beim Erstellen, der eine der folgenden Optionen sein kann: Benutzerdefiniert, Zuweisung durch den Benutzer. Integriert, Zuweisung durch das System.
Rollentyp	Der Rollentyp, wie vom Benutzer oder dem System definiert: - Benutzerdefiniert (benutzerdefinierte Rolle) Integriert (systemdefinierte Rolle)
Umfang	Der Scope ist eine bestimmte Ebene in der Organisationshierarchie, die als Grenze für bestimmte Aktionen, Berechtigungen und Objekte dient. Ein Scope kann eine der folgenden hierarchischen Optionen sein: Organisation Mandant Dienst Ordner
Sicherheitsprinzipal-ID	Der eindeutige Bezeichner für die Identität eines Benutzers, einer Gruppe usw.
Sicherheitsprinzipaltyp	Der Identitätstyp eines Benutzers, einer Gruppe oder eines Roboters.
SicherheitsprinzipalEMail	Die E-Mail-Adresse des Benutzers. Dieses Feld ist leer, wenn es sich bei der Identität nicht um einen Benutzer handelt.
AnzeigenameDesSicherheitsprinzipals	Der Name der Identität. Dieses Feld ist bei Verzeichnisbenutzern leer.
GeerbtAusGruppenname	Der Gruppenname, von dem die Rollenzuweisung geerbt wird.
GeerbtAusGruppenID	Gruppenbezeichner, von dem die Rollenzuweisung geerbt wird.
Mandantenname	Der Name des Mandanten, in dem die Zuweisung vorgenommen wird. Dieses Feld ist bei Zuweisungen auf Organisationsebene leer.
Organisationsname	Der Name der Organisation, in der die Zuweisung vorgenommen wird.
OrganizationId	Der Bezeichner der Organisation, in der die Zuweisung vorgenommen wird.
TenantId	Der Bezeichner des Mandanten, in dem die Zuweisung vorgenommen wird. Dieses Feld ist bei Zuweisungen auf Organisationsebene leer.
CreatedBy	Der eindeutige Bezeichner des Benutzers, der die Zuweisung erstellt.
Erstellt am	Der Zeitstempel, wann die Rolle zugewiesen ist.