Delen via


Een nieuw migratieschema voor commerce annuleren

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

Juiste rollen: Beheerdersagent | Verkoopagent

In dit artikel wordt beschreven hoe u een nieuw migratieschema voor commerce annuleert.

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

REST-aanvraag

Aanvraagsyntaxis

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

URI-parameter

Deze tabel bevat de vereiste queryparameters voor het maken van een nieuwe commercemigratie.

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

Aanvraagheaders

Zie Rest-headers in Partnercentrum voor meer informatie.

Hoofdtekst van de reactie

In deze tabel worden de abonnementseigenschappen in het antwoord beschreven.

Eigenschappen Type Vereist Beschrijving
Id String Nee Een tekenreeks met GUID-indeling die het schema identificeert
currentSubscriptionID tekenreeks Nee Een abonnements-id die aangeeft welk abonnement validatie voor migratie vereist.
termDuration tekenreeks Nee De duur die is opgegeven om te worden gewijzigd bij de migratie.
billingCycle tekenreeks Nee De factureringscyclus die is opgegeven om te worden gewijzigd bij de migratie.
purchaseFullTerm bool Nee Na de migratie is een nieuwe term gestart in NCE.
quantity int Nee Aantal licenties is verhoogd of afgenomen bij de migratie.
customTermEndDate datetime 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
targetDate datetime Nee Doeldatum waarop de migratie moet worden gepland.
migrateOnRenewal bool Nee Geeft aan of het abonnement kan worden gemigreerd bij verlenging.
status tekenreeks Nee Status van de planningsmigratie
createdTime datetime Nee Wanneer de planning is gemaakt
lastModifiedTime datetime Nee Wanneer de planning voor het laatst is gewijzigd

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 dat de fout is geslaagd of mislukt en aanvullende informatie over foutopsporing. 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

{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"subscriptionEndDate": "2023-07-19T00:00:00Z",
"status": "Cancelled",
"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"
}

Zie ook