Freigeben über

Aktualisieren eines Zeitplans für die Migration zum neuen E-Commerce-Verfahren

  • Artikel

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

In diesem Artikel wird beschrieben, wie Sie einen neuen Zeitplan für die E-Commerce-Migration aktualisieren. Partner können vor dem geplanten Zieldatum aktualisiert werden.

Wichtig

Diese API ist derzeit nur im Sandkastenmandanten verfügbar.

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

REST-Anforderung

Anforderungssyntax

Methode Anforderungs-URI
PUT {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/schedules/{scheduleID}

URI-Parameter

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

Name Art Erforderlich Beschreibung
customer-tenant-id Zeichenfolge Ja Eine GUID-formatierte Zeichenfolge, die den Kunden identifiziert.
scheduleID Zeichenfolge Ja Eine GUID-formatierte Zeichenfolge, die den Zeitplan identifiziert hat

Anforderungsheader

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

Anforderungstext

In dieser Tabelle werden die Abonnementeigenschaften im Anforderungstext beschrieben.

Eigenschaft Typ Erforderlich Beschreibung
currentSubscriptionId Zeichenfolge Ja Ein Abonnementbezeichner, der angibt, welches Abonnement eine Überprüfung für die Migration erfordert. Für den Aktualisierungsvorgang nicht zulässig.
termDuration Zeichenfolge No Die Laufzeitdauer kann angegeben werden, die bei der Migration geändert werden soll.
billingCycle Zeichenfolge No Der Abrechnungszyklus kann angegeben werden, der bei der Migration geändert werden soll.
purchaseFullTerm bool No Ein neuer Begriff kann bei der Migration in NCE gestartet werden.
Menge int No Die Lizenzmenge für ein Abonnement kann bei der Migration erhöht oder verringert werden.
customTermEndDate datetime No Ein Enddatum kann so festgelegt werden, dass es an einem vorhandenen Nicht-Test-OnlineServicesNCE-Abonnement oder Kalendermonat ausgerichtet ist. Weitere Informationen zum Ausrichten der Enddaten des Abonnements finden Sie hier: Ausrichten der Enddaten des Abonnements im Partner Center
targetDate datetime No Zieldatum, an dem die Migration geplant werden soll. Wenn targetDate für das angegebene Datum festgelegt ist, kann die MigrationOnRenewal auf NULL oder false festgelegt werden.
migrateOnRenewal bool No Wenn das Flag für migrateOnRenewal auf "true" festgelegt ist, ist es nicht erforderlich, das Zieldatum für die Planung einer Migration festzulegen.

Anforderungsbeispiel

{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"status": "Created",
"customerTenantId": "6f297517-16e6-4313-8c6d-4e10496d2871",
"quantity": 25,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"targetDate": "2022-10-30T00:00:00"
}

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 Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste finden Sie unter Partner Center-REST-Fehlercodes.

Beispielantworten

{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"subscriptionEndDate": "2023-07-19T00:00:00Z",
"status": "Created",
"customerTenantId": "6f297517-16e6-4313-8c6d-4e10496d2871",
"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"
}

Weitere Informationen