Schemalägga en ny handelsmigrering

Artikel
03/07/2025

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

Lämpliga roller: Administratörsagent | Försäljningsagent

I den här artikeln beskrivs hur du schemalägger en ny handelsupplevelse.

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

Syntax för begäran

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

URI-parameter

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

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

Begäranhuvuden

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

Begärandetext

Den här tabellen beskriver prenumerationsegenskaperna i begärandetexten.

Property	Typ	Obligatoriskt	Beskrivning
aktuellAbonnemangsId	sträng	Ja	En prenumerationsidentifierare som anger vilken prenumeration som kräver validering för migrering.
periodlängd	sträng	Nej	Tidsperiodens varaktighet kan definieras för att ändras vid migrering.
billingCycle	sträng	Nej	Du kan ange att faktureringscykeln ska ändras vid migreringen.
köp hela perioden	bool	Nej	En ny term kan startas i NCE i samband med migrering.
kvantitet	heltal	Nej	Licenskvantiteten för en prenumeration kan ökas eller minskas vid migrering.
anpassatTerminslutdatum	datumtid	Nej	Ett slutdatum kan anges så att det överensstämmer med en befintlig OnlineServicesNCE-prenumeration som inte är en utvärderingsversion eller med en kalendermånad. Det finns mer information om hur du justerar prenumerationens slutdatum här: Justera prenumerationens slutdatum i Partnercenter
måldatum	datumtid	Krävs (om migrateOnRenewal är null/false)	Måldatum när migreringen ska schemaläggas. Om targetDate har angetts för angivet datum kan migreringenOnRenewal anges till null eller false.
migreraVidFörnyelse	bool	Krävs (om targetDate är null)	Om flaggan är true för migrateOnRenewal behöver du inte ange targetDate för schemaläggning av en migrering.
addOnMigrationSchedules	bool	Nej	Innehåller en lista över AddOn-prenumerationer som ska ingå i den schemalagda migreringen.

Exempel på begäran

{
    "currentSubscriptionId": "2591295E-DDEB-425A-93F9-C1B4F5AD7FB6",
    "quantity": 1,
    "billingCycle": "monthly",
    "purchaseFullTerm": false,
    "termDuration": "P1Y",
    "customTermEndDate": null,
    "targetDate": "2023-08-09T00:00:00.000Z",
    "addOnMigrations": [
        {
            "currentSubscriptionId": "5B882C48-53C6-46AF-B8A4-0691F19BAD94",
            "quantity": 17,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1M",
            "customTermEndDate": null
        },
        {
            "currentSubscriptionId": "C7D0DB12-9482-4297-8F09-190EB04F9C05",
            "quantity": 23,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1Y",
            "customTermEndDate": null
        }
    ]
}

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 anger lyckad eller misslyckad 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 Rest-felkoder för Partnercenter.

Svarsexempel

{
    "id": "f016c025-a873-47af-8b52-2516fbef4c65",
    "currentSubscriptionId": "2591295E-DDEB-425A-93F9-C1B4F5AD7FB6",
    "quantity": 1,
    "billingCycle": "monthly",
    "purchaseFullTerm": false,
    "termDuration": "P1Y",
    "customTermEndDate": null,
    "targetDate": "2023-08-09T00:00:00.000Z",
    "addOnMigrations": [
        {
            "currentSubscriptionId": "5B882C48-53C6-46AF-B8A4-0691F19BAD94",
            "quantity": 17,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1M",
            "customTermEndDate": null
        },
        {
            "currentSubscriptionId": "C7D0DB12-9482-4297-8F09-190EB04F9C05",
            "quantity": 23,
            "billingCycle": "Monthly",
            "purchaseFullTerm": false,
            "termDuration": "P1Y",
            "customTermEndDate": null
        }
    ]
}

Dela via