Freigeben über

Admin - Groups DeleteUserAsAdmin

  • Referenz
Service:
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, die Gruppenobjekt-ID für die Gruppe und die App-Objekt-ID für den Dienstprinzipal zum Löschen.

Berechtigungen

Der Benutzer muss über Administratorrechte verfügen (z. B. Office 365 globaler Administrator oder Power BI-Dienstadministrator).

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}
With optional parameters: 
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 Gruppen- oder App-Objekt-ID des zu löschenden 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

OK

Beispiele

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

Delete group example

Sample Request

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

Sample Response

Status code:
200

Delete guest user example

Sample Request

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

Sample Response

Status code:
200

Delete service principal example

Sample Request

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

Sample Response

Status code:
200

Delete user example

Sample Request

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

Sample Response

Status code:
200