Uzyskaj stan uaktualnienia produktu dla klienta

Artykuł
03/07/2025

Aby uzyskać stan uaktualnienia do nowej rodziny produktów, możesz użyć zasobu ProductUpgradeRequest. Ten zasób ma zastosowanie podczas uaktualniania klienta z subskrypcji platformy Microsoft Azure (MS-AZR-0145P) do planu platformy Azure. Wynikiem pomyślnego żądania jest zasób ProductUpgradesEligibility.

Warunki wstępne

Poświadczenia zgodnie z opisem w uwierzytelnianie Centrum partnerskiego. Ten scenariusz obsługuje uwierzytelnianie przy użyciu poświadczeń aplikacji i użytkownika. Postępuj zgodnie z bezpiecznym modelem aplikacji podczas korzystania z uwierzytelniania App+User za pomocą API Centrum partnerskiego.
Identyfikator klienta (customer-tenant-id). Jeśli nie znasz identyfikatora klienta, możesz wyszukać go w centrum partnerskim , wybierając obszar roboczy Klienci, a następnie klient z listy klientów, a następnie konto. Na stronie konta klienta poszukaj identyfikatora Microsoft w sekcji Informacje o koncie klienta. Identyfikator Firmy Microsoft jest taki sam jak identyfikator klienta (customer-tenant-id).
Rodzina produktów.
Identyfikator żądania uaktualnienia.

C#

Aby sprawdzić, czy klient kwalifikuje się do uaktualnienia do planu platformy Azure:

Utwórz obiekt ProductUpgradesRequest i określ identyfikator klienta i "Azure" jako rodzinę produktów.
Użyj kolekcji IAggregatePartner.ProductUpgrades.
Wywołaj metodę ById i przekaż identyfikator uaktualnienia.
Wywołaj metodę CheckStatus i przekaż obiekt ProductUpgradesRequest, który zwróci obiekt 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)
{
    ....
}

Żądanie REST

Składnia żądania

Metoda	Identyfikator URI żądania
POST	{baseURL}/v1/productUpgrades/{upgrade-id}/status HTTP/1.1

Parametr identyfikatora URI

Użyj następującego parametru zapytania, aby określić klienta, dla którego otrzymujesz stan uaktualnienia produktu.

Nazwa	Typ	Wymagane	Opis
upgrade-id	GUID	Tak	Wartość jest identyfikatorem uaktualnienia sformatowanego w formacie GUID. Możesz użyć tego identyfikatora, aby określić aktualizację do śledzenia.

Nagłówki żądań

Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum partnerskiego.

Treść żądania

Treść żądania musi zawierać zasób ProductUpgradeRequest.

Przykład żądania

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

Ważny

Od czerwca 2023 r. najnowsza wersja zestawu .NET SDK Centrum partnerskiego 3.4.0 jest teraz archiwizowana. Możesz pobrać wydanie SDK z witryny GitHub, wraz z plikiem readme, zawierającym przydatne informacje.

Zachęcamy partnerów do dalszego korzystania z interfejsów API REST centrum partnerskiego.

Odpowiedź REST

Jeśli ta metoda powiedzie się, zwraca zasób ProductUpgradesEligibility w treści odpowiedzi.

Kody sukcesu i błędów odpowiedzi

Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i dodatkowe informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i dodatkowe parametry. Aby uzyskać pełną listę, zobacz Kody błędów REST Centrum partnerskiego.

Przykład odpowiedzi

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

Udostępnij za pośrednictwem