다음을 통해 공유


새 상거래 마이그레이션 만들기

적용 대상: 파트너 센터 | 21Vianet이 운영하는 파트너 센터 | 미국 정부용 Microsoft 클라우드 파트너 센터

새 상거래 환경으로 구독 마이그레이션을 만드는 방법

필수 구성 요소

  • 파트너 센터 인증설명된 대로 자격 증명. 이 시나리오는 독립 실행형 앱 및 App+사용자 자격 증명을 모두 사용하여 인증을 지원합니다.

  • 고객 ID(customer-tenant-id)입니다. 고객의 ID를 모르는 경우 파트너 센터에서 고객 작업 영역을 선택한 후 고객 목록에서 고객을 선택하여 계정을 통해 조회할 수 있습니다. 고객의 계정 페이지에서 고객 계정 정보 섹션을 찾아 Microsoft ID를 찾으세요. Microsoft ID는 고객 ID(customer-tenant-id)와 동일합니다.

  • 현재 구독 ID

속도 제한

마이그레이션 만들기 API 제한은 파트너가 5분 안에 100개 호출하는 것입니다. 속도 제한 및 조절에 대한 자세한 내용은 API 제한 지침.

REST 요청

요청 구문

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

URI 매개 변수

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

이름 유형 필수 묘사
고객-테넌트-ID 문자열 고객을 식별하는 GUID 형식 문자열입니다.

요청 헤더

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

요청 본문

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

재산 유형 필수 묘사
currentSubscriptionId(현재 구독 ID) 문자열 마이그레이션에 대한 유효성 검사가 필요한 구독을 나타내는 구독 식별자입니다.
기간 기간 문자열 아니요 마이그레이션할 때 기간을 변경할 수 있습니다.
billingCycle 문자열 아니요 마이그레이션 시 청구 주기를 변경할 수 있습니다.
전체 기간 구매 bool 아니요 마이그레이션 시 NCE에서 새 용어를 시작할 수 있습니다.
int 아니요 마이그레이션 시 구독의 라이선스 수량을 늘리거나 줄일 수 있습니다.
사용자 정의 기간 종료일 날짜 및 시간 아니요 종료 날짜는 기존 정식 OnlineServicesNCE 구독 또는 달력 월과 일치하도록 설정할 수 있습니다. 구독 종료 날짜를 정렬하는 방법에 대한 더 많은 정보는 여기에서 확인할 수 있습니다: 파트너 센터에서 구독 종료 날짜 정렬

요청 예제

중첩된 추가 기능(추가 기능 구독이 있는 추가 기능 구독)은 요청 본문에 addOnMigrations 내의 플랫 목록으로 작성되어야 하며 요청의 다른 추가 기능 구독 내에 중첩되지 않아야 합니다. 요청 본문에 추가 기능을 작성하는 방법에 대한 마지막 요청 예제를 참조하세요.

{
    "currentSubscriptionId" : "9beb6319-6889-4d28-a155-68ca9c783842"
}
{ 
    "currentSubscriptionId": "5C77DC7F-BE2C-4306-A3B5-0EBB4365D7FC", 
    "termDuration": "P1M", 
    "billingCycle": "Monthly", 
} 
{
    "currentSubscriptionId": "5C77DC7F-BE2C-4306-A3B5-0EBB4365D7FC", 
    "purchaseFullTerm": true 
}
{
    "currentSubscriptionId": "66E738D6-E0BC-4FFB-8818-BDE99BC7008B",
    "quantity": 1,
    "billingCycle": "Annual",
    "purchaseFullTerm": false,
    "termDuration": "P1Y",
    "addOnMigrations": [
        {
            "currentSubscriptionId": "359011DC-B5B0-4660-850B-A8FA9B2E3309",
            "quantity": 1,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1M"
        },
        {
            "currentSubscriptionId": "159D9F87-CE39-4EBD-B9C2-ECF0892A85A1",
            "quantity": 1,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1Y"
        }
    ]
}

REST 응답

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

응답 성공 및 오류 코드

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

응답 예제

{
    "addOnMigrations": [
        {
            "currentSubscriptionId": "E3AFD30D-D6E7-45AF-A6C5-FB905992AE00",
            "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "catalogItemId": "CFQ7TTC0LH0T:0001:CFQ7TTC0K4KQ",
            "subscriptionEndDate": "2023-02-22T00:00:00Z",
            "quantity": 1,
            "termDuration": "P1Y",
            "billingCycle": "Monthly",
            "purchaseFullTerm": false
        },
        {
            "currentSubscriptionId": "80906BD9-E45C-4D1B-92A8-EA3F3FB6E105",
            "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "catalogItemId": "CFQ7TTC0LH0R:0001:CFQ7TTC0K0SK",
            "subscriptionEndDate": "2023-02-22T00:00:00Z",
            "quantity": 1,
            "termDuration": "P1Y",
            "billingCycle": "Monthly",
            "purchaseFullTerm": false
        },
        {
            "currentSubscriptionId": "72E424F4-10FF-4C76-B101-C274F73BA498",
            "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "catalogItemId": "CFQ7TTC0LHXJ:0001:CFQ7TTC0KHTR",
            "subscriptionEndDate": "2023-02-22T00:00:00Z",
            "quantity": 1,
            "termDuration": "P1Y",
            "billingCycle": "Monthly",
            "purchaseFullTerm": false
        }
    ],
    "id": "7123c075-fc05-42d6-a21e-1d2036fa490b",
    "startedTime": "2022-02-23T13:00:48.4489832Z",
    "currentSubscriptionId": "2E56C7F5-E120-4CA4-BFF3-7DA763B4D777",
    "status": "Processing",
    "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "catalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0KQDF",
    "subscriptionEndDate": "2023-02-22T00:00:00Z",
    "quantity": 1,
    "termDuration": "P1Y",
    "billingCycle": "Monthly",
    "purchaseFullTerm": false
}