Freigeben über

Workspaces - Update Workspace Role Assignment

Dienst:
Core
API-Version:
v1

Aktualisiert eine Arbeitsbereichsrollenzuweisung.
Die Rollenzuweisung des letzten Administrators kann nicht geändert werden.

Erlaubnisse

Der Anrufer muss über Administratorrolle im Arbeitsbereich verfügen.

Erforderliche delegierte Bereiche

Arbeitsbereich.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

PATCH 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.

Anforderungstext

Name Erforderlich Typ Beschreibung
role True

WorkspaceRole

Die Arbeitsbereichsrolle des Prinzipals.

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

Update workspace role assignment example

Beispielanforderung

PATCH https://api.fabric.microsoft.com/v1/workspaces/0ac682f5-aee3-4968-9d21-692eb3fd4056/roleAssignments/0218b8c4-f5a2-4a1e-bbbd-a986dd8aeb81

{
  "role": "Contributor"
}

Beispiel für eine Antwort

Statuscode:
200 
{
  "id": "0218b8c4-f5a2-4a1e-bbbd-a986dd8aeb81",
  "principal": {
    "displayName": "user1",
    "id": "0218b8c4-f5a2-4a1e-bbbd-a986dd8aeb81",
    "type": "User",
    "userDetails": {
      "userPrincipalName": "user1@microsoft.com"
    }
  },
  "role": "Contributor"
}

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.
UpdateWorkspaceRoleAssignmentRequest

Aktualisieren der Arbeitsbereichsrollenzuweisungsanforderungsnutzlast.
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.

UpdateWorkspaceRoleAssignmentRequest

Objekt

Aktualisieren der Arbeitsbereichsrollenzuweisungsanforderungsnutzlast.

Name Typ Beschreibung
role

WorkspaceRole

Die Arbeitsbereichsrolle des Prinzipals.

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.