Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 erhalten.
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
Es gibt zwei verschiedene Möglichkeiten, wie Partner abfragen können.
- Partner können abfragen, um einen bestimmten Zeitplan abzurufen.
- Partner können abfragen, um die Liste der Zeitpläne für bestimmte Kriterien abzurufen.
Anforderungssyntax
Methode | Anforderungs-URI |
---|---|
GET | {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. |
Methode | Anforderungs-URI |
---|---|
GET | {baseURL}/v1/migration/newcommerce/schedules? CustomerTenantId={customer-tenant-id} |
URI-Parameter
In dieser Tabelle sind die erforderlichen Abfrageparameter aufgeführt, um eine neue Commerce-Migration zu erstellen. Jeder der Abfrageparameter kann verwendet werden.
Name | Art | Beschreibung |
---|---|---|
customerTenantId | Zeichenfolge | Eine GUID-formatierte Zeichenfolge, die den Kunden identifiziert. |
currentSubscriptionID | Zeichenfolge | Eine GUID-formatierte Zeichenfolge, die die aktuelle Abonnement-ID identifiziert |
externalReferenceID | Zeichenfolge | Eine GUID-formatierte Zeichenfolge, die den Migrationsbatch identifiziert |
Anforderungsheader
Weitere Informationen finden Sie unter Partner Center-REST-Header.
Antworttext
In dieser Tabelle werden die Abonnementeigenschaften in der Antwort beschrieben.
Eigenschaft | Typ | Erforderlich | Beschreibung |
---|---|---|---|
currentSubscriptionId | Zeichenfolge | Ja | Ein Abonnementbezeichner, der angibt, welches Abonnement eine Überprüfung für die Migration erfordert. |
termDuration | Zeichenfolge | No | Laufzeitdauer, die auf die Migration angewendet wird. |
billingCycle | Zeichenfolge | No | Abrechnungszyklus, der auf die Migration angewendet wurde. |
purchaseFullTerm | bool | No | Gibt an, ob die Migration einen neuen Begriff startet oder nicht. |
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 der Enddaten des Abonnements im Partner Center |
targetDate | datetime | No | Zieldatum, an dem die Migration geplant werden soll. |
migrateOnRenewal | bool | No | Gibt an, ob der Zeitplan bei der Verlängerung erfolgen muss. |
status | Zeichenfolge | No | Status der Zeitplanmigration |
createdTime | datetime | No | Wann der Zeitplan erstellt wurde |
lastModifiedTime | datetime | No | Zeitpunkt der letzten Änderung des Zeitplans |
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 mit weiteren Debuginformationen angibt. Verwenden Sie ein Netzwerkablaufverfolgungstool, um diesen Code, fehlertyp und weitere 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"
}
]