Uppdatera ett nytt handelsmigreringsschema

Artikel
10/26/2023

Gäller för: Partnercenter | Partnercenter som drivs av 21Vianet | Partnercenter för Microsoft Cloud for US Government

I den här artikeln beskrivs hur du uppdaterar ett nytt handelsmigreringsschema. Partner kan uppdatera före det schemalagda måldatumet.

Viktigt

Det här API:et är för närvarande endast tillgängligt i sandbox-klientorganisationen.

Förutsättningar

Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder autentisering med både fristående app- och app+användarautentiseringsuppgifter.
Ett kund-ID (customer-tenant-id). Om du inte känner till kundens ID kan du söka efter det i Partnercenter genom att välja arbetsytan Kunder , sedan kunden från kundlistan och sedan Konto. På kundens kontosida letar du upp Microsoft-ID :t i avsnittet Kundkontoinformation . Microsoft-ID:t är samma som kund-ID:t (customer-tenant-id).
Ett aktuellt prenumerations-ID

REST-begäran

Begärandesyntax

Metod	URI för förfrågan
PUT	{baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/schedules/{scheduleID}

URI-parameter

I den här tabellen visas de frågeparametrar som krävs för att skapa en ny handelsmigrering.

Namn	Typ	Obligatoriskt	Beskrivning
customer-tenant-id	sträng	Ja	En GUID-formaterad sträng som identifierar kunden.
scheduleID	sträng	Ja	En GUID-formaterad sträng som identifierade schemat

Begärandehuvuden

Mer information finns i REST-huvuden för Partnercenter.

Begärandetext

I den här tabellen beskrivs prenumerationsegenskaperna i begärandetexten.

Egenskap	Typ	Obligatoriskt	Beskrivning
currentSubscriptionId	sträng	Ja	En prenumerationsidentifierare som anger vilken prenumeration som kräver validering för migrering. Tillåts inte för uppdateringsåtgärd.
termDuration	sträng	No	Termens varaktighet kan anges för att ändras vid migrering.
billingCycle	sträng	No	Du kan ange att faktureringsperioden ska ändras vid migreringen.
purchaseFullTerm	boolesk	No	En ny term kan startas i NCE vid migrering.
quantity	int	No	Licenskvantiteten för en prenumeration kan ökas eller minskas vid migrering.
customTermEndDate	datetime	No	Ett slutdatum kan anges så att det överensstämmer med en befintlig onlinetjänstprenumeration eller kalendermånad som inte är en utvärderingsversion. Det finns mer information om hur du justerar prenumerationens slutdatum här: Justera prenumerationens slutdatum i Partnercenter
targetDate	datetime	No	Måldatum när migreringen ska schemaläggas. Om targetDate anges för angivet datum kan migrationOnRenewal anges till null eller false.
migrateOnRenewal	boolesk	No	Om flaggan har angetts som true för migrateOnRenewal behöver du inte ange targetDate för schemaläggning av en migrering.

Exempel på begäran

{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"status": "Created",
"customerTenantId": "6f297517-16e6-4313-8c6d-4e10496d2871",
"quantity": 25,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"targetDate": "2022-10-30T00:00:00"
}

REST-svar

Om det lyckas returnerar den här metoden information om de prenumerationer som migreras (migreringsobjekt) i svarstexten.

Lyckade svar och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckat eller misslyckat och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i Partnercenter REST-felkoder.

Svarsexempel

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

Dela via