ballerinax/azure.storage.files Ballerina library

Checks whether a share exists in the storage account. Returns false only when Azure confirms the share is absent; an Error means the check itself failed.

Lists the shares in the storage account.

Creates a new share in the storage account.

Deletes a share from the storage account.

Restores a soft-deleted share.

Reads the account's file-service configuration (metrics and CORS rules).

Updates the account's file-service configuration. The record replaces the whole configuration.

Gets a user-delegation key for signing user-delegation SAS tokens. Requires Microsoft Entra ID credentials with the Storage File Delegator role.

Generates an account-level SAS (Shared Access Signature) token. Requires shared key credentials.

Downloads a file to a local path. An existing local file at destinationPath fails the download.

Retrieves a file's content in the form the target type selects. CSV content binds to record array and record stream targets only. Binding is strict: content that does not match the target fails with a client side Error.

Uploads a local file to the watched share.

Uploads in-memory content to the watched share.

Deletes a file from the watched share.

Renames or moves a file within the watched share. An existing destination file is overwritten only when RenameOptions.replaceIfExists is set.

Copies a file within the watched share. The copy is asynchronous; inspect the returned CopyInfo.copyStatus for its state.

Checks the state of the most recent copy operation that targeted a file.

Aborts a pending asynchronous copy operation.

Creates a directory in the watched share.

Deletes a directory from the watched share. The directory must be empty.

Lists the entries (files and subdirectories) under a directory of the watched share.

Gets the properties of the bound share.

Replaces the metadata of the bound share.

Gets the approximate amount of data stored on the bound share, in bytes.

Creates a directory in the bound share.

Deletes a directory from the bound share. The directory must be empty.

Checks whether a directory exists in the bound share. Returns false only when Azure confirms the directory is absent; an Error means the check itself failed.

Gets the properties of a directory.

Replaces the metadata of a directory.

Lists the entries (files and subdirectories) under a directory.

Renames or moves a directory within the bound share, together with its entire contents.

Creates an empty file of a fixed size.

Deletes a file from the bound share.

Checks whether a file exists in the bound share. Returns false only when Azure confirms the file is absent; an Error means the check itself failed.

Gets the properties of a file.

Replaces the metadata of a file.

Sets the content headers of a file, such as Content-Type and Cache-Control. Any header omitted from headers is cleared on the file.

Renames or moves a file within the bound share. An existing destination file is overwritten only when RenameOptions.replaceIfExists is set.

Uploads a local file to the bound share.

// ./reports/q1.pdf (local disk) --> /2026/q1/report.pdf (on the share)
check fileClient->uploadFromFile("./reports/q1.pdf", "/2026/q1/report.pdf");

Uploads in-memory content to the bound share.

Metrics metrics = {revenue: 1250000, growth: 0.12};
check fileClient->upload(metrics, "/2026/q1/metrics.json");

Uploads a byte stream to the bound share. The total content length is required. There is no record stream upload, so collect records into a record {}[] and use upload.

Downloads a file to a local path. An existing local file at destinationPath fails the download.

// /2026/q1/report.pdf (on the share) --> ./reports/q1.pdf (local disk)
check fileClient->download("/2026/q1/report.pdf", "./reports/q1.pdf");

Retrieves a file's content in the form the target type selects. CSV content binds to record array and record stream targets only. Binding is strict: content that does not match the target fails with a client side Error.

byte[] raw = check fileClient->getFile("/2026/q1/report.pdf");
Person[] people = check fileClient->getFile("/2026/q1/people.csv");
stream<byte[], error?> chunks = check fileClient->getFile("/2026/q1/large.bin");

Copies a file within the bound share. The copy is asynchronous; inspect the returned CopyInfo.copyStatus for its state.

Copies a file from an external URL into the bound share. A source outside this storage account must carry its own authorization in the URL (typically a SAS token).

Checks the state of the most recent copy operation that targeted a file.

Aborts a pending asynchronous copy operation.

Writes a range of bytes into a file at a given offset. A single range write is capped at 4 MiB by the service.

Clears a range of bytes in a file.

Lists the valid (written) byte ranges of a file.

Creates a point-in-time, read-only snapshot of the bound share. Requires account-level credentials.

Lists the snapshots of the bound share. Requires account-level credentials.

Deletes one snapshot of the bound share. Requires account-level credentials.

Lists how a file's byte ranges changed since a share snapshot.

Generates a SAS (Shared Access Signature) token scoped to the bound share. Requires shared key credentials.

Generates a SAS (Shared Access Signature) token scoped to a single file. Requires shared key credentials.

Generates a user-delegation SAS token scoped to the bound share.

Generates a user-delegation SAS token scoped to a single file.