Erstellen einer Migration zum neuen E-Commerce-Verfahren

anwendbar auf: Partnerzentrum | Partnerzentrum betrieben von 21Vianet | Partnerzentrum für die Microsoft-Cloud für die US-Regierung

So erstellen Sie eine Migration eines Abonnements zu New Commerce Experience

Voraussetzungen

• Anmeldeinformationen wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung mit eigenständigen App- und App+Benutzeranmeldeinformationen.

• Eine Kunden-ID (customer-tenant-id). Wenn Sie die Kunden-ID nicht kennen, können Sie sie im Partner Center nachschlagen, indem Sie den Arbeitsbereich Kunden auswählen, dann den Kunden aus der Kundenliste und anschließend Konto. Suchen Sie auf der Kontoseite des Kunden im Abschnitt Kundenkontoinfo nach der Microsoft-ID. Die Microsoft-ID ist identisch mit der Kunden-ID (customer-tenant-id).

• Eine aktuelle Abonnement-ID

Ratengrenzwert

Das Limit für die Create Migration API beträgt 100 Aufrufe durch einen Partner in 5 Minuten. Weitere Informationen zu Ratenlimits und Drosselung finden Sie unter Leitfaden zur API-Drosselung.

REST-Anforderung

Anforderungssyntax

Methode	Anforderungs-URI
BEREITSTELLEN	{baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce HTTP/1.1

URI-Parameter

In dieser Tabelle sind die erforderlichen Abfrageparameter aufgeführt, um eine neue Commerce-Migration zu erstellen.

Name	Typ	Erforderlich	BESCHREIBUNG
Kunden-Mieter-ID	Schnur	Ja	Eine GUID-formatierte Zeichenfolge, die den Kunden identifiziert.

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center REST-Header.

Anfragekörper

In dieser Tabelle werden die Abonnementeigenschaften im Anforderungstext beschrieben.

Eigentum	Typ	Erforderlich	BESCHREIBUNG
currentSubscriptionId	Schnur	Ja	Ein Abonnementbezeichner, der angibt, welches Abonnement für die Migration überprüft werden muss.
termDuration	Schnur	Nein	Die Laufzeitdauer kann bei der Migration geändert werden.
billingCycle	Schnur	Nein	Der Abrechnungszyklus kann bei der Migration geändert werden.
purchaseFullTerm	Boolesch	Nein	Bei der Migration kann in NCE ein neuer Begriff begonnen werden.
Menge	INT	Nein	Die Lizenzmenge für ein Abonnement kann bei der Migration erhöht oder verringert werden.
customTermEndDate	Datum/Uhrzeit	Nein	Ein Enddatum kann so festgelegt werden, dass es mit einem vorhandenen OnlineServicesNCE-Abonnement oder Kalendermonat ohne Testversion übereinstimmt. Weitere Informationen zum Ausrichten von Abonnementenddaten finden Sie hier: Ausrichten von Abonnementenddaten in Partner Center

Beispielanfrage

Beachten Sie, dass geschachtelte Add-Ons (Add-On-Abonnements mit Add-On-Abonnements) als flache Liste innerhalb von addOnMigrations in den Anforderungstext geschrieben und nicht in anderen Add-On-Abonnements in der Anforderung geschachtelt werden sollten. Im letzten Anforderungsbeispiel erfahren Sie, wie Add-ons im Anforderungstext geschrieben werden können.

{
    "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-Antwort

Bei erfolgreicher Ausführung gibt diese Methode Details zu den zu migrierenden Abonnements (Migrationsobjekt) im Antworttext zurück.

Antworterfolgs- und Fehlercodes

Jede Antwort enthält einen HTTP-Statuscode, der Erfolg oder Fehler sowie zusätzliche Debuginformationen angibt. Verwenden Sie ein Netzwerkverfolgungstool, um diesen Code, den Fehlertyp und andere Parameter zu lesen. Die vollständige Liste finden Sie unter Partner Center-REST-Fehlercodes.

Beispielantworten

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