다음을 통해 공유


전환 리소스

적용 대상

  • 파트너 센터

적절한 역할

  • 관리 에이전트

참고

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

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

전환 자격

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

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

전환 자격 세부정보

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

속성 유형 설명
자격 있음 불리언 자격이 유효한지 여부를 반환합니다.
구독ID string 구독의 ID를 반환합니다.
구독 이름 string 구독의 친숙한 이름을 반환합니다.
구독 기간 문자열 구독의 기간을 반환합니다.
구독 청구 주기 청구 주기 유형 구독의 청구 주기 형식을 반환합니다.
오류 TargetSubscriptionErrors 목록 대상 구독을 전환할 수 없는 이유입니다.

대상 구독 적격성 세부사항

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

속성 유형 설명
자격 확인 부울 값 자격이 유효한지 여부를 반환합니다.
구독 ID (SubscriptionId) 문자열 구독의 ID를 반환합니다.
SubscriptionFriendlyName 문자열 구독의 친숙한 이름을 반환합니다.
구독 기간 string 구독의 기간을 반환합니다.
구독 요금 주기 청구 주기 유형 구독의 청구 주기 형식을 반환합니다.
오류 TargetSubscriptionErrors의 목록 대상 구독을 전환할 수 없는 이유입니다.

전환

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

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

TransitionEvent

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

속성 유형 설명
이름 문자열 전환 이벤트의 이름입니다. 가능한 값 - Conversion 또는 LicenseReassignment.
상태 string 전환 이벤트의 상태입니다. 가능한 값 - Started, Completed 또는 Failed.
타임스탬프 날짜 및 시간 이벤트의 UTC 타임스탬프입니다.
오류 TransitionErrors 목록 오류에 해당하는 메타데이터 특성입니다.

TransitionError

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

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

대상 구독 오류

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

속성 유형 설명
코드 타겟구독오류코드 문제와 관련된 오류 코드입니다.
설명 스트링 오류를 설명하는 친숙한 텍스트입니다.