Table of contents

Graph API 常用查詢

Jimaco Brannian|上次更新日期: 2016/8/22
|
1 投稿人

本主題顯示可以搭配 Azure AD Graph API 執行的常用查詢。 如需在查詢 Graph 時支援作業的詳細資訊,請參閱<Supported Queries, Filters, and Paging Options in Azure AD Graph API> (Azure AD Graph API 中的支援的查詢、篩選和分頁選項)。

重要:您也可以透過 Microsoft Graph 取得 Azure AD Graph API 功能,這個統一 API 同時也包含如 Outlook、OneDrive、OneNote、Planner 和 Office Graph 等其他 Microsoft 服務 API,讓您可以使用單一的存取權杖透過單一端點存取所有 API。

定址

下列所有查詢皆使用網域名稱定址租用戶。 您可以使用其中一個租用戶的已註冊網域名稱、您的租用戶識別碼 (GUID),或 MyOrganization 別名 (適用於委派存取) 來取代 contoso.com 。 如需其他定址租用戶方式的資訊,請參閱< Addressing Entities and Operations in the Graph API> (定址 Graph API 中的實體和作業)。

查詢最上層資源

下列常用查詢示範如何使用 contoso.com 作為範例租用戶以 Graph 存取最上層資源。 請注意,對租用戶執行查詢時需要包含 Azure AD 有效持有人權杖的授權標頭。

最上層資源查詢結果URI (針對 contoso.com)
最上層資源為目錄服務傳回最上層資源的 URI 清單 (也列於下方)https://graph.windows.net/contoso.com?api-version=1.6
公司資訊傳回公司資訊https://graph.windows.net/contoso.com/tenantDetails?api-version=1.6
連絡人傳回組織的連絡人資訊https://graph.windows.net/contoso.com/contacts?api-version=1.6
Users傳回使用者資訊https://graph.windows.net/contoso.com/users?api-version=1.6
傳回群組資料https://graph.windows.net/contoso.com/groups?api-version=1.6
目錄角色傳回租用戶中所有已啟用的目錄角色https://graph.windows.net/contoso.com/roles?api-version=1.6
SubscribedSkus傳回租用戶的訂用帳戶https://graph.windows.net/contoso.com/subscribedSkus?api-version=1.6
目錄中繼資料傳回描述資料模型的服務中繼資料檔案 (也就是目錄資源的結構和組織)https://graph.windows.net/contoso.com/$metadata?api-version=1.6

查詢作業

下表顯示一些範例,使用 contoso.com 作為範例租用戶的 Graph API 查詢。

查詢作業URI (針對 contoso.com)
列出所有使用者和群組https://graph.windows.net/contoso.com/users?api-version=1.6

https://graph.windows.net/contoso.com/groups?api-version=1.6
透過指定 objectId 或 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
要求並篩選具有與 “Jon Doe” 相符之 displayName 的使用者https://graph.windows.net/contoso.com/Users?$filter=displayName eq 'Jon Doe'&api-version=1.6
要求並篩選具有與“Jon”相符之 firstName 的特定使用者https://graph.windows.net/contoso.com/users?$filter=givenName eq 'Jon'&api-version=1.6
篩選 givenName 和姓氏值。https://graph.windows.net/contoso.com/users?$filter=givenName eq 'Jon' and surname eq 'Doe'&api-version=1.6
透過指定 objectId 擷取個別群組https://graph.windows.net/contoso.com/groups/06790a81-0382-434c-b40e-216fa41bda21?api-version=1.6
擷取使用者的管理員https://graph.windows.net/contoso.com/users/John.Smith@contoso.com/manager?api-version=1.6
擷取使用者的直屬員工清單https://graph.windows.net/contoso.com/users/3c4a09b0-a7b6-444e-9702-96983635a66e/directReports?api-version=1.6
擷取使用者的直屬員工連結清單https://graph.windows.net/contoso.com/users/3c4a09b0-a7b6-444e-9702-96983635a66e/$links/directReports?api-version=1.6
擷取群組的成員資格清單https://graph.windows.net/contoso.com/groups/3f575eef-bb04-44a5-a9af-eee9f547e3f9/members?api-version=1.6
擷取群組成員的連結清單。https://graph.windows.net/contoso.com/groups/3f575eef-bb04-44a5-a9af-eee9f547e3f9/$links/members?api-version=1.6
擷取使用者的群組成員資格 (不轉移)https://graph.windows.net/contoso.com/users/ee6308f6-646a-4845-a4e1-57ac96ccc0c8/memberOf?api-version=1.6
擷取使用者為群組成員的群組清單 (不轉移)https://graph.windows.net/contoso.com/users/ee6308f6-646a-4845-a4e1-57ac96ccc0c8/$links/memberOf?api-version=1.6
要求和篩選附帶 displayName >= "az" 以及 <= "dz" 的群組https://graph.windows.net/contoso.com/groups?$filter=displayName ge 'az' and displayName le 'dz'&api-version=1.6

注意:查詢字串的空白需在傳送要求之前以 URL 編碼。 例如,下列查詢字串 https://graph.windows.net/contoso.com/Users?$filter=displayName eq 'Jon Doe'&api-version=1.6 應以 URL 編碼為:https://graph.windows.net/contoso.com/Users?$filter=displayName%20eq%20'Jon%20Doe'&api-version=1.6

© 2017 Microsoft