azure-blob-storage

name	azure-blob-storage
description	Expert knowledge for Azure Blob Storage development including troubleshooting, best practices, decision making, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using Blob tiers, Data Lake, NFS/SFTP/BlobFuse mounts, SAS/RBAC auth, or static website hosting, and other Azure Blob Storage related development tasks. Not for Azure Files (use azure-files), Azure Table Storage (use azure-table-storage), Azure Queue Storage (use azure-queue-storage).
compatibility	Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata	{"generated_at":"2026-07-12","generator":"docs2skills/1.0.0"}

Azure Blob Storage Skill

This skill provides expert guidance for Azure Blob Storage. Covers troubleshooting, best practices, decision making, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.

How to Use This Skill

IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g., L35-L120), use read_file with the specified lines. For categories with file links (e.g., [security.md](security.md)), use read_file on the linked reference file

IMPORTANT for Agent: If metadata.generated_at is more than 3 months old, suggest the user pull the latest version from the repository. If mcp_microsoftdocs tools are not available, suggest the user install it: Installation Guide

This skill requires network access to fetch documentation content:

• Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch with query string from=learn-agent-skill. Returns Markdown.
• Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

Category	Lines	Description
Troubleshooting	L36-L46	Diagnosing and fixing Azure Blob Storage issues: Storage Mover job/network errors, support bundles, BlobFuse/BlobFuse2 mount & I/O problems, and known NFS 3.0 limitations.
Best Practices	L47-L81	Performance, reliability, and cost best practices for Blob/Data Lake: access tiers, client tuning, concurrency, lifecycle, NFS/SFTP, retries, monitoring, events, and backup/migration guidance.
Decision Making	L82-L108	Cost planning and design choices for Blob Storage: tiers, archive retrieval, networking, reserved capacity, migration tools, data protection, and mapping operations to billing.
Limits & Quotas	L109-L127	Limits, quotas, performance, and known issues for Azure Blob Storage features (scalability, archive/rehydration, NFS/SFTP/BlobFuse, static websites, replication, and Storage Mover).
Security	L128-L186	Securing Blob Storage access: RBAC/ABAC, Entra auth, SAS tokens, SFTP, ACLs, private networking, Storage Mover, and encryption (CSE, scopes, keys, BlobFuse2).
Configuration	L187-L250	Configuring monitoring, lifecycle, immutability, restore, networking, and client tools (BlobFuse, Storage Mover), plus third‑party backup/migration integrations for Azure Blob Storage.
Integrations & Coding Patterns	L251-L377	SDK, CLI, and PowerShell patterns for connecting to Blob/Data Lake, managing containers/blobs (CRUD, leases, metadata, tiers, SAS), copying/migrating data, mounts (BlobFuse/NFS), and event-driven integrations.
Deployment	L378-L391	Guides for deploying static websites on Blob Storage, enabling Data Lake features, and migrating or integrating data from HDFS, Hadoop, NAS, and hybrid solutions into Azure Storage.

Troubleshooting

Topic	URL
Troubleshoot common Azure storage task issues	https://learn.microsoft.com/en-us/azure/storage-actions/storage-tasks/storage-task-troubleshooting
Troubleshoot Azure Storage Mover agent networking	https://learn.microsoft.com/en-us/azure/storage-mover/network-troubleshooting
Resolve Azure Storage Mover AZSM job error codes	https://learn.microsoft.com/en-us/azure/storage-mover/status-code
Generate and analyze Azure Storage Mover support bundles	https://learn.microsoft.com/en-us/azure/storage-mover/troubleshooting
Diagnose and resolve common BlobFuse2 issues	https://learn.microsoft.com/en-us/azure/storage/blobs/blobfuse2-faq
Troubleshoot common BlobFuse mount and I/O issues	https://learn.microsoft.com/en-us/azure/storage/blobs/blobfuse2-troubleshooting
Resolve known NFS 3.0 issues on Blob Storage	https://learn.microsoft.com/en-us/azure/storage/blobs/network-file-system-protocol-known-issues

Best Practices

