다음을 통해 공유


전환 리소스

적용 대상

  • 파트너 센터

적절한 역할

  • 관리 에이전트

참고 항목

라이선스 기반 서비스에 대한 새로운 상거래 환경에는 많은 새로운 기능이 포함되며 모든 CSP(클라우드 솔루션 공급자)에서 사용할 수 있습니다. 자세한 내용은 새 상거래 환경 개요를 참조하세요.

새 상거래 구독에서 다른 상거래 구독으로 전환하는 데 사용되는 리소스에 대해 설명합니다.

TransitionEligibility

개별 구독 전환 리소스의 동작을 설명합니다.

속성 Type 설명
CatalogItemId string 검사할 카탈로그 항목 ID입니다.
제목 string SKU 제목입니다.
설명 string SKU 설명입니다.
수량 정수 구매할 새 제품의 수량입니다.
자격 TransitionEligibilityDetail 목록 전환 자격 세부 정보 목록입니다.
SubscriptionEligibilities TargetSubscriptionEligibilityDetail 목록 전환할 수 있는 구독 목록입니다.

TransitionEligibilityDetail

개별 대상 구독 자격 세부 정보 리소스의 동작을 설명합니다.

속성 Type 설명
IsEligible 부울 값 자격이 유효한지 여부를 반환합니다.
SubscriptionId string 구독의 ID를 반환합니다.
SubscriptionFriendlyName string 구독의 친숙한 이름을 반환합니다.
SubscriptionTermDuration string 구독의 기간 기간을 반환합니다.
SubscriptionBillingCycle BillingCycleType 구독의 청구 주기 형식을 반환합니다.
Errors TargetSubscriptionErrors 목록 대상 구독을 전환할 수 없는 이유입니다.

TargetSubscriptionEligibilityDetail

개별 대상 구독 자격 세부 정보 리소스의 동작을 설명합니다.

속성 Type 설명
IsEligible 부울 값 자격이 유효한지 여부를 반환합니다.
SubscriptionId string 구독의 ID를 반환합니다.
SubscriptionFriendlyName string 구독의 친숙한 이름을 반환합니다.
SubscriptionTermDuration string 구독의 기간 기간을 반환합니다.
SubscriptionBillingCycle BillingCycleType 구독의 청구 주기 형식을 반환합니다.
Errors TargetSubscriptionErrors 목록 대상 구독을 전환할 수 없는 이유입니다.

전환

개별 구독 전환 리소스의 동작을 설명합니다.

속성 Type 설명
FromCatalogItemId string From 카탈로그 항목 ID입니다.
FromSubscriptionId string From 구독 ID입니다.
ToCatalogItemId string To 카탈로그 항목 ID입니다.
ToSubscriptionId string To 구독 ID입니다. 구독이 변경된 경우에만 채워집니다. 현재 레거시 업그레이드만 필요하지만 최신 부분 전환도 필요합니다.
수량 정수 대상 카탈로그 항목으로 전환되는 수량입니다.
TermDuration string 구독의 기간입니다.
BillingCycle string 구독에 대한 청구 주기.
TransitionType string 전환 유형입니다. 가능한 값 - transition_only, transition_with_license_transfer.
이벤트 TransitionEvents 목록 전환의 이벤트입니다.
promotionId string 전환에 적용된 승격 ID입니다.

TransitionEvent

구독에서 발생한 다양한 이벤트를 설명합니다.

속성 Type Description
이름 string 전환 이벤트의 이름입니다. 가능한 값 - Conversion 또는 LicenseReassignment.
상태 string 전환 이벤트의 상태입니다. 가능한 값 - StartedCompleted 또는 Failed.
Timestamp DateTime 이벤트의 UTC 타임스탬프입니다.
Errors TransitionErrors 목록 오류에 해당하는 메타데이터 특성입니다.

TransitionError

구독 이전 자격에 대한 오류를 나타냅니다. 전환을 수행할 수 없는 이유를 제공합니다.

속성 Type 설명
코드 TransitionErrorCode 문제와 관련된 오류 코드입니다.
설명 string 오류를 설명하는 친숙한 텍스트입니다.

TargetSubscriptionErrors

대상 구독을 전환할 수 없는 경우에 대한 오류를 나타냅니다. 이유를 제공합니다.

속성 Type 설명
코드 TargetSubscriptionErrorCode 문제와 관련된 오류 코드입니다.
설명 string 오류를 설명하는 친숙한 텍스트입니다.