Graph API vanliga frågor
Det här avsnittet beskrivs några vanliga frågor som kan utföras med Azure AD Graph API. Mer information om de åtgärder som stöds när du frågar diagrammet finns stöd för frågor, filter och växling alternativ i Azure AD Graph API.
Viktigt
Vi rekommenderar starkt att du använder Microsoft Graph i stället för Azure AD Graph API för att komma åt resurser i Azure Active Directory. Vårt utvecklingsarbete är nu samlade på Microsoft Graph och inga fler förbättringar som planeras att Azure AD Graph API. Det finns ett begränsat antal scenarier som Azure AD Graph API kan fortfarande vara lämplig. Mer information finns i Microsoft Graph eller Azure AD Graph blogginlägget i Office Dev Center.
Adressering
Frågorna nedan alla hantera klienten med ett domännamn. Du kan ersätta contoso.com med ett registrerat domännamn för din klient, med din klient-ID (GUID) eller med den MyOrganization alias (för delegerad åtkomst). Information om andra sätt att adressera klienten finns i adressering entiteter och åtgärder i Graph API.
Förfrågan efter resurser på den översta nivån
Följande vanliga frågor visar hur du kommer åt resurser på den översta nivån med Graph-API med hjälp av contoso.com som exempel innehavare. Observera att ett Authorization-huvud som innehåller ett giltigt ägartoken som tas emot från Azure AD kommer att behöva köra frågor mot en klient.
| Översta resurs | Frågeresultat | URI: N (för contoso.com) |
|---|---|---|
| Översta resurser | Returnerar URI lista över de översta resurserna för directory services (även nedan) | https://graph.windows.net/contoso.com?api-version=1.6 |
| Företagsinformation | Returnerar företagsinformation | https://graph.windows.net/contoso.com/tenantDetails?api-version=1.6 |
| Kontakter | Returnerar organisationens kontaktinformation | https://graph.windows.net/contoso.com/contacts?api-version=1.6 |
| Användare | Returnerar information om användare | https://graph.windows.net/contoso.com/users?api-version=1.6 |
| Grupper | Returnerar gruppera data | https://graph.windows.net/contoso.com/groups?api-version=1.6 |
| I katalogen | Returnerar alla aktiverade directory roller i klienten | https://graph.windows.net/contoso.com/roles?api-version=1.6 |
| SubscribedSkus | Returnerar klientens prenumerationer | https://graph.windows.net/contoso.com/subscribedSkus?api-version=1.6 |
| Directory metadata | Returnerar ett tjänstdokument Metadata som beskriver datamodellen (det vill säga struktur och organisation för directory-resurser) | https://graph.windows.net/contoso.com/$metadata?api-version=1.6 |
Frågor
I följande tabell visas några exempel Graph API-frågor med med contoso.com som exempel innehavaren.
| Frågeåtgärden | URI: N (för contoso.com) |
|---|---|
| Visa en lista över alla användare och grupper | https://graph.windows.net/contoso.com/users?api-version=1.6 https://graph.windows.net/contoso.com/groups?api-version=1.6 |
| Hämta enskilda användare genom att ange objectId eller 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 |
| Begära och filtrera efter en användare med displayName som är lika med ”Jon Berg” | https://graph.windows.net/contoso.com/Users?$filter=displayName eq 'Jon Doe'&api-version=1.6 |
| Begära och filtrera efter specifika användare med förnamn som är lika med ”jan” | https://graph.windows.net/contoso.com/users?$filter=givenName eq 'Jon'&api-version=1.6 |
| Filtrera efter givenName och efternamn värden. | https://graph.windows.net/contoso.com/users?$filter=givenName eq 'Jon' and surname eq 'Doe'&api-version=1.6 |
| Hämta enskilda grupp genom att ange objekt-ID | https://graph.windows.net/contoso.com/groups/06790a81-0382-434c-b40e-216fa41bda21?api-version=1.6 |
| Hämta en användares chef | https://graph.windows.net/contoso.com/users/John.Smith@contoso.com/manager?api-version=1.6 |
| Hämta en användares direktrapporter lista | https://graph.windows.net/contoso.com/users/3c4a09b0-a7b6-444e-9702-96983635a66e/directReports?api-version=1.6 |
| Hämta en lista med länkar till en användares direktrapporter | https://graph.windows.net/contoso.com/users/3c4a09b0-a7b6-444e-9702-96983635a66e/$links/directReports?api-version=1.6 |
| Hämta listan över en grupp gruppmedlemskap | https://graph.windows.net/contoso.com/groups/3f575eef-bb04-44a5-a9af-eee9f547e3f9/members?api-version=1.6 |
| Hämta en lista med länkar till medlemmar i en grupp. | https://graph.windows.net/contoso.com/groups/3f575eef-bb04-44a5-a9af-eee9f547e3f9/$links/members?api-version=1.6 |
| Hämta en användares gruppmedlemskap (inte transitiva) | https://graph.windows.net/contoso.com/users/ee6308f6-646a-4845-a4e1-57ac96ccc0c8/memberOf?api-version=1.6 |
| Hämta en lista över de grupper som användaren är medlem i (inte transitiva) | https://graph.windows.net/contoso.com/users/ee6308f6-646a-4845-a4e1-57ac96ccc0c8/$links/memberOf?api-version=1.6 |
| Begära och filtrera efter grupper med displayName > = ”az” och < = ”dz” | https://graph.windows.net/contoso.com/groups?$filter=displayName ge 'az' and displayName le 'dz'&api-version=1.6 |
Obs: blanksteg i frågesträngen ska vara URL-kodade innan du skickar en begäran. Till exempel följande frågesträng, https://graph.windows.net/contoso.com/Users?$filter=displayName eq 'Jon Doe'&api-version=1.6, bör vara URL-kodade som: https://graph.windows.net/contoso.com/Users?$filter=displayName%20eq%20'Jon%20Doe'&api-version=1.6.