Skapa en ny handelsmigrering

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

Så här skapar du en migrering av en prenumeration till New Commerce Experience

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 leta upp 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 i avsnittet Kundkontoinformation. Microsoft-ID:t är detsamma som kund-ID :t (customer-tenant-id).

• Ett aktuellt prenumerations-ID

Hastighetsgräns

Gränsen för API för att skapa migrering är 100 anrop av en partner på 5 minuter. Mer information om hastighetsgränser och strypning finns på Vägledning för API-begränsning.

REST-begäran

Syntax för begäran

Metod	Begäran URI
POST	{baseURL}/v1/customers/{customer-tenant-id}/migration/newcommerce HTTP/1.1

URI-parameter

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

Namn	Typ	Krävs	Beskrivning
kundhyresgäst-id	sträng	Ja	En GUID-formaterad sträng som identifierar kunden.

Begäranhuvuden

Mer information finns i Partnercenter-REST-huvuden.

Begärandetext

I den här tabellen beskrivs egenskaperna Prenumeration i begärandetexten.

Egenskap	Typ	Krävs	Beskrivning
nuvarandePrenumerationsId	sträng	Ja	En prenumerationsidentifierare som anger vilken prenumeration som kräver validering för migrering.
tidsperiod	sträng	Nej	Termens varaktighet kan ändras vid migrering.
billingCycle (fakturering)	sträng	Nej	Faktureringscykeln kan ändras vid migrering.
köp av helperiod	Bool	Nej	En ny period kan påbörjas i NCE vid migrering.
kvantitet	Int	Nej	Licenskvantiteten för en prenumeration kan ökas eller minskas vid migrering.
anpassatTerminslutdatum	datum och tid	Nej	Ett slutdatum kan anges så att det överensstämmer med den befintliga OnlineServicesNCE-prenumerationen eller kalendermånaden. Det finns mer information om hur du justerar prenumerationens slutdatum här: Justera prenumerationens slutdatum i Partnercenter

Exempel på begäran

Obs! Kapslade tillägg (tilläggsprenumerationer med tilläggsprenumerationer) ska skrivas i begärandetexten som en platt lista i addOnMigrations och inte kapslas i andra tilläggsprenumerationer i begäran. Se det senaste exemplet på begäran för hur tillägg kan skrivas i begärandetexten.

{
    "currentSubscriptionId" : "9beb6319-6889-4d28-a155-68ca9c783842"
}

{ 
    "currentSubscriptionId": "5C77DC7F-BE2C-4306-A3B5-0EBB4365D7FC", 
    "termDuration": "P1M", 
    "billingCycle": "Monthly", 
} 

{
    "currentSubscriptionId": "5C77DC7F-BE2C-4306-A3B5-0EBB4365D7FC", 
    "purchaseFullTerm": true 
}

{
    "currentSubscriptionId": "66E738D6-E0BC-4FFB-8818-BDE99BC7008B",
    "quantity": 1,
    "billingCycle": "Annual",
    "purchaseFullTerm": false,
    "termDuration": "P1Y",
    "addOnMigrations": [
        {
            "currentSubscriptionId": "359011DC-B5B0-4660-850B-A8FA9B2E3309",
            "quantity": 1,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1M"
        },
        {
            "currentSubscriptionId": "159D9F87-CE39-4EBD-B9C2-ECF0892A85A1",
            "quantity": 1,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1Y"
        }
    ]
}

REST-svar

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

Svarsframgång och felkoder

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

Svarsexempel

{
    "addOnMigrations": [
        {
            "currentSubscriptionId": "E3AFD30D-D6E7-45AF-A6C5-FB905992AE00",
            "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "catalogItemId": "CFQ7TTC0LH0T:0001:CFQ7TTC0K4KQ",
            "subscriptionEndDate": "2023-02-22T00:00:00Z",
            "quantity": 1,
            "termDuration": "P1Y",
            "billingCycle": "Monthly",
            "purchaseFullTerm": false
        },
        {
            "currentSubscriptionId": "80906BD9-E45C-4D1B-92A8-EA3F3FB6E105",
            "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "catalogItemId": "CFQ7TTC0LH0R:0001:CFQ7TTC0K0SK",
            "subscriptionEndDate": "2023-02-22T00:00:00Z",
            "quantity": 1,
            "termDuration": "P1Y",
            "billingCycle": "Monthly",
            "purchaseFullTerm": false
        },
        {
            "currentSubscriptionId": "72E424F4-10FF-4C76-B101-C274F73BA498",
            "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "catalogItemId": "CFQ7TTC0LHXJ:0001:CFQ7TTC0KHTR",
            "subscriptionEndDate": "2023-02-22T00:00:00Z",
            "quantity": 1,
            "termDuration": "P1Y",
            "billingCycle": "Monthly",
            "purchaseFullTerm": false
        }
    ],
    "id": "7123c075-fc05-42d6-a21e-1d2036fa490b",
    "startedTime": "2022-02-23T13:00:48.4489832Z",
    "currentSubscriptionId": "2E56C7F5-E120-4CA4-BFF3-7DA763B4D777",
    "status": "Processing",
    "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "catalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0KQDF",
    "subscriptionEndDate": "2023-02-22T00:00:00Z",
    "quantity": 1,
    "termDuration": "P1Y",
    "billingCycle": "Monthly",
    "purchaseFullTerm": false
}