마이그레이션에 대한 구독 유효성 검사

아티클
10/14/2023

적용 대상: 파트너 센터 | 21Vianet에서 운영되는 파트너 센터 | Microsoft Cloud for US Government 파트너 센터

새 상거래 환경으로 마이그레이션하기 위한 구독의 유효성을 검사하는 방법

필수 조건

자격 증명(파트너 센터 인증에서 설명). 이 시나리오는 독립 실행형 앱 및 App+사용자 자격 증명을 모두 사용하여 인증을 지원합니다.
고객 ID (customer-tenant-id). 고객의 ID를 모르는 경우 고객 작업 영역, 고객 목록에서 고객, 계정을 선택하여파트너 센터에서 조회할 수 있습니다. 고객 계정 페이지의 고객 계정 정보 섹션에서 Microsoft ID를 찾습니다. Microsoft ID는 고객 ID(customer-tenant-id)와 동일합니다.
현재 구독 ID

속도 제한

마이그레이션 API 유효성 검사 제한은 5분 안에 파트너-고객 조합당 450개 호출입니다. 속도 제한 및 제한에 대한 자세한 내용은 API 제한 지침에서 확인할 수 있습니다.

REST 요청

요청 구문

메서드	요청 URI
POST	{baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/validate HTTP/1.1

URI 매개 변수

이 표에는 마이그레이션을 위한 구독의 유효성을 검사하는 데 필요한 쿼리 매개 변수가 나열됩니다.

이름	종류	필요함	설명
customer-tenant-id	string	예	고객을 식별하는 GUID 형식 문자열입니다.
termDuration	string	아니요	마이그레이션 시 용어 기간을 변경할 수 있습니다.
billingCycle	string	아니요	마이그레이션 시 청구 주기를 변경할 수 있습니다.
purchaseFullTerm	부울	아니요	마이그레이션 시 NCE에서 새 용어를 시작할 수 있습니다.
quantity	int	아니요	마이그레이션 시 구독의 라이선스 수량을 늘리거나 줄일 수 있습니다.
customTermEndDate	날짜/시간	아니요	종료 날짜는 기존 비심판 OnlineServicesNCE 구독 또는 월과 일치하도록 설정할 수 있습니다. 구독 종료 날짜 정렬에 대한 자세한 내용은 파트너 센터에서 구독 종료 날짜 정렬

요청 헤더

자세한 내용은 파트너 센터 REST 헤더를 참조하세요.

요청 본문

이 표에서는 요청 본문의 구독 속성에 대해 설명합니다.

속성	형식	필요함	설명
currentSubscriptionId	string	예	마이그레이션에 대한 유효성 검사가 필요한 구독을 나타내는 구독 식별자입니다.

요청 예제

"currentSubscriptionId" : "9beb6319-6889-4d28-a155-68ca9c783842"

REST 응답

성공하면 이 메서드는 현재 구독이 새 상거래로 마이그레이션할 수 있는지 여부를 나타내는 응답 본문에 "isEligible" 부울을 반환합니다. 마이그레이션 유효성 검사 API는 새 상거래에서 구독의 프로모션 자격에 대한 정보를 제공하지 않습니다.

응답 성공 및 오류 코드

각 응답에는 성공 또는 실패 및 추가 디버깅 정보를 나타내는 HTTP 상태 코드가 함께 제공됩니다. 네트워크 추적 도구를 사용하여 이 코드, 오류 유형 및 기타 매개 변수를 읽습니다. 전체 목록은 파트너 센터 REST 오류 코드를 참조하세요.

응답 예제

1. 
    {
        "currentSubscriptionId": "9beb6319-6889-4d28-a155-68ca9c783842",
        "isEligible": false,
        "errors": [
            {
                "code": 5,
                "description": "Subscription cannot be migrated to New Commerce because the equivalent offer is not yet available in New Commerce",
            }
        ]
    }

2. 
    {
        "currentSubscriptionId": "9beb6319-6889-4d28-a155-68ca9c783842",
        "isEligible": true,
        "catalogItemId": "CFQ7TTC0LF8S:0002:CFQ7TTC0KSVV"
    }