Share via


Microsoft.Network dnszones 2015-05-04-preview

Bicep resource definition

The dnszones resource type can be deployed with operations that target:

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.Network/dnszones resource, add the following Bicep to your template.

resource symbolicname 'Microsoft.Network/dnszones@2015-05-04-preview' = {
  scope: resourceSymbolicName or scope
  etag: 'string'
  ___location: 'string'
  name: 'string'
  properties: {
    maxNumberOfRecordSets: int
    numberOfRecordSets: int
  }
  tags: {
    {customized property}: 'string'
  }
}

Property Values

Microsoft.Network/dnszones

Name Description Value
etag Gets or sets the ETag of the zone that is being updated, as received from a Get operation. string
___location The geo-___location where the resource lives string (required)
name The resource name string (required)
properties Gets or sets the properties of the zone. ZoneProperties
scope Use when creating a resource at a scope that is different than the deployment scope. Set this property to the symbolic name of a resource to apply the extension resource.
tags Resource tags Dictionary of tag names and values. See Tags in templates

TrackedResourceTags

Name Description Value

ZoneProperties

Name Description Value
maxNumberOfRecordSets Gets or sets the maximum number of record sets that can be created in this zone. int
numberOfRecordSets Gets or sets the current number of record sets in this zone. int

Usage Examples

Azure Verified Modules

The following Azure Verified Modules can be used to deploy this resource type.

Module Description
Public DNS Zone AVM Resource Module for Public DNS Zone

Azure Quickstart Samples

The following Azure Quickstart templates contain Bicep samples for deploying this resource type.

Bicep File Description
Azure DNS ___domain hosting example This template shows how to create a DNS zone within Azure DNS and how to add some record sets to it.
Front Door Standard/Premium with Azure DNS and custom ___domain This template creates a Front Door Standard/Premium including a custom ___domain on Azure DNS and Microsoft-managed certificate.

ARM template resource definition

The dnszones resource type can be deployed with operations that target:

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.Network/dnszones resource, add the following JSON to your template.

{
  "type": "Microsoft.Network/dnszones",
  "apiVersion": "2015-05-04-preview",
  "name": "string",
  "etag": "string",
  "___location": "string",
  "properties": {
    "maxNumberOfRecordSets": "int",
    "numberOfRecordSets": "int"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Property Values

Microsoft.Network/dnszones

Name Description Value
apiVersion The api version '2015-05-04-preview'
etag Gets or sets the ETag of the zone that is being updated, as received from a Get operation. string
___location The geo-___location where the resource lives string (required)
name The resource name string (required)
properties Gets or sets the properties of the zone. ZoneProperties
tags Resource tags Dictionary of tag names and values. See Tags in templates
type The resource type 'Microsoft.Network/dnszones'

TrackedResourceTags

Name Description Value

ZoneProperties

Name Description Value
maxNumberOfRecordSets Gets or sets the maximum number of record sets that can be created in this zone. int
numberOfRecordSets Gets or sets the current number of record sets in this zone. int

Usage Examples

Azure Quickstart Templates

The following Azure Quickstart templates deploy this resource type.

Template Description
Azure DNS ___domain hosting example

Deploy to Azure
This template shows how to create a DNS zone within Azure DNS and how to add some record sets to it.
Create a DNS Zone with the correct records for Office 365

Deploy to Azure
This template configures the records needed to integrate Azure DNS with Office 365 by adding the correct CNAME, SRV, MX, and TXT records.
Front Door Standard/Premium with Azure DNS and custom ___domain

Deploy to Azure
This template creates a Front Door Standard/Premium including a custom ___domain on Azure DNS and Microsoft-managed certificate.

Terraform (AzAPI provider) resource definition

The dnszones resource type can be deployed with operations that target:

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.Network/dnszones resource, add the following Terraform to your template.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/dnszones@2015-05-04-preview"
  name = "string"
  parent_id = "string"
  ___location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    etag = "string"
    properties = {
      maxNumberOfRecordSets = int
      numberOfRecordSets = int
    }
  }
}

Property Values

Microsoft.Network/dnszones

Name Description Value
etag Gets or sets the ETag of the zone that is being updated, as received from a Get operation. string
___location The geo-___location where the resource lives string (required)
name The resource name string (required)
parent_id The ID of the resource to apply this extension resource to. string (required)
properties Gets or sets the properties of the zone. ZoneProperties
tags Resource tags Dictionary of tag names and values.
type The resource type "Microsoft.Network/dnszones@2015-05-04-preview"

TrackedResourceTags

Name Description Value

ZoneProperties

Name Description Value
maxNumberOfRecordSets Gets or sets the maximum number of record sets that can be created in this zone. int
numberOfRecordSets Gets or sets the current number of record sets in this zone. int

Usage Examples

Terraform Samples

A basic example of deploying DNS Zone.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "___location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  ___location = var.___location
}

resource "azapi_resource" "dnsZone" {
  type                      = "Microsoft.Network/dnsZones@2018-05-01"
  parent_id                 = azapi_resource.resourceGroup.id
  name                      = "${var.resource_name}.com"
  ___location                  = "global"
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Azure Verified Modules

The following Azure Verified Modules can be used to deploy this resource type.

Module Description
Public DNS Zone AVM Resource Module for Public DNS Zone