Ajouter des membres

Espace de noms : microsoft.graph

Important

Les API sous /beta la version dans Microsoft Graph sont sujettes à modification. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans la version 1.0, utilisez le sélecteur de version.

Ajoutez un membre à un groupe de sécurité ou Microsoft 365 par le biais de la propriété de navigation des membres.

Vous pouvez ajouter des utilisateurs, des appareils, des principaux de service ou d’autres groupes.

Important

  • Vous pouvez ajouter des membres à des groupes de sécurité Microsoft 365 groupes uniquement. Pour plus d’informations, voir types de groupes Azure AD et Microsoft Graph uniquement.
  • Vous ne pouvez pas ajouter de groupes de sécurité aux groupes Microsoft 365.
  • Vous ne pouvez pas ajouter de groupes Microsoft 365 à des groupes de sécurité ou à d’autres groupes Microsoft 365.
  • Un groupe de sécurité peut avoir des utilisateurs, des appareils, des groupes ou des principaux de service comme membres, tandis qu’un groupe Microsoft 365 ne peut avoir que des utilisateurs comme membres.

Autorisations

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) GroupMember.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All, Directory.AccessAsUser.All
Déléguée (compte Microsoft personnel) Non prise en charge.
Application GroupMember.ReadWrite.All, Group.ReadWrite.All, Directory.ReadWrite.All

Requête HTTP

POST /groups/{group-id}/members/$ref

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire.

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON d’un objet directoryObject, utilisateur ou groupe à ajouter.

Réponse

Si elle réussit, cette méthode renvoie un code de réponse 204 No Content. Elle ne renvoie rien dans le corps de la réponse. Cette méthode renvoie un code de réponse 400 Bad Request lorsque l’objet est déjà membre du groupe. Cette méthode renvoie un code de réponse 404 Not Found lorsque l’objet ajouté n’existe pas.

Exemple

Demande

Voici un exemple de demande.

POST https://graph.microsoft.com/beta/groups/{group-id}/members/$ref
Content-type: application/json

{
  "@odata.id": "https://graph.microsoft.com/beta/directoryObjects/{id}"
}

Dans le corps de la demande, fournissez une représentation JSON de l’objet id directoryObject, utilisateur ou groupe que vous souhaitez ajouter.

Réponse

Voici un exemple de réponse.

HTTP/1.1 204 No Content

Voir aussi