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 E-Commerce-Migrationszeitplan aktualisieren. Partner können vor dem geplanten Zieldatum aktualisieren.
Wichtig
Diese API ist derzeit nur im Sandboxmandanten 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
).Eine 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 E-Commerce-Migration zu erstellen.
Name | Typ | 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.
Property | Typ | Erforderlich | Beschreibung |
---|---|---|---|
currentSubscriptionId | Zeichenfolge | Ja | Ein Abonnementbezeichner, der angibt, welches Abonnement für die Migration eine Überprüfung erfordert. Für den Aktualisierungsvorgang nicht zulässig. |
termDuration | Zeichenfolge | Nein | Die Laufzeit 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 in NCE bei der Migration gestartet werden. |
quantity | 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 OnlineServicesNCE-Abonnement oder Kalendermonat ohne Testversion ausgerichtet ist. Weitere Informationen zum Ausrichten von Abonnementendterminen finden Sie hier: Ausrichten von Abonnementenddaten in Partner Center |
targetDate | datetime | Nein | Zieldatum, wann die Migration geplant werden soll. Wenn targetDate für das angegebene Datum festgelegt ist, kann migrationOnRenewal auf NULL oder false festgelegt werden. |
migrateOnRenewal | bool | Nein | Wenn das Flag true für migrateOnRenewal festgelegt ist, ist es nicht erforderlich, das targetDate 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 diese Methode Details der zu migrierenden Abonnements (Migrationsobjekt) im Antworttext zurück.
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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für