파트너 센터 REST API를 사용하여 새 상거래에 대한 전송 만들기

아티클
09/20/2024

파트너는 한 거래 파트너에서 다른 거래 파트너로 새 상거래 구독을 전송할 수 있습니다. 대상 파트너가 전송 요청을 만듭니다. 원본 파트너 는 줄 항목 세부 정보로 전송 을 업데이트합니다. 이 항목에서는 대상 파트너가 전송 요청을 만들기 위해 호출하는 API에 대해 설명합니다. 이 항목은 Azure 플랜 예약, 저축 계획, 구독 및 새 상거래 라이선스 기반 구독에만 관련됩니다. 더 중요한 정보는 구독 전송 설명서에서 찾을 수 있습니다.

필수 조건

자격 증명(파트너 센터 인증에서 설명). 이 시나리오는 독립 실행형 앱과 App+사용자 자격 증명을 모두 사용하여 인증을 지원합니다.
고객 ID (customer-tenant-ID). 고객의 ID를 모르는 경우 고객 작업 영역을 선택하고 고객 목록에서 고객을 선택한 다음 계정을 선택하여 파트너 센터에서 조회할 수 있습니다. 고객 계정 페이지의 고객 계정 정보 섹션에서 Microsoft ID를 찾습니다. Microsoft ID는 고객 ID(customer-tenant-ID)와 동일합니다.
적절한 역할: 관리 에이전트

REST 요청

요청 구문

메서드	요청 URI
POST	{baseURL}/v1/customers/{customer-ID}/transfers HTTP/1.1

URI 매개 변수

다음 경로 매개 변수를 사용하여 고객을 식별합니다.

속성	Type	필수	설명
customer-id	string	예	고객을 식별하는 GUID 형식의 고객 ID입니다.

요청 헤더

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

요청 본문

이 표에서는 새 상거래 전송 요청을 만들기 위한 요청 본문의 TransferEntity 속성에 대해 설명합니다.

속성	형식	필수	설명
sourcePartnerTenantId	string	예	전송을 시작하는 파트너를 식별하는 GUID 형식의 파트너 ID입니다.
sourcePartnerName	string	예	전송을 시작하는 파트너 조직의 이름입니다.
customerEmailId	string	예	전송 생성에 대한 알림을 받을 고객의 문자열입니다.
customerName	string	아니요	선택 사항. 구독이 전송되는 고객의 이름입니다.
targetPartnerTenantId	string	아니요	전송 대상이 되는 파트너를 식별하는 GUID 형식의 파트너 테넌트 ID입니다. 생략하면 파트너 권한 부여 컨텍스트가 파트너 테넌트 ID로 확인됩니다.
targetPartnerEmailId	string	아니요	전송 대상이 되는 파트너를 식별하는 GUID 형식의 파트너 테넌트 ID입니다. 생략하면 파트너 권한 부여 컨텍스트가 파트너 테넌트 ID로 확인됩니다.
transferType	string	예	전송 형식을 정의하는 문자열입니다. 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",
    "targetPartnerEmailId": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
    "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 응답

성공하면 이 메서드는 응답 본문에 채워진 TransferEnity 리소스를 반환합니다.

응답 성공 및 오류 코드

각 응답에는 성공 또는 실패 및 더 많은 디버깅 정보를 나타내는 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",
"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": []
    }
}
}

다음을 통해 공유