DocumentaciónKCS de Experience Cloud

La carga de recursos falla al usar las API de Asset Manager en Adobe Experience Manager as a Cloud Service

Última actualización: 13 de julio de 2026

La carga de recursos falla cuando las integraciones utilizan API en JVM como com.day.cq.dam.api.AssetManager.createAsset. Estas API están en desuso y no son compatibles con las cargas binarias en Adobe Experience Manager as a Cloud Service. La carga de binarios dentro de la JVM de AEM se trata como un antipatrón de la nube. Para solucionar este problema, migre al flujo de trabajo de carga binaria directa o utilice la importación masiva para la ingesta de recursos.

Descripción description

Entorno

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

Problema/Síntomas

  • Indicador de informe BPA no admitido.asset.api
  • Uso de com.day.cq.dam.api.AssetManager.createAsset o API similares
  • Intentos de carga de recursos ejecutados dentro de AEM JVM
  • Advertencias que indican que la carga de recursos no debe ejecutarse dentro de Experience Manager JVM
  • Las advertencias del desarrollador indican que las cargas de recursos no deben ejecutarse dentro de Experience Manager JVM

Resolución resolution

  1. Busque en el código base com.day.cq.dam.api.AssetManager.createAsset, createOrReplaceAsset y otros métodos de creación de recursos que escriben binarios dentro de AEM.

  2. Compruebe que el indicador BPA o la advertencia del IDE hagan referencia a estas API, como unsupported.asset.api

  3. Si no encuentra el código afectado, recopile la salida BPA y las rutas de archivo y compártalas con el Soporte técnico de Adobe.

  4. Utilice la ramificación de diagnóstico siguiente:

    • Si carga recursos desde un sistema externo, use API de carga binaria directa (initiateupload → binary upload → complete-upload).
    • Si realiza una ingesta de gran volumen, use AEM Bulk Import desde el almacenamiento en la nube (S3, Azure, GCP, Dropbox, OneDrive).
    • Si se requiere la ingesta programada periódica, use Adobe App Builder + API HTTP de AEM Assets.

  5. Confirme que su caso de uso no requiere cargas de recursos en JVM.

  6. Genere credenciales de servidor a servidor OAuth en Adobe Developer Console.

  7. Asigne el perfil de producto correcto a las credenciales.

  8. Genere un token de acceso y compruebe que Adobe Developer Console devuelve un token de portador válido.

  9. Si la generación de tokens falla, compruebe que el perfil de producto asignado incluya permisos de escritura.

  10. Inicie sesión en AEM Author y vaya a Herramientas > Seguridad > Usuarios.

  11. Busque el usuario de la cuenta técnica que aparece después de la primera invocación de la API.

  12. Compruebe que el usuario pertenece a un grupo de usuarios de servicios con permisos de jcr:read y rep:write en /content/dam.

  13. Compruebe los permisos de Herramientas > > de seguridad para el grupo de usuarios Servicios.

  14. Inicie el flujo de trabajo de carga binaria directa.

  15. Cargue el binario directamente en la ubicación de almacenamiento de nube devuelta.

  16. Complete la solicitud de carga para iniciar el procesamiento de recursos de AEM.

  17. Vaya a Assets > Archivos > en la carpeta de destino y compruebe que el recurso aparece en la carpeta de destino.

  18. Si la carga falla, recopile las cargas útiles de solicitud y respuesta de API y compártalas con el Soporte técnico de Adobe.

  19. Mueva los recursos a un proveedor de almacenamiento en la nube compatible y configure Importación en lotes en AEM

  20. Compruebe que los recursos importados aparecen en AEM.

Lectura relacionada

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