Blobs & Python

Setting up

Configure your storage connection string

Locate the text file that contains the Connection String and copy the Connection String.

Windows: cmd

  • setx AZURE_STORAGE_CONNECTION_STRING "<yourconnectionstring>"

Restart any open program that will be using Blob.

Linux: Bash

  • export AZURE_STORAGE_CONNECTION_STRING="<yourconnectionstring>"

Install the package

Install the Azure Blob storage client library for Python package.

  • Open Anaconda Prompt > More > Run as administrator

  • conda install -c conda-forge azure-storage-blob

  • conda install -c conda-forge azure-mgmt-storage

An example

To learn, run the cells one by one and inspect the outcome.

  • Open Jupyter notebooks

    • New > Folder

    • Rename folder to: data

  • Create new notebook: blob-quickstart-v12

Set up the framework

import os, uuid

from import BlobServiceClient, BlobClient, ContainerClient, __version__


print("Azure Blob storage v" + __version__ + " - Python quickstart sample")

# Quick start code goes here

except Exception as ex:



Get the connection string

# Retrieve the connection string for use with the application. The storage

# connection string is stored in an environment variable on the machine

# running the application called AZURE_STORAGE_CONNECTION_STRING. If the environment variable is

# created after the application is launched in a console or with Visual Studio,

# the shell or application needs to be closed and reloaded to take the

# environment variable into account.

connect_str = os.getenv('AZURE_STORAGE_CONNECTION_STRING')

Create a container

Decide on a name for the new container. The code below appends a UUID value to the container name to ensure that it is unique.


# Create the BlobServiceClient object which will be used to create a container client

blob_service_client = BlobServiceClient.from_connection_string(connect_str)

# Create a unique name for the container

container_name = "quickstart" + str(uuid.uuid4())

# Create the container

container_client = blob_service_client.create_container(container_name)

Upload blobs to a container

# Create a file in local data directory to upload and download

local_path = "./data"

local_file_name = "quickstart" + str(uuid.uuid4()) + ".txt"

upload_file_path = os.path.join(local_path, local_file_name)

# Write text to the file

file = open(upload_file_path, 'w')

file.write("Hello, World!")


# Create a blob client using the local file name as the name for the blob

blob_client = blob_service_client.get_blob_client(container=container_name, blob=local_file_name)

print("\nUploading to Azure Storage as blob:\n\t" + local_file_name)

# Upload the created file

with open(upload_file_path, "rb") as data:


List the blobs in a container

print("\nListing blobs...")

# List the blobs in the container

blob_list = container_client.list_blobs()

for blob in blob_list:

print("\t" +

Download blobs

# Download the blob to a local file

# Add 'DOWNLOAD' before the .txt extension so you can see both files in the data directory

download_file_path = os.path.join(local_path, str.replace(local_file_name ,'.txt', 'DOWNLOAD.txt'))

print("\nDownloading blob to \n\t" + download_file_path)

with open(download_file_path, "wb") as download_file:


Delete a container

# Clean up

print("\nPress the Enter key to begin clean up")


print("Deleting blob container...")


print("Deleting the local source and downloaded files...")




Next steps

To see Blob storage sample apps, continue to:

Azure Blob storage SDK v12 Python samples

To learn more, see the Azure Storage client libraries for Python.

For tutorials, samples, quickstarts, and other documentation, visit Azure for Python Developers.