az-storage-container

Manage Azure Blob Storage containers

TLDR

Create a container

$ az storage container create -n [container-name] --account-name [account]

Create with public blob access

$ az storage container create -n [container-name] --public-access blob --account-name [account]

List all containers

$ az storage container list --account-name [account] -o table

Check if a container exists

$ az storage container exists -n [container-name] --account-name [account]

Show container properties

$ az storage container show -n [container-name] --account-name [account]

Generate a SAS token for a container

$ az storage container generate-sas -n [container-name] --permissions [acdlrw] --expiry [2026-12-31T00:00Z] --account-name [account]

Delete a container

$ az storage container delete -n [container-name] --account-name [account]

Restore a soft-deleted container

$ az storage container restore -n [container-name] --deleted-version [version] --account-name [account]

SYNOPSIS

az storage container subcommand [options]

az storage container manages blob storage containers in Azure Storage accounts. Containers provide a grouping of blobs similar to directories in a file system.Containers can have different access levels: private (default), blob (anonymous read for blobs), or container (anonymous read for container and blobs). All blobs must reside in a container.

PARAMETERS

-n, --name value

Name of the container

--account-name value

Storage account name

--account-key value

Storage account key

--public-access value

Public access level: blob, container, off. Default off (private).

--auth-mode value

Authentication mode: key (legacy account key) or login (your Azure AD credentials).

--fail-on-exist

Throw an exception if the container already exists.

--permissions value

SAS permissions: (a)dd, (c)reate, (d)elete, (l)ist, (r)ead, (w)rite

--expiry value

SAS token expiration datetime (UTC)

SUBCOMMANDS

Container Lifecycle

create, delete, list, exists, show, restore

Access Control

set-permission, show-permission, generate-sas

Metadata

metadata show, metadata update

Leases

lease acquire, lease break, lease release, lease renew, lease change

Policies

policy create, policy delete, policy list, policy show, policy update

Compliance

immutability-policy create, immutability-policy lock, immutability-policy extend, immutability-policy show, immutability-policy delete, legal-hold set, legal-hold clear, legal-hold show

INSTALL

sudo dnf install azure-cli

sudo pacman -S azure-cli

sudo zypper install azure-cli

brew install azure-cli

nix profile install nixpkgs#azure-cli

CAVEATS

Container names must be 3-63 characters, lowercase letters, numbers, and hyphens only. Deleting a container deletes all contained blobs. Soft-delete policies allow recovery within the retention period. Immutability policies and legal holds prevent deletion for compliance purposes.

RESOURCES

Documentation · Homepage · Source code