[僅限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組織識別碼,格式為<org>@AdobeOrg。 組織必須擁有目標租使用者。
  • 目標tenantId,22個字元的英數IMS租使用者ID。
  • 送出輸出IP位址已提交給Adobe並由CDMS閘道加入允許清單。 如果您不確定IP位址或其狀態,請與Adobe團隊協調。
  • 服務主機(依環境和區域資料表)的區域特定服務主機。

產生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"

呼叫清單移轉API

以下請求會擷取租使用者的移轉清單,並需要上一步驟的存取權杖。 從依環境和地區區分的服務主機表格中,選取您所在地區的主機。 -i旗標會列印HTTP狀態行和回應標題,以便您確認結果。

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

解讀回應

HTTP程式碼
含義
範例回應內文
200
成功。 連線、驗證和租使用者授權全部通過。 回應本文包含租使用者的移轉清單。
{"migrations":[...]}
401
遺失或無效的持有人權杖,在到達服務前遭拒。 重新產生權杖
視情況而定(閘道產生)
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