Erstellen einer Migration zum neuen E-Commerce-Verfahren

Gilt für: Partner Center | Partner Center-Betrieb durch 21Vianet | Partner Center für Microsoft Cloud for US Government

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 " und dann den Kunden aus der Kundenliste und dann "Konto" auswählen. Suchen Sie auf der Kontoseite des Kunden im Abschnitt Kundenkontoinfo nach der Microsoft-ID. Die Microsoft-ID entspricht der Kunden-ID (customer-tenant-id).

• Aktuelle Abonnement-ID

Rate Limit

Der Grenzwert für die Erstellung der Migrations-API beträgt 100 Aufrufe eines Partners in 5 Minuten. Weitere Informationen zu Ratelimits und Drosselung finden Sie unter API-Einschränkungsleitfaden.

REST-Anforderung

Anforderungssyntax

Methode	Anforderungs-URI
POST	{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	Type	Erforderlich	Beschreibung
customer-tenant-id	Zeichenfolge	Ja	Eine GUID-formatierte Zeichenfolge, die den Kunden identifiziert.

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center-REST-Header.

Anforderungstext

In dieser Tabelle werden die Abonnementeigenschaften im Anforderungstext beschrieben.

Eigenschaft	Type	Erforderlich	Beschreibung
currentSubscriptionId	Zeichenfolge	Ja	Ein Abonnementbezeichner, der angibt, welches Abonnement eine Überprüfung für die Migration erfordert.
termDuration	Zeichenfolge	Nein	Die Laufzeitdauer kann bei der Migration geändert werden.
billingCycle	Zeichenfolge	Nein	Der Abrechnungszyklus kann bei der Migration geändert werden.
purchaseFullTerm	bool	Nein	Ein neuer Begriff kann bei der Migration in NCE gestartet werden.
Menge	INT	Nein	Die Lizenzmenge für ein Abonnement kann bei der Migration erhöht oder verringert werden.
customTermEndDate	datetime	Nein	Ein Enddatum kann so festgelegt werden, dass es an einem vorhandenen nichttrialen OnlineServicesNCE-Abonnement oder kalendermonat ausgerichtet ist. Weitere Informationen zum Ausrichten der Enddaten des Abonnements finden Sie hier: Ausrichten von Enddaten des Abonnements im Partner Center

Beispiel für eine Anfrage

Beachten Sie, dass geschachtelte Add-Ons (Add-On-Abonnements mit Add-On-Abonnements) im Anforderungstext als flache Liste in addOnMigrations geschrieben und nicht in anderen Add-On-Abonnements in der Anforderung geschachtelt werden sollten; siehe das letzte Anforderungsbeispiel, 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 die Methode Details zu den Abonnements zurück, die migriert werden (Migrationsobjekt) im Antworttext.

Erfolgs- und Fehlercodes der Antwort

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

Beispielantworten

{
    "addOnMigrations": [
        {
            "currentSubscriptionId": "E3AFD30D-D6E7-45AF-A6C5-FB905992AE00",
            "customerTenantId": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
            "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": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
            "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": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
            "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": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
    "catalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0KQDF",
    "subscriptionEndDate": "2023-02-22T00:00:00Z",
    "quantity": 1,
    "termDuration": "P1Y",
    "billingCycle": "Monthly",
    "purchaseFullTerm": false
}