# WriteBlob Required Frends version: 5.7+ Required .NET version: 8.0 Compatible Agents: Unknown Source code: {% tabs %} {% tab title="Parameter: Source" %} | Name | Description | | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | SourceType : `SourceType` |

Selection of source types.

Possible values:

Selection of source types.

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:

Set desired content-encoding.

Defaults to UTF8 BOM.

Set desired content-encoding.

Defaults to UTF8 BOM.

Set desired content-encoding.

Defaults to UTF8 BOM.

Set desired content-encoding.

Defaults to UTF8 BOM.

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: .


Default: -
Example: windows-1252

| | {% endtab %} | | {% tab title="Parameter: Destination" %} | Name | Description | | ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ContainerName : `String` |

Name of the Azure Blob Storage container.

Task will convert all letters to lowercase.

See more info:


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:


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 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:

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.

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.

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: -

| | {% endtab %} | | {% tab title="Parameter: Connection" %} | Name | Description | | ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | AuthenticationMethod : `ConnectionMethod` |

Defines which connection method should be used for connecting to Azure Blob Storage.

Possible values:

Defines which connection method should be used for connecting to Azure Blob Storage.

Defines which connection method should be used for connecting to Azure Blob Storage.

Defines which connection method should be used for connecting to Azure Blob Storage.

Defines which connection method should be used for connecting to Azure Blob Storage.

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

| | {% endtab %} | | {% tab title="Parameter: Options" %} | Name | Description | | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 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

| | {% endtab %} | | {% tab title="Result: Result" %} | Name | Description | | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 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, }, { c:\temp\examplefile2.txt, Blob examplefile2 already exists. } }

| | Uri : `String` | URI of uploaded file. | | {% endtab %} | | {% tab title="Changelog" %} ## Changelog ### \[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. {% endtab %} {% endtabs %}