Aspire.Hosting.Azure.Provisioning.PrivateDns
13.6.1-preview.1.26506.6
Prefix Reserved
dotnet add package Aspire.Hosting.Azure.Provisioning.PrivateDns --version 13.6.1-preview.1.26506.6
NuGet\Install-Package Aspire.Hosting.Azure.Provisioning.PrivateDns -Version 13.6.1-preview.1.26506.6
<PackageReference Include="Aspire.Hosting.Azure.Provisioning.PrivateDns" Version="13.6.1-preview.1.26506.6" />
<PackageVersion Include="Aspire.Hosting.Azure.Provisioning.PrivateDns" Version="13.6.1-preview.1.26506.6" />
<PackageReference Include="Aspire.Hosting.Azure.Provisioning.PrivateDns" />
paket add Aspire.Hosting.Azure.Provisioning.PrivateDns --version 13.6.1-preview.1.26506.6
#r "nuget: Aspire.Hosting.Azure.Provisioning.PrivateDns, 13.6.1-preview.1.26506.6"
#:package Aspire.Hosting.Azure.Provisioning.PrivateDns@13.6.1-preview.1.26506.6
#addin nuget:?package=Aspire.Hosting.Azure.Provisioning.PrivateDns&version=13.6.1-preview.1.26506.6&prerelease
#tool nuget:?package=Aspire.Hosting.Azure.Provisioning.PrivateDns&version=13.6.1-preview.1.26506.6&prerelease
Azure Provisioning Private DNS hosting integration
This package is experimental and emits ASPIREAZUREPROVISIONING001.
Use this integration to customize Azure Private DNS infrastructure from a polyglot Aspire AppHost. It references Aspire.Hosting.Azure.Network; the PrivateDns suffix follows the separate Azure.Provisioning.PrivateDns SDK.
Getting started
Prerequisites
An Azure subscription when provisioning resources.
Add the integration
From your AppHost directory, add the Aspire.Hosting.Azure.Provisioning.PrivateDns integration with the Aspire CLI:
aspire add Aspire.Hosting.Azure.Provisioning.PrivateDns
Usage example
Then, in a TypeScript AppHost, create and customize a standalone private DNS zone:
import { createBuilder } from "./.aspire/modules/aspire.mjs";
const builder = await createBuilder();
const dns = await builder.addAzureInfrastructure("privateDns", async infrastructure => {
const zone = await infrastructure.addPrivateDnsZone("privateDns");
await zone.location.set(infrastructure.bicep().location("global"));
});
await dns.configureInfrastructure(async infrastructure => {
const zone = await infrastructure.getPrivateDnsZone();
await zone.name.set("app.internal");
const tags = await zone.tags.get();
await tags.set("environment", "production");
});
The matching Aspire resource and Bicep identifiers make the no-argument root lookup valid. This example does not create a virtual network link or configure name resolution for workloads.
Scope and limitations
PrivateDnsZone is the selected root; compatible models from the same SDK assembly are also projected, not every SDK member. Supported BicepValue<T> properties accept the corresponding language value or a shared Bicep expression.
The Network hosting integration creates its private endpoint DNS zones and links internally; there is no public addAzurePrivateDnsZone hosting factory. The example therefore uses addAzureInfrastructure, rather than assuming those internal resources are exposed as standalone builders.
Add Aspire.Hosting.Azure.Provisioning.Network when customizing virtual networks, private endpoints, or their DNS zone groups. Those models belong to Azure.Provisioning.Network, not this SDK. This overlay does not replace the hosting integration's private endpoint and DNS lifecycle.
Additional documentation
- Hosting integration
- Network overlay
- Provisioning inventory and shared expressions
- https://aspire.dev/integrations/gallery/
- https://learn.microsoft.com/azure/dns/private-dns-overview
- https://learn.microsoft.com/dotnet/azure/sdk/provisioning/
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.Network (>= 13.6.1)
- Aspire.Hosting.Azure.Provisioning (>= 13.6.1-preview.1.26506.6)
- AspNetCore.HealthChecks.Uris (>= 9.0.0)
- Azure.Core (>= 1.62.0)
- Azure.Identity (>= 1.21.0)
- Azure.Provisioning (>= 1.6.0)
- Azure.Provisioning.KeyVault (>= 1.1.0)
- Azure.Provisioning.Network (>= 1.1.0)
- Azure.Provisioning.PrivateDns (>= 1.0.0)
- Azure.ResourceManager.Authorization (>= 1.1.7)
- Azure.ResourceManager.KeyVault (>= 1.4.0)
- Azure.ResourceManager.Resources.Deployments (>= 1.0.0)
- Azure.Security.KeyVault.Secrets (>= 4.11.1)
- Google.Protobuf (>= 3.36.1)
- Grpc.AspNetCore (>= 2.83.0)
- Grpc.Net.ClientFactory (>= 2.83.0)
- Grpc.Tools (>= 2.83.0)
- Hex1b (>= 0.168.0)
- KubernetesClient (>= 19.0.2)
- MessagePack (>= 2.5.302)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.12)
- Microsoft.Extensions.Configuration.Binder (>= 10.0.12)
- Microsoft.Extensions.Configuration.EnvironmentVariables (>= 10.0.12)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.12)
- Microsoft.Extensions.Diagnostics.HealthChecks (>= 8.0.31)
- Microsoft.Extensions.FileSystemGlobbing (>= 10.0.12)
- Microsoft.Extensions.Hosting (>= 10.0.12)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.12)
- Microsoft.Extensions.Http (>= 10.0.12)
- Microsoft.Extensions.Logging (>= 10.0.12)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.12)
- Microsoft.Extensions.Options (>= 10.0.12)
- Microsoft.Extensions.Primitives (>= 10.0.12)
- ModelContextProtocol (>= 1.4.1)
- Newtonsoft.Json (>= 13.0.4)
- OpenTelemetry.Exporter.OpenTelemetryProtocol (>= 1.17.0)
- OpenTelemetry.Extensions.Hosting (>= 1.17.0)
- Polly.Core (>= 8.7.0)
- Semver (>= 3.0.0)
- StreamJsonRpc (>= 2.25.29)
- System.IO.Hashing (>= 10.0.12)
- System.Text.Json (>= 10.0.12)
- YamlDotNet (>= 18.1.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 13.6.1-preview.1.26506.6 | 55 | 10/7/2026 |
| 13.6.0-preview.1.26479.8 | 82 | 9/29/2026 |