Freigeben über

Workspaces - Get Workspace Role Assignment

Dienst:
Core
API-Version:
v1

Gibt Informationen zu einer Arbeitsbereichsrollenzuweisung zurück.

Erlaubnisse

Der Anrufer muss mitglied oder höher im Arbeitsbereich sein.

Erforderliche delegierte Bereiche

Workspace.Read.All oder Workspace.ReadWrite.All

Von Microsoft Entra unterstützte Identitäten

Diese API unterstützt die in diesem Abschnitt aufgeführten Microsoft Identitäten.

Identität Unterstützung
Benutzer Ja
Service Principal und Verwaltete Identitäten Ja

Schnittstelle

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/roleAssignments/{workspaceRoleAssignmentId}

URI-Parameter

Name In Erforderlich Typ Beschreibung
workspaceId
 path True

string (uuid)

Die Arbeitsbereichs-ID.
workspaceRoleAssignmentId
 path True

string (uuid)

Die Rollenzuweisungs-ID des Arbeitsbereichs.

Antworten

Name Typ Beschreibung
200 OK

WorkspaceRoleAssignment

Die Anforderung wurde erfolgreich abgeschlossen.
Other Status Codes

ErrorResponse

Häufige Fehlercodes:

  • UnknownError – Ein Fehler ist aufgetreten.

Beispiele

Get workspace role assignment example

Beispielanforderung

GET https://api.fabric.microsoft.com/v1/workspaces/0ac682f5-aee3-4968-9d21-692eb3fd4056/roleAssignments/259b6674-74cf-4197-ac05-1bf391800ec2

Beispiel für eine Antwort

Statuscode:
200 
{
  "id": "259b6674-74cf-4197-ac05-1bf391800ec2",
  "principal": {
    "id": "259b6674-74cf-4197-ac05-1bf391800ec2",
    "type": "User"
  },
  "role": "Member"
}

Definitionen

Name Beschreibung
ErrorRelatedResource

Das Fehlerbezogene Ressourcendetails-Objekt.
ErrorResponse

Die Fehlerantwort.
ErrorResponseDetails

Die Fehlerantwortdetails.
GroupDetails

Gruppieren Sie bestimmte Details. Gilt, wenn der Prinzipaltyp Groupist.
GroupType

Der Typ der Gruppe. Weitere Gruppentypen können im Laufe der Zeit hinzugefügt werden.
Principal

Stellt eine Identität oder eine Microsoft Entra-Gruppe dar.
PrincipalType

Der Typ des Prinzipals. Im Laufe der Zeit können zusätzliche Prinzipaltypen hinzugefügt werden.
ServicePrincipalDetails

Spezifische Details des Dienstprinzipals. Gilt, wenn der Prinzipaltyp ServicePrincipalist.
ServicePrincipalProfileDetails

Dienstprinzipalprofildetails. Gilt, wenn der Prinzipaltyp ServicePrincipalProfileist.
UserDetails

Spezifische Details des Benutzerprinzipals. Gilt, wenn der Prinzipaltyp Userist.
WorkspaceRole

Eine Arbeitsbereichsrolle. Zusätzliche Arbeitsbereichsrollen können im Laufe der Zeit hinzugefügt werden.
WorkspaceRoleAssignment

Ein Arbeitsbereichsrollenzuweisungsobjekt.

ErrorRelatedResource

Objekt

Das Fehlerbezogene Ressourcendetails-Objekt.

Name Typ Beschreibung
resourceId

string

Die Ressourcen-ID, die an dem Fehler beteiligt ist.
resourceType

string

Der Typ der Ressource, die an dem Fehler beteiligt ist.

ErrorResponse

Objekt

Die Fehlerantwort.

Name Typ Beschreibung
errorCode

string

Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht.
message

string

Eine lesbare Darstellung des Fehlers.
moreDetails

ErrorResponseDetails[]

Liste der zusätzlichen Fehlerdetails.
relatedResource

ErrorRelatedResource

Die fehlerbezogenen Ressourcendetails.
requestId

string

ID der Anforderung, die dem Fehler zugeordnet ist.

ErrorResponseDetails

Objekt

Die Fehlerantwortdetails.

Name Typ Beschreibung
errorCode

