Dela via

Hämta ett nytt handelsmigreringsschema

  • Artikel

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

Den här artikeln beskriver hur du hämtar ett nytt handelsmigreringsschema.

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+User-autentiseringsuppgifter.

  • 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 efter 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

Det finns två olika sätt som partners kan ställa frågor på.

  • Partner kan fråga för att hämta ett visst schema
  • Partner kan fråga för att hämta listan över scheman för specifika kriterier

Syntax för begäran

Metod Begär URI
GET {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/schedules/{scheduleID}

URI-parameter

Den här tabellen visar de frågeparametrar som krävs för att skapa en ny handelsmigrering.

Namn Typ Obligatoriskt Beskrivning
kund-hyresgäst-id sträng Ja En GUID-formaterad sträng som identifierar kunden.
Metod Förfrågan URI
GET {baseURL}/v1/migrations/newcommerce/schedules? CustomerTenantId={customer-tenant-id}

URI-parameter

Den här tabellen visar de frågeparametrar som krävs för att skapa en ny handelsmigrering. Vilken som helst av frågeparametrarna kan användas.

Namn Typ Beskrivning
kundHyresgästId sträng En GUID-formaterad sträng som identifierar kunden.
nuvarandeAbonnemangsID sträng En GUID-formaterad sträng som identifierar det aktuella prenumerations-ID:t
extern referens-ID sträng En GUID-formaterad sträng som identifierar migreringsbatchen

Begäranhuvuden

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

Svarsinnehåll

Den här tabellen beskriver prenumerationsegenskaperna i svaret.

Property Typ Obligatoriskt Beskrivning
nuvarandePrenumerationsID sträng Ja En prenumerationsidentifierare som anger vilken prenumeration som kräver validering för migrering.
termlängd sträng Nej Termvaraktighet som tillämpas på migreringen.
billingCycle sträng Nej Faktureringscykel som tillämpas på migreringen.
köp hela perioden bool Nej Om migreringen startar en ny term eller inte.
kvantitet heltal Nej Licenskvantiteten för en prenumeration kan ökas eller minskas vid migrering.
anpassatSlutdatum datumtid Nej Ett slutdatum kan ange så att det överensstämmer med en befintlig OnlineServicesNCE-prenumeration som inte är en testversion eller med en kalendermånad. Det finns mer information om hur du justerar prenumerationens slutdatum här: Justera prenumerationens slutdatum i Partnercenter
måldatum datum och tid Nej Måldatum när migreringen ska schemaläggas.
migreraVidFörnyelse bool Nej Anger om schemat måste ske vid förnyelse
status sträng Nej Status för schemamigreringen
skapadTid datum och tid Nej När schemat skapades
senast ändrad tid datum och tid Nej När schemat senast ändrades

REST-svar

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

Svarsframgång och felkoder

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

Svarsexempel

[
{
"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"
}
]

Se även