For the complete documentation index, see llms.txt. This page is also available as Markdown.

CreateContainer

Frends Task for creating a container to Azure Data Lake.

Task version: 1.4.0

Required Frends version: 5.7+

Required .NET version: 8.0

Compatible Agents: Crossplatform

Task Parameters

Name
Description

ConnectionMethod : ConnectionMethod

Which connection method should be used for connecting to Azure Data Lake.

Possible values:

  • ConnectionString: Which connection method should be used for connecting to Azure Data Lake.

  • OAuth2: Which connection method should be used for connecting to Azure Data Lake.

Default: ConnectionString Example: ConnectionMethod.ConnectionString

🗝ConnectionString : String

Connection string to Azure Data Lake.

Default: - Example: DefaultEndpointsProtocol=https;AccountName=accountname;AccountKey=Pdlrxyz==;EndpointSuffix=core.windows.net

StorageAccountName : String

Name of the Azure Data Lake account.

Default: - Example: Storager

ApplicationID : String

Application (Client) ID of Azure AD Application.

Default: - Example: Y6b1hf2a-80e2-xyz2-qwer3h-3a7c3a8as4b7f

TenantID : String

Tenant ID of Azure Tenant.

Default: - Example: Y6b1hf2a-80e2-xyz2-qwer3h-3a7c3a8as4b7f

🗝ClientSecret : String

Client Secret of Azure AD Application.

Default: - Example: Password!

ContainerName : String

Name of the Azure Data Lake container where the data will be uploaded.

Naming: lowercase

Valid chars: alphanumeric and dash, but cannot start or end with dash.

Default: test-container Example: test-container

Name
Description

ThrowErrorOnFailure : Boolean

True: Throw an exception on failure.

False: Return Result with Success=false and Error with description of exception.

Default: True Example: true

ErrorMessageOnFailure : String

Custom error message to use when ThrowErrorOnFailure is true or when returning an error result.

If empty, the original exception message is used.

Default: - Example: -

Task Result

Name
Description

Success : Boolean

Container created successfully. Example: true

Uri : String

URI string of newly created container. Example: https://test.lake.core.windows.net/test8f237ae0-ad33-b4b3-48d9-23b20a14c909

Error : Error

Error information when Success is false and ThrowErrorOnFailure is false.

Error.Message : String

Error message. Example: Container creation failed.

Error.AdditionalInfo : Exception

The exception that caused the failure.

Task Changelog

Changelog for Task Frends.AzureDataLake.CreateContainer.

[1.4.0] - 2026-08-07

Added

  • Added Options parameter with ThrowErrorOnFailure (default: true) and ErrorMessageOnFailure settings, giving you control over whether errors are thrown as exceptions or returned as part of the result.

  • The result now includes an Error property with a message and additional exception details when the task fails and ThrowErrorOnFailure is set to false.

Changed

  • Updated target framework to .NET 8.

[1.3.0] - 2026-01-15

Changed

  • Updated Azure packages to latest versions:

  • Azure.Storage.Files.DataLake 12.25.0

  • Azure.Identity 1.17.1

[1.2.0] - 2024-08-23

Changed

  • Updated the Azure.Identity package to version 1.12.0

[1.1.0] - 2024-05-20

Added

  • Added FrendsTaskMetadata.json

[1.0.0] - 2024-05-06

Added

  • Initial implementation of Frends.AzureDataLake.CreateContainer.

Last updated

Was this helpful?