Table of contents

在 Graph API 中將實體和作業定址

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

本主題討論在使用 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。 其等同於 TenantDetail 物件的 objectId 屬性。 下列 URL 顯示如何使用物件識別碼來處理租用戶目錄的上層資源:https://graph.windows.net/12345678-9abc-def0-1234-56789abcde/?api-version=1.6

  • 依驗證 (登錄) 的網域名稱。 這是針對租用戶登錄的其中一個網域名稱。 這些可以在 TenantDetail 物件的 verifieddomains 屬性中找到。 下列 URL 顯示如何處理具有網域 contoso.com 之租用戶的上層資源:https://graph.windows.net/contoso.com/?api-version=1.6

  • 透過使用 "MyOrganization" 別名。 此別名只有在使用 OAuth 授權碼授與類型 (3-Legged) 驗證時才可使用。 別名不區分大小寫。 可取代 URL 中的物件識別碼或租用戶網域。 使用別名時,Graph API 會從附加至要求之權杖中呈現的宣告來衍生租用戶。 下列 URL 顯示如何處理使用此別名之租用戶的上層資源:https://graph.windows.net/myorganization/?api-version=1.6

  • 透過使用 “Me” 別名。 此別名只有在使用 OAuth 授權碼授與類型 (3-Legged) 驗證時才可使用。 別名不區分大小寫。 可取代 URL 中的物件識別碼或租用戶網域。 使用別名時,Graph API 會從附加至要求之權杖中呈現的宣告來衍生使用者。 下列 URL 可用於呼叫 getMemberGroups 函數,以傳回目前使用者所能移轉的群組成員資格︰https://graph.windows.net/me/getMemberGroups?api-version=1.6。 (注意:要求主體也必須與 POST 要求一起提供。)

另請參閱

Azure AD Graph API 支援的查詢、篩選和分頁選項

Azure AD Graph REST API 參考

© 2017 Microsoft