사용자 검색
적용 대상: Windows Azure Pack
사용자를 검색합니다.
요청
ServiceMgmt를> 서비스 관리 API 엔드포인트 주소로 바꿉니다<. 포트>를 테넌트 API의 경우 30005 또는 관리자 API의 경우 30004로 바꿉<다. UserName을> 사용자 이름으로 바꿉<습니다.
메서드 |
요청 URI |
HTTP 버전 |
|---|---|---|
GET |
<https:// ServiceMgmt>:<Port>/users/<UserName> |
HTTP/1.1 |
URI 매개 변수
없음.
요청 헤더
다음 표에서는 필수 요청 헤더와 선택적 요청 헤더에 대해 설명합니다.
요청 헤더 |
Description |
|---|---|
권한 부여: 전달자 |
필수 요소. 권한 부여 전달자 토큰입니다. |
x-ms-principal-id |
필수 요소. 보안 주체 식별자입니다. |
x-ms-client-request-id |
(선택 사항) 클라이언트 요청 식별자입니다. |
x-ms-client-session-id |
(선택 사항) 클라이언트 세션 식별자입니다. |
x-ms-principal-liveid |
(선택 사항) 보안 주체 라이브 식별자입니다. |
요청 본문
없음.
응답
응답에는 HTTP 상태 코드, 응답 헤더 집합 및 응답 본문이 포함되어 있습니다.
상태 코드
작업에 성공하면 상태 코드 200(정상)이 반환됩니다.
상태 코드에 대한 자세한 내용은 상태 및 오류 코드(Windows Azure Pack Service Management)를 참조하세요.
응답 헤더
이 작업에 대한 응답에는 표준 HTTP 헤더가 포함됩니다. 모든 표준 헤더는 HTTP/1.1 프로토콜 사양을 따릅니다.
응답 본문
다음 표에서는 응답 본문의 주요 요소에 대해 설명합니다.
요소 이름 |
Description |
|---|---|
사용자 |
검색된 사용자입니다. 자세한 내용은 User(Common 개체)를 참조하세요. |
예제
다음 코드 예제에서는 사용자 가져오기 요청을 보여줍니다.
GET https://<computer>:30004/users/tom@tommy.com HTTP/1.1
Authorization: Bearer <token>
x-ms-client-request-id: 137c6d49-4740-42c0-a8a2-db24f34d9da1-2013-06-19 20:55:55Z
x-ms-client-session-id: d7401833-b959-4ac7-adba-c8b9d5c26326
x-ms-principal-id: <computer>\Administrator
Accept-Language: en-US
x-ms-principal-liveid: <computer>\Administrator
Host: <computer>:30004
다음 코드 예제에서는 사용자 가져오기 응답을 보여줍니다.
{
"Name": "tom@tommy.com",
"Email": "Tom@tommy.com",
"State": 1,
"CreatedTime": "2013-06-19T17:09:45.387",
"SubscriptionCount": 1,
"ActivationSyncState": 0,
"LastErrorMessage": null
}