Aspire.Hosting.Azure.Storage 9.3.1
Aspire.Hosting.Azure.Storage library
Provides extension methods and resource definitions for a .NET Aspire AppHost to configure Azure Storage.
Getting started
Prerequisites
- Azure subscription - create one for free
Install the package
Install the .NET Aspire Azure Storage Hosting library with NuGet:
dotnet add package Aspire.Hosting.Azure.Storage
Configure Azure Provisioning for local development
Adding Azure resources to the .NET Aspire application model will automatically enable development-time provisioning for Azure resources so that you don't need to configure them manually. Provisioning requires a number of settings to be available via .NET configuration. Set these values in user secrets in order to allow resources to be configured automatically.
{
"Azure": {
"SubscriptionId": "<your subscription id>",
"ResourceGroupPrefix": "<prefix for the resource group>",
"Location": "<azure location>"
}
}
NOTE: Developers must have Owner access to the target subscription so that role assignments can be configured for the provisioned resources.
Usage example
In the AppHost.cs file of AppHost, add a Blob (can use tables or queues also) Storage connection and consume the connection using the following methods:
var blobs = builder.AddAzureStorage("storage").AddBlobs("blobs");
var myService = builder.AddProject<Projects.MyService>()
.WithReference(blobs);
The WithReference method passes that connection information into a connection string named blobs in the MyService project. In the Program.cs file of MyService, the connection can be consumed using the client library Aspire.Azure.Storage.Blobs:
builder.AddAzureBlobClient("blobs");
Additional documentation
- https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/storage/Azure.Storage.Blobs/README.md
- https://github.com/dotnet/aspire/tree/main/src/Components/README.md
Feedback & contributing
No packages depend on Aspire.Hosting.Azure.Storage.
.NET 8.0
- Aspire.Hosting.Azure (>= 9.3.1)
- Microsoft.Extensions.Configuration.Binder (>= 8.0.2)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.2)
- Microsoft.Extensions.Diagnostics.HealthChecks (>= 8.0.15)
- Microsoft.Extensions.Hosting (>= 8.0.1)
- Microsoft.Extensions.Hosting.Abstractions (>= 8.0.1)
- Microsoft.Extensions.Http (>= 8.0.1)
- Microsoft.Extensions.Configuration.Abstractions (>= 8.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.3)
- Microsoft.Extensions.Primitives (>= 8.0.0)
- Newtonsoft.Json (>= 13.0.3)
- Polly.Core (>= 8.5.2)
- StreamJsonRpc (>= 2.21.69)
- System.IO.Hashing (>= 9.0.4)
- System.Text.Json (>= 8.0.5)
- Microsoft.Extensions.Options (>= 8.0.2)
- KubernetesClient (>= 16.0.7)
- JsonPatch.Net (>= 3.3.0)
- Azure.ResourceManager.Authorization (>= 1.1.4)
- Azure.Provisioning.Storage (>= 1.0.0)
- AspNetCore.HealthChecks.Uris (>= 9.0.0)
- Azure.Core (>= 1.46.0)
- Azure.Identity (>= 1.13.2)
- Azure.Provisioning.KeyVault (>= 1.0.0)
- Humanizer.Core (>= 2.14.1)
- Azure.Provisioning (>= 1.0.0)
- Azure.ResourceManager.KeyVault (>= 1.3.2)
- Azure.Security.KeyVault.Secrets (>= 4.7.0)
- Azure.Storage.Blobs (>= 12.24.0)
- Google.Protobuf (>= 3.30.2)
- Grpc.AspNetCore (>= 2.71.0)
- Grpc.Net.ClientFactory (>= 2.71.0)
- Grpc.Tools (>= 2.72.0)
- Azure.ResourceManager.Resources (>= 1.9.1)
- AspNetCore.HealthChecks.Azure.Storage.Blobs (>= 9.0.0)
| Version | Downloads | Last updated |
|---|---|---|
| 9.3.1 | 1 | 6/13/2025 |
| 9.3.0 | 0 | 5/19/2025 |
| 9.2.1 | 0 | 4/24/2025 |
| 9.2.0 | 0 | 4/10/2025 |
| 9.1.0 | 1 | 6/8/2025 |
| 9.0.0 | 1 | 6/8/2025 |
| 9.0.0-rc.1.24511.1 | 1 | 6/7/2025 |
| 8.2.2 | 0 | 10/24/2024 |
| 8.2.1 | 0 | 9/26/2024 |
| 8.2.0 | 1 | 6/9/2025 |
| 8.1.0 | 1 | 6/7/2025 |
| 8.0.2 | 1 | 6/8/2025 |
| 8.0.1 | 1 | 6/8/2025 |
| 8.0.0 | 1 | 6/8/2025 |
| 8.0.0-preview.7.24251.11 | 0 | 5/7/2024 |
| 8.0.0-preview.6.24214.1 | 1 | 6/9/2025 |
| 8.0.0-preview.5.24201.12 | 0 | 4/9/2024 |