Azure Blob Storage

Azure Blob Storage API Skill

Quick Start

Azure Blob Storage handles massive amounts of unstructured data. The @azure/storage-blob SDK provides powerful abstractions for Block, Append, and Page blobs.

npm install @azure/storage-blob

Common Workflows

SAS (Shared Access Signature) Tokens

Generate a User Delegation SAS Token to grant temporary, tightly-scoped access to a specific blob without exposing the account key.

Production Patterns

Block Blobs vs Append Blobs

Use Block Blobs for standard files (images, documents). Use Append Blobs explicitly for log files where data is continuously written to the end of the blob.

Error Recovery

The SDK automatically handles transient failures using built-in retry policies (exponential backoff). Catch RestError to handle fatal authorization or missing resource failures.

Security Notes

Prioritize Azure AD (Entra ID) authentication via DefaultAzureCredential over using connection strings containing the Account Key.

Performance Considerations

For high-throughput uploads, tune the maxSingleShotSize and blockSize parameters in the uploadFile method to parallelize chunk uploads efficiently across multiple threads.

Testing Guidance

Use Azurite, the official local emulator for Azure Storage, to run integration tests entirely locally without an Azure subscription.

Troubleshooting

If CORS errors occur when using SAS URLs in the browser, ensure CORS rules are explicitly defined on the Storage Account setting AllowedOrigins and AllowedMethods (PUT).

References

• Azure Blob SDK

Related Skills

• [AWS S3](/skills/aws s3)
• [Google Cloud Storage](/skills/google cloud storage)

Why use this skill

Use this when your agent works with azure-blob-storage — structured patterns beat pasted docs and prevent common hallucinations.

AI pitfalls

• Using outdated SDK or API versions from training data
• Inventing environment variable names
• Omitting error handling and retry logic

Production checklist

• [ ] Secrets in environment variables, not source code
• [ ] Error handling and logging in place
• [ ] Rate limits and timeouts configured

Related skills

• [aws s3](../aws s3/SKILL.md) — related to
• [google cloud storage](../google cloud storage/SKILL.md) — related to

---

> Last Verified: 2026-07-02

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: ashish7802
• Source: ashish7802/awesome-api-skills
• License: MIT

Install and usage instructions live in the source repository linked above.