새 상거래 마이그레이션 일정 받기

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

이 문서에서는 새 상거래 마이그레이션 일정을 가져오는 방법을 설명합니다.

중요

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

필수 구성 요소

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

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

• 현재 구독 ID

REST 요청

파트너가 쿼리할 수 있는 방법에는 두 가지가 있습니다.

• 특정 일정을 쿼리하려면
• 지정된 조건에 대한 일정 목록을 가져옵니다.

요청 구문

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

URI 매개 변수

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

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

방법	요청 URI
GET	{baseURL}/v1/migrations/newcommerce/schedules? CustomerTenantId={customer-tenant-id}

URI 매개 변수

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

이름	형식	설명
customerTenantId	문자열	고객을 식별하는 GUID 형식 문자열입니다.
currentSubscriptionID	문자열	현재 구독 ID를 식별하는 GUID 형식 문자열
externalReferenceID	문자열	마이그레이션 일괄 처리를 식별하는 GUID 형식 문자열

요청 헤더

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

응답 본문

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

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

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"
}
]

추가 정보

• 새 상거래 마이그레이션 예약
• 새 상거래 마이그레이션 일정 업데이트
• 새 상거래 마이그레이션 일정 취소