Table of contents

Graph API의 일반적인 쿼리

Jimaco Brannian|마지막 업데이트: 2016-08-22
|
1 기고자

이 항목에서는 Azure AD Graph API로 수행할 수 있는 몇 가지 일반적인 쿼리를 보여 줍니다. Graph를 쿼리할 때 지원되는 작업에 대한 자세한 내용은 Azure AD Graph API에서 지원되는 쿼리, 필터 및 페이징 옵션을 참조하십시오.

중요: Azure AD Graph API 기능은 단일 액세스 토큰으로 단일 끝점을 통해 모두 액세스되는 Outlook, OneDrive, OneNote, Planner 및 Office Graph와 같은 다른 Microsoft 서비스의 API도 포함하는 통합 API인 Microsoft Graph를 통해서도 사용할 수 있습니다.

주소 지정

아래의 쿼리는 모두 도메인 이름을 사용하여 테넌트의 주소를 지정합니다. contoso.com을 테넌트의 등록된 도메인 이름 중 하나, 테넌트의 ID(GUID) 또는 MyOrganization 별칭(위임된 액세스의 경우)으로 바꿀 수 있습니다. 테넌트의 주소를 지정하는 다른 방법에 대한 내용은 Graph API에서 엔터티 및 작업 처리를 참조하십시오.

최상위 리소스 쿼리

다음 쿼리는 contoso.com을 테넌트 예로 사용하여 Graph API로 최상위 리소스에 액세스하는 방법을 보여 줍니다. 테넌트에 대해 쿼리를 실행하려면 Azure AD에서 받은 유효한 전달자 토큰을 포함하는 Authorization 헤더가 필요합니다.

최상위 리소스쿼리 결과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
Groups그룹 데이터를 반환합니다.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
displayName이 “Jon Doe”인 사용자에 대한 요청 및 필터링https://graph.windows.net/contoso.com/Users?$filter=displayName eq 'Jon Doe'&api-version=1.6
firstName이 “Jon”인 특정 사용자에 대한 요청 및 필터링https://graph.windows.net/contoso.com/users?$filter=givenName eq 'Jon'&api-version=1.6
givenName 및 surname 값에 대한 필터링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" and <= "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.6https://graph.windows.net/contoso.com/Users?$filter=displayName%20eq%20'Jon%20Doe'&api-version=1.6과 같이 URL로 인코딩되어야 합니다.

© 2017 Microsoft