고객에 대한 제품 업그레이드 엔터티 만들기

아티클
10/01/2024

ProductUpgradeRequest 리소스를 사용하여 고객을 지정된 제품 제품군(예: Azure 플랜)으로 업그레이드하는 제품 업그레이드 엔터티를 만들 수 있습니다.

필수 조건

자격 증명(파트너 센터 인증에서 설명). 이 시나리오는 앱+사용자 자격 증명을 통한 인증을 지원합니다. 파트너 센터 API에서 App+User 인증을 사용하는 경우 보안 앱 모델을 따릅니다.
고객 ID (customer-tenant-id). 고객의 ID를 모르는 경우 고객 작업 영역, 고객 목록에서 고객, 계정을 선택하여 파트너 센터에서 조회할 수 있습니다. 고객의 계정 페이지에서 고객 계정 정보 섹션에서 Microsoft ID를 찾습니다. Microsoft ID는 고객 ID(customer-tenant-id)와 동일합니다.
고객을 업그레이드하려는 제품군입니다.

C#

고객을 Azure 플랜으로 업그레이드하려면 다음을 수행합니다.

ProductUpgradesRequest 개체를 만들고 고객 식별자 및 "Azure"를 제품 패밀리로 지정합니다.
IAggregatePartner.ProductUpgrades 컬렉션을 사용합니다.
Create 메서드를 호출하고 위치 헤더 문자열을 반환하는 ProductUpgradesRequest 개체를 전달합니다.
업그레이드 상태 쿼리하는 데 사용할 수 있는 위치 헤더 문자열에서 upgrade-id를 추출합니다.

// IAggregatePartner partnerOperations;

string selectedCustomerId = "58e2af4f-0ad3-4688-8744-be2357cd939a";

string selectedProductFamily = "Azure";

var productUpgradeRequest = new ProductUpgradesRequest
{
    CustomerId = selectedCustomerId,
    ProductFamily = selectedProductFamily
};

var productUpgradeLocationHeader = partnerOperations.ProductUpgrades.Create(productUpgradeRequest);

var upgradeId = Regex.Split(productUpgradeLocationHeader, "/")[1];

REST 요청

요청 구문

메서드	요청 URI
POST	{baseURL}/v1/productupgrades HTTP/1.1

요청 헤더

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

요청 본문

요청 본문에는 ProductUpgradeRequest 리소스가 포함되어야 합니다.

요청 예제

POST https://api.partnercenter.microsoft.com/v1/productupgrades HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: c245d5f2-1de3-4ae0-9e42-95e38e3cb8ff
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
MS-PartnerCenter-Application: Partner Center .NET SDK Samples
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 340
Expect: 100-continue
Connection: Keep-Alive
{
  "customerId": "4c721420-72ad-4708-a0a7-371a2f7b0969",
  "productFamily": "Azure"
}

Important

2023년 6월 현재 최신 파트너 센터 .NET SDK 릴리스 3.4.0이 보관됩니다. 유용한 정보가 포함된 추가 정보 파일과 함께 GitHub에서 SDK 릴리스를 다운로드할 수 있습니다.

파트너는 파트너 센터 REST API를 계속 사용하는 것이 좋습니다.

REST 응답

성공하면 응답에 제품 업그레이드 상태 검색하는 데 사용할 수 있는 URI가 있는 Location 헤더가 포함됩니다. 다른 관련 REST API와 함께 사용할 수 있는 이 URI를 저장합니다.

응답 성공 및 오류 코드

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

응답 예제

HTTP/1.1 202 Accepted
Content-Length: 0
Location: productUpgrades/42d075a4-bfe7-43e7-af6d-7c68a57edcb4
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: cb82f7d6-f0d9-44d4-82f9-f6eee6e68390
MS-CV: iqOqN0FnaE2y0HcD.0
MS-ServerId: 030020525
Date: Thu, 28 Sep 2019 20:35:35 GMT

다음을 통해 공유