적용 대상
- 파트너 센터
적절한 역할
- 관리 에이전트
참고
라이선스 기반 서비스에 대한 새로운 상거래 환경에는 많은 새로운 기능이 포함되며 모든 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 | 문제와 관련된 오류 코드입니다. |
| 설명 | 문자열 | 오류를 설명하는 친숙한 텍스트입니다. |
대상 구독 오류
대상 구독을 전환할 수 없는 경우에 대한 오류를 나타냅니다. 이유를 제공합니다.
| 속성 | 유형 | 설명 |
|---|---|---|
| 코드 | 타겟구독오류코드 | 문제와 관련된 오류 코드입니다. |
| 설명 | 스트링 | 오류를 설명하는 친숙한 텍스트입니다. |