새 상거래 마이그레이션 쿼리

아티클
12/29/2023

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

고객 ID, 현재 구독 ID 또는 외부 참조 ID를 기반으로 마이그레이션된 구독을 쿼리하는 방법

적절한 역할: 전역 관리자 | 관리 에이전트 | 판매 에이전트

필수 조건

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

이 API는 파트너가 선택하는 쿼리 문자열을 기준으로 필터링할 수 있습니다. 선택한 쿼리 문자열은 다음 세 가지 옵션 중에서 선택할 수 있습니다.

CustomerTenantId입니다. 고객의 ID를 모르는 경우 고객 작업 영역, 고객 목록에서 고객, 계정을 선택하여파트너 센터에서 조회할 수 있습니다. 고객의 계정 페이지에서 고객 계정 정보 섹션에서 Microsoft ID를 찾습니다. Microsoft ID는 고객 ID와 동일합니다.
CurrentSubscriptionId(마이그레이션된 구독의 레거시 ID)
ExternalReferenceId(파트너 센터 SDK를 통해 다운로드할 수 있는 Batch 마이그레이션 도구에서 반환된 일괄 처리 ID)

REST 요청

요청 구문

메서드	요청 URI
GET	{baseURL}/v1/migrations/newcommerce HTTP/1.1

쿼리 문자열

이 표에는 새 상거래 마이그레이션을 필터링하고 검색하는 데 필요한 쿼리 문자열이 나열되어 있습니다. 마이그레이션을 성공적으로 쿼리하려면 3개 ID 중 하나 이상이 필요합니다. 쿼리에 여러 ID를 입력하는 것은 허용되지만 필수는 아닙니다.

이름	설명
CustomerTenantId	고객을 식별하는 GUID 형식 문자열입니다.
CurrentSubscriptionId	마이그레이션된 레거시 구독을 식별하는 GUID 형식 문자열입니다.
ExternalReferenceId	마이그레이션 일괄 처리를 식별하는 GUID 형식 문자열입니다.

요청 헤더

자세한 내용은 파트너 센터 REST 헤더를 참조하세요. API의 응답은 최대 300개 페이지 레코드를 반환합니다. 입력된 쿼리에서 300개가 넘는 레코드가 반환되면 응답 헤더에 연속 토큰이 제공됩니다. 연속 토큰은 쿼리된 추가 페이지 레코드를 반환하기 위해 다음 요청의 헤더에 입력될 수 있습니다.

요청 본문

없음.

REST 응답

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

응답 성공 및 오류 코드

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

요청 URL 예제

baseurl/v1/migrations/newcommerce?CustomerTenantId=83c51838-fed5-44a4-a275-afa201d53699&CurrentSubscriptionId=6CCC6A93-93E4-4382-AF1F-E51237232833&ExternalReferenceId=9ab61899-0b2b-4320-bd6d-8196c53607d6

baseurl/v1/migrations/newcommerce?CurrentSubscriptionId=6CCC6A93-93E4-4382-AF1F-E51237232833

응답 예제

[
{
"addOnMigrations": [],
"id": "8ce7115e-0324-41b1-8ca3-7c7ae3b64f75",
"startedTime": "2022-02-24T23:50:30.4384819Z",
"completedTime": "2022-02-24T23:53:14.0813711Z",
"currentSubscriptionId": "9E289691-2FF3-419D-B39B-26B3E5A817FB",
"status": "Completed",
"customerTenantId": "ce6fcc21-c276-447b-9605-874decb9024b",
"catalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0KQDF",
"newCommerceSubscriptionId": "f2d6534b-9e30-4cf5-c7b0-5d6393dbf12d",
"newCommerceOrderId": "09714c93092a",
"subscriptionEndDate": "2023-02-14T00:00:00Z",
"quantity": 2,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"externalReferenceId": "771317a4-275d-47d9-9724-3eefa4a168ad"
}
]