Topic	URL
Apply best practices for Azure Storage Tasks	https://learn.microsoft.com/en-us/azure/storage-actions/storage-tasks/storage-task-best-practices
Apply deployment best practices for Azure Storage Discovery	https://learn.microsoft.com/en-us/azure/storage-discovery/deployment-planning
Model Azure Storage Mover resources for migrations	https://learn.microsoft.com/en-us/azure/storage-mover/resource-hierarchy
Best practices for choosing and managing blob access tiers	https://learn.microsoft.com/en-us/azure/storage/blobs/access-tiers-best-practices
Blob inventory performance tuning and best practices	https://learn.microsoft.com/en-us/azure/storage/blobs/blob-inventory-performance-characteristics
Best practices for monitoring Azure Blob Storage workloads	https://learn.microsoft.com/en-us/azure/storage/blobs/blob-storage-monitoring-scenarios
Manage concurrency for Azure Blob Storage writes	https://learn.microsoft.com/en-us/azure/storage/blobs/concurrency-manage
Apply performance and cost best practices for Azure Data Lake Storage	https://learn.microsoft.com/en-us/azure/storage/blobs/data-lake-storage-best-practices
Avoid pitfalls using Azure Data Lake Storage HNS	https://learn.microsoft.com/en-us/azure/storage/blobs/data-lake-storage-known-issues
Optimize Azure Blob lifecycle management performance	https://learn.microsoft.com/en-us/azure/storage/blobs/lifecycle-management-performance-characteristics
Run NFS 3.0 performance benchmarks on Blob	https://learn.microsoft.com/en-us/azure/storage/blobs/network-file-system-protocol-performance-benchmark
Optimize NFS 3.0 performance on Azure Blob	https://learn.microsoft.com/en-us/azure/storage/blobs/network-file-system-protocol-support-performance
Optimize SFTP performance with Azure Blob Storage	https://learn.microsoft.com/en-us/azure/storage/blobs/secure-file-transfer-protocol-performance
Best practices for managing Blob Storage client instances	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-blob-client-management
Delete and restore blob containers using .NET with soft delete	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-blob-container-delete
React to Blob Storage events with Event Grid	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-blob-event-overview
Design low-latency applications with Azure Blob Storage	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-blobs-latency
Tune Azure Blob .NET uploads and downloads	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-blobs-tune-upload-download
Tune Azure Storage Go client uploads and downloads	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-blobs-tune-upload-download-go
Tune Java Azure Blob upload and download performance	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-blobs-tune-upload-download-java
Tune Azure Blob JS client upload and download performance	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-blobs-tune-upload-download-javascript
Tune Azure blob upload and download performance in Python	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-blobs-tune-upload-download-python
Optimize Azure Blob partitions with naming strategies	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-performance-blob-partitions
Performance optimization checklist for Azure Blob Storage	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-performance-checklist
Apply Blob Storage performance checklist for custom apps	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-performance-checklist-developers
Configure retry policies for Blob Storage in .NET	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-retry-policy
Implement resilient retry policies for Blob Storage in Go	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-retry-policy-go
Configure retry policies for Blob Storage in Java	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-retry-policy-java
Configure retry policies for Azure Blob Storage in JavaScript	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-retry-policy-javascript
Configure retry policies for Azure Blob Storage in Python	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-retry-policy-python
Apply Veeam best practices with Azure Blob backups	https://learn.microsoft.com/en-us/azure/storage/solution-integration/validated-partners/backup-archive-disaster-recovery/veeam/veeam-solution-guide

Decision Making

Topic	URL
Plan and manage Azure Storage Actions cost drivers	https://learn.microsoft.com/en-us/azure/storage-actions/storage-actions-plan-manage-costs
Choose Azure Storage Discovery pricing plans and features	https://learn.microsoft.com/en-us/azure/storage-discovery/pricing
Estimate and understand Azure Storage Mover migration costs	https://learn.microsoft.com/en-us/azure/storage-mover/billing
Plan Azure Storage Mover deployments and migrations	https://learn.microsoft.com/en-us/azure/storage-mover/deployment-planning
Choose Azure Blob Storage access tiers by usage	https://learn.microsoft.com/en-us/azure/storage/blobs/access-tiers-overview
Choose Azure Blob smart tier access transitions	https://learn.microsoft.com/en-us/azure/storage/blobs/access-tiers-smart
Calculate archive tier storage and retrieval costs	https://learn.microsoft.com/en-us/azure/storage/blobs/archive-cost-estimation
Estimate AzCopy data transfer costs for Blob Storage	https://learn.microsoft.com/en-us/azure/storage/blobs/azcopy-cost-estimation
Choose Azure Blob cost optimization capabilities	https://learn.microsoft.com/en-us/azure/storage/blobs/blob-cost-optimization-services
Estimate end-to-end costs for Azure Blob Storage usage	https://learn.microsoft.com/en-us/azure/storage/blobs/blob-storage-estimate-costs
Compare BlobFuse behavior to native Linux file systems	https://learn.microsoft.com/en-us/azure/storage/blobs/blobfuse2-compare-linux-file-system
Choose between BlobFuse streaming and caching modes	https://learn.microsoft.com/en-us/azure/storage/blobs/blobfuse2-streaming-versus-caching
Estimate costs to retrieve and analyze archived blobs	https://learn.microsoft.com/en-us/azure/storage/blobs/cost-estimate-archive-retrieval-copy-blob
Estimate costs to move data from archive to hot tier	https://learn.microsoft.com/en-us/azure/storage/blobs/cost-estimate-archive-retrieval-set-tier
Estimate multi-region data access costs for Blob Storage	https://learn.microsoft.com/en-us/azure/storage/blobs/cost-estimate-multi-region-access
Choose Azure Blob data protection and recovery options	https://learn.microsoft.com/en-us/azure/storage/blobs/data-protection-overview
Map Blob Storage REST operations to billing categories	https://learn.microsoft.com/en-us/azure/storage/blobs/map-rest-apis-transaction-categories
Choose between Blob soft delete and versioning	https://learn.microsoft.com/en-us/azure/storage/blobs/soft-delete-vs-versioning-options
Decide when to use premium block blob storage	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-blob-block-blob-premium
Plan and purchase Blob Storage reserved capacity	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-blob-reserved-capacity
Plan upgrade from Blob Storage to Data Lake Storage	https://learn.microsoft.com/en-us/azure/storage/blobs/upgrade-to-data-lake-storage-gen2
Choose Azure unstructured data migration tools	https://learn.microsoft.com/en-us/azure/storage/solution-integration/validated-partners/data-management/migration-tools-comparison
Choose ISV file services options in Azure	https://learn.microsoft.com/en-us/azure/storage/solution-integration/validated-partners/primary-secondary-storage/isv-file-services

