Partager via

Admin - Groups DeleteUserAsAdmin

Service:
Power BI REST APIs
Version d'API:
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 et l’ID d’objet d’application que le principal de service doit supprimer.

Permissions

L’utilisateur doit être administrateur fabric.

Étendue requise

Tenant.ReadWrite.All

Limites

Maximum 200 requêtes par heure. 

DELETE https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/users/{user}
Avec des paramètres facultatifs: 
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)

Identifiant de l’espace de travail.
user
 path True

string

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

boolean

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

string (uuid)

ID de profil du 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

Exemple de requête

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

Exemple de réponse

Code d’état:
200

Delete guest user example

Exemple de requête

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

Exemple de réponse

Code d’état:
200

Delete service principal example

Exemple de requête

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

Exemple de réponse

Code d’état:
200

Delete user example

Exemple de requête

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

Exemple de réponse

Code d’état:
200