Admin - Groups DeleteUserAsAdmin

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}
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

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

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

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