파트너 센터 API를 사용하여 통합 샌드박스에서 주문 취소

아티클
03/15/2024

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

이 문서에서는 파트너 센터 API를 사용하여 통합 샌드박스 계정에서 다양한 유형의 구독 주문을 취소하는 방법을 설명합니다. 이러한 주문에는 예약 인스턴스, 소프트웨어 및 상업용 Marketplace SaaS(Software as a Service) 구독 주문이 포함될 수 있습니다.

다음 표에서는 샌드박스 및 프로덕션의 취소 순서를 보여 줍니다.

제품 유형	샌드박스 업데이트 순서	샌드박스 업데이트 구독	프로덕션 업데이트 순서	프로덕션 업데이트 구독
Azure 예약 인스턴스	Y	N	N	N
영구 소프트웨어	Y	N	Y	N
소프트웨어 구독	Y	Y	Y	Y
새 상거래	N	Y	N	Y
상용 마켓플레이스	N	Y	N	Y
Azure 플랜을 참조하세요.	N	Y	N	Y

참고 항목

예약 인스턴스 또는 상업용 Marketplace SaaS 구독 주문 취소는 통합 샌드박스 계정에서만 가능합니다. 60일보다 오래된 샌드박스 주문은 파트너 센터에서 취소할 수 없습니다.

API를 통해 소프트웨어의 프로덕션 주문을 취소하려면 cancel-software-purchases를 사용합니다. 구매 취소를 사용하여 대시보드를 통해 소프트웨어의 프로덕션 주문을 취소할 수도 있습니다.

필수 조건

자격 증명(파트너 센터 인증에서 설명). 이 시나리오는 독립 실행형 앱과 App+사용자 자격 증명을 모두 사용하여 인증을 지원합니다.
활성 예약 인스턴스/소프트웨어/타사 SaaS 구독 주문이 있는 고객과의 통합 샌드박스 파트너 계정입니다.

C#

통합 샌드박스에서 주문을 취소하려면 계정 자격 증명을 메서드에 CreatePartnerOperations 전달하여 파트너 작업을 가져오는 IPartner 인터페이스를 가져옵니다.

특정 주문을 선택하려면 고객 식별자와 함께 파트너 작업 및 호출 Customers.ById() 메서드를 사용하여 고객을 지정한 Orders.ById() 다음 주문 식별자와 함께 주문 및 최종 Get 또는 GetAsync 검색 방법을 지정합니다.

Order.Status 속성을 cancelled 설정하고 메서드를 Patch() 사용하여 주문을 업데이트합니다.

// IPartnerCredentials tipAccountCredentials;
// Customer tenant Id to be deleted.
// string customerTenantId;

IPartner tipAccountPartnerOperations = PartnerService.Instance.CreatePartnerOperations(tipAccountCredentials);

// Cancel order
var order = tipAccountPartnerOperations.Customers.ById(customerTenantId).Orders.ById(orderId).Get();
order.Status = "cancelled";
order = tipAccountPartnerOperations.Customers.ById(customerTenantId).Orders.ById(orderId).Patch(order);

REST 요청

요청 구문

메서드	요청 URI
패치	{baseURL}/v1/customers/{customer-tenant-id}/orders/{order-id} HTTP/1.1

URI 매개 변수

다음 쿼리 매개 변수를 사용하여 고객을 삭제합니다.

속성	Type	필수	설명
customer-tenant-id	guid	Y	이 값은 재판매인이 자신에게 속한 특정 고객에 대한 결과를 필터링할 수 있도록 하는 GUID 유형의 customer-tenant-id입니다.
order-id	string	Y	이 값은 취소해야 하는 주문 ID를 나타내는 문자열입니다.

요청 헤더

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

요청 본문

{
    "id": "UKXASSO1dezh3HdxClHxSp5UEFXGbAnt1",
    "status": "cancelled",
}

요청 예제

PATCH https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/orders/<order-id> HTTP/1.1
Accept: application/json
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

{
    "id": "UKXASSO1dezh3HdxClHxSp5UEFXGbAnt1",
    "status": "cancelled",
}

REST 응답

성공하면 이 메서드는 취소된 순서를 반환합니다.

응답 성공 및 오류 코드

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

응답 예제

HTTP/1.1 200 OK
Content-Length: 866
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5

{
    "id": "UKXASSO1dezh3HdxClHxSp5UEFXGbAnt1",
    "alternateId": "11fc4bdfd47a",
    "referenceCustomerId": "bd59b416-37f9-4d8f-8df3-5750111fc615",
    "billingCycle": "one_time",
    "currencyCode": "USD",
    "currencySymbol": "$",
    "lineItems": [
        {
            "lineItemNumber": 0,
            "offerId": "DG7GMGF0DWT0:0001:DG7GMGF0DSQR",
            "termDuration": "",
            "transactionType": "New",
            "friendlyName": "Microsoft Identity Manager 2016 - 1 User CAL",
            "quantity": 1,
            "links": {
                "product": {
                    "uri": "/products/DG7GMGF0DWT0?country=US",
                    "method": "GET",
                    "headers": []
                },
                "sku": {
                    "uri": "/products/DG7GMGF0DWT0/skus/0001?country=US",
                    "method": "GET",
                    "headers": []
                },
                "availability": {
                    "uri": "/products/DG7GMGF0DWT0/skus/0001/availabilities/DG7GMGF0DSQR?country=US",
                    "method": "GET",
                    "headers": []
                }
            }
        }
    ],
    "creationDate": "2019-02-21T17:56:21.1335741Z",
    "status": "cancelled",
    "transactionType": "UserPurchase",
    "attributes": {
        "objectType": "Order"
    }
}

다음을 통해 공유