구독 리소스
적용 대상: 파트너 센터 | 21Vianet에서 운영되는 파트너 센터 | Microsoft Cloud for US Government 파트너 센터
구독을 사용하면 고객이 특정 기간 동안 서비스를 사용할 수 있습니다. 모든 필드가 모든 구독에 적용되는 것은 아닙니다. 구독이 일시 중단되거나 취소되는 경우와 같이 수명 주기의 특정 지점에만 많은 필드가 적용됩니다.
구독
참고 항목
구독 리소스의 속도 제한은 테넌트 식별자당 분당 500개 요청입니다.
구독 리소스는 구독의 수명 주기를 나타내며 구독 수명 주기 동안 상태를 정의하는 속성을 포함합니다.
| 속성 | Type | 설명 |
|---|---|---|
| ID | string | 구독 식별자입니다. |
| offerId | string | 제품 식별자입니다. |
| entitlementId | string | 권한 식별자(Azure 구독 ID)입니다. |
| offerName | string | 제품 이름입니다. |
| friendlyName | string | 명확하게 구분하기 위해 파트너가 정의한 구독의 이름입니다. |
| quantity | 번호 | 수량입니다. 이 속성은 라이선스 기반 청구에 대한 라이선스 수로 설정됩니다. |
| unitType | string | 구독의 수량을 정의하는 단위: "라이선스", "사용량 기반" 또는 "혜택" |
| parentSubscriptionId | string | 부모 구독 식별자를 가져오거나 설정합니다. |
| creationDate | string | 만든 날짜를 날짜-시간 형식으로 가져오거나 설정합니다. |
| effectiveStartDate | UTC 날짜/시간 형식의 문자열 | 이 구독의 유효 시작 날짜를 날짜-시간 형식으로 가져오거나 설정합니다. 이 속성은 마이그레이션된 구독의 날짜를 다시 지정하거나 다른 구독과 정렬하는 데 사용됩니다. |
| commitmentEndDate | UTC 날짜/시간 형식의 문자열 | 이 구독의 약정 종료 날짜(날짜-시간 형식)입니다. 자동 갱신할 수 없는 구독의 경우 이 속성은 나중에 멀리 떨어진 날짜를 나타냅니다. 새로운 상거래 종료 날짜는 포함됩니다. 즉, 용어의 끝은 하루 종일 종료됩니다. 레거시 종료 날짜는 포함되지 않습니다. |
| commitmentEndDateTime | UTC 날짜/시간 형식의 문자열 | 이 구독에 대한 약정 종료 날짜 및 시간(날짜-시간 형식)입니다. 자동 갱신할 수 없는 구독의 경우 이 속성은 나중에 멀리 떨어진 날짜를 나타냅니다. |
| status | string | 구독은 "none", "active", "pending", "suspended", "expired", "disabled" 또는 "deleted"를 상태. |
| autoRenewEnabled | 부울 값 | 구독이 자동으로 갱신되는지 여부를 나타내는 값을 가져옵니다. |
| billingType | string | 구독 요금이 청구되는 방법을 지정합니다. "none", "usage", "license" 또는 "benefit." |
| billingCycle | string | 파트너가 이 주문에 대해 청구되는 빈도를 나타냅니다. 지원되는 값은 BillingCycleType에 있는 멤버 이름입니다. |
| hasPurchasableAddons | 부울 값 | 구독에 구매할 수 있는 추가 기능이 있는지 여부를 나타내는 값을 가져오거나 설정합니다. |
| isTrial | 부울 값 | 구독이 평가판인지 여부를 나타내는 값입니다. |
| isMicrosoftProduct | 부울 값 | 구독이 Microsoft 제품인지 여부를 나타내는 값입니다. |
| publisherName | string | 게시자 이름입니다. |
| actions | 문자열 배열 | 허용되는 작업을 가져오거나 설정합니다. 가능한 값: "edit", "cancel" |
| partnerId | string | 간접 파트너 모델에 사용되는 레코드 재판매인의 PartnerID입니다. |
| suspensionReasons | 문자열 배열 | 읽기 전용. 구독이 일시 중단된 경우 이유를 나타냅니다. |
| contractType | string | 읽기 전용. 계약 유형: "subscription", "productKey" 또는 "redemptionCode." |
| refundOptions | RefundOption 리소스 배열 | 읽기 전용입니다. 이 구독에 사용할 수 있는 환불 옵션 집합입니다. |
| scheduledNextTermInstructions | scheduledNextTermInstructions | 다음 용어가 시작될 때 실행되는 예약된 지침을 가져오거나 설정합니다. |
| nextChargeInstructions | nextChargeInstructions | 현재 용어가 끝날 때 보류 중인 청구 주기 변경 내용에 대한 다음 용어 청구 지침에 대한 세부 정보를 가져옵니다. |
| 링크 | SubscriptionLinks | 구독 링크를 가져오거나 설정합니다. |
| orderId | string | 구독을 시작하기 위해 배치된 주문의 ID입니다. |
| termDuration | string | 용어 기간의 ISO 8601 표현입니다. 현재 지원되는 값은 P1M (1개월), P1Y (1년) 및 P3Y (3년)입니다. |
| attributes | ResourceAttributes | 구독에 해당하는 메타데이터 특성입니다. |
| renewalTermDuration | string | 용어 기간의 ISO 8601 표현입니다. 현재 지원되는 값은 P1M (1개월) 및 P1Y (1년)입니다. |
| ProductType | ItemType | 읽기 전용. 구독의 제품 유형입니다. |
| consumptionType | 초과분 리소스 배열 | 지정된 고객에 대한 초과분(overage)을 가져오거나 설정합니다. |
| promotionId | string | 구독에 적용되는 경우 승격 식별자입니다. 형식 예제: "39NFJQT1PJQB:0001:39NFJQT1Q5KN" |
| CancellationAllowedUntilDate | DateTime | 취소의 마지막 날짜입니다. |
| BillingCycleEndDate | DateTime | 이 구독의 청구 주기 종료 날짜를 날짜-시간 형식으로 가져오거나 설정합니다. |
| BillingCycleEndDateTime | DateTime | 이 구독에 대한 청구 주기 종료 날짜 시간을 날짜-시간 형식으로 가져옵니다. |
| productOrderId | string | 특정 제품 구매에 대한 식별자입니다(예: 예약 또는 Azure 저축 계획). |
| lineItems | SubscriptionLineItem | 품목에는 특정 구독의 구매 세부 정보가 포함됩니다. |
SubscriptionLinks
SubscriptionLinks 리소스는 구독 리소스에 연결된 링크의 컬렉션을 설명합니다.
| 속성 | Type | 설명 |
|---|---|---|
| offer | 링크 | 제품을 가져오거나 설정합니다. |
| parentSubscription | 링크 | 부모 구독을 가져오거나 설정합니다. |
| product | 링크 | 구독과 연결된 제품을 가져옵니다. |
| sku | 링크 | 구독과 연결된 제품 sku를 가져옵니다. |
| 사용 가능성 | 링크 | 구독과 연결된 제품 sku 가용성을 가져옵니다. |
| activationLinks | 링크 | 구독과 연결된 활성화 링크 목록을 가져옵니다. |
| self | 링크 | 자체 URI입니다. |
| next | 링크 | 항목의 다음 페이지입니다. |
| previous | 링크 | 항목의 이전 페이지입니다. |
SubscriptionProvisioningStatus
SubscriptionProvisioningStatus 리소스는 구독의 프로비저닝 상태 대한 정보를 제공합니다.
| 속성 | Type | 설명 |
|---|---|---|
| skuId | string | 제품 SKU를 식별하는 문자열입니다. |
| status | string | 프로비전 상태 나타냅니다. "success", "pending" 또는 "failed." |
| quantity | 번호 | 프로비전 후 구독 수량을 제공합니다. |
| endDate | UTC 날짜/시간 형식의 문자열 | 구독의 종료 날짜입니다. |
| attributes | ResourceAttributes | 메타데이터 특성입니다. |
scheduledNextTermInstructions
scheduledNextTermInstructions 리소스는 구독의 다음 기간이 시작될 때 적용할 지침을 정의합니다. 예약된 변경 내용이 설정되거나 모든 평가판 구독에만 존재합니다.
| 속성 | Type | 설명 |
|---|---|---|
| product | product | 제품 SKU를 식별하는 GUID 형식 문자열입니다. |
| quantity | 번호 | 프로비전 후 구독 수량을 제공합니다. |
| customTermEndDate | UTC 날짜/시간 형식의 문자열 | 다른 구독의 종료 날짜에 맞춰진 경우 구독에 대한 사용자 지정 종료 날짜 |
Product
scheduledNextTermInstructions.product 리소스 및 특성은 예약된 변경 내용이 다음 기간에 적용됩니다.
| 속성 | Type | 설명 |
|---|---|---|
| productId | 문자열 | 제품의 ID입니다. |
| skuId | 문자열 | 프로비전 후 구독 수량을 제공합니다. |
| availabilityId | 문자열 | 이 가용성의 ID입니다. 이 ID는 부모 제품 및 SKU의 컨텍스트 내에서만 고유합니다. 가용성 ID는 시간이 지남에 따라 변경될 수 있습니다. 파트너는 검색한 후 짧은 시간 내에만 이 값을 사용해야 합니다. |
| billingCycle | 문자열 | 파트너가 이 주문에 대해 청구되는 빈도를 나타냅니다. 지원되는 값은 BillingCycleType에 있는 멤버 이름입니다. |
| termDuration | 문자열 | 용어 기간의 ISO 8601 표현입니다. 현재 지원되는 값은 P1M (1개월) 및 P1Y (1년)입니다. |
| promotionId | 문자열 | 예약된 다음 기간에 적용할 승격 식별자입니다. 형식 예제: "39NFJQT1PJQB:0001:39NFJQT1Q5KN." |
nextChargeInstructions
nextChargeInstructions 리소스는 구독의 다음 기간이 시작될 때 적용되는 청구 주기 지침을 정의합니다. 보류 중인 청구 주기 변경 내용이 보류 중인 경우에만 존재합니다.
| 속성 | Type | 설명 |
|---|---|---|
| product | product | 제품 SKU를 식별하는 GUID 형식 문자열입니다. |
| quantity | 번호 | 프로비전 후 구독 수량을 제공합니다. |
SubscriptionRegistrationStatus
SubscriptionRegistrationStatus 리소스는 구독 리소스에 연결된 링크의 컬렉션을 설명합니다.
| 속성 | Type | 설명 |
|---|---|---|
| subscriptionId | string | 구독 식별자입니다. |
| status | string | 등록 상태 나타냅니다. "registered", "registering" 또는 "notregistered." |
SupportContact
SupportContact 리소스는 고객의 구독에 대한 지원 연락처를 나타냅니다.
| 속성 | Type | 설명 |
|---|---|---|
| supportTenantId | string | 지원 연락처의 테넌트 식별자를 나타내는 GUID 형식 문자열입니다. |
| supportMpnId | string | 연락처의 파트너 식별자입니다. |
| name | string | 지원 연락처의 이름입니다. |
| 링크 | ResourceLinks | 지원 연락처 관련 링크입니다. |
| attributes | ResourceAttributes | 메타데이터 특성입니다. "objectType": "SupportContact"를 포함합니다. |
초과분
초과분 리소스는 할당된 구독 및 재판매인 할당 여부에 관계없이 할당될 수 있는 소비 구독 초과를 나타냅니다.
| 속성 | Type | 설명 |
|---|---|---|
| azureEntitlementId | string | 소비 구독 식별자를 나타내는 GUID 형식 문자열입니다. |
| partnerId | string | 구독과 연결된 재판매인의 파트너 식별자입니다. |
| type | string | 초과분 유형은 "전화서비스"일 수 있습니다. |
| 없 더군요 | 부울 값 | 초과분 사용 여부를 나타내는 값입니다. |
| 링크 | ResourceLinks | 초과분 관련 링크입니다. |
| attributes | ResourceAttributes | 메타데이터 특성입니다. "objectType": "Overage"를 포함합니다. |
RegisterSubscription
RegisterSubscription 리소스는 구독의 등록 상태 쿼리하는 데 사용할 수 있는 링크를 반환합니다. 등록 상태 Azure 구독 등록에 성공적으로 수락된 요청의 응답 본문에 반환됩니다.
| 속성 | Type | 설명 |
|---|---|---|
| httpResponseMessage | 개체 | 등록 상태 쿼리하는 링크가 포함된 위치 헤더가 포함된 HTTP 상태 코드 202 "Accepted"를 반환합니다. 예를 들어 "/customers/{customer-id}/subscriptions/{subscription-id}/registrationstatus" |
RefundOption
RefundOption 리소스는 구독에 대한 가능한 환불 옵션을 나타냅니다.
| 속성 | Type | Description |
|---|---|---|
| type | string | 환불 유형입니다. 지원되는 값은 "Partial" 및 "Full"입니다. |
| expiresAfter | UTC 날짜/시간 형식의 문자열 | 이 옵션이 만료되는 타임스탬프입니다. null이면 환불 작업에 만료가 없습니다. |
AzureEntitlement
AzureEntitlement 리소스는 구독에 대한 Azure 자격을 나타냅니다.
| 속성 | Type | 설명 |
|---|---|---|
| ID | string | 권한 식별자 |
| friendlyName | string | 자격의 이름입니다. |
| status | string | 자격의 상태. |
| subscriptionId | string | 자격이 속한 구독 식별자입니다. |
SubscriptionLineItem
품목에는 특정 구독의 구매 세부 정보가 포함됩니다.
| 속성 | Type | 설명 |
|---|---|---|
| ID | string | 구독 줄 항목 식별자입니다. |
| friendlyName | string | 명확하게 구분하기 위해 파트너가 정의한 구독 품목의 이름입니다. |
| scope | 범위 | 범위는 혜택이 적용되는 위치를 나타냅니다. |
| autoRenewEnabled | 부울 | 구독이 자동으로 갱신되는지 여부를 나타내는 값을 가져옵니다. |
| status | string | 구독은 "none", "active", "pending", "suspended", "expired", "disabled" 또는 "deleted"를 상태. |
| purchaseCommitment | 구매 약정 | 컴퓨팅 서비스에 커밋된 고정 금액입니다. |
범위
범위는 혜택이 적용되는 위치를 나타냅니다.
| 속성 | Type | 설명 |
|---|---|---|
| type | string | 구매의 범위 유형: "단일", "공유", "리소스 그룹" 또는 "관리 그룹" |
| subscriptionId | string | 구매에 사용할 Azure 플랜의 ID입니다. 공유 범위에 필요합니다. |
| entitlementId | string | 구매에 사용할 Azure 구독의 ID입니다. 단일 범위에 필요합니다. |
| managementGroupId | string | 구매에 사용할 관리 그룹의 ID입니다. 이 범위는 현재 Azure Portal을 통해서만 선택할 수 있지만 업데이트는 PC에 반영됩니다. |
| resourceGroupId | string | 구매에 사용할 리소스 그룹의 ID입니다. 이 범위는 현재 Azure Portal을 통해서만 선택할 수 있지만 업데이트는 PC에 반영됩니다. |
구매 약정
컴퓨팅 서비스에 커밋된 고정 금액입니다.
| 속성 | Type | 설명 |
|---|---|---|
| 금액 | string | 고정 금액 약정입니다. |
| 곡물 | string | 약정 기간입니다. |
| 통화 | string | 약정 통화입니다. |