Puts content into a blob on Azure Blob Storage. The processor uses Azure Blob Storage client library v12.


azure, microsoft, cloud, storage, blob


In the list below, the names of required properties appear in bold. Any other properties (not in bold) are considered optional. The table also indicates any default values, and whether a property supports the NiFi Expression Language.

Display NameAPI NameDefault ValueAllowable ValuesDescription
Storage Credentialsstorage-credentials-serviceController Service API:
Implementations: AzureStorageCredentialsControllerServiceLookup_v12
Controller Service used to obtain Azure Blob Storage Credentials.
Container Namecontainer-nameName of the Azure storage container. In case of PutAzureBlobStorage processor, container can be created if it does not exist.
Supports Expression Language: true (will be evaluated using flow file attributes and variable registry)
Create Containercreate-containerfalse
  • true
  • false
Specifies whether to check if the container exists and to automatically create it if it does not. Permission to list containers is required. If false, this check is not made, but the Put operation will fail if the container does not exist.
Conflict Resolution Strategyconflict-resolution-strategyfail
  • fail Fail if the blob already exists
  • ignore Ignore if the blob already exists; the 'azure.error' attribute will be set to the value 'BLOB_ALREADY_EXISTS'
  • replace Replace blob contents if the blob already exist
Specifies whether an existing blob will have its contents replaced upon conflict.
Blob Nameblob-nameThe full name of the blob
Supports Expression Language: true (will be evaluated using flow file attributes and variable registry)
Resource Transfer SourceResource Transfer SourceFlowFile Content
  • FlowFile Content The content of the incoming FlowFile provides the source for transfer
  • File Resource Service The File Resource Service provides the source for transfer
The source of the content to be transferred
File Resource ServiceFile Resource ServiceController Service API:
Implementation: StandardFileResourceService
File Resource Service providing access to the local resource to be transferred

This Property is only considered if the [Resource Transfer Source] Property has a value of "File Resource Service".
Proxy Configuration Serviceproxy-configuration-serviceController Service API:
Implementation: StandardProxyConfigurationService
Specifies the Proxy Configuration Controller Service to proxy network requests. Supported proxies: HTTP, SOCKS In case of SOCKS, it is not guaranteed that the selected SOCKS Version will be used by the processor.
Client-Side Encryption Key TypeClient-Side Encryption Key TypeNONE
  • NONE Client-Side Encryption disabled
  • LOCAL Client-Side Encryption enabled using local key
Specifies the key type to use for client-side encryption.
Client-Side Encryption Key IDClient-Side Encryption Key IDSpecifies the ID of the key to use for client-side encryption.
Supports Expression Language: true (will be evaluated using flow file attributes and variable registry)

This Property is only considered if the [Client-Side Encryption Key Type] Property has a value of "LOCAL".
Client-Side Encryption Local KeyClient-Side Encryption Local KeyWhen using local client-side encryption, this is the raw key, encoded in hexadecimal
Sensitive Property: true

This Property is only considered if the [Client-Side Encryption Key Type] Property has a value of "LOCAL".


successAll successfully processed FlowFiles are routed to this relationship
failureUnsuccessful operations will be transferred to the failure relationship.

Reads Attributes:

None specified.

Writes Attributes:

azure.containerThe name of the Azure Blob Storage container
azure.blobnameThe name of the blob on Azure Blob Storage
azure.primaryUriPrimary location of the blob
azure.etagETag of the blob
azure.blobtypeType of the blob (either BlockBlob, PageBlob or AppendBlob)
mime.typeMIME Type of the content
langLanguage code for the content
azure.timestampTimestamp of the blob
azure.lengthLength of the blob
azure.error.codeError code reported during blob operation
azure.ignoredWhen Conflict Resolution Strategy is 'ignore', this property will be true/false depending on whether the blob was ignored.

State management:

This component does not store state.


This component is not restricted.

Input requirement:

This component requires an incoming relationship.

System Resource Considerations:

None specified.

See Also:

ListAzureBlobStorage_v12, FetchAzureBlobStorage_v12, DeleteAzureBlobStorage_v12