새 상거래 마이그레이션 일정 취소

  • 아티클

적용 대상: 파트너 센터 | 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/{scheduleID}/cancel

URI 매개 변수

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

이름 Type 필수 Description
customer-tenant-id 문자열 예 고객을 식별하는 GUID 형식 문자열입니다.
scheduleID 문자열 예 일정을 식별하는 GUID 형식 문자열

요청 헤더

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

응답 본문

이 표에서는 응답의 구독 속성에 대해 설명합니다.

속성 Type 필수 Description
ID 문자열 아니요 일정을 식별하는 GUID 형식 문자열
currentSubscriptionId 문자열 아니요 마이그레이션에 대한 유효성 검사가 필요한 구독을 나타내는 구독 식별자입니다.
termDuration 문자열 아니요 마이그레이션 시 용어 기간을 변경할 수 있습니다.
billingCycle 문자열 아니요 마이그레이션 시 청구 주기를 변경하도록 지정할 수 있습니다.
purchaseFullTerm bool 아니요 마이그레이션 시 NCE에서 새 용어를 시작할 수 있습니다.
수량 int 아니요 마이그레이션 시 구독의 라이선스 수량을 늘리거나 줄일 수 있습니다.
customTermEndDate datetime 아니요 종료 날짜는 기존 평가판이 아닌 OnlineServicesNCE 구독 또는 월과 일치하도록 설정할 수 있습니다. 구독 종료 날짜 정렬에 대한 자세한 내용은 파트너 센터에서 구독 종료 날짜 정렬
targetDate datetime 아니요 마이그레이션을 예약할 대상 날짜입니다.
migrateOnRenewal bool 아니요 갱신할 때 구독을 마이그레이션할 수 있는지를 나타냅니다.
상태 문자열 아니요 일정 마이그레이션 상태
createdTime datetime 아니요 일정을 만든 경우
lastModifiedTime datetime 아니요 일정이 마지막으로 수정된 시간

REST 응답

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

응답 성공 및 오류 코드

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

응답 예제

{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"subscriptionEndDate": "2023-07-19T00:00:00Z",
"status": "Cancelled",
"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"
}

참고 항목