Skapa en produktuppgraderingsentitet för en kund

Artikel
03/07/2025

Du kan skapa en entitet för produktuppgradering för att uppgradera en kund till en viss produktfamilj (till exempel Azure-plan) med hjälp av resursen ProductUpgradeRequest.

Förutsättningar

Autentiseringsuppgifter enligt beskrivningen i PartnerCenter-autentisering. Det här scenariot stöder autentisering med app+användarautentiseringsuppgifter. Följ säker appmodell när du använder App+User-autentisering med Api:er för Partnercenter.
Ett kund-ID (customer-tenant-id). Om du inte känner till kundens ID kan du leta upp 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 i avsnittet Kundkontoinformation. Microsoft-ID:t är detsamma som kund-ID :t (customer-tenant-id).
Produktfamiljen som du vill uppgradera kunden till.

C#

Så här uppgraderar du en kund till Azure-plan:

Skapa ett ProductUpgradesRequest- objekt och ange kundidentifieraren och "Azure" som produktfamilj.
Använd samlingen IAggregatePartner.ProductUpgrades.
Anropa metoden Create och skicka in ProductUpgradesRequest-objektet, vilket kommer att returnera en plats-HTTP-huvudsträng.
Extrahera upgrade-id från platsens header-sträng som kan användas för att söka uppgraderingsstatus.

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

REST-begäran

Syntax för begäran

Metod	Begärande-URI
POST	{baseURL}/v1/productupgrades HTTP/1.1

Begärandehuvuden

Mer information finns i Partner Centers REST-huvuden.

Begärandetext

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

Exempel på begäran

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

Viktig

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 använda REST API:erna i Partnercenter.

REST-svar

Om det är framgångsrikt innehåller svaret ett Plats-huvudfält som har en URI som kan användas för att hämta produktuppgraderingsstatus. Spara den här URI:n för användning med andra relaterade REST-API:er.

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 Partner Center REST-felkoder.

Svarsexempel

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

Dela via