Delen via

Haal een nieuw migratieschema voor commerce op

  • Artikel

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 kunt krijgen.

Belangrijk

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

Vereisten

  • Referenties zoals beschreven in de Partnercentrum-authenticatie. 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

Er zijn twee verschillende manieren waarop partners query's kunnen uitvoeren.

  • Partners kunnen een query uitvoeren om een bepaalde planning op te halen
  • Partners kunnen een query uitvoeren om de lijst met planningen voor specifieke criteria op te halen

Aanvraagsyntaxis

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

URI-parameter

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

Naam Type Vereist Beschrijving
klant-huurder-id tekenreeks Ja Een string in GUID-formaat die de klant identificeert.
Methode Aanvraag-URI
GET {baseURL}/v1/migrations/newcommerce/schedules? CustomerTenantId={customer-tenant-id}

URI-parameter

Deze tabel bevat de nodige queryparameters voor het maken van een nieuwe commerciële migratie. Elke queryparameter kan worden gebruikt.

Naam Type Beschrijving
klantTenantId tekenreeks Een tekenreeks in GUID-indeling die de klant identificeert.
currentSubscriptionID string Een tekenreeks met GUID-indeling die de huidige abonnements-id identificeert
externeReferentieID tekenreeks Een GUID-geformatteerde tekenreeks die de migratiebatch identificeert

Headers van de aanvraag

Voor meer informatie, zie REST-headers van Partnercentrum.

Hoofdtekst van de reactie

In deze tabel worden de abonnementseigenschappen in het antwoord beschreven.

Eigenschappen Type Vereist Beschrijving
currentSubscriptionId tekenreeks Ja Een abonnements-id die aangeeft welk abonnement validatie voor migratie vereist.
TermijnDuur tekenreeks Nee Looptijd toegepast op de migratie.
billingCycle tekenreeks Nee Factureringscyclus toegepast op de migratie.
purchaseFullTerm bool Nee Of de migratie al dan niet een nieuwe termijn begint.
hoeveelheid int Nee De licentiehoeveelheid voor een abonnement kan worden verhoogd of verlaagd bij de migratie.
AangepasteTermijnEindDatum datumtijd Nee Een einddatum kan worden ingesteld om af te stemmen op een bestaand niet-proefversie 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
streefdatum datumtijd Nee Doeldatum waarop de migratie moet worden gepland.
migreren bij verlenging bool Nee Geeft aan of het schema moet worden uitgevoerd bij verlenging
toestand tekenreeks Nee Status van de migratie van het schema
aanmaakTijd datum en tijd Nee Wanneer de planning is gemaakt
laatstgewijzigdetijd datum-tijd 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

Elke reactie komt met een HTTP-statuscode die aangeeft of de operatie is geslaagd of mislukt, samen met verdere foutopsporingsinformatie. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en meer 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": "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"
}
]

Zie ook