(0) exportieren Drucken
Alle erweitern

Allgemeine Abfragen der Azure AD Graph-API

Letzte Aktualisierung: April 2014

In diesem Thema sind allgemeine Abfragen aufgeführt, die mit Azure AD Graph verwendet werden können. Informationen zu unterstützten Vorgängen beim Abfragen von Graph finden Sie unter Unterstützte Abfragen, Filter und Paginierungsoptionen in Azure AD Graph,

Alle folgenden Abfragen adressieren den Mandanten über einen Domänennamen. Sie können "contoso.com" durch einen der registrierten Domänennamen des Mandanten ersetzen, um Abfragen für das Abonnement erfolgreich auszuführen. Weitere Informationen über andere Methoden zur Adressierung des Mandanten finden Sie unter Adressieren von Entitäten und Vorgängen in der Graph-API.

Die folgenden allgemeinen Abfragen demonstrieren, wie Sie in Graph auf Ressourcen der obersten Ebene zugreifen, wobei Sie contoso.com als Beispielmandant verwenden.

 

Ressourcen der obersten Ebene Abfrageergebnisse URI (für contoso.com)

Ressourcen der obersten Ebene

Gibt die URI-Liste der Ressourcen oberster Ebene für Verzeichnisdienste (siehe unten) zurück.

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

Unternehmensinformationen

Gibt Unternehmensinformationen zurück.

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

Kontakte

Gibt Kontaktinformationen zurück.

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

Benutzer

Gibt Benutzerinformationen zurück.

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

Gruppen

Gibt Gruppendaten zurück.

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

Roles

Gibt alle Rollen zurück, denen Benutzer oder Gruppen zugeordnet sind.

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

SubscribedSkus

Gibt die Abonnements des Mandanten zurück.

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

Verzeichnismetadaten

Gibt ein Dienstmetadatendokument zurück, das das Datenmodell beschreibt (d. h. die Struktur und Organisation von Verzeichnisressourcen).

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

Die folgenden allgemeinen Abfragen demonstrieren, wie Sie einen Abfragevorgang in Graph mithilfe von contoso.com als Beispielmandant ausführen.

 

Abfragevorgang URI (für contoso.com)

Auflisten aller Benutzer und Gruppen

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

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

Abrufen einzelner Benutzer durch Angabe von objectId oder 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

Anfordern und Herausfiltern eines Benutzers, dessen displayName "Jon Doe" ist

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

Anfordern und Herausfiltern bestimmter Benutzer, deren firstName "Jon" ist

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

Herausfiltern der Werte givenName und surname

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

Abrufen einzelner Gruppen durch Angabe von objectId

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

Abrufen des Vorgesetzten eines Benutzers

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

Abrufen einer Liste mit Mitarbeitern, die dem Benutzer direkt unterstellt sind

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

Abrufen einer Liste mit Links zu den direkt unterstellten Mitarbeitern eines Benutzers

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

Abrufen der Mitgliederliste einer Gruppe

https://graph.windows.net/contoso.com/groups/3f575eef-bb04-44a5-a9af-eee9f547e3f9/members?api-version=2013-04-05

Abrufen einer Liste von Links zu den Mitgliedern einer Gruppe

https://graph.windows.net/contoso.com/groups/3f575eef-bb04-44a5-a9af-eee9f547e3f9/$links/members?api-version=2013-04-05

Abrufen der Gruppenmitgliedschaft eines Benutzers (nicht transitiv)

https://graph.windows.net/contoso.com/users/ee6308f6-646a-4845-a4e1-57ac96ccc0c8/memberOf?api-version=2013-04-05

Abrufen einer Liste der Gruppen, denen der Benutzer als Mitglied angehört (nicht transitiv)

https://graph.windows.net/contoso.com/users/ee6308f6-646a-4845-a4e1-57ac96ccc0c8/$links/memberOf?api-version=2013-04-05

Anfordern und Herausfiltern von Gruppen, deren displayName => 'az' und <= 'dz’ ist

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

noteHinweis
Leerzeichen in der Abfragezeichenfolge sollten URL-codiert werden, bevor eine Anforderung gesendet wird. Die folgende Abfragezeichenfolge "https://graph.windows.net/contoso.com/Users?$filter=displayName eq 'Jon Doe'&api-version=2013-04-05" sollte z. B. wie folgt URL-codiert werden: https://graph.windows.net/contoso.com/Users?$filter=displayName%20eq%20'Jon%20Doe'&api-version=2013-04-05.

Siehe auch

Anzeigen:
© 2014 Microsoft