Table of contents

Graph API에서 엔터티 및 작업 처리Addressing Entities and Operations in the Graph API

Jimaco Brannian|마지막 업데이트: 2018-06-19
|
2 기고자

이 항목에서는 디렉터리 엔터티를 처리하고 디렉터리 함수를 호출하며 디렉터리에 대해 쿼리를 수행하거나, Azure AD Graph API를 사용하여 디렉터리 엔터티 및 리소스 집합에 대한 작업을 수행할 때 사용할 수 있는 다양한 처리 대안을 설명합니다.This topic discusses different addressing alternatives that you can use when addressing directory entities, calling directory functions, performing queries against the directory, or performing operations on directory entities and resource sets using Azure AD Graph API.특정 작업 또는 쿼리를 수행하고, 디렉터리 엔터티를 처리하거나, 함수를 호출하는 방법에 대한 자세한 내용은 Azure AD Graph API 참조 문서의 해당 작업 항목을 참조하십시오.For more detailed information about performing specific operations or queries, addressing directory entities, or calling functions, see the appropriate operations topic in the Azure AD Graph API reference documentation.

중요

Azure Active Directory 리소스에 액세스하려면 Azure AD Graph가 아닌 Microsoft Graph를 사용하는 것이 좋습니다.We strongly recommend that you use Microsoft Graph instead of Azure AD Graph API to access Azure Active Directory resources.우리는 현재 Microsoft Graph 개발에 집중하고 있으며 앞으로 Azure AD Graph API에 대한 개선 작업은 계획이 없습니다.Our development efforts are now concentrated on Microsoft Graph and no further enhancements are planned for Azure AD Graph API.아직까지 Azure AD Graph API가 적합할 수 있는 시나리오는 매우 제한적입니다. 자세한 내용은 Office 개발자 센터의 Microsoft Graph 또는 Azure AD Graph 블로그 게시물을 참조하십시오.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.

테넌트 처리Tenant Addressing

다음과 같은 3가지 방법 중 하나로 테넌트를 처리할 수 있습니다.You can address your tenant in one of three ways:

  • 테넌트 개체 ID 사용.By tenant object ID.이 ID는 테넌트가 만들어질 때 할당된 GUID이며,This is a GUID that was assigned when the tenant was created.TenantDetail 개체의 objectId 속성과 같습니다.It is equivalent to the objectId property of the TenantDetail object.https://graph.windows.net/12345678-9abc-def0-1234-56789abcde/?api-version=1.6 URL에는 개체 ID를 사용하여 테넌트 디렉터리의 최상위 리소스를 처리하는 방법이 나와 있습니다.The following URL shows how to address the top-level resources of a tenant’s directory by using the object ID: https://graph.windows.net/12345678-9abc-def0-1234-56789abcde/?api-version=1.6.

  • 확인된(등록된) 도메인 이름 사용.By verified (registered) domain name.테넌트에 대해 등록된 도메인 이름 중 하나입니다.This is one of the domain names that are registered for the tenant.TenantDetail 개체의 verifiedDomains 속성에서 찾을 수 있습니다.These can be found in the verifiedDomains property of the TenantDetail object.https://graph.windows.net/contoso.com/?api-version=1.6 URL에는 contoso.com이라는 도메인이 포함된 테넌트의 최상위 리소스를 처리하는 방법이 나와 있습니다.The following URL shows how to address the top-level resources of a tenant that has the domain contoso.com: https://graph.windows.net/contoso.com/?api-version=1.6.

  • “MyOrganization” 별칭 사용.By using the “MyOrganization” alias.이 별칭은 OAuth 인증 코드 권한 유형(3각) 인증을 사용할 때만 사용할 수 있습니다.This alias is only available when using OAuth Authorization Code Grant type (3-legged) authentication.이 별칭은 대/소문자를 구분하지 않으며,The alias is not case sensitive.URL에서 개체 ID 또는 테넌트 도메인을 바꿉니다.It replaces the object ID or tenant domain in the URL.이 별칭을 사용할 경우 Graph API가 요청에 연결된 토큰에 있는 클레임에서 테넌트를 파생시킵니다.When the alias is used, Graph API derives the tenant from the claims presented in the token attached to the request.다음 URL에는 이 별칭을 사용하여 테넌트의 최상위 리소스를 처리하는 방법이 나와 있습니다. https://graph.windows.net/myorganization/?api-version=1.6.The following URL shows how to address the top-level resources of a tenant using this alias: https://graph.windows.net/myorganization/?api-version=1.6.

  • “Me” 별칭 사용.By using the “Me” alias.이 별칭은 OAuth 인증 코드 권한 유형(3각) 인증을 사용할 때만 사용할 수 있습니다.This alias is only available when using OAuth Authorization Code Grant type (3-legged) authentication.이 별칭은 대/소문자를 구분하지 않으며,The alias is not case sensitive.URL에서 개체 ID 또는 테넌트 도메인을 바꿉니다.It replaces the object ID or tenant domain in the URL.이 별칭을 사용할 경우 Graph API가 요청에 연결된 토큰에 있는 클레임에서 사용자를 파생시킵니다.When the alias is used, Graph API derives the user from the claims presented in the token attached to the request.다음 URL은 현재 사용자의 전이적 그룹 멤버 자격을 반환하기 위한 getMemberGroups 함수를 호출하는 데 사용할 수 있습니다. https://graph.windows.net/me/getMemberGroups?api-version=1.6.The following URL can be used to call the getMemberGroups function to return the transitive group memberships of the current user: https://graph.windows.net/me/getMemberGroups?api-version=1.6.(참고: POST 요청과 함께 요청 본문도 제공해야 합니다.)(Note: a request body must also be supplied with the POST request.)

참고 항목See Also

Azure AD Graph API에서 지원되는 쿼리, 필터 및 페이징 옵션Azure AD Graph API Supported Queries, Filters, and Paging Options

REST API 참조Azure AD Graph REST API Reference

© 2018 Microsoft