Azure Blob Storage
Connect to Azure Blob Storage.
This article describes the operations for the Azure Blob Storage built-in connector, which is available only for Standard workflows in single-tenant Azure Logic Apps. If you're looking for the Azure Blob Storage managed connector operations instead, see Azure Blob Storage managed connector reference.
Built-in connector settings
In a Standard logic app resource, the Azure Blob Storage built-in connector includes settings that control various thresholds for performance, timeout, execution time, and so on. For example, you can change the timeout value for blob storage requests from the Azure Logic Apps runtime. For more information, review Reference for host settings - host.json - Blob storage.
Connector how-to guide
For more information about connecting to Azure Blob Storage from your workflow in Azure Logic Apps, see Connect to Azure Blob Storage from workflows in Azure Logic Apps.
Authentication
Storage account connection string
The connection string for your Azure storage account.
Parameters
| Name | Description | Type | Required | Allowed Values |
|---|---|---|---|---|
| Storage account connection string | The connection string for your Azure storage account. | securestring | True |
Active Directory OAuth
Active Directory OAuth
Parameters
| Name | Description | Type | Required | Allowed Values |
|---|---|---|---|---|
| Storage account endpoint string | The endpoint string for an Azure Blob storage account, for example, https://[storage-account-name].blob.core.windows.net | string | True | |
| Active Directory OAuth | Active Directory OAuth | string | True | |
| Authority | Active Directory authority | string | False | |
| Tenant | Active Directory tenant | string | True | |
| Credential type | Active Directory credential type | string | False | Certificate, Secret |
| Client ID | Active Directory client ID | string | True | |
| Client secret | Active Directory client secret | securestring | True | |
| Pfx | Active Directory pfx | securestring | True | |
| Password | Active Directory password | securestring | True |
Managed identity
Managed identity
Parameters
| Name | Description | Type | Required | Allowed Values |
|---|---|---|---|---|
| Storage account endpoint string | The endpoint string for an Azure Blob storage account, for example, https://[storage-account-name].blob.core.windows.net | string | True | |
| Managed identity | Managed identity | string | True | |
| Managed identity | Managed identity | string | False |
Actions
| Check whether blob exists |
Check whether a blob exists in an Azure storage container. |
| Copy blob from source location to destination |
Copy blob from source location to destination. |
| Copy blob from source location to destination reference by URI |
Copy a blob in an Azure storage container based on a URI. |
| Delete a blob |
Delete a blob from an Azure storage container. |
| Delete a blob based on a URI |
Delete a blob in an Azure storage container based on a URI. |
| Extract an archive from a blob path to a folder |
Extract an archive from a blob path to a folder. |
| Extract an archive from a blob path to a folder based on a URI |
Extract an archive from a blob path to a folder in an Azure storage container based on a URI. |
| Extract archive from content to a folder |
Extract archive from content to a folder. |
| Get blob access policies |
Get blob access policies. |
| Get blob metadata based on a URI |
Get blob metadata from an Azure storage container based on a URI. |
| Get blob metadata using path |
Get blob metadata using a path to an Azure storage container. |
| Get blob SAS URI using path |
Get the SAS URI for a blob using a path to an Azure storage container. |
| Get container metadata using path |
Get container metadata using a path to an Azure storage container. |
| Get the SAS URI for a blob based on a URI |
Get the SAS URI for a blob in an Azure storage container based on a URI. |
| List all containers |
List all containers in Azure storage account. |
| List all the blob directories using path |
List all the blob directories in the given path of Azure blob storage. |
| List all the blobs based on a URI |
List all the blobs in an Azure storage container based on a URI. |
| List all the blobs using path |
List all the blobs using a path to an Azure storage container. |
| Read blob content |
Read content from a blob in an Azure storage container. |
| Read blob content based on URI |
Read the content from a blob in an Azure storage container based on a URI. |
| Set the tier for a blob |
Set the tier for a blob. |
| Set the tier for a blob based on a URI |
Set the tier for a blob in an Azure storage container based on a URI. |
| Upload blob to storage container |
Upload a blob to an Azure storage container. |
| Upload blob to storage container based on a URI |
Upload a blob to an Azure storage container based on URI. |
Check whether blob exists
Check whether a blob exists in an Azure storage container.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Container name
|
containerName | True | string |
The name for the storage container and optional folder. |
|
Blob name
|
blobName | True | string |
The name for the blob and optional folder. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Is Blob Exists
|
isBlobExists | string |
Determine whether a blob exists in an Azure storage container. |
|
Properties
|
properties | string |
The blob properties. |
|
Blob Metadata
|
metadata | string |
The blob metadata. |
Copy blob from source location to destination
Copy blob from source location to destination.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Source Container name
|
sourceContainerName | True | string |
The container name of source blob for copy operation. |
|
Source Blob name
|
sourceBlobName | True | string |
The blob name of source blob for copy operation. |
|
Destination Container name
|
destinationContainerName | True | string |
The container name of destination blob for copy operation. |
|
Destination Blob name
|
destinationBlobName | True | string |
The blob name of destination blob for copy operation. |
|
Override If Exists
|
overrideIfExists | string |
Specifies if the copy operation would overwrite an existing blob with same name. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Name
|
name | string |
The entity name. |
|
Creation Time
|
creationTime | string |
The creation time for the blob. |
|
Blob Type
|
blobType | string |
The blob type. |
|
Blob Full Path
|
blobFullPathWithContainer | string |
Blob full path with container name. |
|
Content Disposition
|
contentDisposition | string |
The content disposition. |
|
Content MD5 Hash
|
contentMD5 | string |
The content MD5 hash. |
|
Content Type
|
contentType | string |
The type of content. |
|
Content Language
|
contentLanguage | string |
The language of the content. |
|
Blob ETag
|
eTag | string |
The ETag for the blob. |
Copy blob from source location to destination reference by URI
Copy a blob in an Azure storage container based on a URI.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Source URI
|
sourceBlobUri | True | string |
The source blob's full path in one of the following formats: 'container1/directory1/blob1' or 'container2/directory1/subdirectory2/' |
|
Destination URI
|
destinationBlobUri | True | string |
The destination blob's full path in one of the following formats: 'container1/directory1/blob1' or 'container2/directory1/subdirectory2/' |
|
Override If Exists
|
overrideIfExists | string |
Specifies if the copy operation would overwrite an existing blob with same name. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Name
|
name | string |
The entity name. |
|
Creation Time
|
creationTime | string |
The creation time for the blob. |
|
Blob Type
|
blobType | string |
The blob type. |
|
Blob Full Path
|
blobFullPathWithContainer | string |
Blob full path with container name. |
|
Content Disposition
|
contentDisposition | string |
The content disposition. |
|
Content MD5 Hash
|
contentMD5 | string |
The content MD5 hash. |
|
Content Type
|
contentType | string |
The type of content. |
|
Content Language
|
contentLanguage | string |
The language of the content. |
|
Blob ETag
|
eTag | string |
The ETag for the blob. |
Delete a blob
Delete a blob from an Azure storage container.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Container name
|
containerName | True | string |
The name for the storage container and optional folder. |
|
Blob name
|
blobName | True | string |
The name for the blob and optional folder. |
Delete a blob based on a URI
Delete a blob in an Azure storage container based on a URI.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Blob URI
|
blobUri | True | string |
The blob's full path in one of the following formats: 'container1/directory1/blob1' or 'container2/directory1/subdirectory2/' |
Extract an archive from a blob path to a folder
Extract an archive from a blob path to a folder.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Source Container name
|
sourceContainerName | True | string |
The container name of source blob for extract archive operation. |
|
Source Blob name
|
sourceBlobName | True | string |
The blob name of source blob for extract archive operation. |
|
Destination Container name
|
destinationContainerName | True | string |
The container name of destination blob for extract an archive from a blob path operation. |
|
Destination Folder path
|
destinationFolderPath | True | string |
The destination folder path for extract archive operation. |
|
Overwrite behaviour
|
overwriteExistingFilesBehaviour | string |
The input determines the behaviour when dealing with blobs having same path as the archive already exist on the blob storage. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Extract Archive Entities List
|
extractedBlobs | string |
The list of extract archive response entities. |
Extract an archive from a blob path to a folder based on a URI
Extract an archive from a blob path to a folder in an Azure storage container based on a URI.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Source URI
|
sourceBlobUri | True | string |
The source blob's full path in one of the following formats: 'container1/directory1/blob1' or 'container2/directory1/subdirectory2/' |
|
Destination URI
|
destinationBlobUri | True | string |
The destination blob's full path in one of the following formats: 'container1/directory1/blob1' or 'container2/directory1/subdirectory2/' |
|
Overwrite behaviour
|
overwriteExistingFilesBehaviour | string |
The input determines the behaviour when dealing with blobs having same path as the archive already exist on the blob storage. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Extract Archive Entities List
|
extractedBlobs | string |
The list of extract archive response entities. |
Extract archive from content to a folder
Extract archive from content to a folder.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Content
|
content | string |
The archived content input for extract archive operation. |
|
|
Destination Container name
|
destinationContainerName | True | string |
The container name of destination blob for extract an archive from a blob path operation. |
|
Destination Folder path
|
destinationFolderPath | string |
The destination folder path for extract archive operation. |
|
|
Overwrite behaviour
|
overwriteExistingFilesBehaviour | string |
The input determines the behaviour when dealing with blobs having same path as the archive already exist on the blob storage. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Extract Archive Entities List
|
extractedBlobs | string |
The list of extract archive response entities. |
Get blob access policies
Get blob access policies.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Container name
|
containerName | True | string |
The name for the storage container and optional folder. |
Returns
The list of access policies.
- Access Policy List
- array
Get blob metadata based on a URI
Get blob metadata from an Azure storage container based on a URI.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Blob URI
|
blobUri | True | string |
The blob's full path in one of the following formats: 'container1/directory1/blob1' or 'container2/directory1/subdirectory2/' |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Name
|
name | string |
The entity name. |
|
Creation Time
|
creationTime | string |
The creation time for the blob. |
|
Blob Type
|
blobType | string |
The blob type. |
|
Blob Full Path
|
blobFullPathWithContainer | string |
Blob full path with container name. |
|
Content Disposition
|
contentDisposition | string |
The content disposition. |
|
Content MD5 Hash
|
contentMD5 | string |
The content MD5 hash. |
|
Content Type
|
contentType | string |
The type of content. |
|
Content Language
|
contentLanguage | string |
The language of the content. |
|
Blob ETag
|
eTag | string |
The ETag for the blob. |
Get blob metadata using path
Get blob metadata using a path to an Azure storage container.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Container name
|
containerName | True | string |
The name for the storage container and optional folder. |
|
Blob name
|
blobName | True | string |
The name for the blob and optional folder. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Name
|
name | string |
The entity name. |
|
Creation Time
|
creationTime | string |
The creation time for the blob. |
|
Blob Type
|
blobType | string |
The blob type. |
|
Blob Full Path
|
blobFullPathWithContainer | string |
Blob full path with container name. |
|
Content Disposition
|
contentDisposition | string |
The content disposition. |
|
Content MD5 Hash
|
contentMD5 | string |
The content MD5 hash. |
|
Content Type
|
contentType | string |
The type of content. |
|
Content Language
|
contentLanguage | string |
The language of the content. |
|
Blob ETag
|
eTag | string |
The ETag for the blob. |
Get blob SAS URI using path
Get the SAS URI for a blob using a path to an Azure storage container.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Container name
|
containerName | True | string |
The name for the storage container and optional folder. |
|
Blob name
|
blobName | True | string |
The name for the blob and optional folder. |
|
Group policy identifier
|
groupPolicyIdentifier | string |
The string that identifies a stored access policy. Group policy parameters, such as start time and expiry time, have precedence over input parameters in actions. |
|
|
Permissions
|
permissions | string |
The access permissions for the SAS URI. |
|
|
Start time
|
startTime | string |
The date and time when the SAS becomes valid, for example, '2017-11-01T15:30:00+00.00'.Default=now(). |
|
|
Expiry time
|
expiryTime | string |
The date and time when the SAS is no longer valid, for example, '2017-11-01T15:30:00+00.00'.Default=now() + 24h. |
|
|
Shared access protocol
|
sharedAccessProtocol | string |
The allowed protocols, either HTTPS only or HTTP and HTTPS. Leave empty if you don't want to restrict traffic based on protocol. |
|
|
IP address or address range
|
ipAddressRange | string |
The allowed IP address or address range. Leave empty if you don't to restrict traffic based on IP address. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
SAS URI
|
blobUri | string |
The SAS URI based on a given blob path. |
Get container metadata using path
Get container metadata using a path to an Azure storage container.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Container name
|
containerName | True | string |
The name for the storage container and optional folder. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Container name
|
name | string |
The name for the Azure storage container. |
|
ETag
|
eTag | string |
The ETag for the Azure storage container. |
|
Last updated time
|
lastModifiedTime | string |
The last updated time. |
Get the SAS URI for a blob based on a URI
Get the SAS URI for a blob in an Azure storage container based on a URI.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Blob URI
|
blobUri | True | string |
The blob's full path in one of the following formats: 'container1/directory1/blob1' or 'container2/directory1/subdirectory2/' |
|
Group policy identifier
|
groupPolicyIdentifier | string |
The string that identifies a stored access policy. Group policy parameters, such as start time and expiry time, have precedence over input parameters in actions. |
|
|
Permissions
|
permissions | string |
The access permissions for the SAS URI. |
|
|
Start time
|
startTime | string |
The date and time when the SAS becomes valid, for example, '2017-11-01T15:30:00+00.00'.Default=now(). |
|
|
Expiry time
|
expiryTime | string |
The date and time when the SAS is no longer valid, for example, '2017-11-01T15:30:00+00.00'.Default=now() + 24h. |
|
|
Shared access protocol
|
sharedAccessProtocol | string |
The allowed protocols, either HTTPS only or HTTP and HTTPS. Leave empty if you don't want to restrict traffic based on protocol. |
|
|
IP address or address range
|
ipAddressRange | string |
The allowed IP address or address range. Leave empty if you don't to restrict traffic based on IP address. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
SAS URI
|
blobUri | string |
The SAS URI based on a given blob path. |
List all containers
List all containers in Azure storage account.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Page Marker
|
pageMarker | string |
A page marker that identifies the part of the list to return with the list action. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Container List
|
containers | string |
The list of all containers. |
|
Page Marker
|
pageMarker | string |
A page marker that identifies the part of the list to return with the list action. |
List all the blob directories using path
List all the blob directories in the given path of Azure blob storage.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Container name
|
containerName | True | string |
The name for the storage container and optional folder. |
|
Blob prefix path
|
blobNamePrefix | string |
The prefix path for the blob like 'directory1/blob1' or 'directory1/subdirectory2/'. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Blob Directories List
|
blobDirectories | string |
The list of all blob directories. |
List all the blobs based on a URI
List all the blobs in an Azure storage container based on a URI.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Blob URI
|
blobUri | True | string |
The blob's full path in one of the following formats: 'container1/directory1/blob1' or 'container2/directory1/subdirectory2/' |
|
Page Marker
|
pageMarker | string |
A page marker that identifies the part of the list to return with the list action. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Blob List
|
blobs | string |
The list of all the blobs. |
|
Page Marker
|
pageMarker | string |
A page marker that identifies the part of the list to return with the list action. |
List all the blobs using path
List all the blobs using a path to an Azure storage container.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Container name
|
containerName | True | string |
The name for the storage container and optional folder. |
|
Blob prefix path
|
blobNamePrefix | string |
The prefix path for the blob like 'directory1/blob1' or 'directory1/subdirectory2/'. |
|
|
Page Marker
|
pageMarker | string |
A page marker that identifies the part of the list to return with the list action. |
|
|
Exclude sub folder blobs
|
excludeSubFolderBlobs | string |
A boolean value indicating if the sub folder blobs should be listed in response. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Blob List
|
blobs | string |
The list of all the blobs. |
|
Page Marker
|
pageMarker | string |
A page marker that identifies the part of the list to return with the list action. |
Read blob content
Read content from a blob in an Azure storage container.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Container name
|
containerName | True | string |
The name for the storage container and optional folder. |
|
Blob name
|
blobName | True | string |
The name for the blob and optional folder. |
|
Infer Content Type
|
inferContentType | string |
Infer content-type based on extension. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Content
|
content | string |
The blob content. |
|
Properties
|
properties | string |
The blob properties. |
|
Blob Metadata
|
metadata | string |
The blob metadata. |
Read blob content based on URI
Read the content from a blob in an Azure storage container based on a URI.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Blob URI
|
blobUri | True | string |
The blob's full path in one of the following formats: 'container1/directory1/blob1' or 'container2/directory1/subdirectory2/' |
|
Infer Content Type
|
inferContentType | string |
Infer content-type based on extension. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Content
|
content | string |
The blob content. |
|
Properties
|
properties | string |
The blob properties. |
|
Blob Metadata
|
metadata | string |
The blob metadata. |
Set the tier for a blob
Set the tier for a blob.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Container name
|
containerName | True | string |
The name for the storage container and optional folder. |
|
Blob name
|
blobName | True | string |
The name for the blob and optional folder. |
|
Blob Access Tier
|
blobAccessTier | True | string |
The access tier for the blob to be set. |
Set the tier for a blob based on a URI
Set the tier for a blob in an Azure storage container based on a URI.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Blob URI
|
blobUri | True | string |
The blob's full path in one of the following formats: 'container1/directory1/blob1' or 'container2/directory1/subdirectory2/' |
|
Blob Access Tier
|
blobAccessTier | True | string |
The access tier for the blob to be set. |
Upload blob to storage container
Upload a blob to an Azure storage container.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Container name
|
containerName | True | string |
The name for the storage container and optional folder. |
|
Blob name
|
blobName | True | string |
The name for the blob and optional folder. |
|
Content
|
content | True | string |
The blob content. |
|
Override If Exists
|
overrideIfExists | string |
Override if blob already exists |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Properties
|
properties | string |
The blob properties. |
|
Blob Metadata
|
metadata | string |
The blob metadata. |
Upload blob to storage container based on a URI
Upload a blob to an Azure storage container based on URI.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Blob URI
|
blobUri | True | string |
The blob's full path in one of the following formats: 'container1/directory1/blob1' or 'container2/directory1/subdirectory2/' |
|
Content
|
content | True | string |
The blob content. |
|
Override If Exists
|
overrideIfExists | string |
Override if blob already exists |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Properties
|
properties | string |
The blob properties. |
|
Blob Metadata
|
metadata | string |
The blob metadata. |
Triggers
| When a blob is added or updated |
When a blob is added or updated in an Azure storage container. |
When a blob is added or updated
When a blob is added or updated in an Azure storage container.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Blob path
|
path | True | string |
The format for the blob path. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Blob Name
|
name | string |
The name for the blob. |
|
Container Info
|
containerInfo | string |
The container information. |
|
Properties
|
properties | string |
The blob properties. |
|
Blob Metadata
|
metadata | string |
The blob metadata. |