Azure Documentation

1. Using Azure Storage SDKs (Recommended)

The Azure Storage SDKs provide client libraries for various programming languages, allowing you to interact with Azure Blob Storage programmatically.

Uploading with .NET SDK

Here's a C# example demonstrating how to upload a blob using the Azure.Storage.Blobs NuGet package.

C#

using Azure.Storage.Blobs;
using System;
using System.IO;
using System.Threading.Tasks;

public class BlobUploader
{
    public static async Task UploadFileAsync(string blobUri, string filePath, string blobName)
    {
        try
        {
            // Create a BlobServiceClient object which will be used to create a container client
            BlobServiceClient blobServiceClient = new BlobServiceClient(blobUri);

            // Get a client for the specified container
            BlobContainerClient containerClient = blobServiceClient.GetBlobContainerClient("mycontainer"); // Replace with your container name

            // Get a client to reference a specific blob
            BlobClient blobClient = containerClient.GetBlobClient(blobName);

            using (FileStream uploadFileStream = File.OpenRead(filePath))
            {
                await blobClient.UploadAsync(uploadFileStream, true); // Set overwrite to true to replace existing blobs
                Console.WriteLine($"Successfully uploaded {blobName} to container {containerClient.Name}");
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error uploading blob: {ex.Message}");
        }
    }

    // Example usage:
    // public static async Task Main(string[] args)
    // {
    //     string connectionString = "YOUR_AZURE_STORAGE_CONNECTION_STRING"; // Or use blobUri directly
    //     string filePath = "path/to/your/local/file.txt";
    //     string blobName = "my-uploaded-file.txt";
    //     await UploadFileAsync(connectionString, filePath, blobName);
    // }
}

Uploading with Python SDK

Here's a Python example using the azure-storage-blob library.

Python

from azure.storage.blob import BlobServiceClient
import os

def upload_blob(connect_str, container_name, blob_name, file_path):
    try:
        # Create the BlobServiceClient object
        blob_service_client = BlobServiceClient.from_connection_string(connect_str)

        # Get a client to reference a specific blob, and create the blob client
        blob_client = blob_service_client.get_blob_client(container=container_name, blob=blob_name)

        # Open the local file and upload it
        with open(file_path, "rb") as data:
            blob_client.upload_blob(data, overwrite=True)
            print(f"Successfully uploaded {blob_name} to container {container_name}")

    except Exception as ex:
        print(f"Error uploading blob: {ex}")

# Example usage:
# if __name__ == "__main__":
#     connect_str = "YOUR_AZURE_STORAGE_CONNECTION_STRING"
#     container_name = "mycontainer" # Replace with your container name
#     blob_name = "my-uploaded-file.txt"
#     file_path = "path/to/your/local/file.txt"
#     upload_blob(connect_str, container_name, blob_name, file_path)

Refer to the official Azure Storage SDK documentation for other languages like Java, Node.js, and Go.

2. Using Azure CLI

The Azure Command-Line Interface (CLI) is a powerful tool for managing Azure resources, including uploading blobs.

Bash

az storage blob upload \
    --account-name <your-storage-account-name> \
    --container-name <your-container-name> \
    --name <your-blob-name> \
    --file <path-to-your-local-file> \
    --auth-mode login  # or --account-key <your-account-key> or --sas-token <your-sas-token>

Note: Replace placeholders like <your-storage-account-name>, <your-container-name>, <your-blob-name>, and <path-to-your-local-file> with your actual values. For authentication, you can use --auth-mode login if you are logged into Azure CLI, or provide an account key or SAS token.

3. Using Azure Storage Explorer

Azure Storage Explorer is a graphical tool that allows you to manage your Azure storage resources from your desktop. It provides an intuitive interface for uploading, downloading, and managing blobs.

1. Download and install Azure Storage Explorer from the official Azure website.
2. Connect to your Azure Storage account.
3. Navigate to your container.
4. Click the "Upload" button and select "Upload Files..." or "Upload Folder...".
5. Choose the file(s) or folder you wish to upload.

Storage Explorer is excellent for quick uploads, testing, and exploring your storage.

4. Using REST API

For advanced scenarios or when SDKs are not suitable, you can interact directly with Azure Blob Storage via its REST API. This involves making HTTP requests to the Azure Storage endpoints.

The primary operation for uploading a blob is the Put Blob operation. You'll need to construct HTTP PUT requests with appropriate headers (e.g., x-ms-version, x-ms-date, Content-Length) and an authorization header (e.g., Shared Key or SAS token).

Refer to the Azure Blob Storage REST API documentation for detailed information on request structure, headers, and response codes.