移行サービスへのアクセスの確認
IMPORTANT
一括データ移行ツールは現在、早期アクセス中です。 アクセスは、Commerce デプロイドエンジニアリング(CDE)のエンゲージメントプロセスを通じてのみ提供されます。 ツールとその適格要件の概要については、一括データ移行ツール を参照してください。
このガイドでは、Commerce Data Migration Service (CDMS) APIへのエンドツーエンドのアクセスを確認する方法を説明します。 呼び出しが成功すると、エグレス IP (IP 許可リストに加える)、IMS認証、およびテナント認証からのネットワーク到達可能性が同時に検証されます。
このガイドは、顧客対応チェックリスト のすべての項目を完了した後、移行ガイド で説明されている移行を実行する前に完了してください。
前提条件
- Adobe Developer Consoleで作成されたOAuth 2.0 サーバー間の資格情報(クライアント IDおよびクライアント秘密鍵)。
- IMS組織ID (形式:
<org>@AdobeOrg)。 組織がターゲットテナントを所有している必要があります。 - ターゲット
tenantId、22文字、英数字のIMS テナント ID。 - CDMS ゲートウェイ用にAdobeに送信および許可リストに加えるされたアウトバウンドエグレス IP アドレス。 IP アドレスやそのステータスがわからない場合は、Adobeチームと調整してください。
- 環境および地域🔗 テーブル別のService ホストからの地域固有のサービス ホスト。
IMS アクセストークンの生成
client_credentials付与を使用して、OAuth 2.0 サーバー間の資格情報を使用してアクセストークンを生成します。 このステップのIMS ホストは、すべてのデータ領域で同じです。 CDMS ホストのみが領域ごとに変更されます。
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"
List Migrations APIの呼び出し
次のリクエストは、テナントの移行のリストを取得し、前の手順のアクセストークンを必要とします。 環境および地域🔗 テーブルのService ホストから、地域のホストを選択します。 -i フラグは、結果を確認できるように、HTTP ステータス行と応答ヘッダーを印刷します。
curl -i "https://<host>/<tenantId>/v1/migrations" \
-H "Authorization: Bearer <your IMS access token>"
応答の解釈
HTTP コード
意味
応答本文の例
200
成功: 接続、認証、テナント認証はすべて合格しました。 応答本文には、テナントの移行のリストが含まれます。
{"migrations":[...]}403
認証済みユーザーには、このテナントの移行権限がありません。
{"error":"access_denied","message":"You do not have permission to access this tenant"}500
内部サーバーエラー。
{"error":{"message":"Internal Server Error","status":500}}NOTE
リクエストがタイムアウトするか、接続が拒否され、HTTP ステータスが返されない場合は、エグレス IPが許可リストに加えるされない可能性が高い場合や、誤ったホストを使用している場合があります。 次の表のリージョンホストと許可リストに加えるしたIPを確認します。
環境および地域別のサービスホスト
地域または環境
ホスト
サンドボックスまたはプリプロダクション
https://na1-sandbox.api.commerce.adobe.com北米
https://na1.api.commerce.adobe.comヨーロッパ
https://eu1.api.commerce.adobe.comインド
https://in1.api.commerce.adobe.comUK
https://uk1.api.commerce.adobe.comオーストラリアおよびニュージーランド
https://au1.api.commerce.adobe.com次のステップ
アクセスを確認したら、移行ガイド に進み、環境設定と移行の実行を開始します。
recommendation-more-help
commerce-help-cloud-service