Een abonnement valideren voor migratie

Artikel
10/14/2023

Van toepassing op: Partnercentrum | Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud voor de Amerikaanse overheid

Een abonnement valideren voor migratie naar New Commerce Experience

Vereisten

Referenties zoals beschreven in verificatie in partnercentrum. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als app+gebruikersreferenties.
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).
Een huidige abonnements-id

Frequentielimiet

De limiet voor de Migratie-API valideren is in vijf minuten 450 aanroepen per combinatie van partner-klanten. Meer informatie over frequentielimieten en bandbreedtebeperking vindt u in api-beperkingsrichtlijnen.

REST-aanvraag

Aanvraagsyntaxis

Methode	Aanvraag-URI
POST	{baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/validate HTTP/1.1

URI-parameter

Deze tabel bevat de vereiste queryparameters voor het valideren van een abonnement voor migratie.

Naam	Type	Vereist	Beschrijving
klant-tenant-id	tekenreeks	Ja	Een tekenreeks met GUID-indeling die de klant identificeert.
termDuration	tekenreeks	Nee	De duur van de looptijd kan worden gewijzigd bij de migratie.
billingCycle	tekenreeks	Nee	De factureringscyclus kan worden gewijzigd bij de migratie.
purchaseFullTerm	bool	Nee	Bij migratie kan een nieuwe term in NCE worden gestart.
quantity	geheel getal (int)	Nee	De licentiehoeveelheid voor een abonnement kan worden verhoogd of verlaagd bij de migratie.
customTermEndDate	datum/tijd	Nee	Een einddatum kan worden ingesteld om te worden afgestemd op een bestaand niet-trial OnlineServicesNCE-abonnement of kalendermaand. Hier vindt u meer informatie over het uitlijnen van de einddatums van het abonnement: Einddatums van het abonnement uitlijnen in het Partnercentrum

Aanvraagheaders

Zie Rest-headers in Partnercentrum voor meer informatie.

Aanvraagtekst

In deze tabel worden de abonnementseigenschappen in de aanvraagbody beschreven.

Eigenschappen	Type	Vereist	Beschrijving
currentSubscriptionId	tekenreeks	Ja	Een abonnements-id die aangeeft welk abonnement validatie voor migratie vereist.

Aanvraagvoorbeeld

"currentSubscriptionId" : "9beb6319-6889-4d28-a155-68ca9c783842"

REST-antwoord

Als dit lukt, retourneert deze methode een booleaanse waarde 'isEligible' in de hoofdtekst van het antwoord, waarmee wordt aangegeven of het huidige abonnement in aanmerking komt voor migratie naar nieuwe commerce. Opmerking: de Migratie-API valideren biedt geen informatie over de geschiktheid van een abonnement voor promoties in New Commerce.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat de informatie over geslaagde of mislukte fouten en extral-foutopsporing wordt aangegeven. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en andere parameters te lezen. Zie rest-foutcodes in Partnercentrum voor de volledige lijst.

Antwoordvoorbeelden

1. 
    {
        "currentSubscriptionId": "9beb6319-6889-4d28-a155-68ca9c783842",
        "isEligible": false,
        "errors": [
            {
                "code": 5,
                "description": "Subscription cannot be migrated to New Commerce because the equivalent offer is not yet available in New Commerce",
            }
        ]
    }

2. 
    {
        "currentSubscriptionId": "9beb6319-6889-4d28-a155-68ca9c783842",
        "isEligible": true,
        "catalogItemId": "CFQ7TTC0LF8S:0002:CFQ7TTC0KSVV"
    }