Hämta status för produktuppgradering för en kund

Artikel
10/01/2024

Du kan använda resursen ProductUpgradeRequest för att hämta status för en uppgradering till en ny produktfamilj. Den här resursen gäller när du uppgraderar en kund från en Microsoft Azure-prenumeration (MS-AZR-0145P) till en Azure-plan. En lyckad begäran returnerar resursen ProductUpgradesEligibility .

Förutsättningar

Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder autentisering med app+användarautentiseringsuppgifter. Följ den säkra appmodellen när du använder App+User-autentisering med Partnercenter-API:er.
Ett kund-ID (customer-tenant-id). Om du inte känner till kundens ID kan du söka efter det i Partnercenter genom att välja arbetsytan Kunder , sedan kunden från kundlistan och sedan Konto. På kundens kontosida letar du efter Microsoft-ID :t i avsnittet Kundkontoinformation . Microsoft-ID:t är samma som kund-ID :t (customer-tenant-id).
Produktfamiljen.
Uppgraderings-ID för en uppgraderingsbegäran.

C#

Så här kontrollerar du om en kund är berättigad att uppgradera till Azure-planen:

Skapa ett ProductUpgradesRequest-objekt och ange kundidentifieraren och "Azure" som produktfamilj.
Använd samlingen IAggregatePartner.ProductUpgrades.
Anropa ById-metoden och skicka in uppgraderings-ID:t.
Anropa metoden CheckStatus och skicka in objektet ProductUpgradesRequest, som returnerar ett ProductUpgradeStatus-objekt.

// 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-begäran

Syntax för begäran

Metod	URI för förfrågan
POST	{baseURL}/v1/productUpgrades/{upgrade-id}/status HTTP/1.1

URI-parameter

Använd följande frågeparameter för att ange den kund som du får status för produktuppgradering för.

Namn	Type	Obligatoriskt	Beskrivning
upgrade-id	GUID	Ja	Värdet är en GUID-formaterad uppgraderingsidentifierare. Du kan använda den här identifieraren för att ange en uppgradering att spåra.

Begärandehuvuden

Mer information finns i REST-huvuden för Partnercenter.

Begärandetext

Begärandetexten måste innehålla en ProductUpgradeRequest-resurs.

Exempel på begäran

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"
  }
}

Viktigt!

Från och med juni 2023 arkiveras nu den senaste Partner Center .NET SDK-versionen 3.4.0. Du kan ladda ned SDK-versionen från GitHub tillsammans med en readme-fil som innehåller användbar information.

Partner uppmanas att fortsätta att använda REST-API:er för Partnercenter.

REST-svar

Om det lyckas returnerar den här metoden en ProductUpgradesEligibility-resurs i brödtexten.

Svarsframgång och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i Rest-felkoder för Partnercenter.

Svarsexempel

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"
        }
    ]
}

Dela via