Répertorier les membresList members

Espace de noms : microsoft.graphNamespace: microsoft.graph

Obtenir la liste de membres directs du groupe.Get a list of the group's direct members. Un groupe peut avoir comme membres des utilisateurs, des contacts d’organisation et d’autres groupes.A group can have users, organizational contacts, devices, service principals and other groups as members. Les principaux de service actuellement ne sont pas répertoriés en tant que membres du groupe en raison de la restauration intermédiaire des principaux de service sur le point de terminaison Graph V 1.0.Currently service principals are not listed as group members due to staged roll-out of service principals on Graph V1.0 endpoint. Cette opération n’est pas transitive.This operation is not transitive.

AutorisationsPermissions

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.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Type d’autorisationPermission type Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)Permissions (from least to most privileged)
Déléguée (compte professionnel ou scolaire)Delegated (work or school account) User.ReadBasic.All, User.Read.All, GroupMember.Read.All, Group.Read.All, Directory.Read.AllUser.ReadBasic.All, User.Read.All, GroupMember.Read.All, Group.Read.All, Directory.Read.All
Déléguée (compte Microsoft personnel)Delegated (personal Microsoft account) Non prise en charge.Not supported.
ApplicationApplication User.Read.All, GroupMember.Read.All, Group.Read.All, Directory.Read.AllUser.Read.All, GroupMember.Read.All, Group.Read.All, Directory.Read.All

Lorsqu’une application interroge une relation qui renvoie une collection de type directoryObject, si elle n’a pas l’autorisation de lire un certain type dérivé (tel que l’appareil), les membres de ce type sont renvoyés, mais avec une information limitée.When an application queries a relationship that returns a directoryObject type collection, if it does not have permission to read a certain derived type (like device), members of that type are returned but with limited information. Avec ces applications comportementales, les applications peuvent demander les autorisations minimales dont elles ont besoin, plutôt que de s’appuyer sur l’accès aux autorisations.With this behaviour applications can request the least privileged permissions they need, rather than rely on the set of Directory.* permissions. Pour plus d’informations, consultez Informations limitées retournées pour les objets membres inaccessibles.For details, see Limited information returned for inaccessible member objects.

Requête HTTPHTTP request

GET /groups/{id}/members

Paramètres facultatifs de la requêteOptional query parameters

Cette méthode prend en charge les paramètres de requête OData pour vous aider à personnaliser la réponse.This method supports the OData query parameters to help customize the response.

En-têtes de demandeRequest headers

En-têteHeader ValeurValue
AutorisationAuthorization Porteur {token}. Obligatoire.Bearer {token}. Required.

Corps de la demandeRequest body

N’indiquez pas le corps de la demande pour cette méthode.Do not supply a request body for this method.

RéponseResponse

Si elle réussit, cette méthode renvoie un code de réponse 200 OK et une collection d’objets directoryObject dans le corps de la réponse.If successful, this method returns a 200 OK response code and a collection of directoryObject objects in the response body.

ExempleExample

DemandeRequest

Voici un exemple de demande.The following is an example of the request.

GET https://graph.microsoft.com/v1.0/groups/{id}/members

RéponseResponse

Voici un exemple de réponse.The following is an example of the response.

Remarque :  l’objet de réponse affiché ici peut être raccourci pour plus de lisibilité.Note: The response object shown here might be shortened for readability.

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 55

{
  "value": [
    {
      "id": "id-value"
    }
  ]
}