匯出 (0) 列印
全部展開
本主題尚未接受評分 - 為這個主題評分

Windows Azure AD Graph 常用查詢

更新日期: 2013年8月

本主題列出可以搭配 Windows Azure AD Graph 使用的常用查詢。

下列所有查詢皆使用網域名稱定址租用戶。您可以用您的租用戶所註冊的其中一個網域名稱取代 “contoso.com”,以成功針對您的訂用帳戶執行查詢。如需租用戶其他定址方式的資訊,請參閱<Addressing Entities and Operations in the Graph>。

 

最上層資源 查詢結果 URI (針對 contoso.com)

最上層資源

為目錄服務傳回最上層資源的 URI 清單 (也列於下方)

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

公司資訊

傳回公司資訊

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

連絡人

傳回連絡資訊

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

使用者

傳回使用者資訊

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

群組

傳回群組資料

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

角色

傳回有指派使用者或群組的所有角色

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

SubscribedSkus

傳回租用戶的訂用帳戶

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

目錄中繼資料

傳回描述資料模型的服務中繼資料檔案 (也就是目錄資源的結構和組織)

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

 

查詢作業 URI (針對 contoso.com)

列出所有使用者和群組

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

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

透過指定 objectId 或 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

要求並篩選具有與 “Jon Doe” 相符之 displayName 的使用者

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

要求並篩選具有與“Jon”相符之 firstName 的特定使用者

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

篩選 givenName 和姓氏值。

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

透過指定 objectId 擷取個別群組

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

擷取使用者的管理員

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

擷取使用者的直屬員工清單

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

擷取使用者的直屬員工連結清單

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

擷取群組的成員資格清單

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

擷取群組成員的連結清單。

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

擷取使用者的群組成員資格 (不轉移)

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

擷取使用者為群組成員的群組清單 (不轉移)

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

要求和篩選附帶 displayName=> 'az' 以及 < = 'dz' 的群組

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

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

Windows Azure AD 支援下列查詢選項:$filter 和 $top。(目前不支援下列查詢選項:$count、$expand、$format、$inlinecount、$orderby 及 $skip。)

下列一般限制適用於包含篩選的查詢。

  • 篩選不受 角色SubscribedSku 目錄物件的查詢所支援。

  • 並非所有支援目錄物件的屬性都能夠用於篩選運算式。如需支援類型的可篩選屬性之資訊,請參閱<使用者>、<群組>以及<連絡人>。

  • 篩選查詢不支援分頁。只傳回了第一組 N 結果,其中 N 為預設頁面大小 (100) 或用戶端指定的頁面大小 (介於 1 到 999 之間)。

下列限制適用於篩選運算式。

  • 邏輯運算子:支援 and,不支援 or

  • 比較運算子:支援 eq (等於)、ge (大於或等於),以及 le (小於或等於)。

  • 算術運算子:不支援。

  • 函數:不支援。

  • 不支援 null 值做為篩選運算式中的運算元。例如,您無法指定 null 值來篩選未設定的屬性。

$top 不支援 角色SubscribedSku 目錄物件上的查詢。

  • 預設頁面大小為 100。頁面大小上限為 999。

  • 對角色的查詢不支援分頁。這包括自行讀取角色物件及角色成員。

  • 資源清單,如總括/使用者查詢 (https://graph.windows.net/contoso.com/users?api-version=2013-04-05),確實支援分頁。但是在所有類型中套用篩選時,不會支援分頁且只會傳回結果的第一頁。

  • 分頁不支援連結搜尋;例如,搜尋群組成員 (https://graph.windows.net/contoso.com/groups/3f575eef-bb04-44a5-a9af-eee9f547e3f9/$links/members?api-version=2013-04-05)。

  • Windows Azure AD Graph 不支援 $orderby 查詢選項。因此,您無法指定查詢結果的排序方式。

  • 所有使用者皆適用的查詢結果組 (https://graph.windows.net/contoso.com/users?api-version=2013-04-05) 會根據 UserPrincipalName 屬性排序。

  • 其他所有最上層資源皆適用的查詢結果組,例如群組 (https://graph.windows.net/contoso.com/groups?api-version=2013-04-05)、連絡人 (https://graph.windows.net/contoso.com/contacts?api-version=2013-04-05) 等等,會根據 objectId 屬性排序。

  • 除了最上層資源以外的查詢結果順序皆不明確。

另請參閱

本文對您有任何幫助嗎?
(剩餘 1500 個字元)
感謝您提供意見
顯示:
© 2014 Microsoft. 著作權所有,並保留一切權利。