Supprimer un membre
Espace de noms: microsoft.graph
Utilisez cette API pour supprimer un membre (utilisateur, groupe ou appareil) d’une unité administrative.
Cette API est disponible dans les déploiements de cloud national suivants.
Service global | Gouvernement des États-Unis L4 | Us Government L5 (DOD) | Chine gérée par 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Autorisations
Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.
Type d’autorisation | Autorisations avec privilèges minimum | Autorisations privilégiées plus élevées |
---|---|---|
Déléguée (compte professionnel ou scolaire) | AdministrativeUnit.ReadWrite.All | Non disponible. |
Déléguée (compte Microsoft personnel) | Non prise en charge. | Non prise en charge. |
Application | AdministrativeUnit.ReadWrite.All | Non disponible. |
Pour supprimer un membre d’une unité administrative, le principal appelant doit être affecté au moins au rôle Administrateur de rôle privilégiéMicrosoft Entra.
Requête HTTP
DELETE /directory/administrativeUnits/{id}/members/{id}/$ref
Attention
Si vous n’ajoutez /$ref
pas à la demande et que l’application appelante dispose des autorisations nécessaires pour gérer l’objet membre, l’objet est également supprimé de l’ID Microsoft Entra ; sinon, une 403 Forbidden
erreur est retournée. Vous pouvez restaurer des objets spécifiques via l’API Restaurer les éléments supprimés.
En-têtes de demande
Nom | Description |
---|---|
Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
Corps de la demande
N’indiquez pas le corps de la demande pour cette méthode.
Réponse
Si elle réussit, cette méthode renvoie un code de réponse 204 No Content
. Il ne retourne rien dans le corps de la réponse.
Exemple
Demande
L’exemple suivant illustre une demande. Dans l’exemple ci-dessous, {id1}
représente l’identificateur de l’unité administrative cible et {id2}
l’identificateur unique de l’utilisateur membre, du groupe ou de l’appareil à supprimer de l’unité administrative cible.
DELETE https://graph.microsoft.com/v1.0/directory/administrativeUnits/{id1}/members/{id2}/$ref
Réponse
L’exemple suivant illustre la réponse.
HTTP/1.1 204 No Content