Requêtes courantes de l’API Graph
Cette rubrique répertorie quelques requêtes courantes qui peuvent être exécutées avec l’API Azure AD Graph. Pour plus d’informations sur les opérations prises en charge lors de l’interrogation de Graph, consultez Options de requêtes, de filtres et de pagination prises en charge par l’API Azure AD Graph.
Important
Nous vous recommandons fortement d’utiliser Microsoft Graph plutôt que l’API Graph Azure AD pour accéder aux ressources Azure Active Directory. Nos efforts de développement sont désormais axés sur Microsoft Graph et aucune autre amélioration n’est prévue pour l’API Graph Azure AD. Il existe un nombre très limité de scénarios pour lesquels l’API Graph Azure AD peut être encore appropriée ; pour plus d’informations, consultez le billet de blog Microsoft Graph ou l’API Azure AD dans le Centre de développement Office.
Adressage
Toutes les requêtes ci-dessous s’adressent au locataire à l’aide d’un nom de domaine. Vous pouvez remplacer contoso.com par l’un des noms de domaine inscrits de votre locataire avec votre ID de locataire (GUID) ou avec l’alias MyOrganization (pour l’accès délégué). Pour obtenir des informations sur d’autres façons de s’adresser au locataire, consultez Traitement des entités et opérations dans l’API Graph.
Interrogation des ressources de niveau supérieur
Les requêtes courantes qui suivent montrent comment accéder à des ressources de niveau supérieur dans l’API Graph en utilisant contoso.com comme exemple de locataire. Notez qu’un en-tête Authorization qui contient un jeton de support valide provenant d’Azure AD doit exécuter des requêtes sur un locataire.
| Ressource de niveau supérieur | Résultats de la requête | URI (pour contoso.com) |
|---|---|---|
| Ressources de niveau supérieur | Retourne la liste d’URI des ressources de niveau supérieur pour les services d’annuaire (également répertoriés ci-dessous) | https://graph.windows.net/contoso.com?api-version=1.6 |
| Informations sur la société | Retourne les informations sur la société | https://graph.windows.net/contoso.com/tenantDetails?api-version=1.6 |
| Contacts | Retourne les informations sur les contacts d’organisation | https://graph.windows.net/contoso.com/contacts?api-version=1.6 |
| Utilisateurs | Retourne les informations utilisateur | https://graph.windows.net/contoso.com/users?api-version=1.6 |
| Groupes | Retourne les données des groupes | https://graph.windows.net/contoso.com/groups?api-version=1.6 |
| Rôles d’annuaire | Retourne tous les rôles d’annuaire activés dans le locataire | https://graph.windows.net/contoso.com/roles?api-version=1.6 |
| SubscribedSkus | Retourne les abonnements du locataire | https://graph.windows.net/contoso.com/subscribedSkus?api-version=1.6 |
| Métadonnées d’annuaire | Retourne un document de métadonnées de service qui décrit le modèle de données (c’est-à-dire, structure et organisation des ressources d’annuaire) | https://graph.windows.net/contoso.com/$metadata?api-version=1.6 |
Opérations de requête
Le tableau suivant présente quelques exemples de requêtes d’API Graph utilisant contoso.com en tant que locataire.
| Opération de requête | URI (pour contoso.com) |
|---|---|
| Répertorier tous les utilisateurs et groupes | https://graph.windows.net/contoso.com/users?api-version=1.6 https://graph.windows.net/contoso.com/groups?api-version=1.6 |
| Récupérer un utilisateur en spécifiant l’objectId ou le userPrincipalName | https://graph.windows.net/contoso.com/users/d1f67a6c-02c9-4fe5-81fb-58160ce24fe5?api-version=1.6 https://graph.windows.net/contoso.com/users/admin@contoso.com?api-version=1.6 |
| Demander et filtrer un utilisateur dont le displayName est égal à « Jon Doe » | https://graph.windows.net/contoso.com/Users?$filter=displayName eq 'Jon Doe'&api-version=1.6 |
| Demander et filtrer des utilisateurs dont le firstName est égal à « Jon » | https://graph.windows.net/contoso.com/users?$filter=givenName eq 'Jon'&api-version=1.6 |
| Filtrer sur les valeurs givenName et surname | https://graph.windows.net/contoso.com/users?$filter=givenName eq 'Jon' and surname eq 'Doe'&api-version=1.6 |
| Récupérer un groupe en spécifiant l’objectId | https://graph.windows.net/contoso.com/groups/06790a81-0382-434c-b40e-216fa41bda21?api-version=1.6 |
| Récupérer le gestionnaire d’un utilisateur | https://graph.windows.net/contoso.com/users/John.Smith@contoso.com/manager?api-version=1.6 |
| Récupérer la liste des collaborateurs directs d’un utilisateur | https://graph.windows.net/contoso.com/users/3c4a09b0-a7b6-444e-9702-96983635a66e/directReports?api-version=1.6 |
| Récupérer la liste des liens vers les collaborateurs directs d’un utilisateur | https://graph.windows.net/contoso.com/users/3c4a09b0-a7b6-444e-9702-96983635a66e/$links/directReports?api-version=1.6 |
| Récupérer la liste des adhérents à un groupe | https://graph.windows.net/contoso.com/groups/3f575eef-bb04-44a5-a9af-eee9f547e3f9/members?api-version=1.6 |
| Récupérer la liste de liens vers les membres du groupe | https://graph.windows.net/contoso.com/groups/3f575eef-bb04-44a5-a9af-eee9f547e3f9/$links/members?api-version=1.6 |
| Récupérer l’appartenance aux groupes d’un utilisateur (non transitif) | https://graph.windows.net/contoso.com/users/ee6308f6-646a-4845-a4e1-57ac96ccc0c8/memberOf?api-version=1.6 |
| Récupérer la liste des groupes dont l’utilisateur est membre (non transitif) | https://graph.windows.net/contoso.com/users/ee6308f6-646a-4845-a4e1-57ac96ccc0c8/$links/memberOf?api-version=1.6 |
| Demander et filtrer les groupes avec displayName >= "az" and <= "dz" | https://graph.windows.net/contoso.com/groups?$filter=displayName ge 'az' and displayName le 'dz'&api-version=1.6 |
Remarque : l’espace blanc dans la chaîne de requête doit être encodé dans l’URL avant d’envoyer une demande. Par exemple, la chaîne de requête https://graph.windows.net/contoso.com/Users?$filter=displayName eq 'Jon Doe'&api-version=1.6 doit être codée URL comme suit : https://graph.windows.net/contoso.com/Users?$filter=displayName%20eq%20'Jon%20Doe'&api-version=1.6.