DocumentaçãoKCS da Experience Cloud

Falha no upload de ativos ao usar APIs do Asset Manager no Adobe Experience Manager as a Cloud Service

Última atualização: 13 de julho de 2026

O upload de ativos falha quando as integrações usam APIs JVM, como com.day.cq.dam.api.AssetManager.createAsset. Essas APIs estão obsoletas e não são compatíveis com uploads binários no Adobe Experience Manager as a Cloud Service. O upload de binários na JVM do AEM é tratado como um antipadrão de nuvem. Para corrigir esse problema, migre para o fluxo de trabalho de Upload binário direto ou use a Importação em massa para assimilação de ativos.

Descrição description

Ambiente

  • Adobe Experience Manager as a Cloud Service
  • Adobe Developer App Builder
  • AEM Dynamic Media

Problema/Sintomas

  • Sinalizador de relatório BPA unsupported.asset.api
  • Uso de com.day.cq.dam.api.AssetManager.createAsset ou APIs semelhantes
  • Tentativas de upload de ativos executadas no AEM JVM
  • Avisos informando que o upload do ativo não deve ser executado no Experience Manager JVM
  • Avisos do desenvolvedor indicam que os uploads de ativos não devem ser executados dentro do Experience Manager JVM

Resolução resolution

  1. Procure por com.day.cq.dam.api.AssetManager.createAsset, createOrReplaceAsset e outros métodos de criação de ativos que gravam binários no AEM na sua base de código.

  2. Verifique se o sinalizador BPA ou o aviso do IDE faz referência a essas APIs, como unsupported.asset.api

  3. Se você não conseguir localizar o código afetado, colete a saída de BPA e os caminhos de arquivo e compartilhe-os com o Suporte da Adobe.

  4. Use a ramificação de diagnóstico abaixo:

    • Ao carregar ativos de um sistema externo, use a API de carregamento binário direto (initiateupload → binary upload → complete-upload).
    • Se estiver executando a assimilação de alto volume, use a Importação em massa do AEM do armazenamento na nuvem (S3, Azure, GCP, Dropbox, OneDrive).
    • Se a assimilação agendada periódica for necessária, use a Adobe App Builder + API HTTP do AEM Assets.

  5. Confirme se seu caso de uso não requer uploads de ativos no JVM.

  6. Gerar credenciais OAuth de servidor para servidor no Adobe Developer Console.

  7. Atribua o Perfil de produto correto às credenciais.

  8. Gere um token de acesso e verifique se o Adobe Developer Console retorna um token de portador válido.

  9. Se a geração do token falhar, verifique se o Perfil de produto atribuído inclui permissões de gravação.

  10. Faça logon no AEM Author e navegue até Ferramentas > Segurança > Usuários.

  11. Localize o usuário da conta técnica que aparece após a primeira invocação da API.

  12. Verifique se o usuário pertence a um grupo de usuários de serviços com permissões jcr:read e rep:write em /content/dam.

  13. Verifique Ferramentas > Segurança > Permissões para o grupo de usuários Serviços.

  14. Inicie o fluxo de trabalho de Upload binário direto.

  15. Faça upload do binário diretamente no local de armazenamento na nuvem retornado.

  16. Conclua a solicitação de upload para iniciar o processamento de ativos do AEM.

  17. Navegue até Assets > Arquivos > na pasta de destino e verifique se o ativo aparece na pasta de destino.

  18. Se o upload falhar, colete as cargas de solicitação e resposta da API e compartilhe-as com o Suporte da Adobe.

  19. Mova os ativos para um provedor de armazenamento na nuvem compatível e configure a Importação em massa no AEM

  20. Verifique se os ativos importados aparecem no AEM.

Leitura relacionada

recommendation-more-help
experience-cloud-kcs-help-kbarticles