고객에 대한 제품 업그레이드 상태 가져오기

아티클
10/01/2024

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

필수 조건

자격 증명(파트너 센터 인증에서 설명). 이 시나리오는 앱+사용자 자격 증명을 통한 인증을 지원합니다. 파트너 센터 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 메서드를 호출하고 ProductUpgradeStatus 개체를 반환하는 ProductUpgradesRequest 개체를 전달합니다.

// 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}/상태 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: e3f26e6a-044f-4371-ad52-0d91ce4200be
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"
  }
}

Important

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

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

REST 응답

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

응답 성공 및 오류 코드

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

응답 예제

HTTP/1.1 200 Ok
Content-Length: 150
MS-CorrelationId: 772871a9-399b-4f3b-b8c7-38f550e4f22a
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"
        }
    ]
}

다음을 통해 공유