전환 가져오기
적용 대상
- 파트너 센터
적절한 역할
- 글로벌 관리자
- 관리 에이전트
참고
라이선스 기반 서비스에 대한 새로운 상거래 환경에는 많은 새로운 기능이 포함되며 모든 CSP(클라우드 솔루션 공급자)에서 사용할 수 있습니다. 자세한 내용은 새 상거래 환경 개요를 참조하세요.
지정된 고객 및 구독에 대한 전환 기록을 가져오는 데 사용됩니다. 기록에는 전환에 대해 처리된 모든 이벤트가 포함됩니다. 이는 새로운 상거래 라이선스 기반 구독 전환만 지원합니다.
필수 구성 요소
자격 증명(파트너 센터 인증에서 설명). 이 시나리오는 독립 실행형 앱 및 App+사용자 자격 증명을 모두 사용하여 인증을 지원합니다.
고객 ID (
customer-tenant-id
). 고객의 ID를 모르는 경우 고객 작업 영역, 고객 목록에서 고객, 계정을 차례로 선택하여 파트너 센터에서 조회할 수 있습니다. 고객 계정 페이지의 고객 계정 정보 섹션에서 Microsoft ID를 찾습니다. Microsoft ID는 고객 ID(customer-tenant-id
)와 동일합니다.전환된 구독에 대한 하나의 구독 ID입니다.
REST 요청
[GET] customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitions
요청 구문
방법 | 요청 URI |
---|---|
GET | {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitions HTTP/1.1 |
URI 매개 변수
다음 쿼리 매개 변수를 사용하여 적격 전환을 반환합니다.
속성 | 형식 | 필수 | Description |
---|---|---|---|
customer-tenant-id | guid | Y | 고객의 테넌트 에 해당하는 GUID입니다. |
subscription-id | guid | Y | 초기 구독에 해당하는 GUID입니다. |
operation-id | guid | N | 전환을 고유하게 식별하고 상태를 추적하는 GUID입니다. |
요청 헤더
자세한 내용은 파트너 센터 REST 헤더를 참조하세요.
요청 본문
없음
요청 예제
GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitions HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
MS-CorrelationId: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
X-Locale: en-US
REST 응답
성공하면 제공된 구독에 대한 전환 기록이 반환됩니다.
응답 성공 및 오류 코드
각 응답에는 성공 또는 실패와 추가 디버깅 정보를 나타내는 HTTP 상태 코드가 함께 제공됩니다. 네트워크 추적 도구를 사용하여 이 코드, 오류 유형 및 추가 매개 변수를 읽을 수 있습니다. 전체 목록은 오류 코드를 참조하세요.
응답 예제
HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
Date: Fri, 26 Feb 2021 20:42:26 GMT
{
"transition": [
{
"operationId": "1caf8ec7-62cc-4ab5-b35d-572d2a62974c",
"FromCatalogItemId": "CFQ7TTC0LDPB:0001:CFQ7TTC0LGNT",
"ToCatalogItemId": "CFQ7TTC0LF8S:0001:CFQ7TTC0K9G9",
"quantity": 1,
"transitionType": "transition_with_license_transfer",
"Events": [
{
"name": "Conversion",
"status": "Started ",
"timestamp": "2021-01-08T18:01:14.7488618Z",
"attributes":
{
"objectType": "TransitionEvent"
}
},
{
"name": "Conversion",
"status": "Completed",
"timestamp": "2021-01-08T18:37:41.591855Z",
"attributes":
{
"objectType": "TransitionEvent"
}
}
],
"attributes":
{
"objectType": "Transition"
}
}
],
"attributes":
{
"objectType": "Collection"
}
}
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기