[Somente SaaS]{class="badge positive" title="Aplicável somente a projetos do Adobe Commerce as a Cloud Service e do Adobe Commerce Optimizer (infraestrutura SaaS gerenciada pela Adobe)."}

Verificar acesso ao serviço de migração

IMPORTANT
A ferramenta de migração de dados em massa está atualmente em Acesso antecipado. O acesso é fornecido exclusivamente por meio do processo de contrato do Commerce Deployment Engineering (CDE). Para obter uma visão geral da ferramenta e seus requisitos de qualificação, consulte Ferramenta de migração de dados em massa.

Use este guia para verificar o acesso completo à API do Serviço de migração de dados (CDMS) da Commerce a partir de seu ambiente. Uma chamada bem-sucedida valida simultaneamente a capacidade de alcance da rede dos IPs de saída (incluir na lista de permissões de IPs), da autenticação IMS e da autorização do locatário.

Conclua este guia depois de concluir todos os itens da Lista de verificação de preparação do cliente e antes de executar a migração descrita no guia de migração.

Pré-requisitos

  • Uma credencial OAuth 2.0 Server-to-Server (ID de cliente e segredo do cliente) criada no Adobe Developer Console.
  • Sua ID da organização IMS, no formato <org>@AdobeOrg. A organização deve ser proprietária do locatário de destino.
  • O destino tenantId, uma ID de locatário IMS alfanumérica de 22 caracteres.
  • Endereços IP de saída enviados para o gateway CDMS e pelo Adobe. Entre em contato com a equipe do Adobe se não tiver certeza sobre os endereços IP ou seus status.
  • O host de serviço específico da região da tabela Hosts de serviço por ambiente e região.

Gerar um token de acesso IMS

Gere um token de acesso usando suas credenciais de Servidor para Servidor do OAuth 2.0 com a concessão client_credentials. O host IMS nessa etapa é o mesmo para todas as regiões de dados. Somente o host CDMS é alterado por região.

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"

Chamar a API de migração de lista

A solicitação a seguir recupera a lista de migrações para o locatário e requer o token de acesso da etapa anterior. Selecione o host da sua região na tabela Hosts de serviço por ambiente e região. O sinalizador -i imprime a linha de status HTTP e os cabeçalhos de resposta para que você possa confirmar o resultado.

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

Interpretar a resposta

Código HTTP
Significado
Exemplo de corpo de resposta
200
Sucesso. Conectividade, autenticação e autorização do locatário foram transmitidas. O corpo da resposta contém a lista de migrações para o locatário.
{"migrations":[...]}
401
Token de portador ausente ou inválido, rejeitado antes de alcançar o serviço. Regenerar o token.
Varia (gerado pelo gateway)
403
O usuário autenticado não tem permissões de migração para este locatário.
{"error":"access_denied","message":"You do not have permission to access this tenant"}
500
Erro interno do servidor.
{"error":{"message":"Internal Server Error","status":500}}
NOTE
Se a solicitação atingir o tempo limite ou a conexão for recusada e nenhum status HTTP for retornado, o IP de saída provavelmente não será atualizado ou você está usando um host incorreto. Confirme o host da região na tabela a seguir e os IPs personalizados.

Hosts de serviço por ambiente e região

Região ou ambiente
Host
Sandbox ou pré-produção
https://na1-sandbox.api.commerce.adobe.com
América do Norte
https://na1.api.commerce.adobe.com
Europa
https://eu1.api.commerce.adobe.com
Índia
https://in1.api.commerce.adobe.com
Reino Unido
https://uk1.api.commerce.adobe.com
Austrália e Nova Zelândia
https://au1.api.commerce.adobe.com

Próximas etapas

Após confirmar o acesso, prossiga para o guia de migração para iniciar a configuração do ambiente e a execução da migração.

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