Freigeben über

Abrufen 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 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"
}
]

Siehe auch