Introduce Azure.Provisioning.Dns (#53497)

Co-authored-by: Copilot <[email protected]>

Author: ArcturusZhang

eng/Packages.Data.props

@@ -148,6 +148,7 @@
     <PackageReference Update="Azure.ResourceManager.ContainerRegistry" Version="1.3.0" />
     <PackageReference Update="Azure.ResourceManager.ContainerService" Version="1.2.3" />
     <PackageReference Update="Azure.ResourceManager.CosmosDB" Version="1.4.0-beta.12" />
+    <PackageReference Update="Azure.ResourceManager.Dns" Version="1.2.0-beta.2" />
     <PackageReference Update="Azure.ResourceManager.EventGrid" Version="1.1.0" />
     <PackageReference Update="Azure.ResourceManager.EventHubs" Version="1.2.0" />
     <PackageReference Update="Azure.ResourceManager.FrontDoor" Version="1.4.1" />

sdk/provisioning/Azure.Provisioning.Dns/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Release History
+
+## 1.0.0-beta.1 (2025-11-07)
+
+### Features Added
+
+- Initial beta release of new Azure.Provisioning.Dns.

sdk/provisioning/Azure.Provisioning.Dns/README.md

@@ -0,0 +1,99 @@
+# Azure Provisioning Dns client library for .NET
+
+Azure.Provisioning.Dns simplifies declarative resource provisioning in .NET.
+
+## Getting started
+
+### Install the package
+
+Install the client library for .NET with [NuGet](https://www.nuget.org/ ):
+
+```dotnetcli
+dotnet add package Azure.Provisioning.Dns --prerelease
+```
+
+### Prerequisites
+
+> You must have an [Azure subscription](https://azure.microsoft.com/free/dotnet/).
+
+### Authenticate the Client
+
+## Key concepts
+
+This library allows you to specify your infrastructure in a declarative style using dotnet.  You can then use azd to deploy your infrastructure to Azure directly without needing to write or maintain bicep or arm templates.
+
+## Examples
+
+### Create a DNS Zone
+
+This template shows how to create a DNS zone within Azure DNS and how to add some record sets to it.
+
+```C# Snippet:CreateAzureDnsNewZone
+Infrastructure infra = new();
+
+ProvisioningParameter zoneName = new(nameof(zoneName), typeof(string))
+{
+    Description = "The name of the DNS zone to be created.  Must have at least 2 segments, e.g. hostname.org",
+    Value = BicepFunction.Interpolate($"{BicepFunction.GetUniqueString(BicepFunction.GetResourceGroup().Id)}.azurequickstart.org")
+};
+infra.Add(zoneName);
+
+ProvisioningParameter recordName = new(nameof(recordName), typeof(string))
+{
+    Description = "The name of the DNS record to be created.  The name is relative to the zone, not the FQDN.",
+    Value = "www"
+};
+infra.Add(recordName);
+
+DnsZone zone = new(nameof(zone), DnsZone.ResourceVersions.V2018_05_01)
+{
+    Name = zoneName,
+    Location = new AzureLocation("global")
+};
+infra.Add(zone);
+
+DnsARecord aRecord = new(nameof(aRecord), DnsARecord.ResourceVersions.V2018_05_01)
+{
+    Parent = zone,
+    Name = recordName,
+    TtlInSeconds = 3600,
+    ARecords =
+    {
+        new DnsARecordInfo() { Ipv4Addresses = IPAddress.Parse("203.0.113.1") },
+        new DnsARecordInfo() { Ipv4Addresses = IPAddress.Parse("203.0.113.2") }
+    }
+};
+infra.Add(aRecord);
+```
+
+## Troubleshooting
+
+-   File an issue via [GitHub Issues](https://github.com/Azure/azure-sdk-for-net/issues).
+-   Check [previous questions](https://stackoverflow.com/questions/tagged/azure+.net) or ask new ones on Stack Overflow using Azure and .NET tags.
+
+## Next steps
+
+## Contributing
+
+For details on contributing to this repository, see the [contributing
+guide][cg].
+
+This project welcomes contributions and suggestions. Most contributions
+require you to agree to a Contributor License Agreement (CLA) declaring
+that you have the right to, and actually do, grant us the rights to use
+your contribution. For details, visit <https://cla.microsoft.com>.
+
+When you submit a pull request, a CLA-bot will automatically determine
+whether you need to provide a CLA and decorate the PR appropriately
+(for example, label, comment). Follow the instructions provided by the
+bot. You'll only need to do this action once across all repositories
+using our CLA.
+
+This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For
+more information, see the [Code of Conduct FAQ][coc_faq] or contact
+<[email protected]> with any other questions or comments.
+
+<!-- LINKS -->
+[cg]: https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/resourcemanager/Azure.ResourceManager/docs/CONTRIBUTING.md
+[coc]: https://opensource.microsoft.com/codeofconduct/
+[coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/

sdk/provisioning/Azure.Provisioning.Dns/api/Azure.Provisioning.Dns.net8.0.cs

@@ -0,0 +1,17 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <Description>Azure.Provisioning.Dns simplifies declarative resource provisioning in .NET.</Description>
+    <Version>1.0.0-beta.1</Version>
+    <TargetFrameworks>$(RequiredTargetFrameworks)</TargetFrameworks>
+    <LangVersion>12</LangVersion>
+
+    <!-- Disable warning CS1591: Missing XML comment for publicly visible type or member -->
+    <NoWarn>CS1591</NoWarn>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Azure.Provisioning" />
+  </ItemGroup>
+
+</Project>

sdk/provisioning/Azure.Provisioning.Dns/api/Azure.Provisioning.Dns.netstandard2.0.cs

@@ -0,0 +1,143 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+
+#nullable enable
+
+using Azure.Core;
+using Azure.Provisioning.Primitives;
+using Azure.Provisioning.Resources;
+
+namespace Azure.Provisioning.Dns;
+
+/// <summary>
+/// DnsARecord.
+/// </summary>
+public partial class DnsARecord : ProvisionableResource
+{
+    /// <summary>
+    /// Gets or sets the Name.
+    /// </summary>
+    public BicepValue<string> Name
+    {
+        get { Initialize(); return _name!; }
+        set { Initialize(); _name!.Assign(value); }
+    }
+    private BicepValue<string>? _name;
+
+    /// <summary>
+    /// Gets the Id.
+    /// </summary>
+    public BicepValue<ResourceIdentifier> Id
+    {
+        get { Initialize(); return _id!; }
+    }
+    private BicepValue<ResourceIdentifier>? _id;
+
+    /// <summary>
+    /// Gets the SystemData.
+    /// </summary>
+    public SystemData SystemData
+    {
+        get { Initialize(); return _systemData!; }
+    }
+    private SystemData? _systemData;
+
+    /// <summary>
+    /// The list of A records in the record set.
+    /// </summary>
+    public BicepList<DnsARecordInfo> ARecords
+    {
+        get { Initialize(); return _aRecords!; }
+        set { Initialize(); _aRecords!.Assign(value); }
+    }
+    private BicepList<DnsARecordInfo>? _aRecords;
+
+    /// <summary>
+    /// The TTL (time-to-live) of the records in the record set.
+    /// </summary>
+    public BicepValue<long> TtlInSeconds
+    {
+        get { Initialize(); return _ttlInSeconds!; }
+        set { Initialize(); _ttlInSeconds!.Assign(value); }
+    }
+    private BicepValue<long>? _ttlInSeconds;
+
+    /// <summary>
+    /// Gets or sets a reference to the parent DnsZone.
+    /// </summary>
+    public DnsZone? Parent
+    {
+        get { Initialize(); return _parent!.Value; }
+        set { Initialize(); _parent!.Value = value; }
+    }
+    private ResourceReference<DnsZone>? _parent;
+
+    /// <summary>
+    /// Creates a new DnsARecord.
+    /// </summary>
+    /// <param name="bicepIdentifier">
+    /// The the Bicep identifier name of the DnsARecord resource.  This can be
+    /// used to refer to the resource in expressions, but is not the Azure
+    /// name of the resource.  This value can contain letters, numbers, and
+    /// underscores.
+    /// </param>
+    /// <param name="resourceVersion">Version of the DnsARecord.</param>
+    public DnsARecord(string bicepIdentifier, string? resourceVersion = default)
+        : base(bicepIdentifier, "Microsoft.Network/dnsZones/A", resourceVersion ?? "2018-05-01")
+    {
+    }
+
+    /// <summary>
+    /// Define all the provisionable properties of DnsARecord.
+    /// </summary>
+    protected override void DefineProvisionableProperties()
+    {
+        base.DefineProvisionableProperties();
+        _name = DefineProperty<string>("Name", ["name"], isRequired: true);
+        _id = DefineProperty<ResourceIdentifier>("Id", ["id"], isOutput: true);
+        _systemData = DefineModelProperty<SystemData>("SystemData", ["systemData"], isOutput: true);
+        _parent = DefineResource<DnsZone>("Parent", ["parent"], isRequired: true);
+        _aRecords = DefineListProperty<DnsARecordInfo>("ARecords", ["properties", "ARecords"]);
+        _ttlInSeconds = DefineProperty<long>(nameof(TtlInSeconds), ["properties", "TTL"]);
+    }
+
+    /// <summary>
+    /// Supported DnsARecord resource versions.
+    /// </summary>
+    public static class ResourceVersions
+    {
+        /// <summary>
+        /// 2018-05-01.
+        /// </summary>
+        public static readonly string V2018_05_01 = "2018-05-01";
+
+        /// <summary>
+        /// 2017-10-01.
+        /// </summary>
+        public static readonly string V2017_10_01 = "2017-10-01";
+
+        /// <summary>
+        /// 2017-09-01.
+        /// </summary>
+        public static readonly string V2017_09_01 = "2017-09-01";
+
+        /// <summary>
+        /// 2016-04-01.
+        /// </summary>
+        public static readonly string V2016_04_01 = "2016-04-01";
+    }
+
+    /// <summary>
+    /// Creates a reference to an existing DnsARecord.
+    /// </summary>
+    /// <param name="bicepIdentifier">
+    /// The the Bicep identifier name of the DnsARecord resource.  This can be
+    /// used to refer to the resource in expressions, but is not the Azure
+    /// name of the resource.  This value can contain letters, numbers, and
+    /// underscores.
+    /// </param>
+    /// <param name="resourceVersion">Version of the DnsARecord.</param>
+    /// <returns>The existing DnsARecord resource.</returns>
+    public static DnsARecord FromExisting(string bicepIdentifier, string? resourceVersion = default) =>
+        new(bicepIdentifier, resourceVersion) { IsExistingResource = true };
+}