directoryObject : checkMemberObjects
Espace de noms: microsoft.graph
Vérifiez l’appartenance à une liste d’ID de groupe, d’ID d’unité administrative ou d’ID de rôle d’annuaire pour les ID de l’utilisateur, du groupe, du principal de service, du contact organisationnel, de l’appareil ou de l’objet d’annuaire spécifiés. La vérification est transitive.
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
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.
Appartenances pour un objet d’annuaire
| 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) | Directory.Read.All |
| Déléguée (compte Microsoft personnel) | Non prise en charge. |
| Application | Directory.Read.All |
Appartenances de l’utilisateur connecté
| 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) | User.Read, User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All |
| Déléguée (compte Microsoft personnel) | Non prise en charge. |
| Application | Non prise en charge. |
Appartenances pour les autres utilisateurs
| 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) | User.Read, User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All |
| Déléguée (compte Microsoft personnel) | Non prise en charge. |
| Application | User.Read.All, Directory.Read.All, User.ReadWrite.All, Directory.ReadWrite.All |
Appartenances à un groupe
| 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.Read.All, Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All |
| Déléguée (compte Microsoft personnel) | Non prise en charge. |
| Application | GroupMember.Read.All, Group.Read.All, Directory.Read.All, Group.ReadWrite.All, Directory.ReadWrite.All |
Appartenances d’un principal de service
| 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) | Application.Read.All, Application.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
| Déléguée (compte Microsoft personnel) | Non prise en charge. |
| Application | Application.Read.All, Application.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
Appartenances pour un contact organisationnel
| 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) | Directory.Read.All, Directory.ReadWrite.All |
| Déléguée (compte Microsoft personnel) | Non prise en charge. |
| Application | Directory.Read.All, Directory.ReadWrite.All |
Appartenances pour un appareil
| 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) | Device.Read.All, Directory.Read.All, Directory.ReadWrite.All |
| Déléguée (compte Microsoft personnel) | Non prise en charge. |
| Application | Device.Read.All, Device.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
Requête HTTP
Appartenances pour un objet d’annuaire.
POST /directoryObjects/{id}/checkMemberObjects
Appartenances de l’utilisateur connecté.
POST /me/checkMemberObjects
Appartenances pour d’autres utilisateurs.
POST /users/{id | userPrincipalName}/checkMemberObjects
Appartenances à un groupe.
POST /groups/{id}/checkMemberObjects
Appartenances pour un principal de service.
POST /servicePrincipals/{id}/checkMemberObjects
Appartenances pour un contact organisationnel.
POST /contacts/{id}/checkMemberObjects
Appartenances pour un appareil.
POST /devices/{id}/checkMemberObjects
En-têtes de demande
| Nom | Description |
|---|---|
| Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
| Content-Type | application/json. Obligatoire. |
Corps de la demande
Dans le corps de la demande, indiquez un objet JSON avec les paramètres suivants.
| Paramètre | Type | Description |
|---|---|---|
| Ids | String collection | Collection qui contient les ID d’objet des groupes, des unités administratives, des rôles d’annuaire ou des ID roleTemplate des rôles d’annuaire, dans lesquels case activée appartenance. Vous pouvez spécifier jusqu’à 20 objets. |
Réponse
Si elle réussit, cette méthode renvoie un 200 OK code de réponse et un nouvel objet de collection String dans le corps de la réponse.
Exemples
Voici un exemple d’appel de cette API.
Demande
L’exemple suivant illustre une demande.
POST https://graph.microsoft.com/v1.0/me/checkMemberObjects
Content-type: application/json
{
"ids": [
"80a963dd-84af-4eb8-b2a6-781e444d4fb0",
"62e90394-69f5-4237-9190-012177145e10",
"86a64f51-3a64-4cc6-a8c8-6b8f000c0f52",
"ac38546e-ddf3-437a-ac5c-27a94cd7a0f1"
]
}
Réponse
L’exemple suivant illustre la réponse.
Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.
HTTP/1.1 200 OK
Content-type: application/json
{
"value": [
"80a963dd-84af-4eb8-b2a6-781e444d4fb0",
"62e90394-69f5-4237-9190-012177145e10"
]
}