Skip to main content Skip to footer

Azure Blob Storage Documentation

Version: 4.1.1

Retrieved: 2025-10-09 15:15:42


Azure Blob Storage

This module add blobs to Azure blob storage. The source can be a file, string or byte array. Three types of blobs are supported; append, page and block blobs.

This module is designed to be located at the end of a flow.

Settings

Name Requirements Purpose Default
Source Property String with length 1-64 The property on which the file name or data is found data
Upload Type File, ByteArray, String This setting is used to specify what type of data to upload to Azure File
Blob Type Append Block, Block Blob, Page Blob This setting is used to specify what type of blob to upload to Azure Append Blob
Timeout Positive int Timeout for Azure upload in seconds. Leave empty for default timeout (100 seconds).  
Delete after upload true/false Only for File Upload Type.
Whether files should be removed if they are successfully added to Azure file storage
false
Blob Container String with length 3-63 Which container the blob should be uploaded to mycontainer
Blob Name Property String with length 1-1024 The property that contains the name of the blob to upload blobname
Blob Storage URL String URL to Azure blob storage  
Blob Allocation Size (in MB) long Only for Page Blobs.
The number of MB to allocate for the page blob in Azure. A page blob can be altered continuously but a size must be set for allocation
1024
Offset Property String Only for Page Blobs.
The property that contains the offset in bytes the current blob part should be inserted at
offset

Note: When a blob is created it cannot change type so any attempt to put data to a blob of another type will fail.

Credential

This module contains an option to select credentials to use in the module. All credentials supported by the module are presented in a drop-down.

Blobtypes

Here a short introduction to the different kinds of blobs is given. For a more detailed explanation, please read the Microsoft Azure documentation. There you can also find the total sizes the different blobs have.

Append blob

Will append data to the end of the blob if it exists, otherwise create a new one and add the data to the beginning. Suitable for logging purposes as new data is always added to the end of the blob.

Block blob

Will add the data to the blob if it exists and overwrite previous data. If the blob doesn't exist it will create a new one. Typically you want to create a new blob for each content. Suitable for storing text or binary files.

Page blob

More efficient for frequent read/write operations as you can add parts of a blob to a certain part of the existing blob (as a multiple of 512 bytes). Will create a new blob if it doesn't exist. When creating the blob the first time an allocation size must be set.

Input

Any incoming message is accepted.

Output

No output is sent from the module. Instead the module adds blobs to Azure blob storage if the incomming message contain the property Source Property. Depending on Upload Type the content of the blob to add is either taken directly from Source Property or from the file with path in Source Property. The blob type is set by the Blob Type property.

Example 1 - Append to Append blob from a string

This example describes how to add content from a string to Azure Append blob. Each messages that is received is appended to the blob.

# Settings:
Source Property=data
Upload Type=String
Blob Type=Append blob
Timeout=
Blob Container=mycontainer
Blob Name Property=blobname
Blob Storage URL=https://crossertest.blob.core.windows.net

# Incoming message (1):
{
    data: "first post. ",
    blobname: "myblob"
}

A append blob is created in Azure:
Blob: mycontainer/myblob
Content: first post.

Now lets send another message to the module
# Incoming message (2):
{
    data: "second post. ",
    blobname: "myblob"
}

The new post is added to the append blob:
Blob: mycontainer/myblob
Content: first post. second post.

Example 2 - Add to Block blob from a file

This example describes how to add a file to Azure blob storage. The file path is sent as a property to the module.

# Settings:
Source Property=filePath
Upload Type=File
Blob Type=Block blob
Timeout=
Delete File After Upload=false
Blob Container=mycontainer
Blob Name Property=blobname
Blob Storage URL=https://crossertest.blob.core.windows.net

# Incoming message:
{
    filePath: "data/files/azure.txt",
    blobname: "myblob"
}

# Blob created in Azure:
Blob: mycontainer/myblob
Content: Content from data/files/azure.txt

Example 3 - Add to Page blob from byte array

This example describes how to add content from a byte array to a Page blob.

# Settings:
Source Property=data
Upload Type=ByteArray
Blob Type=Page blob
Timeout=
Blob Container=mycontainer
Blob Name Property=blobname
Blob Storage URL=https://crossertest.blob.core.windows.net
Blob Allocation Size (in MB)=1024
Offset Property=offset

# Incoming message (1):
{
    data: "Y29udGVudCBmcm9tIGJ5dGUgYXJyYXk",
    blobname: "myblob"
}

# Blob created in Azure of size 1024 MB:
Blob: mycontainer/myblob
Content: content from byte arrayNULLNULL...

As a Page blob allocates a size for a blob NULL values are set on positions not received.

Lets send another message but this time with an offset (multiple of 512 bytes).

# Incoming message (2):
{
    data: "YW5vdGhlciBwYXJ0",
    blobname: "myblob",
    offset: 512
}

# Blob updated:
Blob: mycontainer/myblob
Content: content from byte arrayNULLNULL...anotherpartNULLNULL...

The received data is added at the position set by the offset, in this case 512.