Udostępnij przez

Tworzenie jednostki uaktualniania produktu dla klienta

Możesz utworzyć encję uaktualnienia produktu, aby uaktualnić klienta do danej rodziny produktów (na przykład planu platformy Azure) przy użyciu zasobu ProductUpgradeRequest .

Wymagania wstępne

  • Poświadczenia opisane w sekcji Uwierzytelnianie w Centrum partnerskim. 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, następnie klienta z listy klientów, a na końcu Konto. Na stronie konta klienta poszukaj identyfikatora Microsoft w sekcji informacje o koncie klienta. Identyfikator Microsoftu to samo co identyfikator klienta (customer-tenant-id).

  • Rodzina produktów, do której ma zostać uaktualnione klient.

C#

Aby uaktualnić klienta do planu platformy Azure:

  1. Utwórz obiekt ProductUpgradesRequest i określ identyfikator klienta i "Azure" jako rodzinę produktów.

  2. Użyj kolekcji IAggregatePartner.ProductUpgrades.

  3. Wywołaj metodę Create i przekaż obiekt ProductUpgradesRequest , który zwróci ciąg nagłówka lokalizacji .

  4. Wyodrębnij identyfikator upgrade-id z ciągu nagłówka lokalizacji, którego można użyć do wykonywania zapytań o stan uaktualnienia.

// 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];

Żądanie REST

Składnia żądania

Metoda Żądanie URI
POST {baseURL}/v1/productupgrades HTTP/1.1

Nagłówki zapytań

Aby uzyskać więcej informacji, zapoznaj się z Nagłówkami Centrum partnerskiego REST.

Ciało żądania

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

Przykład zapytania

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

Ważne

Od czerwca 2023 r. najnowsza wersja zestawu .NET SDK Centrum partnerskiego 3.4.0 jest teraz archiwizowana. Możesz pobrać wersję zestawu SDK z witryny GitHubwraz z plikiem readme, który zawiera przydatne informacje.

Zachęcamy partnerów do dalszego korzystania z interfejsów REST API Centrum Partnerskiego .

Odpowiedź REST

Jeśli to się powiedzie, odpowiedź zawiera nagłówek Location z identyfikatorem URI, którego można użyć do pobrania stanu uaktualnienia produktu. Zapisz ten identyfikator URI do użycia z innymi powiązanymi interfejsami API REST.

Kody sukcesu i błędów w odpowiedziach

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 Centrum Partnerskiego REST.

Przykład odpowiedzi

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
  • Last updated on