ID로 전송 세부 정보 가져오기
필수 조건
자격 증명(파트너 센터 인증에서 설명). 이 시나리오는 독립 실행형 앱과 App+사용자 자격 증명을 모두 사용하여 인증을 지원합니다.
고객 ID (
customer-tenant-id). 고객의 ID를 모르는 경우 고객 작업 영역을 선택하고 고객 목록에서 고객을 선택한 다음 계정을 선택하여 파트너 센터에서 조회할 수 있습니다. 고객 계정 페이지의 고객 계정 정보 섹션에서 Microsoft ID를 찾습니다. Microsoft ID는 고객 ID(customer-tenant-id)와 동일합니다.기존 전송에 대한 전송 식별자입니다.
적절한 역할: 관리 에이전트
REST 요청
요청 구문
| 메서드 | 요청 URI |
|---|---|
| GET | {baseURL}/v1/customers/{customer-id}/transfers/{transfer-id} HTTP/1.1 |
URI 매개 변수
다음 경로 매개 변수를 사용하여 고객을 식별하고 수락할 전송을 지정합니다.
| 속성 | Type | 필수 | 설명 |
|---|---|---|---|
| customer-id | string | 예 | 고객을 식별하는 GUID 형식의 고객 ID입니다. |
| transfer-id | string | 예 | 전송을 식별하는 GUID 형식의 transfer-id입니다. |
요청 헤더
자세한 내용은 파트너 센터 REST 헤더를 참조하세요.
요청 예제
GET /v1/customers/b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0/transfers/46e8ed67-8adf-4f65-b3d8-d31318080556 HTTP/1.1
Authorization: Bearer <token>
Connection: keep-alive
MS-RequestId: 0d61b5ce-b396-4f5e-a50b-e8779d0d23cc
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
Accept: application/json
REST 응답
성공하면 이 메서드는 응답 본문에 채워진 TransferEntity 리소스를 반환합니다.
응답 성공 및 오류 코드
각 응답에는 성공 또는 실패와 추가 디버깅 정보를 나타내는 HTTP 상태 코드가 함께 제공됩니다. 네트워크 추적 도구를 사용하여 이 코드, 오류 유형 및 추가 매개 변수를 읽을 수 있습니다. 전체 목록은 오류 코드를 참조하세요.
진행 중인 응답 예제
HTTP/1.1 200 OK
Content-Length: 1501
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 0d61b5ce-b396-4f5e-a50b-e8779d0d23cc
X-Locale: en-US
Date: Fri, 17 May 2024 18:25:25 GMT
{
"id": "96978f5b-ee35-486f-96e9-a17ed4a1d87d",
"status": "InProgress",
"transferType": 3,
"customerEmailId": "",
"createdTime": "2024-04-09T22:45:06.7851706Z",
"lastModifiedTime": "2024-04-10T17:26:56Z",
"customerName": "legacytomodern09022021",
"customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"partnertenantid": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
"sourcePartnerName": "test",
"sourcePartnerTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
"targetPartnerName": "TEST_TEST_CSPIntegrationTest2T19Q3",
"targetPartnerTenantId": "ccccdddd-2222-eeee-3333-ffff4444aaaa",
"targetPartnerEmailId": "ccccdddd-2222-eeee-3333-ffff4444aaaa",
"transferDirection": 2,
"ignoreEligibilityCheck": false,
"lastModifiedUser": "fec7ff82-163d-4763-afb1-6947d2b0db28",
"lineItems": [
{
"id": 0,
"subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
"billingCycle": "unknown",
"quantity": 0,
"productType": 0,
"status": "InProgress"
},
{
"id": 0,
"subscriptionId": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
"billingCycle": "unknown",
"quantity": 0,
"productType": 5,
"status": "InProgress"
}
],
"links": {
"self": {
"uri": "/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/transfers/96978f5b-ee35-486f-96e9-a17ed4a1d87d",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "TransferEntity"
}
}
진행 중인 응답 예제
HTTP/1.1 200 OK
Content-Length: 1501
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 0d61b5ce-b396-4f5e-a50b-e8779d0d23cc
X-Locale: en-US
Date: Fri, 17 May 2024 18:25:25 GMT
{
"id": "2d9a20f4-532d-438d-b694-bb7ab4585508",
"status": "Pending",
"transferType": 3,
"customerEmailId": "",
"createdTime": "2024-05-09T18:53:13.8486497Z",
"lastModifiedTime": "2024-05-09T18:53:14Z",
"customerName": "legacytomodern09022021",
"customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"partnertenantid": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
"sourcePartnerName": "test",
"sourcePartnerTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
"targetPartnerName": "TEST_TEST_CSPIntegrationTest2T19Q3",
"targetPartnerTenantId": "ccccdddd-2222-eeee-3333-ffff4444aaaa",
"targetPartnerEmailId": "ccccdddd-2222-eeee-3333-ffff4444aaaa",
"transferDirection": 2,
"ignoreEligibilityCheck": false,
"lastModifiedUser": "35ebf490-ac97-44af-9048-d3cdac1e4c84",
"links": {
"self": {
"uri": "/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/transfers/2d9a20f4-532d-438d-b694-bb7ab4585508",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "TransferEntity"
}
}
완료에 대한 응답 예제
HTTP/1.1 200 OK
Content-Length: 1501
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 0d61b5ce-b396-4f5e-a50b-e8779d0d23cc
X-Locale: en-US
Date: Fri, 17 May 2024 18:25:25 GMT
{
"id": "1c53f090-7a5d-454f-bffa-696650863e79",
"status": "Complete",
"transferType": 3,
"customerEmailId": "",
"createdTime": "2024-04-24T19:29:58.4656093Z",
"lastModifiedTime": "2024-04-24T19:38:22Z",
"completedTime": "2024-04-24T19:36:12.7197415Z",
"customerName": "legacytomodern09022021",
"customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"partnertenantid": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
"sourcePartnerName": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
"sourcePartnerTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
"targetPartnerName": "TEST_TEST_CSPIntegrationTest2T19Q3",
"targetPartnerTenantId": "ccccdddd-2222-eeee-3333-ffff4444aaaa",
"targetPartnerEmailId": "ccccdddd-2222-eeee-3333-ffff4444aaaa",
"transferDirection": 2,
"ignoreEligibilityCheck": false,
"lastModifiedUser": "f430373f-96d2-4ba5-b3ab-6b5dc69ae44f",
"lineItems": [
{
"id": 0,
"subscriptionId": "cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a",
"billingCycle": "unknown",
"quantity": 0,
"productType": 0
},
{
"id": 1,
"orderId": "bc857bb7-45ad-4667-b369-14126df2f74c",
"billingCycle": "unknown",
"quantity": 0,
"productType": 1
}
],
"links": {
"self": {
"uri": "/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/transfers/1c53f090-7a5d-454f-bffa-696650863e79",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "TransferEntity"
}
}