Azure Blob Storage
Azure Blob Storage is used to store arbitrary unstructured data like images, files, backups, etc. Aidbox offers integration with Blob Storage to simplify upload and retrieval of data. You can read more on Blob Storage internals here. All examples from this tutorial are executable in the Aidbox REST console.

First of all, we have to create AzureAccount resource with id = account name and key = secret key of your account. Your account name and keys can be found under "Access keys" section in Azure Storage account settings.

  • id (required): Azure storage Account name
  • key (required): Azure storage Account key

POST /AzureAccount
id: aidbox
key: long-base64-encoded-string

Go to Azure console and create a container, for example, "avatars". Now we can create an AzureContainer resource:

  • id (optional): id to reference this container in Aidbox requests
  • account (required): reference to AzureAccount resource
  • storage (required): Azure resource group name
  • container (required): Azure container name

POST /AzureContainer
id: avatars
account: {id: aidbox, resourceType: AzureAccount}
storage: aidbox
container: avatars

When the configuration is complete, you can request a temporary URL to upload blobs. By default, such URL expires in 30 minutes. You can provide a blob name or just the extension (name will be generated).

  • blob (required): file name
  • timeout (optional, default: 30): timeout in minutes

POST /azure/storage/avatars
blob: pt-1.png

  • url: signed url to upload file

Configure CORS in Azure if you want to send data from the browser:
Now you can upload file from your UI using signed URL provided by Aidbox:
//onChange input[type=file]
var file = inputEvent.file.originFileObj;
fetch("<signed-url>", {
method: 'PUT',
body: file,
headers: {'x-ms-blob-type': 'BlockBlob'}

To read the uploaded file you can request a signed URL with:
GET /azure/storage/avatar/pt-1.png
status: 200
url: <read-signed-url>
# or
GET /azure/storage/avatar/pt-1.png?redirect=true
status: 302
Location: <read-signed-url>
For example, you can use a trick with redirect to render an image:
<img src="/azure/storage/avatar/pt-1.png?redirect=true"/>
Copy link
Edit on GitHub
On this page
Set up Azure storage account
Register AzureContainer
Get Shared Access Signature (SAS) to upload file
Get SAS to read a file