Intermittent HTTP 503 errors occur during bulk asset import in Experience Manager Assets
In Experience Manager Assets as a Cloud Service, bulk imports submitted through POST /adobe/assets/import/fromUrl return intermittent HTTP 503 responses. These responses disrupt asset-ingestion workflows when the client sends large batches or too many requests concurrently. This article explains how to address intermittent HTTP 503 responses that occur during bulk asset imports in Experience Manager Assets as a Cloud Service.
Description description
Environment
Experience Manager Assets as a Cloud Service
Issue/Symptoms
When you submit bulk asset imports through POST /adobe/assets/import/fromUrl, the service intermittently returns HTTP 503 responses.
The following error message is returned:
[ AemCloudImageTransfer] Cloud Import failed: AEM Cloud import failed (503): AEM Cloud import failed (503):
- The
HTTP 503response is returned immediately after you submit the import request. - The issue is intermittent but occurs frequently enough to affect asset-ingestion reliability.
- No consistent pattern is observed for the affected assets or request times.
Cause
Request bursts or high concurrency exceed available service capacity during asset import, resulting in intermittent HTTP 503 responses.
Resolution resolution
To reduce intermittent HTTP 503 responses, follow these steps:
-
Analyze the frequency and size of the asset-import requests.
- Review the number of assets included in each request.
- Review the number of import requests submitted at the same time.
- Identify request bursts that coincide with the
HTTP 503responses.
-
Reduce the number of assets included in each batch import request.
-
Decrease the number of simultaneous import requests to reduce request concurrency.
-
Add retry handling for transient
HTTP 503responses.- Use exponential backoff between retry attempts.
- Prevent the client from immediately resubmitting all failed requests at the same time.
-
Monitor the import workflow after adjusting the batch size, request concurrency, and retry behavior.
- Monitor the import workflow after adjusting the batch size, request concurrency, and retry behavior to verify that imports complete successfully and that intermittent HTTP 503 responses no longer disrupt the workflow.