Share via

구독 리소스

  • 아티클

적용 대상: 파트너 센터 | 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 리소스는 구독 리소스에 연결된 링크의 컬렉션을 설명합니다.

속성 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 약정 통화입니다.