Vytvoření entity upgradu produktu pro zákazníka

Článek
09/23/2023

Entitu upgradu produktu můžete vytvořit k upgradu zákazníka na danou produktovou řadu (například plán Azure) pomocí prostředku ProductUpgradeRequest .

Požadavky

Přihlašovací údaje popsané v ověřování v Partnerském centru Tento scénář podporuje ověřování pomocí přihlašovacích údajů aplikace a uživatele. Při použití ověřování aplikací a uživatelů s rozhraními API Partnerského centra postupujte podle modelu zabezpečené aplikace.
ID zákazníka (customer-tenant-id). Pokud neznáte ID zákazníka, můžete ho vyhledat v Partnerském centru tak , že vyberete pracovní prostor Zákazníci , pak zákazník ze seznamu zákazníků a pak účet. Na stránce Účet zákazníka vyhledejte ID Microsoftu v části Informace o účtu zákazníka. ID Microsoftu je stejné jako ID zákazníka (customer-tenant-id).
Produktová řada, na kterou chcete zákazníka upgradovat.

C#

Upgrade zákazníka na plán Azure:

Vytvořte objekt ProductUpgradesRequest a jako produktovou řadu zadejte identifikátor zákazníka a Azure.
Použijte kolekci IAggregatePartner.ProductUpgrades .
Zavolejte create metodu a předejte ProductUpgradesRequest objekt, který vrátí řetězec hlavičky umístění.
Extrahujte ID upgradu z řetězce hlavičky umístění, který lze použít k dotazování stavu upgradu.

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

Požadavek REST

Syntaxe požadavku

Metoda	Identifikátor URI žádosti
POST	{baseURL}/v1/productupgrades HTTP/1.1

Záhlaví žádosti

Další informace najdete v tématu Hlavičky REST Partnerského centra.

Text požadavku

Tělo požadavku musí obsahovat prostředek ProductUpgradeRequest .

Příklad požadavku

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

Důležité

Od června 2023 se teď archivuje nejnovější verze sady .NET SDK partnerského centra 3.4.0. Vydání sady SDK si můžete stáhnout z GitHubu spolu se souborem readme, který obsahuje užitečné informace.

Doporučujeme, aby partneři dál používali rozhraní REST API Partnerského centra.

Odpověď REST

V případě úspěchu odpověď obsahuje hlavičku Umístění s identifikátorem URI, který lze použít k načtení stavu upgradu produktu. Uložte tento identifikátor URI pro použití s jinými souvisejícími rozhraními REST API.

Kódy úspěšnosti a chyb odpovědi

Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo selhání a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v tématu Kódy chyb REST v Partnerském centru.

Příklad odpovědi

HTTP/1.1 202 Accepted
Content-Length: 0
Location: productUpgrades/42d075a4-bfe7-43e7-af6d-7c68a57edcb4
MS-CorrelationId: 772871a9-399b-4f3b-b8c7-38f550e4f22a
MS-RequestId: cb82f7d6-f0d9-44d4-82f9-f6eee6e68390
MS-CV: iqOqN0FnaE2y0HcD.0
MS-ServerId: 030020525
Date: Thu, 28 Sep 2019 20:35:35 GMT

Sdílet prostřednictvím