Freigeben über

Admin - Groups DeleteUserAsAdmin

Dienst:
Power BI REST APIs
API-Version:
v1.0

Entfernt Benutzerberechtigungen aus dem angegebenen Arbeitsbereich.

Dieser API-Aufruf unterstützt das Entfernen eines Benutzers, einer Sicherheitsgruppe, einer M365-Gruppe und eines Dienstprinzipals. Verwenden Sie die E-Mail-Adresse oder den UPN für Benutzer, Gruppenobjekt-ID für gruppen- und App-Objekt-ID, um den Dienstprinzipal zu löschen.

Erlaubnisse

Der Benutzer muss ein Fabric-Administrator sein.

Erforderlicher Bereich

Tenant.ReadWrite.All

Einschränkungen

Maximal 200 Anforderungen pro Stunde. 

DELETE https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/users/{user}
Mit optionalen Parametern: 
DELETE https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/users/{user}?profileId={profileId}&isGroup={isGroup}

URI-Parameter

Name In Erforderlich Typ Beschreibung
groupId
 path True

string (uuid)

Die Arbeitsbereichs-ID.
user
 path True

string

Der Benutzerprinzipalname (UPN) der Benutzer- oder Gruppenobjekt-ID der zu löschenden Gruppen- oder App-Objekt-ID des Dienstprinzipals.
isGroup
 query

boolean

Gibt an, ob ein bestimmter Benutzer eine Gruppe ist oder nicht. Dieser Parameter ist erforderlich, wenn der Zu löschende Benutzer eine Gruppe ist.
profileId
 query

string (uuid)

Die zu löschende Dienstprinzipalprofil-ID.

Antworten

Name Typ Beschreibung
200 OK

OKAY

Beispiele

Delete group example
Delete guest user example
Delete service principal example
Delete user example

Delete group example

Beispielanforderung

DELETE https://api.powerbi.com/v1.0/myorg/admin/groups/f7d76f5a-7190-43c6-bf12-7a135c6c2d23/users/23476f5a-7190-43c6-bf12-7a135c6c2d23?isGroup=True

Beispiel für eine Antwort

Statuscode:
200

Delete guest user example

Beispielanforderung

DELETE https://api.powerbi.com/v1.0/myorg/admin/groups/f7d76f5a-7190-43c6-bf12-7a135c6c2d23/users/john_contoso.com%23EXT%23@test.com

Beispiel für eine Antwort

Statuscode:
200

Delete service principal example

Beispielanforderung

DELETE https://api.powerbi.com/v1.0/myorg/admin/groups/f7d76f5a-7190-43c6-bf12-7a135c6c2d23/users/23476f5a-7190-43c6-bf12-7a135c6c2d23

Beispiel für eine Antwort

Statuscode:
200

Delete user example

Beispielanforderung

DELETE https://api.powerbi.com/v1.0/myorg/admin/groups/f7d76f5a-7190-43c6-bf12-7a135c6c2d69/users/john@contoso.com

Beispiel für eine Antwort

Statuscode:
200