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-L48	Diagnosing and fixing Azure Blob Storage issues: Storage Mover errors/networking, support bundles, BlobFuse/BlobFuse2 mount & I/O problems, metrics/logging quirks, NFS 3.0, and SFTP limitations.
Best Practices	L49-L84	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	L85-L113	Cost and pricing guidance for Blob Storage: choosing tiers, connectivity, migration tools, data protection, reserved capacity, and estimating end-to-end and feature-specific costs.
Limits & Quotas	L114-L133	Limits, quotas, performance, and known issues for Blob Storage features (tiers, lifecycle, replication, NFS/SFTP, static sites, premium accounts, tools like BlobFuse and Storage Mover).
Security	L134-L194	Securing Blob Storage: RBAC/ABAC access control, SAS tokens, SFTP auth, ACLs, encryption (CSE, CPK, scopes), WORM/immutability, private networking, and anonymous access remediation.
Configuration	L195-L254	Configuring monitoring, lifecycle, immutability, networking, mounts (BlobFuse/NFS), inventory, restore/versioning, and third‑party backup/migration tools for Azure Blob Storage.
Integrations & Coding Patterns	L255-L380	SDK and CLI patterns for integrating with Blob and ADLS Gen2: connect, upload/download, copy, list, manage containers/blobs/leases/metadata/tags/tiers, events, SAS, mounts, and migration/inventory workflows.
Deployment	L381-L393	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
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 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
Detect and mitigate Azure Blob hot partitions	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-performance-mitigate-hot-partitions
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
Choose Azure private connectivity (ExpressRoute, VPN, SD-WAN)	https://learn.microsoft.com/en-us/azure/storage-mover/cloud-to-cloud-private-network-configuration
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 a method to relocate Azure Data Lake Storage across regions	https://learn.microsoft.com/en-us/azure/storage/blobs/data-lake-storage-migrate-data
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 Azure Blob inventory output behavior and limits	https://learn.microsoft.com/en-us/azure/storage/blobs/blob-inventory-faq
Understand BlobFuse limitations and known issues	https://learn.microsoft.com/en-us/azure/storage/blobs/blobfuse2-known-issues
Azure Blob lifecycle policy behaviors and constraints	https://learn.microsoft.com/en-us/azure/storage/blobs/lifecycle-management-policy-faq
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
Use premium page blob storage scalability targets	https://learn.microsoft.com/en-us/azure/storage/blobs/scalability-targets-premium-page-blobs
Static website hosting behaviors and constraints in Blob Storage	https://learn.microsoft.com/en-us/azure/storage/blobs/static-website-hosting-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 Azure Blob data	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 Azure portal access to Blob data securely	https://learn.microsoft.com/en-us/azure/storage/blobs/authorize-data-operations-portal
Authorize Azure Blob data operations with PowerShell	https://learn.microsoft.com/en-us/azure/storage/blobs/authorize-data-operations-powershell
Secure BlobFuse2 configuration files with encryption commands	https://learn.microsoft.com/en-us/azure/storage/blobs/blobfuse2-commands-secure
Decrypt BlobFuse2 configuration files using secure decrypt	https://learn.microsoft.com/en-us/azure/storage/blobs/blobfuse2-commands-secure-decrypt
Encrypt BlobFuse2 configuration files using secure encrypt	https://learn.microsoft.com/en-us/azure/storage/blobs/blobfuse2-commands-secure-encrypt
Read encrypted BlobFuse2 config parameters with secure get	https://learn.microsoft.com/en-us/azure/storage/blobs/blobfuse2-commands-secure-get
Modify encrypted BlobFuse2 config parameters with secure set	https://learn.microsoft.com/en-us/azure/storage/blobs/blobfuse2-commands-secure-set
Implement client-side encryption for Azure blobs in .NET	https://learn.microsoft.com/en-us/azure/storage/blobs/client-side-encryption
Configure POSIX-style ACLs for Azure Data Lake Storage	https://learn.microsoft.com/en-us/azure/storage/blobs/data-lake-storage-access-control
Configure access control for Azure Data Lake Storage	https://learn.microsoft.com/en-us/azure/storage/blobs/data-lake-storage-access-control-model
Configure Data Lake Storage ACLs in Azure portal	https://learn.microsoft.com/en-us/azure/storage/blobs/data-lake-storage-acl-azure-portal
Manage Data Lake Storage ACLs with Azure CLI	https://learn.microsoft.com/en-us/azure/storage/blobs/data-lake-storage-acl-cli
Use .NET to configure ACLs in Azure Data Lake Storage	https://learn.microsoft.com/en-us/azure/storage/blobs/data-lake-storage-acl-dotnet
Use Java to configure ACLs in Azure Data Lake Storage	https://learn.microsoft.com/en-us/azure/storage/blobs/data-lake-storage-acl-java
Use JavaScript to configure ACLs in Azure Data Lake Storage	https://learn.microsoft.com/en-us/azure/storage/blobs/data-lake-storage-acl-javascript
Manage Data Lake Storage ACLs with PowerShell	https://learn.microsoft.com/en-us/azure/storage/blobs/data-lake-storage-acl-powershell
Use Python to configure ACLs in Azure Data Lake Storage	https://learn.microsoft.com/en-us/azure/storage/blobs/data-lake-storage-acl-python
Manage Data Lake Storage ACLs with Storage Explorer	https://learn.microsoft.com/en-us/azure/storage/blobs/data-lake-storage-explorer-acl
Use customer-provided encryption keys with Blob Storage	https://learn.microsoft.com/en-us/azure/storage/blobs/encryption-customer-provided-keys
Create and assign encryption scopes in Blob Storage	https://learn.microsoft.com/en-us/azure/storage/blobs/encryption-scope-manage
Understand encryption scopes for Azure Blob Storage	https://learn.microsoft.com/en-us/azure/storage/blobs/encryption-scope-overview
Configure immutable WORM policies for Azure Blob storage	https://learn.microsoft.com/en-us/azure/storage/blobs/immutable-storage-overview
Secure object replication by blocking cross-tenant policies	https://learn.microsoft.com/en-us/azure/storage/blobs/object-replication-prevent-cross-tenant-policies
Create service SAS for containers and blobs in Java	https://learn.microsoft.com/en-us/azure/storage/blobs/sas-service-create-java
Create service SAS for blobs with JavaScript	https://learn.microsoft.com/en-us/azure/storage/blobs/sas-service-create-javascript
Create service SAS for Azure blobs using Python	https://learn.microsoft.com/en-us/azure/storage/blobs/sas-service-create-python
Apply security best practices to Azure Blob Storage	https://learn.microsoft.com/en-us/azure/storage/blobs/secure-blobs
Validate SFTP host keys for Azure Blob Storage	https://learn.microsoft.com/en-us/azure/storage/blobs/secure-file-transfer-protocol-host-keys
Authorize SFTP access to Azure Blob Storage	https://learn.microsoft.com/en-us/azure/storage/blobs/secure-file-transfer-protocol-support-authorize-access
Configure Entra ID-based SFTP access to Azure Blob Storage	https://learn.microsoft.com/en-us/azure/storage/blobs/secure-file-transfer-protocol-support-entra-id-based-access
Configure SFTP access for Azure Blob Storage accounts	https://learn.microsoft.com/en-us/azure/storage/blobs/secure-file-transfer-protocol-support-how-to
Apply security recommendations for Azure Blob Storage	https://learn.microsoft.com/en-us/azure/storage/blobs/security-recommendations
Use Azure ABAC role assignment conditions for Blob Storage	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-auth-abac
Actions and attributes for Blob Storage ABAC conditions	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-auth-abac-attributes
Configure Blob ABAC role conditions with Azure CLI	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-auth-abac-cli
Example Azure ABAC role conditions for Blob Storage	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-auth-abac-examples
Configure Blob ABAC role conditions in Azure portal	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-auth-abac-portal
Configure Blob ABAC role conditions with PowerShell	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-auth-abac-powershell
Security considerations for Blob Storage ABAC conditions	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-auth-abac-security
Create and use account SAS tokens with JavaScript	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-blob-account-delegation-sas-create-javascript
Create user delegation SAS tokens with JavaScript	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-blob-create-user-delegation-sas-javascript
Use customer-provided encryption keys with .NET blobs	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-blob-customer-provided-key
Check encryption status of Azure blobs via portal and CLI	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-blob-encryption-status
Create user delegation SAS for blobs with Azure CLI	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-blob-user-delegation-sas-create-cli
Create user delegation SAS for blobs with Java	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-blob-user-delegation-sas-create-java
Create user delegation SAS for blobs with PowerShell	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-blob-user-delegation-sas-create-powershell
Create user delegation SAS tokens with Python	https://learn.microsoft.com/en-us/azure/storage/blobs/storage-blob-user-delegation-sas-create-python