Überprüfen des Zugriffs auf den Migrationsdienst

Letzte Aktualisierung: 28. Juli 2026

Erstellt für:

{"id":"b5a62a22-46f7-4f0d-b151-3fc640bef588"}
{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

IMPORTANT

Das Tool für die Massendatenmigration befindet sich derzeit im Early Access-Modus. Der Zugriff wird ausschließlich über den Interaktionsprozess mit dem von Commerce bereitgestellten Engineering (CDE) bereitgestellt. Einen Überblick über das Tool und seine Eignungsanforderungen finden Sie unter Tool für die Massendatenmigration.

Verwenden Sie dieses Handbuch, um den End-to-End-Zugriff auf die Commerce Data Migration Service (CDMS)-API von Ihrer Umgebung aus zu überprüfen. Bei einem erfolgreichen Aufruf wird gleichzeitig die Erreichbarkeit des Netzwerks anhand Ihrer Ausgangs-IPs (IP-Zulassungsauflistung), der IMS-Authentifizierung und der Mandantenautorisierung überprüft.

Füllen Sie dieses Handbuch aus, nachdem Sie alle Elemente in der Checkliste zur Kundenbereitschaft abgeschlossen haben und bevor Sie die im Migrationshandbuch beschriebene Migration ausführen.

Voraussetzungen

Eine OAuth 2.0-Server-zu-Server-Anmeldedaten (Client-ID und Client-Geheimnis), die in der Adobe Developer Console erstellt .
Ihre IMS-Organisations-ID im Format <org>@AdobeOrg. Die Organisation muss Eigentümer des Ziel-Mandanten sein.
Die Ziel-tenantId, eine 22-stellige alphanumerische IMS-Mandanten-ID.
Ausgehende Ausgangs-IP-Adressen, die an Adobe für das CDMS-Gateway gesendet und von diesem auf die Zulassungsliste gesetzt werden. Stimmen Sie sich mit dem Adobe-Team ab, wenn Sie sich bezüglich der IP-Adressen oder ihres Status nicht sicher sind.
Der regionsspezifische Service-Host aus der Tabelle Service-Hosts nach Umgebung und Region.

Generieren eines IMS-Zugriffstoken

Erstellen Sie mit der client_credentials-Berechtigung ein Zugriffs-Token mit Ihren OAuth 2.0 Server-zu-Server-Anmeldeinformationen. Der IMS-Host in diesem Schritt ist für alle Datenregionen gleich. Nur der CDMS-Host ändert sich pro Region.

curl -X POST "https://ims-na1.adobelogin.com/ims/token/v3" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -H "x-org-id:<your-org-id>@AdobeOrg" \
  -d "grant_type=client_credentials" \
  -d "client_id=<your-ims-client-id>" \
  -d "client_secret=<your-ims-client-secret>" \
  -d "scope=AdobeID,openid,read_organizations,additional_info.projectedProductContext,additional_info.roles,adobeio_api,read_client_secret,manage_client_secrets"

Aufrufen der List Migrations-API

Die folgende Anfrage ruft die Liste der Migrationen für den Mandanten ab und erfordert das Zugriffstoken aus dem vorherigen Schritt. Wählen Sie den Host für Ihre Region aus der Tabelle Service-Hosts nach Umgebung und Region aus. Mit der -i-Markierung werden die HTTP-Statuszeile und die Antwort-Header gedruckt, damit Sie das Ergebnis bestätigen können.

curl -i "https://<host>/<tenantId>/v1/migrations" \
  -H "Authorization: Bearer <your IMS access token>"

Interpretieren der Antwort

HTTP-Code

Bedeutung

Beispiel-Antworttext

200

Erfolgreich. Konnektivität, Authentifizierung und Mandantenautorisierung wurden weitergeleitet. Der Antworttext enthält die Liste der Migrationen für den Mandanten.

{"migrations":[...]}

401

Fehlendes oder ungültiges Bearer-Token, vor Erreichen des Service abgelehnt. Erneutes Generieren des Tokens.

Variiert (Gateway-generiert)

403

Der authentifizierte Benutzer verfügt nicht über Migrationsberechtigungen für diesen Mandanten.

{"error":"access_denied","message":"You do not have permission to access this tenant"}

500

Interner Server-Fehler.

{"error":{"message":"Internal Server Error","status":500}}

NOTE

Wenn die Anfrage eine Zeitüberschreitung aufweist oder die Verbindung abgelehnt wird und kein HTTP-Status zurückgegeben wird, wird Ihre Ausgangs-IP wahrscheinlich nicht auf die Zulassungsliste gesetzt oder Sie verwenden einen falschen Host. Bestätigen Sie den Host für die Region in der folgenden Tabelle und Ihre auf die Zulassungsliste gesetzt IPs.

Service-Hosts nach Umgebung und Region

Region oder Umgebung

Host

Sandbox für die Vorproduktion

https://na1-sandbox.api.commerce.adobe.com

Nordamerika

https://na1.api.commerce.adobe.com

Europa

https://eu1.api.commerce.adobe.com

Indien

https://in1.api.commerce.adobe.com

https://uk1.api.commerce.adobe.com

Australien und Neuseeland

https://au1.api.commerce.adobe.com

Nächste Schritte

Nachdem Sie den Zugriff bestätigt haben, fahren Sie mit dem Migrationshandbuch fort, um mit der Umgebungskonfiguration und der Ausführung der Migration zu beginnen.

recommendation-more-help

commerce-help-cloud-service