/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 planning tiers/costs, lifecycle/versioning, SAS/RBAC auth, NFS/SFTP access, or SDK/BlobFuse integrations, 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-11-08"
  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](https://github.com/MicrosoftDocs/mcp/blob/main/README.md)

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-L49 | Diagnosing and fixing Azure Blob Storage issues: Storage Mover networking/jobs, support bundles, BlobFuse/BlobFuse2 mount & I/O errors, metrics/logging quirks, NFS 3.0 problems, and SFTP limitations. | | Best Practices | L50-L85 | Performance, cost, and reliability best practices for Azure Blob/Data Lake: access tiers, lifecycle, partitioning, concurrency, client tuning, retries, monitoring, NFS/SFTP, events, and backups. | | Decision Making | L86-L115 | Cost planning and design choices for Blob Storage: pricing, tiers, archive vs hot, private connectivity, migration tools, SFTP, reserved capacity, and cost-optimized access patterns. | | Limits & Quotas | L116-L134 | Limits, quotas, and performance behaviors for Blob Storage features: scalability targets, archive/rehydration, lifecycle policies, NFS, static websites, replication, BlobFuse, and Storage Mover. | | Security | L135-L196 | Securing Blob Storage: RBAC/ABAC and Entra ID auth, SAS tokens, SFTP, private networking, ACLs, encryption (CSE, CPK, scopes), WORM, and hardening/remediating anonymous or cross-tenant access. | | Configuration | L197-L255 | Configuring and monitoring Blob Storage and related tools: storage tasks, discovery, Storage Mover, BlobFuse, lifecycle/immutability, versioning, restore, NFS, and third‑party backup/migration integrations. | | Integrations & Coding Patterns | L256-L381 | SDK, CLI, and tooling patterns for integrating with Blob Storage/ADLS Gen2: connect, upload/download, copy, delete/restore, leases, metadata, access tiers, SAS, events, mounts, and S3/HDFS migrations. | | Deployment | L382-L395 | Guides for deploying and migrating data and static sites with Blob Storage: Storage Discovery setup, HDFS/Hadoop migrations, static website deployment (GitHub/Terraform), and partner tools (NetApp, Nasuni, Tiger Bridge). |

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 | | Diagnose issues using Azure Storage Mover release notes | https://learn.microsoft.com/en-us/azure/storage-mover/release-notes | | Diagnose Azure Storage Mover job run 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 | | Troubleshoot Blob Storage metrics and logging behavior | https://learn.microsoft.com/en-us/azure/storage/blobs/monitor-blob-storage-faq | | Resolve known NFS 3.0 issues on Blob Storage | https://learn.microsoft.com/en-us/azure/storage/blobs/network-file-system-protocol-known-issues | | Diagnose SFTP limitations and issues in Azure Blob Storage | https://learn.microsoft.com/en-us/azure/storage/blobs/secure-file-transfer-protocol-known-issues |

Best Practices

| Topic | URL | |-------|-----| | Apply Azure Storage task best practices | https://learn.microsoft.com/en-us/azure/storage-actions/storage-tasks/storage-task-best-practices | | Analyze Azure Blob capacity details with advanced insights | https://learn.microsoft.com/en-us/azure/storage-discovery/analyze-blob-capacity-details | | 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.micr