파트너는 한 거래 파트너에서 다른 거래 파트너로 새 상거래 구독을 전송할 수 있습니다. 대상 파트너가 전송 요청을 만듭니다. 소스 파트너는 항목 세부 사항을 포함하여 전송을 업데이트합니다. 이 항목에서는 대상 파트너가 전송 요청을 만들기 위해 호출하는 API에 대해 설명합니다. 이 항목은 Azure 플랜 예약, 저축 계획, 구독 및 새 상거래 라이선스 기반 구독에만 관련됩니다. 더 가치 있는 정보는 구독 전송 설명서에서 찾을 수 있습니다.
필수 조건
파트너 센터 인증에 설명된 대로 자격 증명. 이 시나리오는 독립 실행형 앱과 App+사용자 자격 증명을 모두 사용하여 인증을 지원합니다.
고객 ID (
customer-tenant-ID). 고객의 ID를 모르는 경우 고객 작업 영역을 선택하고 고객 목록에서 고객을 선택한 다음 계정을 선택하여 파트너 센터에서 조회할 수 있습니다. 고객 계정 페이지의 고객 계정 정보 섹션에서 Microsoft ID를 찾습니다. Microsoft ID는 고객 ID(customer-tenant-ID)와 동일합니다.적절한 역할: 관리 에이전트
REST 요청
요청 구문
| 메서드 | 요청 URI |
|---|---|
| 게시물 | {baseURL}/v1/customers/{customer-ID}/transfers HTTP/1.1 |
URI 매개 변수
다음 경로 매개 변수를 사용하여 고객을 식별합니다.
| 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| customer-id | 문자열 | 예 | 고객을 식별하는 GUID 형식의 고객 ID입니다. |
요청 헤더
자세한 내용은 Partner Center REST 헤더를 참조하세요.
요청 본문
이 표에서는 새 상거래 전송 요청을 만들기 위한 요청 본문에 있는 TransferEntity 속성에 대해 설명합니다.
| 재산 | 유형 | 필수 | 설명 |
|---|---|---|---|
| sourcePartnerTenantId (소스 파트너 테넌트 ID) | 문자열 | 예 | 전송을 시작하는 파트너를 식별하는 GUID 형식의 파트너 ID입니다. |
| sourcePartnerName | 문자열 | 예 | 전송을 시작하는 파트너 조직의 이름입니다. |
| 고객 이메일 ID | 문자열 | 예 | 전송 생성에 대한 알림을 받을 고객의 문자열입니다. |
| 고객 이름 | 문자열 | 아니요 | 선택 사항. 구독이 전송되는 고객의 이름입니다. |
| 대상 파트너 테넌트 ID | 문자열 | 아니요 | 전송 대상이 되는 파트너를 식별하는 GUID 형식의 파트너 테넌트 ID입니다. 생략할 경우, 파트너 승인 컨텍스트는 파트너 테넌트 ID로 확인됩니다. |
| 대상파트너이메일ID | 문자열 | 아니요 | 전송 대상이 되는 파트너를 식별하는 GUID 형식의 파트너 테넌트 ID입니다. 생략할 경우, 파트너 승인 컨텍스트는 파트너 테넌트 ID로 확인됩니다. |
| 대상 제품 유형 | 문자열 | 아니요 | 전송을 위해 제출할 수 있는 구독 유형을 지정하는 문자열 컬렉션입니다. Null은 모든 타입으로 간주됩니다. 값에는 AzureSubscription, AzureReservation, AzureSavingsPlan 및 OnlineServicesNCE가 포함될 수 있습니다. |
| partnerOnRecord | 문자열 | 아니요 | 전송된 품목 구독에 대한 레코드 파트너의 MPNID입니다. 간접 공급자 대상 파트너에게 트랜퍼링하는 경우에만 적용됩니다. |
| 전송유형 | 문자열 | 예 | 전송 형식을 정의하는 문자열입니다. 3은 NewCommerce 를 나타내며 Azure 플랜 및 새 상거래 라이선스 기반 구독에 사용해야 합니다. |
요청 예제
{
"id": "43fb1d3a-79fe-45a9-863e-9a4acf17b630",
"status": "InProgress",
"transferType": 3,
"customerEmailId": "",
"createdTime": "2024-04-30T18:31:41.5133355Z",
"lastModifiedTime": "2024-05-01T00:51:55Z",
"expirationTime": "2024-05-31T00:00:00Z",
"customerName": "ipdbtrans2",
"customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"partnertenantid": "a94dcde1-ecd7-wace-a6ef-ef73ba6b8ba5",
"sourcePartnerName": "Test_Test_IP4_AG",
"sourcePartnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"targetPartnerName": "Test_Test_DB_AG",
"targetPartnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"partnerOnRecord": "456789",
"targetPartnerEmailId": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
"targetProductTypes": [
"AzureSubscription",
"AzureReservation",
"AzureSavingsPlan",
"OnlineServicesNCE“
],
"transferDirection": 2,
"ignoreEligibilityCheck": false,
"lastModifiedUser": "1671774b-679f-4543-a152-1f8b14006c0e",
"lineItems": [{
"id": 0,
"subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
"billingCycle": "unknown",
"quantity": 0,
"productType": 5,
"status": "InProgress"
}],
"links": {
"self": {
"uri": "/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/transfers/43fb1d3a-79fe-45a9-863e-9a4acf17b630",
"method": "GET",
"headers": []
}
}
}
REST 응답
성공하면 이 메서드는 응답 본문에 채워진 TransferEntity 리소스를 반환합니다.
응답 성공 및 오류 코드
각 응답에는 성공 또는 실패 및 더 많은 디버깅 정보를 나타내는 HTTP 상태 코드가 함께 제공됩니다. 네트워크 추적 도구를 사용하여 이 코드, 오류 유형 및 기타 매개 변수를 읽습니다. 전체 목록은 오류 코드를 참조하세요.
응답 예제
HTTP/1.1 201 Created
Content-Length: 138
Content-Type: application/json; charset=utf-8
MS-RequestId: 4fa6dad6-a89f-4875-8247-7294a10ae1cf
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US,en-US
{
"id": "43fb1d3a-79fe-45a9-863e-9a4acf17b630",
"status": "Pending",
"transferType": 3,
"customerEmailId": "",
"createdTime": "2024-04-30T18:31:41.5133355Z",
"lastModifiedTime": "2024-04-30T18:31:41Z",
"expirationTime": "2024-05-31T00:00:00Z",
"customerName": "ipdbtrans2",
"customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"partnertenantid": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
"sourcePartnerName": "Test_Test_IP4_AG",
"sourcePartnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"targetPartnerName": "Test_Test_DB_AG",
"targetPartnerTenantId": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
"targetPartnerEmailId": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
"partnerOnRecord": "456789",
"targetProductTypes": [
"AzureSubscription",
"AzureReservation",
"AzureSavingsPlan",
"OnlineServicesNCE“
],
"transferDirection": 1,
"ignoreEligibilityCheck": false,
"lastModifiedUser": "7ffdaa28-3b1c-4a61-b580-e1aa6ecf833c",
"links": {
"self": {
"uri": "/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/transfers/43fb1d3a-79fe-45a9-863e-9a4acf17b630",
"method": "GET",
"headers": []
}
}
}