알림에 대한 구독 검색
적용 대상: Windows Azure Pack
서비스 관리 API에서 구독 정보를 검색하는 데 사용됩니다.
요청
NotificationEndpoint>를 Windows Azure Pack 사용자 지정 리소스 공급자 알림 REST API의 엔드포인트 주소로 바꿉<니다. ID>를 검색할 구독의 식별자로 바꿉<니다.
메서드 |
요청 URI |
HTTP 버전 |
|---|---|---|
GET |
<http:// NotificationEndpoint>/subscriptions/<Id> |
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 |
|---|---|
Subscription |
검색된 구독입니다. 자세한 내용은 구독(알림 엔드포인트 개체)을 참조하세요. |
예제
다음 예제에서는 알림 요청에 대한 구독 검색을 보여줍니다.
GET https://<NotificationEndpoint>:30010/subscriptions/ec66ec96-8edd-4916-be45-607959155c2a HTTP/1.1
Referer: https://<Computer>:30004/subscriptions/ec66ec96-8edd-4916-be45-607959155c2a
Accept-Language: en-US
x-ms-client-request-id: ef2c5d93-a957-439b-9210-de52107322c1-2014-07-09 23:45:22Z
x-ms-client-session-id: a519f0aa-53e9-4522-94fd-3c55607a6b65
x-ms-principal-id: <Computer>%5cAdministrator
x-ms-request-id: 684b6822d29e4aac96fe45110881e525.2014-07-09T23:45:24.2267567Z
Authorization: Basic <encoded username and password>
Content-Type: application/json; charset=utf-8
Host: <Computer>:30010
Content-Length: 0
Expect: 100-continue
다음 코드 예제에서는 알림에 대한 구독 검색에 대한 JSON 응답을 보여줍니다.
{
"SubscriptionId": "ec66ec96-8edd-4916-be45-607959155c2a",
"SubscriptionName": null,
"State": 1,
"LifecycleState": 0,
"LastErrorMessage": null,
"QuotaSettings": [
{
"Key": "Editions",
"Value": "[{\"displayName\":\"Default\",\"groupName\":\"Default\",\"resourceCount\":\"10\",\"resourceSize\":\"1024\",\"resourceSizeLimit\":\"0\",\"offerEditionId\":\"32814080310\",\"groupType\":\"Shared\"}]"
}
],
"AdminId": "notauser@contoso.com",
"CoAdminIds": [
]
}
설명
QuotaSettings 속성은 응답에 채워져야 합니다.
리소스 공급자가 비동기 구독 작업을 사용하는 경우 리소스 공급자는 비동기 작업에서 202를 반환하고, TBD는 서비스 관리 API에 의해 10초마다 호출되어 작업이 완료되었는지 확인합니다.
TBD는 Windows Azure Pack 버전 1에서 시스템 업그레이드 중에 사용됩니다.