Table of contents

Requêtes courantes de l’API GraphGraph API Common Queries

Jimaco Brannian|Dernière mise à jour: 19/06/2018
|
2 Collaborateurs

Cette rubrique répertorie quelques requêtes courantes qui peuvent être exécutées avec l’API Azure AD Graph.This topic shows some common queries that can be performed with the Azure AD Graph API.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.For more information about supported operations when querying the Graph, see Supported Queries, Filters, and Paging Options in Azure AD Graph API.

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.We strongly recommend that you use Microsoft Graph instead of Azure AD Graph API to access Azure Active Directory resources.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.Our development efforts are now concentrated on Microsoft Graph and no further enhancements are planned for Azure AD Graph API.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.There are a very limited number of scenarios for which Azure AD Graph API might still be appropriate; for more information, see the Microsoft Graph or the Azure AD Graph blog post in the Office Dev Center.

AdressageAddressing

Toutes les requêtes ci-dessous s’adressent au locataire à l’aide d’un nom de domaine.The queries below all address the tenant using a domain name.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é).You can replace contoso.com with one of your tenant’s registered domain names, with your tenant's ID (GUID), or with the MyOrganization alias (for delegated access).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.For information about other ways of addressing the tenant, see Addressing Entities and Operations in the Graph API.

Interrogation des ressources de niveau supérieurQuerying Top-Level Resources

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.The following common queries demonstrate how to access top-level resources with the Graph API using contoso.com as the example tenant.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.Note that an Authorization header containing a valid bearer token received from Azure AD will be required to run queries against a tenant.

Ressource de niveau supérieurTop-Level ResourceRésultats de la requêteQuery ResultsURI (pour contoso.com)URI (for contoso.com)
Ressources de niveau supérieurTop-level resourcesRetourne la liste d’URI des ressources de niveau supérieur pour les services d’annuaire (également répertoriés ci-dessous)Returns URI list of the top-level resources for directory services (also listed below)https://graph.windows.net/contoso.com?api-version=1.6
Informations sur la sociétéCompany informationRetourne les informations sur la sociétéReturns company informationhttps://graph.windows.net/contoso.com/tenantDetails?api-version=1.6
ContactsContactsRetourne les informations sur les contacts d’organisationReturns organizational contact informationhttps://graph.windows.net/contoso.com/contacts?api-version=1.6
UtilisateursUsersRetourne les informations utilisateurReturns user informationhttps://graph.windows.net/contoso.com/users?api-version=1.6
GroupesGroupsRetourne les données des groupesReturns group datahttps://graph.windows.net/contoso.com/groups?api-version=1.6
Rôles d’annuaireDirectory RolesRetourne tous les rôles d’annuaire activés dans le locataireReturns all activated directory roles in the tenanthttps://graph.windows.net/contoso.com/roles?api-version=1.6
SubscribedSkusSubscribedSkusRetourne les abonnements du locataireReturns the tenant's subscriptionshttps://graph.windows.net/contoso.com/subscribedSkus?api-version=1.6
Métadonnées d’annuaireDirectory metadataRetourne 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)Returns a Service Metadata Document that describes the data model (that is, structure and organization of directory resources)https://graph.windows.net/contoso.com/$metadata?api-version=1.6

Opérations de requêteQuery Operations

Le tableau suivant présente quelques exemples de requêtes d’API Graph utilisant contoso.com en tant que locataire.The following table shows some example Graph API queries using using contoso.com as the example tenant.

Opération de requêteQuery OperationURI (pour contoso.com)URI (for contoso.com)
Répertorier tous les utilisateurs et groupesList all Users and Groupshttps://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 userPrincipalNameRetrieve individual User by specifying the objectId or userPrincipalNamehttps://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 »Request and Filter for a user with displayName equal to “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 »Request and Filter for specific users with firstName equal to “Jon”https://graph.windows.net/contoso.com/users?$filter=givenName eq 'Jon'&api-version=1.6
Filtrer sur les valeurs givenName et surnameFilter for givenName and surname values.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’objectIdRetrieve individual group by specifying the objectIdhttps://graph.windows.net/contoso.com/groups/06790a81-0382-434c-b40e-216fa41bda21?api-version=1.6
Récupérer le gestionnaire d’un utilisateurRetrieve a user’s managerhttps://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 utilisateurRetrieve a user’s direct reports listhttps://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 utilisateurRetrieve a list of links to a user’s direct reportshttps://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 groupeRetrieve membership list of a grouphttps://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 groupeRetrieve a list of links to the members of a group.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)Retrieve a user’s group membership (not transitive)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)Retrieve a list of the groups that the user is a member of (not transitive)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"Request and filter for groups with 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.Note: White space in the query string should be URL-encoded before sending a request.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.For example, the following query string, https://graph.windows.net/contoso.com/Users?$filter=displayName eq 'Jon Doe'&api-version=1.6, should be URL encoded as: https://graph.windows.net/contoso.com/Users?$filter=displayName%20eq%20'Jon%20Doe'&api-version=1.6.

© 2018 Microsoft