Limits & Quotas

Topic	URL
Understand Azure Storage Tasks limits and issues	https://learn.microsoft.com/en-us/azure/storage-actions/storage-tasks/storage-task-known-issues
Review Azure Storage Discovery FAQs and service limits	https://learn.microsoft.com/en-us/azure/storage-discovery/frequently-asked-questions
Understand Azure Storage Mover scale and performance	https://learn.microsoft.com/en-us/azure/storage-mover/performance-targets
Review Azure Storage Mover release changes and limitations	https://learn.microsoft.com/en-us/azure/storage-mover/release-notes
Manage Azure Blob archive tier retention and access	https://learn.microsoft.com/en-us/azure/storage/blobs/archive-blob
Blob archive rehydration time and priority limits	https://learn.microsoft.com/en-us/azure/storage/blobs/archive-rehydrate-to-online-tier
Understand BlobFuse limitations and known issues	https://learn.microsoft.com/en-us/azure/storage/blobs/blobfuse2-known-issues
Protocol limits for NFS 3.0 on Azure Blob	https://learn.microsoft.com/en-us/azure/storage/blobs/network-file-system-protocol-support
Object replication priority replication latency guarantees	https://learn.microsoft.com/en-us/azure/storage/blobs/object-replication-priority-replication
Understand Azure Blob Storage scalability limits	https://learn.microsoft.com/en-us/azure/storage/blobs/scalability-targets
Scalability limits for premium block blob storage accounts	https://learn.microsoft.com/en-us/azure/storage/blobs/scalability-targets-premium-block-blobs
Use premium page blob storage scalability targets	https://learn.microsoft.com/en-us/azure/storage/blobs/scalability-targets-premium-page-blobs
Limitations and known issues for SFTP on Azure Blob Storage	https://learn.microsoft.com/en-us/azure/storage/blobs/secure-file-transfer-protocol-known-issues
Azure Blob Storage FAQs on limits and behavior	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-blob-faq
Static website hosting limits in Azure Blob Storage	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-blob-static-website

Security

Topic	URL
Use Azure RBAC roles for Storage Tasks access	https://learn.microsoft.com/en-us/azure/storage-actions/storage-tasks/storage-task-authorization-roles
Assign Storage Tasks with correct Azure roles	https://learn.microsoft.com/en-us/azure/storage-actions/storage-tasks/storage-task-authorization-roles-assign
Securely register Azure Storage Mover agents	https://learn.microsoft.com/en-us/azure/storage-mover/agent-register
Configure private networking for Azure Storage Mover migrations	https://learn.microsoft.com/en-us/azure/storage-mover/migrations-requiring-private-connections
Configure anonymous read access for Blob containers	https://learn.microsoft.com/en-us/azure/storage/blobs/anonymous-read-access-configure
Remediate anonymous read access to Azure Blob data	https://learn.microsoft.com/en-us/azure/storage/blobs/anonymous-read-access-overview
Prevent anonymous read access for ARM-based Blob accounts	https://learn.microsoft.com/en-us/azure/storage/blobs/anonymous-read-access-prevent