Graph API běžné dotazy
Toto téma ukazuje některé běžné dotazy, které lze provést pomocí rozhraní Azure AD Graph API. Další informace o podporovaných operacích při dotazu na graf najdete v části podporované dotazy, filtrů a možností stránkování v Azure AD Graph API.
Důležité
Důrazně doporučujeme použít Microsoft Graph místo Azure AD Graph API pro přístup k prostředkům Azure Active Directory. Náš vývojový program jsou nyní soustředit na Microsoft Graph a dále jsou plánované pro Azure AD Graph API. Je velmi omezený počet scénářů, pro které Azure AD Graph API může být vhodné; Další informace najdete v tématu Microsoft Graph nebo Azure AD Graph příspěvku na blogu v Office Dev Center.
Adresování
Dotazy níže všechny adres klienta pomocí názvu domény. Můžete nahradit contoso.com s jedním z vašeho klienta registrovaných doménách, s ID vašeho klienta (GUID) nebo pomocí MyOrganization
alias (pro delegovaný přístup). Informace o jiných způsobech adres klienta najdete v tématu adresování entity a operace v rozhraní Graph API.
Dotaz na nejvyšší úrovni prostředky
Následující běžné dotazy ukazují, jak získat přístup k prostředkům nejvyšší úrovně s použitím contoso.com jako příklad klienta rozhraní Graph API. Všimněte si, že hlavičku autorizace obsahující platné nosný token přijatého z Azure AD bude nutné ke spouštění dotazů na klienta.
Nejvyšší úrovně prostředků | Výsledky dotazu | Identifikátor URI (contoso.com) |
---|---|---|
Nejvyšší úrovně prostředky | Vrátí seznam URI nejvyšší úrovně prostředků pro directory services (také uvedené níže) | https://graph.windows.net/contoso.com?api-version=1.6 |
Informace o společnosti | Vrátí společnosti informace | https://graph.windows.net/contoso.com/tenantDetails?api-version=1.6 |
Kontakty | Vrátí organizační kontaktní informace | https://graph.windows.net/contoso.com/contacts?api-version=1.6 |
Uživatelé | Vrátí informace o uživateli | https://graph.windows.net/contoso.com/users?api-version=1.6 |
skupiny | Vrátí seskupení dat | https://graph.windows.net/contoso.com/groups?api-version=1.6 |
Role adresáře | Vrátí všechny role aktivovaný adresáře v klientovi | https://graph.windows.net/contoso.com/roles?api-version=1.6 |
SubscribedSkus | Vrátí odběry klienta | https://graph.windows.net/contoso.com/subscribedSkus?api-version=1.6 |
Metadat adresáře | Vrátí Metadata dokument služby, který popisuje datový model (to znamená, struktura a organizace prostředky adresáře) | https://graph.windows.net/contoso.com/$metadata?api-version=1.6 |
Operace dotazů
Následující tabulka uvádí některé ukázkové dotazy rozhraní Graph API pomocí pomocí contoso.com jako příklad klienta.
Operace dotazů | Identifikátor URI (contoso.com) |
---|---|
Zobrazí seznam všech uživatelů a skupin | https://graph.windows.net/contoso.com/users?api-version=1.6 https://graph.windows.net/contoso.com/groups?api-version=1.6 |
Zadáním objectId nebo userPrincipalName načíst jednotlivé uživatele | 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 |
Vyžádat a filtrování pro uživatele se zobrazovaným názvem rovno "Jan Doe" | https://graph.windows.net/contoso.com/Users?$filter=displayName eq 'Jon Doe'&api-version=1.6 |
Vyžádat a filtrování pro konkrétní uživatele s firstName rovno "Jan" | https://graph.windows.net/contoso.com/users?$filter=givenName eq 'Jon'&api-version=1.6 |
Filtr pro hodnoty givenName a příjmení. | https://graph.windows.net/contoso.com/users?$filter=givenName eq 'Jon' and surname eq 'Doe'&api-version=1.6 |
Načtení jednotlivé skupiny zadáním objectId | https://graph.windows.net/contoso.com/groups/06790a81-0382-434c-b40e-216fa41bda21?api-version=1.6 |
Načtení správce uživatele | https://graph.windows.net/contoso.com/users/John.Smith@contoso.com/manager?api-version=1.6 |
Načtení seznamu uživatele přímé podřízené | https://graph.windows.net/contoso.com/users/3c4a09b0-a7b6-444e-9702-96983635a66e/directReports?api-version=1.6 |
Načtení seznamu odkazů na uživatele přímé podřízené | https://graph.windows.net/contoso.com/users/3c4a09b0-a7b6-444e-9702-96983635a66e/$links/directReports?api-version=1.6 |
Načtení seznamu členství ve skupině | https://graph.windows.net/contoso.com/groups/3f575eef-bb04-44a5-a9af-eee9f547e3f9/members?api-version=1.6 |
Načtení seznamu odkazů na členy skupiny. | https://graph.windows.net/contoso.com/groups/3f575eef-bb04-44a5-a9af-eee9f547e3f9/$links/members?api-version=1.6 |
Načíst uživatele členství ve skupině (není přenositelné) | https://graph.windows.net/contoso.com/users/ee6308f6-646a-4845-a4e1-57ac96ccc0c8/memberOf?api-version=1.6 |
Načtení seznamu skupin, že uživatel je členem skupiny (není přenositelné) | https://graph.windows.net/contoso.com/users/ee6308f6-646a-4845-a4e1-57ac96ccc0c8/$links/memberOf?api-version=1.6 |
Vyžádat a filtrování pro skupiny se zobrazovaným názvem > = "az" a < = "dz" | https://graph.windows.net/contoso.com/groups?$filter=displayName ge 'az' and displayName le 'dz'&api-version=1.6 |
Poznámka:: prázdné znaky v řetězci dotazu by měla být kódovaná adresou URL před odesláním požadavku. Například následující dotaz řetězci https://graph.windows.net/contoso.com/Users?$filter=displayName eq 'Jon Doe'&api-version=1.6
, by měl být kódovaná v řetězci URL jako: https://graph.windows.net/contoso.com/Users?$filter=displayName%20eq%20'Jon%20Doe'&api-version=1.6
.