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 Data Lake features, NFS/SFTP/BlobFuse, static website hosting, SAS/RBAC auth, or SDK-based blob operations, 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), 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-04-19","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-L45	Diagnosing and fixing Azure Blob Storage issues: Storage Mover networking/job errors, support bundles, BlobFuse mount/I/O problems, and known NFS 3.0 behavior and error scenarios.
Best Practices	L46-L79	Performance, cost, resiliency, and monitoring best practices for Blob Storage: access tiers, lifecycle, concurrency, client tuning, retries, NFS/SFTP, events, backups, and language-specific optimizations
Decision Making	L80-L105	Cost and architecture decisions for Blob Storage: pricing, cost estimation/optimization, tiers, protocols (NFS/SFTP/BlobFuse), data protection, connectivity, and migration/upgrade tool choices.
Limits & Quotas	L106-L126	Blob Storage limits, quotas, performance and scale caps, protocol-specific constraints (NFS, SFTP, BlobFuse, ADLS), archive rules, replication SLAs, and cost/tier optimization rules.
Security	L127-L184	Configuring secure access to Blob Storage: RBAC/ABAC, Entra ID auth, SAS tokens, SFTP, ACLs, encryption (CSE, CPK, scopes), private networking, and preventing anonymous access.
Configuration	L185-L251	Configuring and operating Blob Storage: monitoring, lifecycle, immutability, soft delete, snapshots/restore, NFS/SFTP/BlobFuse, Data Lake, static sites, and third‑party backup/migration tools.
Integrations & Coding Patterns	L252-L387	SDK, CLI, and tooling patterns for integrating with Blob/Data Lake: connect from various languages, mount/file-system access, copy/migrate data, manage containers/blobs, leases, tiers, tags, and events.
Deployment	L388-L401	Guides for deploying and configuring Blob Storage: static website hosting (CDN, GitHub Actions, Terraform), feature support, Data Lake enablement, and hybrid/migration tools (Data Box, WANdisco, 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
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
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 Azure Storage task best-practice guidelines	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, cost, and security best practices for Azure Data Lake Storage	https://learn.microsoft.com/en-us/azure/storage/blobs/data-lake-storage-best-practices
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

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
Choose Azure private connectivity for Storage Mover	https://learn.microsoft.com/en-us/azure/storage-mover/cloud-to-cloud-private-network-configs
Plan Azure Storage Mover deployments and migrations	https://learn.microsoft.com/en-us/azure/storage-mover/deployment-planning
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
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

Limits & Quotas

Topic	URL
Review known issues and limits for Azure storage tasks	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
Optimize Blob Storage costs with smart tier thresholds	https://learn.microsoft.com/en-us/azure/storage/blobs/access-tiers-smart
Archive tier usage rules and minimum retention period	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
Understand limitations and known issues for Azure Data Lake Storage	https://learn.microsoft.com/en-us/azure/storage/blobs/data-lake-storage-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

Security

Topic	URL
Assign Azure RBAC roles for storage tasks	https://learn.microsoft.com/en-us/azure/storage-actions/storage-tasks/storage-task-authorization-roles
Configure roles to assign and run storage tasks	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
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 using 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 schedules	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
Manage Azure Storage Mover source and target endpoints

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
Integrate Azure Storage with Azure CDN for blob delivery	https://learn.microsoft.com/en-us/azure/cdn/cdn-create-a-storage-account-with-cdn
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
Check Azure Blob Storage feature support by 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 configure Nasuni with Azure Blob Storage	https://learn.microsoft.com/en-us/azure/storage/solution-integration/validated-partners/primary-secondary-storage/nasuni-deployment-guide