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, static websites, or SDK/CLI data operations, and other Azure Blob Storage related development tasks. Not for Azure Files (use azure-files), Azure Queue Storage (use azure-queue-storage), Azure Table Storage (use azure-table-storage), Azure NetApp Files (use azure-netapp-files).
compatibility	Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata	{"generated_at":"2026-08-09","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-L82	Performance, reliability, and cost-optimization guidance for Azure Blob/Data Lake: access tiers, lifecycle, hot partitions, NFS/SFTP, client tuning, retries, monitoring, and backup best practices.
Decision Making	L83-L109	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	L110-L128	Limits, quotas, and performance/scalability behavior for Blob Storage features (archive, NFS, SFTP, static sites, replication, premium tiers), including known issues and latency guarantees.
Security	L129-L187	Securing Blob Storage access: RBAC/ABAC, Entra auth, SAS tokens, SFTP, ACLs, Storage Mover, anonymous access remediation, and encryption (CSE, keys, scopes, BlobFuse2).
Configuration	L188-L249	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	L250-L376	SDK, CLI, and tooling patterns for integrating with Blob Storage/ADLS: mounting, uploads/downloads, copy/delete/restore, leases, metadata, access tiers, tags, SAS, events, and language-specific code samples.
Deployment	L377-L390	Guides for deploying static websites on Blob Storage, enabling Data Lake features, and migrating data from on-prem, AWS, and third‑party NAS 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

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

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
Azure Blob Storage scalability and performance 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

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
Disable and remediate anonymous Azure Blob access	https://learn.microsoft.com/en-us/azure/storage/blobs/anonymous-read-access-prevent
Assign Azure RBAC roles for Blob data access	https://learn.microsoft.com/en-us/azure/storage/blobs/assign-azure-role-data-access
Authorize Azure Blob access with Microsoft Entra ID	https://learn.microsoft.com/en-us/azure/storage/blobs/authorize-access-azure-active-directory
Authorize Azure Blob data operations with Azure CLI	https://learn.microsoft.com/en-us/azure/storage/blobs/authorize-data-operations-cli
Authorize Blob data access in Azure portal using Entra or keys

Configuration

Topic	URL
Configure monitoring for Azure Storage Actions with Azure Monitor	https://learn.microsoft.com/en-us/azure/storage-actions/storage-tasks/monitor-storage-tasks
Configure Azure Storage Task assignments and scope	https://learn.microsoft.com/en-us/azure/storage-actions/storage-tasks/storage-task-assignment
Configure JSON conditions for Azure storage tasks	https://learn.microsoft.com/en-us/azure/storage-actions/storage-tasks/storage-task-conditions
Define JSON operations for Azure storage tasks	https://learn.microsoft.com/en-us/azure/storage-actions/storage-tasks/storage-task-operations
Reference monitoring data for Azure Storage Actions	https://learn.microsoft.com/en-us/azure/storage-actions/storage-tasks/storage-tasks-monitor-data-reference
Configure Azure Storage Discovery workspace scopes and reporting	https://learn.microsoft.com/en-us/azure/storage-discovery/create-workspace
Deploy a Storage Discovery workspace using Bicep	https://learn.microsoft.com/en-us/azure/storage-discovery/create-workspace-bicep
Deploy and configure Azure Storage Mover agents	https://learn.microsoft.com/en-us/azure/storage-mover/agent-deploy
Deploy and configure Azure Storage Mover agents	https://learn.microsoft.com/en-us/azure/storage-mover/agent-deploy
Configure bandwidth schedules for Storage Mover agents	https://learn.microsoft.com/en-us/azure/storage-mover/bandwidth-management
Configure and use Azure Storage Mover copy logs

Integrations & Coding Patterns

Topic	URL
Configure S3 to Azure Blob cloud-to-cloud migration	https://learn.microsoft.com/en-us/azure/storage-mover/cloud-to-cloud-migration
Trigger Azure Functions from blob rehydration events via Event Grid	https://learn.microsoft.com/en-us/azure/storage/blobs/archive-rehydrate-handle-event
Manage Azure block blobs with Azure CLI	https://learn.microsoft.com/en-us/azure/storage/blobs/blob-cli
Manage Azure Blob containers with Azure CLI	https://learn.microsoft.com/en-us/azure/storage/blobs/blob-containers-cli
Manage Azure Blob containers using PowerShell commands	https://learn.microsoft.com/en-us/azure/storage/blobs/blob-containers-powershell
Manage Azure block blobs using PowerShell	https://learn.microsoft.com/en-us/azure/storage/blobs/blob-powershell
Generate BlobFuse2 autocompletion scripts with completion command	https://learn.microsoft.com/en-us/azure/storage/blobs/blobfuse2-commands-completion
Create bash autocompletion for BlobFuse2	https://learn.microsoft.com/en-us/azure/storage/blobs/blobfuse2-commands-completion-bash
Create fish autocompletion for BlobFuse2	https://learn.microsoft.com/en-us/azure/storage/blobs/blobfuse2-commands-completion-fish
Create PowerShell autocompletion for BlobFuse2	https://learn.microsoft.com/en-us/azure/storage/blobs/blobfuse2-commands-completion-powershell
Create zsh autocompletion for BlobFuse2	https://learn.microsoft.com/en-us/azure/storage/blobs/blobfuse2-commands-completion-zsh

Deployment

Topic	URL
Move Storage Discovery workspaces across Azure scopes	https://learn.microsoft.com/en-us/azure/storage-discovery/resource-move
Migrate on-premises HDFS data to Azure Storage using Data Box	https://learn.microsoft.com/en-us/azure/storage/blobs/data-lake-storage-migrate-on-premises-hdfs-cluster
Migrate Hadoop data to Azure Data Lake Storage with WANdisco LiveData	https://learn.microsoft.com/en-us/azure/storage/blobs/migrate-gen2-wandisco-live-data-platform
Configure and deploy a static website on Blob Storage	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-blob-static-website-host
Deploy static websites to Azure Storage using GitHub Actions	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-blobs-static-site-github-actions
Assess Blob feature support by storage account type	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-feature-support-in-storage-accounts
Deploy static website on Azure Storage with Terraform	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-quickstart-static-website-terraform
Enable Data Lake capabilities on existing Blob accounts	https://learn.microsoft.com/en-us/azure/storage/blobs/upgrade-to-data-lake-storage-gen2-how-to
Deploy and operate NetApp Data Migrator to Azure NetApp Files	https://learn.microsoft.com/en-us/azure/storage/solution-integration/validated-partners/data-management/netapp-data-migrator-guide
Deploy and configure Nasuni with Azure Blob Storage	https://learn.microsoft.com/en-us/azure/storage/solution-integration/validated-partners/primary-secondary-storage/nasuni-deployment-guide