string

Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht.
message

string

Eine lesbare Darstellung des Fehlers.
relatedResource

ErrorRelatedResource

Die fehlerbezogenen Ressourcendetails.

GroupDetails

Objekt

Gruppieren Sie bestimmte Details. Gilt, wenn der Prinzipaltyp Groupist.

Name Typ Beschreibung
groupType

GroupType

Der Typ der Gruppe. Weitere Gruppentypen können im Laufe der Zeit hinzugefügt werden.

GroupType

Enumeration

Der Typ der Gruppe. Weitere Gruppentypen können im Laufe der Zeit hinzugefügt werden.

Wert Beschreibung
Unknown

Der Prinzipalgruppentyp ist unbekannt.
SecurityGroup

Prinzipal ist eine Sicherheitsgruppe.
DistributionList

Prinzipal ist eine Verteilerliste.

Principal

Objekt

Stellt eine Identität oder eine Microsoft Entra-Gruppe dar.

Name Typ Beschreibung
displayName

string

Der Anzeigename des Prinzipals.
groupDetails

GroupDetails

Gruppieren Sie bestimmte Details. Gilt, wenn der Prinzipaltyp Groupist.
id

string (uuid)

Die ID des Prinzipals.
servicePrincipalDetails

ServicePrincipalDetails

Spezifische Details des Dienstprinzipals. Gilt, wenn der Prinzipaltyp ServicePrincipalist.
servicePrincipalProfileDetails

ServicePrincipalProfileDetails

Dienstprinzipalprofildetails. Gilt, wenn der Prinzipaltyp ServicePrincipalProfileist.
type

PrincipalType

Der Typ des Prinzipals. Im Laufe der Zeit können zusätzliche Prinzipaltypen hinzugefügt werden.
userDetails

UserDetails

Spezifische Details des Benutzerprinzipals. Gilt, wenn der Prinzipaltyp Userist.

PrincipalType

Enumeration

Der Typ des Prinzipals. Im Laufe der Zeit können zusätzliche Prinzipaltypen hinzugefügt werden.

Wert Beschreibung
User

Prinzipal ist ein Microsoft Entra-Benutzerprinzipal.
ServicePrincipal

Prinzipal ist ein Microsoft Entra-Dienstprinzipal.
Group

Prinzipal ist eine Sicherheitsgruppe.
ServicePrincipalProfile

Prinzipal ist ein Dienstprinzipalprofil.
EntireTenant

Prinzipal stellt alle Mandantenbenutzer dar.

ServicePrincipalDetails

Objekt

Spezifische Details des Dienstprinzipals. Gilt, wenn der Prinzipaltyp ServicePrincipalist.

Name Typ Beschreibung
aadAppId

string (uuid)

Die Microsoft Entra AppId des Dienstprinzipals.

ServicePrincipalProfileDetails

Objekt

Dienstprinzipalprofildetails. Gilt, wenn der Prinzipaltyp ServicePrincipalProfileist.

Name Typ Beschreibung
parentPrincipal

Principal

Der übergeordnete Prinzipal des Dienstprinzipals.

UserDetails

Objekt

Spezifische Details des Benutzerprinzipals. Gilt, wenn der Prinzipaltyp Userist.

Name Typ Beschreibung
userPrincipalName

string

Der Benutzerprinzipalname.

WorkspaceRole

Enumeration

Eine Arbeitsbereichsrolle. Zusätzliche Arbeitsbereichsrollen können im Laufe der Zeit hinzugefügt werden.

Wert Beschreibung
Admin

Ermöglicht den Administratorzugriff auf den Arbeitsbereich.
Member

Ermöglicht den Mitgliedschaftszugriff auf den Arbeitsbereich.
Contributor

Aktiviert den Beitrag zum Arbeitsbereich.
Viewer

Aktiviert die Anzeige des Arbeitsbereichs.

WorkspaceRoleAssignment

Objekt

Ein Arbeitsbereichsrollenzuweisungsobjekt.

Name Typ Beschreibung
id

string (uuid)

Die Rollenzuweisungs-ID des Arbeitsbereichs.
principal

Principal

Der Prinzipal.
role

WorkspaceRole

Die Arbeitsbereichsrolle des Prinzipals.