Aspire.Hosting.Azure.Storage
8.2.1
Prefix Reserved
This version is out of support and is no longer maintained. Please upgrade to the latest version. See our support policy for details: https://aka.ms/dotent/aspire/support
See the version list below for details.
dotnet add package Aspire.Hosting.Azure.Storage --version 8.2.1
NuGet\Install-Package Aspire.Hosting.Azure.Storage -Version 8.2.1
<PackageReference Include="Aspire.Hosting.Azure.Storage" Version="8.2.1" />
<PackageVersion Include="Aspire.Hosting.Azure.Storage" Version="8.2.1" />
<PackageReference Include="Aspire.Hosting.Azure.Storage" />
paket add Aspire.Hosting.Azure.Storage --version 8.2.1
#r "nuget: Aspire.Hosting.Azure.Storage, 8.2.1"
#:package Aspire.Hosting.Azure.Storage@8.2.1
#addin nuget:?package=Aspire.Hosting.Azure.Storage&version=8.2.1
#tool nuget:?package=Aspire.Hosting.Azure.Storage&version=8.2.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 Program.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
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net8.0
- Aspire.Hosting.Azure (>= 8.2.1)
- Azure.Core (>= 1.42.0)
- Azure.Identity (>= 1.12.0)
- Azure.Provisioning (>= 0.3.0)
- Azure.Provisioning.KeyVault (>= 0.2.0)
- Azure.Provisioning.Resources (>= 0.2.0)
- Azure.Provisioning.Storage (>= 0.2.0)
- Azure.Security.KeyVault.Secrets (>= 4.6.0)
- Google.Protobuf (>= 3.28.0)
- Grpc.AspNetCore (>= 2.65.0)
- Grpc.Net.ClientFactory (>= 2.65.0)
- Grpc.Tools (>= 2.66.0)
- KubernetesClient (>= 14.0.9)
- Microsoft.Extensions.Configuration.Abstractions (>= 8.0.0)
- Microsoft.Extensions.Configuration.Binder (>= 8.0.2)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.1)
- Microsoft.Extensions.Hosting (>= 8.0.0)
- Microsoft.Extensions.Hosting.Abstractions (>= 8.0.0)
- Microsoft.Extensions.Http (>= 8.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.1)
- Microsoft.Extensions.Options (>= 8.0.2)
- Microsoft.Extensions.Primitives (>= 8.0.0)
- Polly.Core (>= 8.4.1)
- System.IO.Hashing (>= 8.0.0)
- System.Text.Json (>= 8.0.4)
NuGet packages (3)
Showing the top 3 NuGet packages that depend on Aspire.Hosting.Azure.Storage:
Package | Downloads |
---|---|
Aspire.Hosting.Azure.Functions
Azure Functions resource types for .NET Aspire. |
|
Aspire.Hosting.Azure.EventHubs
Azure Event Hubs resource types for .NET Aspire. |
|
EAVFramework.Extensions.Aspire.Hosting
Aspire Hosting package for EAVFramework |
GitHub repositories (9)
Showing the top 9 popular GitHub repositories that depend on Aspire.Hosting.Azure.Storage:
Repository | Stars |
---|---|
bitfoundation/bitplatform
Build all of your apps using what you already know and love ❤️
|
|
dotnet/aspire-samples
|
|
erwinkramer/bank-api
The Bank API is a design reference project suitable to bootstrap development for a compliant and modern API.
|
|
microsoft/AzUrlShortener
An simple and easy Url Shortener
|
|
petabridge/akkadotnet-code-samples
Akka.NET professional reference code samples
|
|
CommunityToolkit/Aspire
A community project with additional components and extensions for .NET Aspire
|
|
foxminchan/BookWorm
The practical implementation of .NET Aspire using Microservices
|
|
J-Tech-Japan/Sekiban
Sekiban - an Opinionated Event Sourcing and CQRS Framework using C#. It can store data into Azure Cosmos DB, AWS Dynamo DB or Postgres
|
|
marinasundstrom/YourBrand
Prototype enterprise system for e-commerce and consulting services
|
Version | Downloads | Last Updated | |
---|---|---|---|
9.4.2 | 32,913 | 9/2/2025 | |
9.4.1 | 54,769 | 8/12/2025 | |
9.4.0 | 36,662 | 7/29/2025 | |
9.3.1 | 139,867 | 6/10/2025 | |
9.3.0 | 78,284 | 5/19/2025 | |
9.2.1 | 69,424 | 4/24/2025 | |
9.2.0 | 60,067 | 4/10/2025 | |
9.1.0 | 143,788 | 2/25/2025 | |
9.0.0 | 224,336 | 11/12/2024 | |
9.0.0-rc.1.24511.1 | 6,210 | 10/15/2024 | |
8.2.2 | 24,896 | 10/24/2024 | |
8.2.1 | 20,488 | 9/26/2024 | |
8.2.0 | 35,804 | 8/29/2024 | |
8.1.0 | 14,212 | 7/23/2024 | |
8.0.2 | 9,886 | 6/28/2024 | |
8.0.1 | 17,004 | 5/21/2024 | |
8.0.0 | 1,999 | 5/21/2024 | |
8.0.0-preview.7.24251.11 | 2,001 | 5/7/2024 | |
8.0.0-preview.6.24214.1 | 4,760 | 4/23/2024 | |
8.0.0-preview.5.24201.12 | 4,245 | 4/9/2024 |