Een entiteit voor een productupgrade maken voor een klant

Artikel
09/23/2023

U kunt een entiteit voor een productupgrade maken om een klant te upgraden naar een bepaalde productfamilie (bijvoorbeeld Een Azure-abonnement) met behulp van de ProductUpgradeRequest-resource .

Vereisten

Referenties zoals beschreven in verificatie in partnercentrum. Dit scenario ondersteunt verificatie met app+gebruikersreferenties. Volg het beveiligde app-model bij het gebruik van app+gebruikersverificatie met Partnercentrum-API's.
Een klant-id (customer-tenant-id). Als u de klant-id niet weet, kunt u deze opzoeken in het Partnercentrum door de werkruimte Klanten te selecteren, vervolgens de klant in de lijst met klanten en vervolgens Account. Zoek op de pagina Account van de klant naar de Microsoft-id in de sectie Klantaccountgegevens . De Microsoft-id is hetzelfde als de klant-id (customer-tenant-id).
De productfamilie waarnaar u de klant wilt upgraden.

C#

Een klant upgraden naar Een Azure-abonnement:

Maak een ProductUpgradesRequest-object en geef de klant-id en 'Azure' op als productfamilie.
Gebruik de verzameling IAggregatePartner.ProductUpgrades .
Roep de methode Create aan en geef het object ProductUpgradesRequest door. Hiermee wordt een tekenreeks voor de locatieheader geretourneerd.
Pak de upgrade-id uit de tekenreeks van de locatieheader die kan worden gebruikt om de upgradestatus op te vragen.

// 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-aanvraag

Aanvraagsyntaxis

Methode	Aanvraag-URI
POST	{baseURL}/v1/productupgrades HTTP/1.1

Aanvraagheaders

Zie Rest-headers in Partnercentrum voor meer informatie.

Aanvraagtekst

De aanvraagbody moet een ProductUpgradeRequest-resource bevatten.

Aanvraagvoorbeeld

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

Belangrijk

Vanaf juni 2023 wordt de nieuwste Versie van Partner Center .NET SDK 3.4.0 gearchiveerd. U kunt de SDK-release downloaden van GitHub, samen met een leesmij-bestand dat nuttige informatie bevat.

Partners worden aangemoedigd om de REST API's van partnercentrum te blijven gebruiken.

REST-antwoord

Als dit lukt, bevat het antwoord een locatieheader met een URI die kan worden gebruikt om de status van de productupgrade op te halen. Sla deze URI op voor gebruik met andere gerelateerde REST API's.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat de fout is geslaagd of mislukt en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie rest-foutcodes in Partnercentrum voor de volledige lijst.

Responsvoorbeeld

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

Delen via