Share via

Admin - Groups DeleteUserAsAdmin

  • Référence
Service:
Power BI REST APIs
API Version:
v1.0

Supprime les autorisations utilisateur de l’espace de travail spécifié.

Cet appel d’API prend en charge la suppression d’un utilisateur, d’un groupe de sécurité, d’un groupe M365 et d’un principal de service. Utilisez l’adresse e-mail ou l’UPN pour l’utilisateur, l’ID d’objet de groupe pour le groupe et l’ID d’objet d’application pour le principal de service à supprimer.

Autorisations

L’utilisateur doit disposer de droits d’administrateur (par exemple, Office 365 Administrateur général ou Administrateur de service Power BI).

Étendue requise

Tenant.ReadWrite.All

Limites

Maximum 200 demandes par heure. 

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}

Paramètres URI

Nom Dans Obligatoire Type Description
groupId
 path True

string

uuid

ID de l’espace de travail.
user
 path True

string

Nom d’utilisateur principal (UPN) de l’ID d’objet d’utilisateur ou de groupe de l’ID d’objet du groupe ou de l’application du principal de service à supprimer.
isGroup
 query

boolean

Indique si un utilisateur donné est un groupe ou non. Ce paramètre est obligatoire lorsque l’utilisateur à supprimer est un groupe.
profileId
 query

string

uuid

ID de profil de principal de service à supprimer.

Réponses

Nom Type Description
200 OK

Ok

Exemples

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