Een nieuw migratieschema voor commerce bijwerken

Artikel
03/07/2025

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

In dit artikel wordt beschreven hoe u een nieuw migratieschema voor commerce bijwerkt. Partners kunnen zelf updates uitvoeren voor de geplande doeldatum.

Belangrijk

Deze API is momenteel alleen beschikbaar in de Sandbox-tenant.

Vereisten

Inloggegevens zoals beschreven in Partner Center-verificatie. 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

REST-aanvraag

Aanvraagsyntaxis

Methode	Aanvraag-URI
PUT	{baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/schedules/{scheduleID}

URI-parameter

Deze tabel bevat de vereiste queryparameters voor het maken van een nieuwe commerciële migratie.

Naam	Type	Vereist	Beschrijving
klant-tenant-id	tekenreeks	Ja	Een GUID-geformatteerde tekenreeks die de klant identificeert.
scheduleID	tekenreeks	Ja	Een tekenreeks met GUID-indeling die het schema identificeerde

Aanvraagheaders

Zie Rest-headers in Partnercentrum voor meer informatie.

Aanvraagtekst

In deze tabel worden de abonnementseigenschappen in de aanvraagbody beschreven.

Eigenschappen	Type	Vereist	Beschrijving
huidigeAbonnementId	string	Ja	Een abonnements-id die aangeeft welk abonnement validatie voor migratie vereist. Niet toegestaan voor updatebewerking.
looptijd	tekenreeks	Nee	Duur van de looptijd voor de migratie.
billingCycle	tekenreeks	Nee	Factureringscyclus voor de migratie.
purchaseFullTerm	bool	Nee	Of de migratie nu de huidige verouderde term voortzet of een nieuwe term start.
hoeveelheid	int	Nee	De licentiehoeveelheid voor een abonnement kan worden verhoogd of verlaagd bij de migratie.
einddatumAangepasteTermijn	datumtijd	Nee	Een einddatum kan worden ingesteld om af te stemmen op een bestaand niet-proefperiode OnlineServicesNCE-abonnement of een kalendermaand. Hier vindt u meer informatie over het uitlijnen van abonnementseinddatums: Einddatums van abonnementen uitlijnen in partnercentrum
streefdatum	datumtijd	Nee	Doeldatum waarop de migratie moet worden gepland. Als targetDate is ingesteld op de opgegeven datum, kan migrationOnRenewal worden ingesteld op null of false.
migreerBijVernieuwing	bool	Nee	Als de vlag waar is ingesteld voor migrateOnRenewal, hoeft u de targetDate niet te specificeren voor het plannen van een migratie.

Aanvraagvoorbeeld

{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"status": "Created",
"customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"quantity": 25,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"targetDate": "2022-10-30T00:00:00"
}

REST-antwoord

Als dit lukt, retourneert deze methode details van de abonnementen die worden gemigreerd (migratieobject) in de hoofdtekst van het antwoord.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft of er sprake is van succes of mislukking, en extra informatie biedt over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en andere parameters te lezen. Zie Partnercentrum REST-foutcodes voor de volledige lijst.

Antwoordvoorbeelden

{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"subscriptionEndDate": "2023-07-19T00:00:00Z",
"status": "Created",
"customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"quantity": 25,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"targetDate": "2022-10-30T00:00:00",
"createdTime": "2022-10-18T21:20:50.9668605+00:00",
"lastModifiedTime": "2022-10-18T21:29:32.8992819+00:00"
}

Delen via