WriteBlob
Frends Task to write content to Azure Blob Storage.
Task version: 2.0.0
Required Frends version: 5.7+
Required .NET version: 8.0
Compatible Agents: Crossplatform
Source code: https://github.com/FrendsPlatform/Frends.AzureBlobStorage/tree/main/Frends.AzureBlobStorage.WriteBlob
Task Parameters
SourceType : SourceType
Selection of source types.
Possible values:
String: Selection of source types.Bytes: Selection of source types.
Default: 1
Example: SourceType.String
ContentString : String
Source content in string format.
Default: -
Example: This is test
ContentBytes : Byte[]
Source content in byte array.
Default: -
Example: VGhpcyBpcyB0ZXN0
Encoding : FileEncoding
Set desired content-encoding.
Defaults to UTF8 BOM.
Possible values:
UTF8: Set desired content-encoding.
Defaults to UTF8 BOM.
Default: Set desired content-encoding.
Defaults to UTF8 BOM.
ASCII: Set desired content-encoding.
Defaults to UTF8 BOM.
WINDOWS1252: Set desired content-encoding.
Defaults to UTF8 BOM.
Other: Set desired content-encoding.
Defaults to UTF8 BOM.
Default: 0
Example: utf8
EnableBOM : Boolean
Enables BOM for UTF-8.
Default: True
Example: -
FileEncodingString : String
Content encoding as string. A partial list of possible encodings: https://en.wikipedia.org/wiki/Windows_code_page#List.
Default: -
Example: windows-1252
ContainerName : String
Name of the Azure Blob Storage container.
Task will convert all letters to lowercase.
See more info: https://learn.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata#container-names
Default: -
Example: examplecontainer
BlobName : String
Name of the blob. Blob name can also be folder structure and folders will be created to Blob Storage.
See more info: https://learn.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata#blob-names
Default: -
Example: BlobName.txt; C:\folder\blobName.txt
Tags : Tag[]
Tags for the block or append blob.
Default: -
Example: {name, value}
CreateContainerIfItDoesNotExist : Boolean
Determines if the container should be created if it does not exist.
See https://docs.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata for naming rules.
Default: False
Example: false
HandleExistingFile : HandleExistingFile
How the existing blob will be handled.
Append: Append the blob with Source.SourceFile. Block and Page blobs will be downloaded as a temp file which will be deleted after local append and upload processes are complete. No downloading needed for Append Blob.
Overwrite: The original blob will be deleted before uploading the new one.
Error: Depending on Options.ThrowErrorOnFailure, throw an exception or Result will contain an error message instead of the blob's URL.
Possible values:
Error: How the existing blob will be handled.
Append: Append the blob with Source.SourceFile. Block and Page blobs will be downloaded as a temp file which will be deleted after local append and upload processes are complete. No downloading needed for Append Blob.
Overwrite: The original blob will be deleted before uploading the new one.
Error: Depending on Options.ThrowErrorOnFailure, throw an exception or Result will contain an error message instead of the blob's URL.
Overwrite: How the existing blob will be handled.
Append: Append the blob with Source.SourceFile. Block and Page blobs will be downloaded as a temp file which will be deleted after local append and upload processes are complete. No downloading needed for Append Blob.
Overwrite: The original blob will be deleted before uploading the new one.
Error: Depending on Options.ThrowErrorOnFailure, throw an exception or Result will contain an error message instead of the blob's URL.
Append: How the existing blob will be handled.
Append: Append the blob with Source.SourceFile. Block and Page blobs will be downloaded as a temp file which will be deleted after local append and upload processes are complete. No downloading needed for Append Blob.
Overwrite: The original blob will be deleted before uploading the new one.
Error: Depending on Options.ThrowErrorOnFailure, throw an exception or Result will contain an error message instead of the blob's URL.
Default: 0
Example: HandleExistingFile.Error
Compress : Boolean
Should the string be compressed before sending?
Default: False
Example: -
AuthenticationMethod : ConnectionMethod
Defines which connection method should be used for connecting to Azure Blob Storage.
Possible values:
ConnectionString: Defines which connection method should be used for connecting to Azure Blob Storage.OAuth2: Defines which connection method should be used for connecting to Azure Blob Storage.SasToken: Defines which connection method should be used for connecting to Azure Blob Storage.ArcManagedIdentity: Defines which connection method should be used for connecting to Azure Blob Storage.ArcManagedIdentityCrossTenant: Defines which connection method should be used for connecting to Azure Blob Storage.
Default: 1
Example: ConnectionMethod.ConnectionString
🗝ConnectionString : String
Connection string to Azure storage.
Default: -
Example: DefaultEndpointsProtocol=https;AccountName=account-name;AccountKey=abc==;EndpointSuffix=core.windows.net
ApplicationId : String
Application (Client) ID of Azure AD Application.
Default: -
Example: Y6b1hf2a-80e2-xyz2-abc33h-3a7c3a8as4b7f
TenantId : String
Tenant ID of Azure Tenant.
Default: -
Example: Y6b1hf2a-80e2-xyz2-abc33h-3a7c3a8as4b7f
🗝ClientSecret : String
Client Secret of Azure AD Application.
Default: -
Example: Password!
🗝SasToken : String
A shared access signature to use when connecting to an Azure storage container.
Grants restricted access rights to Azure Storage resources when combined with URI.
Default: -
Example: sv=2021-04-10&se=2022-04-10T10%3A431Z&sr=c&sp=l&sig=ZJg983RovE%23ZXI
StorageAccountName : String
Name of the Azure storage account.
Default: -
Example: TestStorage
Scopes : String[]
Scopes used when authenticating with Arc Managed Identity Cross Tenant.
Default: -
Example: [api://AzureADTokenExchange/.default]
TargetTenantId : String
Target Tenant ID of Azure Tenant.
Default: -
Example: Y6b1hf2a-80e2-xyz2-abc33h-3a7c3a8as4b7f
TargetClientId : String
Target Client ID of Azure Tenant.
Default: -
Example: Y6b1hf2a-80e2-xyz2-abc33h-3a7c3a8as4b7f
ThrowErrorOnFailure : Boolean
True: Throw an exception.
False: If the error is ignorable, such as when a Blob already exists, the error will be added to the Result.ErrorMessages list instead of stopping the Task.
Default: True
Example: true
Task Result
Success : Boolean
Operation complete. Operation is seens as completed if an ignorable error has occured and Options.ThrowErrorOnFailure is set to false.
Example: true
Info : String
This object contains the source file path and the URL of the blob. If an ignorable error occurs, such as when a blob already exists and Options.ThrowErrorOnFailure is set to false, the URL will be replaced with the corresponding error message.age.
Example: { { c:\temp\examplefile.txt, https://storage.blob.core.windows.net/container/examplefile.txt }, { c:\temp\examplefile2.txt, Blob examplefile2 already exists. } }
Uri : String
URI of uploaded file.
Task Changelog
Changelog for Task Frends.AzureBlobStorage.WriteBlob.
[2.0.0] - 2026-04-26
Changed
Standardized parameter names and validation across all Azure Blob Storage tasks for consistency.
[1.3.0] - 2026-01-23
Added
Add options to support Arc Managed Identity authentication.
[1.2.0] - 2026-01-15
Changed
Updated Azure packages to the latest versions:
Azure.Storage.Blobs 12.27.0
Azure.Identity 1.17.1
[1.1.0] - 2025-10-07
Fixed
Change returned info type from 3rd party BlobContentInfo to string with json.
[1.0.0] - 2025-01-24
Added
Initial implementation of Frends.AzureBlobStorage.WriteBlob.
Last updated
Was this helpful?