Aktualisieren eines Zeitplans für die 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
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 | Laufzeitdauer für die Migration. |
| billingCycle | Zeichenfolge | No | Abrechnungszyklus für die Migration. |
| purchaseFullTerm | bool | No | Gibt an, ob die Migration den aktuellen Legacyausdruck fortsetzt oder eine neue startet. |
| 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 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 |
| 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, muss das Zieldatum für die Planung einer Migration nicht spezifisch sein. |
Anforderungsbeispiel
{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"status": "Created",
"customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"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 Erfolg oder Fehler sowie zusätzliche Debuginformationen angibt. Verwenden Sie ein Netzwerkablaufverfolgungstool, um diesen Code, fehlertyp und andere 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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"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"
}