Table of contents

Graph API běžné dotazyGraph API Common Queries

Jimaco Brannian|Poslední aktualizace: 19. 6. 2018
|
1 Přispěvatel

Toto téma ukazuje některé běžné dotazy, které lze provést pomocí rozhraní Azure AD Graph API.This topic shows some common queries that can be performed with the 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.For more information about supported operations when querying the Graph, see Supported Queries, Filters, and Paging Options in 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.We strongly recommend that you use Microsoft Graph instead of Azure AD Graph API to access Azure Active Directory resources.Náš vývojový program jsou nyní soustředit na Microsoft Graph a dále jsou plánované pro Azure AD Graph API.Our development efforts are now concentrated on Microsoft Graph and no further enhancements are planned for 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.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.

AdresováníAddressing

Dotazy níže všechny adres klienta pomocí názvu domény.The queries below all address the tenant using a domain name.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).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).Informace o jiných způsobech adres klienta najdete v tématu adresování entity a operace v rozhraní Graph API.For information about other ways of addressing the tenant, see Addressing Entities and Operations in the Graph API.

Dotaz na nejvyšší úrovni prostředkyQuerying Top-Level Resources

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

Nejvyšší úrovně prostředkůTop-Level ResourceVýsledky dotazuQuery ResultsIdentifikátor URI (contoso.com)URI (for contoso.com)
Nejvyšší úrovně prostředkyTop-level resourcesVrátí seznam URI nejvyšší úrovně prostředků pro directory services (také uvedené níže)Returns URI list of the top-level resources for directory services (also listed below)https://graph.windows.net/contoso.com?api-version=1.6
Informace o společnostiCompany informationVrátí společnosti informaceReturns company informationhttps://graph.windows.net/contoso.com/tenantDetails?api-version=1.6
KontaktyContactsVrátí organizační kontaktní informaceReturns organizational contact informationhttps://graph.windows.net/contoso.com/contacts?api-version=1.6
UživateléUsersVrátí informace o uživateliReturns user informationhttps://graph.windows.net/contoso.com/users?api-version=1.6
skupinyGroupsVrátí seskupení datReturns group datahttps://graph.windows.net/contoso.com/groups?api-version=1.6
Role adresářeDirectory RolesVrátí všechny role aktivovaný adresáře v klientoviReturns all activated directory roles in the tenanthttps://graph.windows.net/contoso.com/roles?api-version=1.6
SubscribedSkusSubscribedSkusVrátí odběry klientaReturns the tenant's subscriptionshttps://graph.windows.net/contoso.com/subscribedSkus?api-version=1.6
Metadat adresářeDirectory metadataVrátí Metadata dokument služby, který popisuje datový model (to znamená, struktura a organizace prostředky adresáře)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

Operace dotazůQuery Operations

Následující tabulka uvádí některé ukázkové dotazy rozhraní Graph API pomocí pomocí contoso.com jako příklad klienta.The following table shows some example Graph API queries using using contoso.com as the example tenant.

Operace dotazůQuery OperationIdentifikátor URI (contoso.com)URI (for contoso.com)
Zobrazí seznam všech uživatelů a skupinList 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
Zadáním objectId nebo userPrincipalName načíst jednotlivé uživateleRetrieve 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
Vyžádat a filtrování pro uživatele se zobrazovaným názvem rovno "Jan 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
Vyžádat a filtrování pro konkrétní uživatele s firstName rovno "Jan"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
Filtr pro hodnoty givenName a příjmení.Filter for givenName and surname values.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 objectIdRetrieve individual group by specifying the objectIdhttps://graph.windows.net/contoso.com/groups/06790a81-0382-434c-b40e-216fa41bda21?api-version=1.6
Načtení správce uživateleRetrieve a user’s managerhttps://graph.windows.net/contoso.com/users/John.Smith@contoso.com/manager?api-version=1.6
Načtení seznamu uživatele přímé podřízenéRetrieve a user’s direct reports listhttps://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éRetrieve 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
Načtení seznamu členství ve skupiněRetrieve membership list of a grouphttps://graph.windows.net/contoso.com/groups/3f575eef-bb04-44a5-a9af-eee9f547e3f9/members?api-version=1.6
Načtení seznamu odkazů na členy skupiny.Retrieve 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
Načíst uživatele členství ve skupině (není přenositelné)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
Načtení seznamu skupin, že uživatel je členem skupiny (není přenositelné)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
Vyžádat a filtrování pro skupiny se zobrazovaným názvem > = "az" a < = "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

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.Note: White space in the query string should be URL-encoded before sending a request.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.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