알림에 대한 구독 만들기
적용 대상: Windows Azure Pack
서비스 관리 API에서 계획에 대한 구독이 생성되고 있음을 리소스 공급자에게 알리는 데 사용됩니다. 제공된 구독 개체는 리소스 공급자가 새 구독을 내부적으로 처리하는 데 사용할 수 있는 정보를 제공합니다.
요청
NotificationEndpoint>를 Windows Azure Pack 사용자 지정 리소스 공급자 알림 REST API의 엔드포인트 주소로 바꿉<니다.
메서드 |
요청 URI |
HTTP 버전 |
|---|---|---|
POST |
<http:// NotificationEndpoint>/subscriptions |
HTTP/1.1 |
URI 매개 변수
없음.
요청 헤더
다음 표에서는 필수 요청 헤더와 선택적 요청 헤더에 대해 설명합니다.
요청 헤더 |
Description |
|---|---|
권한 부여: 기본 |
필수 요소. 기본 권한 부여 토큰입니다. |
x-ms-principal-id |
필수 요소. 보안 주체 식별자입니다. |
x-ms-client-request-id |
(선택 사항) 클라이언트 요청 식별자입니다. |
x-ms-client-session-id |
(선택 사항) 클라이언트 세션 식별자입니다. |
x-ms-principal-liveid |
(선택 사항) 보안 주체 라이브 식별자입니다. |
요청 본문
다음 표에서는 요청 본문의 요소에 대해 설명합니다.
요소 이름 |
Description |
|---|---|
Subscription |
만들 구독입니다. 자세한 내용은 구독(알림 엔드포인트 개체)을 참조하세요. |
응답
응답에는 HTTP 상태 코드, 응답 헤더 집합 및 응답 본문이 포함되어 있습니다.
상태 코드
리소스 공급자 내부 구독 만들기에 성공하면 상태 코드 201(생성됨)을 반환합니다. 작업이 비동기적으로 실행되는 경우 상태 코드 202(수락됨)를 반환할 수 있습니다.
상태 코드에 대한 자세한 내용은 상태 및 오류 코드(Windows Azure Pack Service Management)를 참조하세요.
응답 헤더
이 작업에 대한 응답에는 표준 HTTP 헤더가 포함됩니다. 모든 표준 헤더는 HTTP/1.1 프로토콜 사양을 준수합니다.
응답 본문
다음 표에서는 응답 본문의 주요 요소에 대해 설명합니다.
요소 이름 |
Description |
|---|---|
Subscription |
새 구독입니다. 자세한 내용은 구독(알림 엔드포인트 개체)을 참조하세요. |
예제
다음 코드 예제에서는 구독 만들기 요청을 보여줍니다.
POST https://<NotificationEndpoint>/subscriptions HTTP/1.1
Referer: https://<Computer>:30004/subscriptions
Accept-Language: en-US
x-ms-client-request-id: 4abcdb02-cf03-4b07-a1e1-d43c4fe06a8b-2013-07-25 06:09:39Z
x-ms-client-session-id: be02e255-38de-4e86-9690-b3a3e3037e4c
x-ms-principal-id: <COMPUTER>\Administrator
x-ms-principal-liveid: <COMPUTER>\Administrator
x-ms-request-id: 60668356a6204f269a455cc3f3901a84.2013-07-25T06:09:42.8465532Z
Authorization: Basic <encoded username and password>
Content-Type: application/json; charset=utf-8
Host: <Computer>:30010
Content-Length: 438
Expect: 100-continue
{
"SubscriptionId": "685a05ed-3a6f-4c3a-b70c-924a1307834f",
"SubscriptionName": "Hosting Plan One",
"State": 0,
"LifecycleState": 0,
"LastErrorMessage": null,
"QuotaSettings": [
{
"Key": "Editions",
"Value": "[{\"displayName\":\"Default\",\"groupName\":\"Default\",\"resourceCount\":\"10\",\"resourceSize\":\"1024\",\"resourceSizeLimit\":\"1024\",\"offerEditionId\":\"070913050037\",\"groupType\":null}]"
}
],
"AdminId": "egghead@contoso.com",
"CoAdminIds": [
]
}
다음 코드 예제에서는 구독 JSON 만들기 응답을 보여줍니다.
{
"SubscriptionId": "685a05ed-3a6f-4c3a-b70c-924a1307834f",
"SubscriptionName": "Hosting Plan One",
"State": 0,
"LifecycleState": 0,
"LastErrorMessage": null,
"QuotaSettings": [
{
"Key": "Editions",
"Value": "[{\"displayName\":\"Default\",\"groupName\":\"Default\",\"resourceCount\":\"10\",\"resourceSize\":\"1024\",\"resourceSizeLimit\":\"1024\",\"offerEditionId\":\"070913050037\",\"groupType\":null}]"
}
],
"AdminId": "egghead@contoso.com",
"CoAdminIds": [
]
}
설명
TBD를 호출할 때 서비스 관리 API는 응답을 위해 1분 동안 대기합니다. 응답을 받지 못하면 구독이 동기화되지 않은 것으로 표시됩니다.
비동기 작업이 지원됩니다. 만들기 작업을 완료하는 데 1분 이상이 걸리는 경우 리소스 공급자는 202(수락됨)를 반환하고 구독의 내부 표현(알림 엔드포인트 개체)을 설정할 수 있습니다. LifecycleState에서 프로비전으로. 리소스 공급자가 만들기 작업을 완료하면 구독(알림 엔드포인트 개체)의 표현을 설정해야 합니다. LifecycleState에서 프로비전됨으로. 서비스 관리 API는 구독(알림 엔드포인트 개체)을 확인합니다. TBD를 사용하여 10초마다 작업 완료를 위한 LifecycleState입니다.