다음을 통해 공유

새 구독 프로비전(테넌트 구독)

  • 아티클

 

적용 대상: Windows Azure Pack

지정된 정보를 사용하여 새 구독을 프로비전합니다.

요청

ServiceMgmt를> 서비스 관리 API 엔드포인트 주소로 바꿉니다<.

메서드

요청 URI

HTTP 버전

POST

<https:// ServiceMgmt>:30005/subscriptions

HTTP/1.1

URI 매개 변수

없음.

요청 헤더

다음 표에서는 필수 요청 헤더와 선택적 요청 헤더에 대해 설명합니다.

요청 헤더

Description

x-ms-principal-id:

필수 요소. 보안 주체 식별자입니다.

권한 부여: 전달자

필수 요소. 권한 부여 전달자 토큰입니다.

x-ms-client-request-id:

(선택 사항) 클라이언트 요청 식별자입니다.

x-ms-client-session-id:

(선택 사항) 클라이언트 세션 식별자입니다.

x-ms-principal-liveid:

(선택 사항) 보안 주체 라이브 식별자입니다.

요청 본문

다음 표에서는 요청 본문의 요소에 대해 설명합니다.

요소 이름

설명

AccountAdminLiveEmailId

계정 관리자의 Microsoft 계정 식별자입니다. 구독 프로비저닝에는 필요하지 않습니다. null을 사용합니다.

AccountAdminLivePuid

계정 관리자의 Passport 계정 식별자입니다. 기존 사용자 계정이어야 합니다. 사용자 검색을 사용하여 계정이 있는지 확인할 수 있습니다.

AccountId

계정 식별자입니다. Guid.Empty를 사용합니다.

FriendlyName

구독에 대한 식별 이름입니다.

OfferCategory

제품 범주입니다. null을 사용합니다.

OfferInfo

제품 정보입니다. null을 사용합니다.

OfferType

제품 유형입니다. 0을 사용합니다.

ReasonCode

이유 코드입니다. null을 사용합니다.

ServiceAdminLiveEmailId

서비스 관리자의 Microsoft 계정 식별자입니다. 이 값은 Windows Azure Pack에서 사용되지 않으며 일관성을 위해서만 필요합니다. null을 사용합니다.

ServiceAdminLivePuid

서비스 관리자의 Passport 계정 식별자입니다. 구독 프로비저닝에는 필요하지 않습니다. null을 사용합니다.

SubscriptionId

구독 식별자입니다. Guid.NewGuid()를 사용합니다. GUID를 만들려면 ToString()입니다.

상태

구독 상태입니다. null을 사용합니다.

PlanId

구독 중인 계획의 계획 식별자입니다.

CoAdminNames

공동 관리자 목록입니다. 공동 관리자가 없는 경우 null을 사용합니다. 공동 관리자는 시스템에 알 수 없습니다. 이후에 공동 관리자 계정이 만들어지면 구독이 공동 관리자에게 자동으로 적용됩니다.

응답

응답에는 HTTP 상태 코드, 응답 헤더 집합 및 응답 본문이 포함되어 있습니다.

상태 코드

작업에 성공하면 상태 코드 200(정상)이 반환됩니다. 계획에 허용되는 최대 구독 수에 도달하면 MaxSubscriptionsPerPlanReached가 반환됩니다.

상태 코드에 대한 자세한 내용은 상태 및 오류 코드(Windows Azure Pack Service Management)를 참조하세요.

응답 헤더

이 작업에 대한 응답에는 표준 HTTP 헤더가 포함됩니다. 모든 표준 헤더는 HTTP/1.1 프로토콜 사양을 따릅니다.

응답 본문

다음 표에서는 응답 본문의 주요 요소에 대해 설명합니다.

요소 이름

Description

Subscription

프로비전된 구독입니다. 자세한 내용은 구독(일반 개체)을 참조하세요.

예제

다음 코드 예제에서는 구독 프로비전 요청을 보여 집니다.

POST https://<Computer>:30005/subscriptions HTTP/1.1
Authorization: Bearer <Token>
x-ms-client-request-id: 02130fee-13b7-4b93-b618-3a8830dbe611-2014-04-15 20:00:55Z
x-ms-client-session-id: eec98428-7dd5-4033-8a2c-77946f61a2f6
x-ms-principal-id: NewUser%40contoso.com
Accept-Language: en-US
Content-Type: application/json; charset=utf-8
Host: <computer>:30005
Content-Length: 458
Expect: 100-continue
{
  "AccountAdminLiveEmailId": null,
  "AccountAdminLivePuid": "newuser@contoso.com",
  "AccountId": "00000000-0000-0000-0000-000000000000",
  "FriendlyName": "MyServicePlanX",
  "OfferCategory": null,
  "OfferInfo": null,
  "OfferType": 0,
  "ReasonCode": null,
  "ServiceAdminLiveEmailId": null,
  "ServiceAdminLivePuid": "newuser@contoso.com",
  "SubscriptionId": "da506abb-1658-4abf-971c-e0e5a9c47b83",
  "Status": null,
  "PlanId": "MyServicePlanX18aa6bac",
  "CoAdminNames": null
}

다음 코드 예제에서는 프로비전 구독 응답 본문을 보여 줍니다.

{
  "SubscriptionID": "da506abb-1658-4abf-971c-e0e5a9c47b83",
  "SubscriptionName": "MyServicePlanX",
  "AccountAdminLiveEmailId": "newuser@contoso.com",
  "ServiceAdminLiveEmailId": null,
  "CoAdminNames": [

  ],
  "AddOnReferences": [

  ],
  "AddOns": [

  ],
  "State": 1,
  "QuotaSyncState": 0,
  "ActivationSyncState": 1,
  "PlanId": "MyServicePlanX18aa6bac",
  "Services": [
    {
      "Type": "mysqlservers",
      "State": "registered",
      "QuotaSyncState": 0,
      "ActivationSyncState": 1,
      "BaseQuotaSettings": [
        {
          "Key": "Editions",
          "Value": "[{\"displayName\":\"Default\",\"groupName\":\"Default\",\"resourceCount\":\"10\",\"resourceSize\":\"1024\",\"offerEditionId\":\"040814101717\",\"groupType\":null}]"
        }
      ]
    }
  ],
  "LastErrorMessage": null,
  "Features": null,
  "OfferFriendlyName": "MyServicePlanX",
  "OfferCategory": null,
  "Created": "2014-04-15T20:00:59.187"
}

설명

테넌트에 대한 관리 포털은 구독을 프로비전할 때 다음 REST 호출을 수행합니다.

  1. 사용 가능한 계획을 검색합니다. 사용자가 구독할 수 있는 계획을 표시하는 데 사용됩니다. 반환된 Plan(Administrator 개체) 개체 에는 각각 ID 속성이 있습니다. 계획을 선택한 후에는 ID 값을 사용하여 새 구독 프로비전 호출에서 선택한 계획을 식별합니다.

  2. 사용자를 검색합니다. 존재하지 않는 사용자에 대한 구독을 만들 수 없으므로 이 호출은 사용자가 실제로 존재하는지 확인합니다.

  3. 새 구독을 프로비전합니다. 제공된 정보를 사용하여 구독을 프로비전합니다.

참고 항목

테넌트 구독 인터페이스