[SaaSのみ]{class="badge positive" title="Adobe Commerce as a Cloud ServiceおよびAdobe Commerce Optimizer プロジェクト(Adobeが管理するSaaS インフラストラクチャ)にのみ適用されます。"}

移行サービスへのアクセスの確認

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":[...]}
401
ベアラートークンが見つからないか無効です。サービスに到達する前に拒否されました。 ​ トークンを再生成
Varies (ゲートウェイ生成)
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.com
UK
https://uk1.api.commerce.adobe.com
オーストラリアおよびニュージーランド
https://au1.api.commerce.adobe.com

次のステップ

アクセスを確認したら、移行ガイド ​に進み、環境設定と移行の実行を開始します。

recommendation-more-help
commerce-help-cloud-service