새 상거래 마이그레이션 일정 업데이트

  • 아티클

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

이 문서에서는 새 상거래 마이그레이션 일정을 업데이트하는 방법을 설명합니다. 파트너는 예약된 대상 날짜 전에 업데이트할 수 있습니다.

중요

이 API는 현재 샌드박스 테넌트에서만 사용할 수 있습니다.

필수 구성 요소

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

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

  • 현재 구독 ID

REST 요청

요청 구문

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

URI 매개 변수

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

이름 형식 필수 설명
customer-tenant-id 문자열 Yes 고객을 식별하는 GUID 형식 문자열입니다.
scheduleID 문자열 Yes 일정을 식별한 GUID 형식 문자열

요청 헤더

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

요청 본문

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

Property Type 필수 설명
currentSubscriptionId 문자열 Yes 마이그레이션에 대한 유효성 검사가 필요한 구독을 나타내는 구독 식별자입니다. 업데이트 작업에 허용되지 않습니다.
termDuration 문자열 No 기간은 마이그레이션 시 변경되도록 지정할 수 있습니다.
billingCycle 문자열 No 마이그레이션 시 청구 주기를 변경하도록 지정할 수 있습니다.
purchaseFullTerm bool No 마이그레이션 시 NCE에서 새 용어를 시작할 수 있습니다.
quantity int 아니요 구독에 대한 라이선스 수량은 마이그레이션 시 늘리거나 줄일 수 있습니다.
customTermEndDate Datetime No 종료 날짜는 기존 평가판이 아닌 OnlineServicesNCE 구독 또는 달력 월과 일치하도록 설정할 수 있습니다. 구독 종료 날짜 정렬에 대한 자세한 내용은 파트너 센터에서 구독 종료 날짜 정렬을 참조하세요.
targetDate Datetime No 대상 마이그레이션을 예약할 날짜입니다. targetDate가 지정된 날짜에 대해 설정된 경우 migrationOnRenewal을 null 또는 false로 설정할 수 있습니다.
migrateOnRenewal bool No migrateOnRenewal에 대해 플래그가 true로 설정된 경우 마이그레이션 예약을 위해 targetDate를 구체적으로 지정할 필요가 없습니다.

요청 예제

{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"status": "Created",
"customerTenantId": "6f297517-16e6-4313-8c6d-4e10496d2871",
"quantity": 25,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"targetDate": "2022-10-30T00:00:00"
}

REST 응답

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

응답 성공 및 오류 코드

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

응답 예

{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"subscriptionEndDate": "2023-07-19T00:00:00Z",
"status": "Created",
"customerTenantId": "6f297517-16e6-4313-8c6d-4e10496d2871",
"quantity": 25,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"targetDate": "2022-10-30T00:00:00",
"createdTime": "2022-10-18T21:20:50.9668605+00:00",
"lastModifiedTime": "2022-10-18T21:29:32.8992819+00:00"
}

추가 정보