De productupgradestatus voor een klant ophalen

Artikel
10/01/2024

U kunt de Resource ProductUpgradeRequest gebruiken om de status van een upgrade naar een nieuwe productfamilie op te halen. Deze resource is van toepassing wanneer u een klant een upgrade uitvoert van een Microsoft Azure-abonnement (MS-AZR-0145P) naar een Azure-abonnement. Een geslaagde aanvraag retourneert de Resource ProductUpgradesEligibility.

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.
De upgrade-id van een upgradeaanvraag.

C#

Ga als volgt te werk om te controleren of een klant in aanmerking komt voor een upgrade 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 ById-methode aan en geef de upgrade-id door.
Roep de CheckStatus-methode aan en geef het object ProductUpgradesRequest door. Hiermee wordt een ProductUpgradeStatus-object geretourneerd.

// 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)
{
    ....
}

REST-aanvraag

Aanvraagsyntaxis

Methode	Aanvraag-URI
POST	{baseURL}/v1/productUpgrades/{upgrade-id}/status HTTP/1.1

URI-parameter

Gebruik de volgende queryparameter om de klant op te geven voor wie u de status van een productupgrade krijgt.

Naam	Type	Vereist	Beschrijving
upgrade-id	GUID	Ja	De waarde is een upgrade-id met GUID-indeling. U kunt deze id gebruiken om een upgrade op te geven die moet worden bijgehouden.

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

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, retourneert deze methode een Resource ProductUpgradesEligibility in de hoofdtekst.

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

Delen via