새 상거래 마이그레이션 예약

아티클
03/07/2025

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

적절한 역할: 관리 에이전트 | 영업 에이전트

이 문서에서는 새 상거래 환경을 예약하는 방법을 설명합니다.

필수 조건

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

REST 요청

요청 구문

방법	요청 URI
POST	{baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/schedules

URI 매개 변수

이 표에는 새 상거래 마이그레이션을 만드는 데 필요한 쿼리 매개 변수가 나열됩니다.

이름	유형	필요함	설명
고객-테넌트-ID	string	예	고객을 식별하는 GUID 형식 문자열입니다.

요청 헤더

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

요청 본문

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

속성	유형	필요함	설명
currentSubscriptionId (현재 구독 ID)	문자열	예	마이그레이션에 대한 유효성 검사가 필요한 구독을 나타내는 구독 식별자입니다.
기간 지속 시간	string	아니요	마이그레이션 시 기간 변경을 지정할 수 있습니다.
billingCycle	문자열	아니요	마이그레이션 시 청구 주기를 변경하도록 지정할 수 있습니다.
전체 기간 구매	bool	아니요	마이그레이션 시 NCE에서 새 용어를 시작할 수 있습니다.
수량	정수	아니요	마이그레이션 시 구독의 라이선스 수량을 늘리거나 줄일 수 있습니다.
사용자 정의 기간 종료일	날짜/시간	아니요	종료 날짜는 기존 평가판이 아닌 OnlineServicesNCE 구독 또는 월과 일치하도록 설정할 수 있습니다. 구독 종료 날짜 조정에 관한 자세한 정보는 파트너 센터에서 확인하세요.
목표 날짜	날짜/시간	필수(migrateOnRenewal이 null/false인 경우)	마이그레이션을 예약할 대상 날짜입니다. targetDate가 지정된 날짜로 설정된 경우 migrationOnRenewal을 null 또는 false로 설정할 수 있습니다.
갱신 시 마이그레이션	bool	필수(targetDate가 null인 경우)	migrateOnRenewal에 대해 플래그가 true로 설정된 경우 마이그레이션 예약을 위해 targetDate를 지정할 필요가 없습니다.
추가기능이동일정	bool	아니요	예약된 마이그레이션에 포함할 AddOn 구독 목록을 포함합니다.

요청 예제

{
    "currentSubscriptionId": "2591295E-DDEB-425A-93F9-C1B4F5AD7FB6",
    "quantity": 1,
    "billingCycle": "monthly",
    "purchaseFullTerm": false,
    "termDuration": "P1Y",
    "customTermEndDate": null,
    "targetDate": "2023-08-09T00:00:00.000Z",
    "addOnMigrations": [
        {
            "currentSubscriptionId": "5B882C48-53C6-46AF-B8A4-0691F19BAD94",
            "quantity": 17,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1M",
            "customTermEndDate": null
        },
        {
            "currentSubscriptionId": "C7D0DB12-9482-4297-8F09-190EB04F9C05",
            "quantity": 23,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1Y",
            "customTermEndDate": null
        }
    ]
}

REST 응답

성공하면 이 메서드는 응답 본문에서 마이그레이션되는 구독(마이그레이션 개체)의 세부 정보를 반환합니다 .

응답 성공 및 오류 코드

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

응답 예

{
    "id": "f016c025-a873-47af-8b52-2516fbef4c65",
    "currentSubscriptionId": "2591295E-DDEB-425A-93F9-C1B4F5AD7FB6",
    "quantity": 1,
    "billingCycle": "monthly",
    "purchaseFullTerm": false,
    "termDuration": "P1Y",
    "customTermEndDate": null,
    "targetDate": "2023-08-09T00:00:00.000Z",
    "addOnMigrations": [
        {
            "currentSubscriptionId": "5B882C48-53C6-46AF-B8A4-0691F19BAD94",
            "quantity": 17,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1M",
            "customTermEndDate": null
        },
        {
            "currentSubscriptionId": "C7D0DB12-9482-4297-8F09-190EB04F9C05",
            "quantity": 23,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1Y",
            "customTermEndDate": null
        }
    ]
}

다음을 통해 공유