고객의 제품 업그레이드 상태 가져오기

아티클
03/07/2025

ProductUpgradeRequest 리소스를 사용하여 새 제품군으로 업그레이드 상태를 가져올 수 있습니다. 이 리소스는 Microsoft Azure(MS-AZR-0145P) 구독에서 Azure 플랜으로 고객을 업그레이드할 때 적용됩니다. 요청이 성공하면 ProductUpgradesEligibility 리소스가 반환됩니다.

필수 구성 요소

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

C#

고객이 Azure 플랜으로 업그레이드할 수 있는지 확인하려면 다음을 수행합니다.

ProductUpgradesRequest 개체를 만들고 고객 식별자 및 "Azure"를 제품 패밀리로 지정합니다.
IAggregatePartner.ProductUpgrades 컬렉션을 사용하세요.
ById 메서드를 호출하고 upgrade-id전달합니다.
CheckStatus 메서드를 호출하고 ProductUpgradesRequest 개체를 전달하면 ProductUpgradeStatus 개체가 반환됩니다.

// IAggregatePartner partnerOperations;

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

string selectedProductFamily = "azure";

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

ProductUpgradesStatus productUpgradeStatus = partnerOperations.ProductUpgrades.ById(selectedUpgradeId).CheckStatus(productUpgradeRequest);

if (productUpgradeEligibility.IsEligibile)
{
    ....
}

REST 요청

요청 구문

메서드	요청 URI
POST	{baseURL}/v1/productUpgrades/{upgrade-id}/status HTTP/1.1

URI 매개 변수

다음 쿼리 매개 변수를 사용하여 제품 업그레이드 상태를 가져오는 고객을 지정합니다.

이름	유형	필수	묘사
upgrade-id	GUID	예	값은 GUID 형식 업그레이드 식별자입니다. 이 식별자를 사용하여 추적할 업그레이드를 지정할 수 있습니다.

요청 헤더

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

요청 본문

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

요청 예제

POST https://api.partnercenter.microsoft.com/v1/productupgrades/42d075a4-bfe7-43e7-af6d-7c68a57edcb4/status  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"
  }
  "Attributes": {
  "ObjectType": "ProductUpgradeRequest"
  }
}

중요하다

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

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

REST 응답

성공하면 이 메서드는 본문에 ProductUpgradesEligibility 리소스를 반환합니다.

응답 성공 및 오류 코드

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

응답 예제

HTTP/1.1 200 Ok
Content-Length: 150
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: cb82f7d6-f0d9-44d4-82f9-f6eee6e68390
MS-CV: iqOqN0FnaE2y0HcD.0
MS-ServerId: 030020525
Date: Thu, 04 Oct 2019 20:35:35 GMT

{
    "id": "42d075a4-bfe7-43e7-af6d-7c68a57edcb4",
    "status": "Completed",
    "productFamily": "Azure",
    "lineItems": [
        {
            "sourceProduct": {
                "id": "b1beb621-3cad-4d7a-b360-62db33ce028e",
                "name": "AzureSubscription"
            },
            "targetProduct": {
                "id": "d231908e-31c1-de0e-027b-bc5ce11f09d9",
                "name": "Microsoft Azure plan"
            },
            "upgradedDate": "2019-08-29T23:47:28.8524555Z",
            "status": "Completed"
        }
    ]
}

다음을 통해 공유