Exporter (0) Imprimer
Développer tout

Requêtes courantes de l'API Azure AD Graph

Mis à jour: avril 2014

Cette rubrique répertorie des requêtes courantes qui peuvent être utilisées avec 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 dans Azure AD Graph.

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 enregistrés de votre locataire pour exécuter avec succès des requêtes sur votre abonnement. Pour obtenir des informations sur d'autres façons de s'adresser au locataire, voir Traitement des entités et opérations dans l'API Graph.

Les requêtes courantes qui suivent montrent comment accéder à des ressources de niveau supérieur dans Graph avec l'exemple de locataire contoso.com.

 

Ressources 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=2013-04-05

Informations sur la société

Retourne les informations sur la société

https://graph.windows.net/contoso.com/tenantDetails?api-version=2013-04-05

Contacts

Retourne les informations sur les contacts

https://graph.windows.net/contoso.com/contacts?api-version=2013-04-05

Utilisateurs

Retourne les informations utilisateur

https://graph.windows.net/contoso.com/users?api-version=2013-04-05

Groupes

Retourne les données des groupes

https://graph.windows.net/contoso.com/groups?api-version=2013-04-05

Rôles

Retourne tous les rôles auxquels des utilisateurs ou groupes sont affectés

https://graph.windows.net/contoso.com/roles?api-version=2013-04-05

SubscribedSkus

Retourne les abonnements du locataire

https://graph.windows.net/contoso.com/subscribedSkus?api-version=2013-04-05

Métadonnées de répertoires

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 de répertoire)

https://graph.windows.net/contoso.com/$metadata?api-version=2013-04-05

Les requêtes courantes qui suivent montrent comment réaliser une opération d'interrogation dans Graph avec l'exemple de locataire contoso.com.

 

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=2013-04-05

https://graph.windows.net/contoso.com/groups?api-version=2013-04-05

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=2013-04-05

https://graph.windows.net/contoso.com/users/admin@contoso.com?api-version=2013-04-05

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=2013-04-05

Demander et filtrer des utilisateurs dont le firstName est égal à « Jon »

https://graph.windows.net/contoso.com/users?$filter=givenName eq 'Jon'&api-version=2013-04-05

Filtrer sur les valeurs givenName et surname

https://graph.windows.net/contoso.com/users?$filter=givenName eq 'Jon' and surname eq 'Doe'&api-version=2013-04-05

Récupérer un groupe en spécifiant l'objectId

https://graph.windows.net/contoso.com/groups/06790a81-0382-434c-b40e-216fa41bda21?api-version=2013-04-05

Récupérer le gestionnaire d'un utilisateur

https://graph.windows.net/contoso.com/users/John.Smith@contoso.com/manager?api-version=2013-04-05

Récupérer la liste des subordonnés directs d'un utilisateur

https://graph.windows.net/contoso.com/users/3c4a09b0-a7b6-444e-9702-96983635a66e/directReports?api-version=2013-04-05

Récupérer la liste des liens vers les subordonnées directs d'un utilisateur

https://graph.windows.net/contoso.com/users/3c4a09b0-a7b6-444e-9702-96983635a66e/$links/directReports?api-version=2013-04-05

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=2013-04-05

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=2013-04-05

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=2013-04-05

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=2013-04-05

Demander et filtrer les groupes displayName => ‘az’ and <= ‘dz’

https://graph.windows.net/contoso.com/groups?$filter=displayName ge 'az' and displayName le 'dz'&api-version=2013-04-05

noteRemarque
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 suivante, https://graph.windows.net/contoso.com/Users?$filter=displayName eq 'Jon Doe'&api-version=2013-04-05, doit être encodée dans l'URL de cette façon : https://graph.windows.net/contoso.com/Users?$filter=displayName%20eq%20'Jon%20Doe'&api-version=2013-04-05.

Voir aussi

Afficher:
© 2015 Microsoft