How to Create a Container in Azure Blob Storage

To create a container in Azure Blob Storage, use the BlobServiceClient from the Azure SDK and call create_container() with your container name. This sets up a new storage container where you can upload and organize blobs.

Syntax

The main method to create a container is create_container(container_name) from the BlobServiceClient class.

• BlobServiceClient: Connects to your Azure Storage account.
• create_container(container_name): Creates a new container with the given name.
• container_name: The name you choose for your container; it must be lowercase and follow Azure naming rules.

python

from azure.storage.blob import BlobServiceClient

blob_service_client = BlobServiceClient.from_connection_string("<your_connection_string>")
container_client = blob_service_client.create_container("mycontainer")

Example

This example shows how to connect to Azure Blob Storage and create a container named mycontainer. It prints confirmation when the container is created.

python

from azure.storage.blob import BlobServiceClient

# Replace with your Azure Storage connection string
connection_string = "DefaultEndpointsProtocol=https;AccountName=youraccount;AccountKey=yourkey;EndpointSuffix=core.windows.net"

# Create the BlobServiceClient object
blob_service_client = BlobServiceClient.from_connection_string(connection_string)

# Create a container named 'mycontainer'
container_name = "mycontainer"
try:
    container_client = blob_service_client.create_container(container_name)
    print(f"Container '{container_name}' created successfully.")
except Exception as e:
    print(f"Error creating container: {e}")

Output

Container 'mycontainer' created successfully.

Common Pitfalls

Common mistakes when creating containers include:

• Using uppercase letters or invalid characters in the container name. Container names must be lowercase, between 3 and 63 characters, and can only contain letters, numbers, and hyphens.
• Trying to create a container that already exists without handling the error.
• Not providing a valid connection string or missing permissions.

Always handle exceptions to catch these issues.

python

from azure.storage.blob import BlobServiceClient

connection_string = "<your_connection_string>"
blob_service_client = BlobServiceClient.from_connection_string(connection_string)
container_name = "MyContainer"  # Incorrect: uppercase letters

try:
    container_client = blob_service_client.create_container(container_name)
except Exception as e:
    print(f"Failed to create container: {e}")

# Correct container name
container_name = "mycontainer"
try:
    container_client = blob_service_client.create_container(container_name)
    print("Container created successfully.")
except Exception as e:
    print(f"Failed to create container: {e}")

Quick Reference

Step	Description
1. Connect	Create BlobServiceClient with your connection string.
2. Choose Name	Pick a lowercase container name (3-63 chars, letters, numbers, hyphens).
3. Create	Call create_container(container_name) to make the container.
4. Handle Errors	Catch exceptions for existing containers or permission issues.

Key Takeaways

Use BlobServiceClient.create_container() with a valid lowercase container name to create a container.

Container names must be 3-63 characters, lowercase, and only letters, numbers, or hyphens.

Always handle exceptions to manage errors like duplicate containers or permission problems.

Provide a correct Azure Storage connection string with proper permissions.

Check for container existence before creating to avoid errors.