In AEM as a Cloud Service, image processing has been moved to the Asset Compute Microservice. Binary files are uploaded directly to blob storage instead of streaming through the AEM JVM.&nbsp; In this post, I explain how to get started with the asset upload HTTP API. I review and demonstrate the below-illustrated steps ( 1, 2, and 3) using <a title="Postman" href="https://www.postman.com/downloads/" target="_blank" rel="noopener">Postman</a> as a client application.
<blockquote>
Note: The Asset Upload HTTP API only works on Cloud Service, not for local SDK
&nbsp;
Note: Adobe &nbsp;provides the <a title="AEM Upload" href="https://github.com/adobe/aem-upload" target="_blank" rel="noopener">AEM Upload</a> tool to make uploading easier, and can be used as a command line executable or required as a Node.js module.
</blockquote>
<img src="https://i.ibb.co/BZt6pmc/asset-upload-http-api.png" alt="Asset Upload HTTP API" width="90%" /> credit Adobe for <a title="original image source" href="https://experienceleague.adobe.com/docs/experience-manager-cloud-service/assets/admin/developer-reference-material-apis.html?lang=en#asset-upload" target="_blank" rel="noopener">original image source</a>
<h3>&nbsp;</h3>
&nbsp;
<h3>Asset Upload</h3>
<blockquote>
Note: Before you begin, create a user in AEM with sufficient permission to upload assets and create a folder within the asset dam to upload to. For the sake of demo and simplicity, I am using the basic authentication but&nbsp;<a class="bd sv" href="https://experienceleague.adobe.com/docs/experience-manager-learn/getting-started-with-aem-headless/authentication/overview.html?lang=en" rel="noopener nofollow">Service Token base authentication</a>&nbsp;is the preferred method
</blockquote>
<h4> 1. Make a request for upload to AEM</h4>
The first step in the sequence is to make a request to AEM, relaying the intent to upload files. This requires authenticating with AEM and providing details about the assets you intend to upload (e.g. file name, file size).
The URI format for this POST call is: <code>https://&lt;aem-url&gt;/content/dam/&lt;asset-folder&gt;.initiateUpload.json</code>
<ul>
<li>Add Basic Auth Credentials <img src="https://i.ibb.co/fkwXrbL/asset-upload-1-auth.png" alt="Postman Basic Auth" width="90%" /> </li>
<li>Add Body <img src="https://i.ibb.co/9m095yR/asset-upload-1-body.png" alt="Postman Body" width="90%" /> </li>
<li>Submit and review response body <img src="https://i.ibb.co/0VDJ173/asset-upload-api-step-1-response.png" alt="Postman response" width="90%" /></li>
</ul>
<blockquote>
Note: Response object properties will be used in the next steps:
<code>folderPath, </code><code>minPartSize,</code><code>maxPartSize,</code><code>files,</code><code>uploadURIs,</code><code>mimeType,</code><code>uploadToken,</code><code>completeURI</code>
</blockquote>
&nbsp;
<ul>
<li>Review response cookies <img src="https://i.ibb.co/vLwt3HT/asset-upload-1-response-cookies.png" alt="" width="90%" /> 
<blockquote>Note: All corresponding calls to AEM should have the affinity cookie set on the request. The purpose of the affinity cookie is to tell AEM to use the same node in the cluster to handle the requests.</blockquote>
</li>
</ul>
<h4>&nbsp;</h4>
<h4>2. Upload binary to the blob store</h4>
The response from the first call will contain a list of pre-signed upload URLs, which will be used to upload directly to the blob store.&nbsp;
Make a PUT request to the pre-signed upload URI that was included in the previous response.
<ul>
<li>Remove Authentication <img src="https://i.ibb.co/3zFrwC1/step-2-remove-authentication.png" alt="Postman remove authentication" width="90%" /> </li>
<li>Add Body, Submit and confirm the request was successful <img src="https://i.ibb.co/k1ksPg1/step-2-body.png" alt="Postman binary body" width="90%" /></li>
</ul>
<h4>3. Make a request to complete in AEM</h4>
After the binaries have been successfully uploaded to the blob store, it is necessary to make a final request to complete the upload with AEM. Assets will not appear within AEM until this final API call is completed.
This call will require a few details from the initial request-response: upload token, complete URI, fileName
Make a POST call to the complete URI returned from the initial request.
<ul>
<li>Add Basic Auth Credentials <img src="https://i.ibb.co/y0TXdKK/asset-upload-3-auth.png" alt="Postman authentication tab" width="90%" /> </li>
<li>Add affinity Cookie <img src="https://i.ibb.co/K0JbjqV/asset-upload-3-cookies.png" alt="" width="90%" /> 
<blockquote>
Note: The corresponding calls to AEM should have the affinity cookie set on the request. If Token-Based Authentication was used, then the <code>x-aem-affinity-type: api</code> header would be passed with the request instead of the Affinity cookie.
</blockquote>
</li>
<li>Add Body, Submit and confirm the request was successful <img src="https://i.ibb.co/sQy34Rz/asset-upload-3-body-response.png" alt="Postman Body" width="90%" /> </li>
</ul>
<h3>View Uploaded Asset in AEM</h3>
When the final step of the request sequence is complete, AEM will run the <code>Asset Cloud Post-Processing Workflow</code>. You can navigate to your asset folder and confirm your upload was a success.
<img src="https://i.ibb.co/NxKy3nJ/asset-upload-api-success.png" alt="Asset Upload HTTP API Success" width="100%" />
&nbsp;
<h3>Part Splitting Use-Cases</h3>
In this introduction, I upload a standard web image file (245k). When uploading either a single large file or multiple files, it will be necessary to split the binary uploads into multiple requests. Each part should respect the minPartSize and maxPartSize values returned from the initial upload request.
&nbsp;
&nbsp;
<hr />
&nbsp;
*A big thank you to Kiran Murugulla and Kaushal Mall for their contributions and feedback in putting this together!

In this post, I explain how to get started with the asset upload HTTP API in AEM as a Cloud Service 

Edit Blog Post

Published

Title

Date

SEO Friendly URI

Meta Keywords

Meta Description

Tags

Content