Microsoft.Network (stable:2024-06-01)

2025/07/04 • 1 new, 16 updated methods

RecordSets_List (new)
Description :  Lists all record sets in a Private DNS zone.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateZoneName}/aLL
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
privateZoneName:
{
Description: The name of the Private DNS zone (without a terminating dot). ,
Required: True ,
}
string ,
$top:
{
Description: The maximum number of record sets to return. If not specified, returns up to 100 record sets. ,
Format: int32 ,
Required: False ,
}
integer ,
$recordsetnamesuffix:
{
Description: The suffix label of the record set name to be used to filter the record set enumeration. If this parameter is specified, the returned enumeration will only contain records that end with ".". ,
Required: False ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The RecordSet items on this page ,
Required: True ,
}
[
{
etag:
{
Description: The ETag of the record set. ,
Required: False ,
}
string ,
properties:
{
Description: The properties of the record set. ,
Required: False ,
}
{
metadata:
{
Description: The metadata attached to the record set. ,
Required: False ,
}
object ,
ttl:
{
Description: The TTL (time-to-live) of the records in the record set. ,
Format: int64 ,
Required: False ,
}
integer ,
fqdn:
{
Description: Fully qualified domain name of the record set. ,
Required: False ,
}
string ,
isAutoRegistered:
{
Description: Is the record set auto-registered in the Private DNS zone through a virtual network link? ,
Required: False ,
}
boolean ,
aRecords:
{
Description: The list of A records in the record set. ,
Required: False ,
}
[
{
ipv4Address:
{
Description: The IPv4 address of this A record. ,
Required: False ,
}
string ,
}
,
]
,
aaaaRecords:
{
Description: The list of AAAA records in the record set. ,
Required: False ,
}
[
{
ipv6Address:
{
Description: The IPv6 address of this AAAA record. ,
Required: False ,
}
string ,
}
,
]
,
cnameRecord:
{
Description: The CNAME record in the record set. ,
Required: False ,
}
{
cname:
{
Description: The canonical name for this CNAME record. ,
Required: False ,
}
string ,
}
,
mxRecords:
{
Description: The list of MX records in the record set. ,
Required: False ,
}
[
{
preference:
{
Description: The preference value for this MX record. ,
Format: int32 ,
Required: False ,
}
integer ,
exchange:
{
Description: The domain name of the mail host for this MX record. ,
Required: False ,
}
string ,
}
,
]
,
ptrRecords:
{
Description: The list of PTR records in the record set. ,
Required: False ,
}
[
{
ptrdname:
{
Description: The PTR target domain name for this PTR record. ,
Required: False ,
}
string ,
}
,
]
,
soaRecord:
{
Description: The SOA record in the record set. ,
Required: False ,
}
{
host:
{
Description: The domain name of the authoritative name server for this SOA record. ,
Required: False ,
}
string ,
email:
{
Description: The email contact for this SOA record. ,
Required: False ,
}
string ,
serialNumber:
{
Description: The serial number for this SOA record. ,
Format: int64 ,
Required: False ,
}
integer ,
refreshTime:
{
Description: The refresh value for this SOA record. ,
Format: int64 ,
Required: False ,
}
integer ,
retryTime:
{
Description: The retry time for this SOA record. ,
Format: int64 ,
Required: False ,
}
integer ,
expireTime:
{
Description: The expire time for this SOA record. ,
Format: int64 ,
Required: False ,
}
integer ,
minimumTtl:
{
Description: The minimum value for this SOA record. By convention this is used to determine the negative caching duration. ,
Format: int64 ,
Required: False ,
}
integer ,
}
,
srvRecords:
{
Description: The list of SRV records in the record set. ,
Required: False ,
}
[
{
priority:
{
Description: The priority value for this SRV record. ,
Format: int32 ,
Required: False ,
}
integer ,
weight:
{
Description: The weight value for this SRV record. ,
Format: int32 ,
Required: False ,
}
integer ,
port:
{
Description: The port value for this SRV record. ,
Format: int32 ,
Required: False ,
}
integer ,
target:
{
Description: The target domain name for this SRV record. ,
Required: False ,
}
string ,
}
,
]
,
txtRecords:
{
Description: The list of TXT records in the record set. ,
Required: False ,
}
[
{
value:
{
Description: The text value of this TXT record. ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
}
,
}
,
]
,
nextLink:
{
Description: The link to the next page of items ,
Format: uri ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: Cloud error body. ,
Required: False ,
}
{
code:
{
Description: An identifier for the error. Codes are invariant and are intended to be consumed programmatically. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error, intended to be suitable for display in a user interface. ,
Required: False ,
}
string ,
target:
{
Description: The target of the particular error. For example, the name of the property in error. ,
Required: False ,
}
string ,
details:
{
Description: A list of additional details about the error. ,
Required: False ,
}
[
string ,
]
,
}
,
}
PrivateZones_List (updated)
Description :  Lists the Private DNS zones in all resource groups in a subscription.
Reference :  Link ¶

⚶ Changes

{
  "#id": "PrivateZones_List",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Gets subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    }
  ],
  "$responses": {
    "200": {
      "Description": {
        "new": "The response of a PrivateZone list operation.",
        "old": "The response to a Private DNS zone list operation."
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The PrivateZone items on this page",
            "old": "Information about the Private DNS zones."
          },
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "$properties": {
              "@added_2d0dfb948674455681867704d6fcd360": {
                "#name": "tags",
                "Description": "Resource tags.",
                "Required": false,
                "Type": "object"
              },
              "@added_695687cdb6f7489199e3c770b3fa7cfb": {
                "#name": "location",
                "Description": "The Azure Region where the resource lives",
                "Required": false,
                "Type": "string"
              }
            }
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "The continuation token for the next page of results."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.Network/privateDnsZones
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
$top:
{
Description: The maximum number of Private DNS zones to return. If not specified, returns up to 100 zones. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: The PrivateZone items on this page ,
Required: True ,
}
[
{
tags:
{
Description: Resource tags. ,
Required: False ,
}
object ,
location:
{
Description: The Azure Region where the resource lives ,
Required: False ,
}
string ,
etag:
{
Description: The ETag of the zone. ,
Required: False ,
}
string ,
properties:
{
Description: Properties of the Private DNS zone. ,
Required: False ,
}
{
maxNumberOfRecordSets:
{
Description: The maximum number of record sets that can be created in this Private DNS zone. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
numberOfRecordSets:
{
Description: The current number of record sets in this Private DNS zone. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
maxNumberOfVirtualNetworkLinks:
{
Description: The maximum number of virtual networks that can be linked to this Private DNS zone. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
numberOfVirtualNetworkLinks:
{
Description: The current number of virtual networks that are linked to this Private DNS zone. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
maxNumberOfVirtualNetworkLinksWithRegistration:
{
Description: The maximum number of virtual networks that can be linked to this Private DNS zone with registration enabled. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
numberOfVirtualNetworkLinksWithRegistration:
{
Description: The current number of virtual networks that are linked to this Private DNS zone with registration enabled. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
provisioningState:
{
Description: The provisioning state of the resource. This is a read-only property and any attempt to set this value will be ignored. ,
Enum:
{
Creating: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
internalId:
{
Description: Private zone internal Id ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: The link to the next page of items ,
Format: uri ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: Cloud error body. ,
Required: False ,
}
{
code:
{
Description: An identifier for the error. Codes are invariant and are intended to be consumed programmatically. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error, intended to be suitable for display in a user interface. ,
Required: False ,
}
string ,
target:
{
Description: The target of the particular error. For example, the name of the property in error. ,
Required: False ,
}
string ,
details:
{
Description: A list of additional details about the error. ,
Required: False ,
}
[
string ,
]
,
}
,
}
PrivateZones_ListByResourceGroup (updated)
Description :  Lists the Private DNS zones within a resource group.
Reference :  Link ¶

⚶ Changes

{
  "#id": "PrivateZones_ListByResourceGroup",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Gets subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The name of the resource group."
      }
    }
  ],
  "$responses": {
    "200": {
      "Description": {
        "new": "The response of a PrivateZone list operation.",
        "old": "The response to a Private DNS zone list operation."
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The PrivateZone items on this page",
            "old": "Information about the Private DNS zones."
          },
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "$properties": {
              "@added_b0a36ef0783b41c6904f35ee1bbd24ca": {
                "#name": "tags",
                "Description": "Resource tags.",
                "Required": false,
                "Type": "object"
              },
              "@added_44e41977dec945faa0c2a305394f0428": {
                "#name": "location",
                "Description": "The Azure Region where the resource lives",
                "Required": false,
                "Type": "string"
              }
            }
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "The continuation token for the next page of results."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
$top:
{
Description: The maximum number of record sets to return. If not specified, returns up to 100 record sets. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: The PrivateZone items on this page ,
Required: True ,
}
[
{
tags:
{
Description: Resource tags. ,
Required: False ,
}
object ,
location:
{
Description: The Azure Region where the resource lives ,
Required: False ,
}
string ,
etag:
{
Description: The ETag of the zone. ,
Required: False ,
}
string ,
properties:
{
Description: Properties of the Private DNS zone. ,
Required: False ,
}
{
maxNumberOfRecordSets:
{
Description: The maximum number of record sets that can be created in this Private DNS zone. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
numberOfRecordSets:
{
Description: The current number of record sets in this Private DNS zone. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
maxNumberOfVirtualNetworkLinks:
{
Description: The maximum number of virtual networks that can be linked to this Private DNS zone. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
numberOfVirtualNetworkLinks:
{
Description: The current number of virtual networks that are linked to this Private DNS zone. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
maxNumberOfVirtualNetworkLinksWithRegistration:
{
Description: The maximum number of virtual networks that can be linked to this Private DNS zone with registration enabled. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
numberOfVirtualNetworkLinksWithRegistration:
{
Description: The current number of virtual networks that are linked to this Private DNS zone with registration enabled. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
provisioningState:
{
Description: The provisioning state of the resource. This is a read-only property and any attempt to set this value will be ignored. ,
Enum:
{
Creating: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
internalId:
{
Description: Private zone internal Id ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: The link to the next page of items ,
Format: uri ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: Cloud error body. ,
Required: False ,
}
{
code:
{
Description: An identifier for the error. Codes are invariant and are intended to be consumed programmatically. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error, intended to be suitable for display in a user interface. ,
Required: False ,
}
string ,
target:
{
Description: The target of the particular error. For example, the name of the property in error. ,
Required: False ,
}
string ,
details:
{
Description: A list of additional details about the error. ,
Required: False ,
}
[
string ,
]
,
}
,
}
PrivateZones_Get (updated)
Description :  Gets a Private DNS zone. Retrieves the zone properties, but not the virtual networks links or the record sets within the zone.
Reference :  Link ¶

⚶ Changes

{
  "#id": "PrivateZones_Get",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Gets subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The name of the resource group."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "@added_d9884c6a9c064d96b61d60877b23f2f9": {
          "#name": "tags",
          "Description": "Resource tags.",
          "Required": false,
          "Type": "object"
        },
        "@added_00d2208729584168870336b176a3301b": {
          "#name": "location",
          "Description": "The Azure Region where the resource lives",
          "Required": false,
          "Type": "string"
        }
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateZoneName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
privateZoneName:
{
Description: The name of the Private DNS zone (without a terminating dot). ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
tags:
{
Description: Resource tags. ,
Required: False ,
}
object ,
location:
{
Description: The Azure Region where the resource lives ,
Required: False ,
}
string ,
etag:
{
Description: The ETag of the zone. ,
Required: False ,
}
string ,
properties:
{
Description: Properties of the Private DNS zone. ,
Required: False ,
}
{
maxNumberOfRecordSets:
{
Description: The maximum number of record sets that can be created in this Private DNS zone. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
numberOfRecordSets:
{
Description: The current number of record sets in this Private DNS zone. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
maxNumberOfVirtualNetworkLinks:
{
Description: The maximum number of virtual networks that can be linked to this Private DNS zone. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
numberOfVirtualNetworkLinks:
{
Description: The current number of virtual networks that are linked to this Private DNS zone. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
maxNumberOfVirtualNetworkLinksWithRegistration:
{
Description: The maximum number of virtual networks that can be linked to this Private DNS zone with registration enabled. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
numberOfVirtualNetworkLinksWithRegistration:
{
Description: The current number of virtual networks that are linked to this Private DNS zone with registration enabled. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
provisioningState:
{
Description: The provisioning state of the resource. This is a read-only property and any attempt to set this value will be ignored. ,
Enum:
{
Creating: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
internalId:
{
Description: Private zone internal Id ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
error:
{
Description: Cloud error body. ,
Required: False ,
}
{
code:
{
Description: An identifier for the error. Codes are invariant and are intended to be consumed programmatically. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error, intended to be suitable for display in a user interface. ,
Required: False ,
}
string ,
target:
{
Description: The target of the particular error. For example, the name of the property in error. ,
Required: False ,
}
string ,
details:
{
Description: A list of additional details about the error. ,
Required: False ,
}
[
string ,
]
,
}
,
}
PrivateZones_CreateOrUpdate (updated)
Description :  Creates or updates a Private DNS zone. Does not modify Links to virtual networks or DNS records within the zone.
Reference :  Link ¶

⚶ Changes

{
  "#id": "PrivateZones_CreateOrUpdate",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Gets subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The name of the resource group."
      }
    },
    {
      "parameters": {
        "$properties": {
          "@added_9b00c314cce345d0a1ac499986a812b1": {
            "#name": "tags",
            "Description": "Resource tags.",
            "Required": false,
            "Type": "object"
          },
          "@added_140c273b49ad46a58ed28bac159ce873": {
            "#name": "location",
            "Description": "The Azure Region where the resource lives",
            "Required": false,
            "Type": "string"
          }
        }
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "@added_3858a497f015414eadb1f99022b5da2b": {
          "#name": "tags",
          "Description": "Resource tags.",
          "Required": false,
          "Type": "object"
        },
        "@added_57da35ad556648e1b8d4638b9d63abb7": {
          "#name": "location",
          "Description": "The Azure Region where the resource lives",
          "Required": false,
          "Type": "string"
        }
      }
    },
    "201": {
      "$properties": {
        "@added_2af098e8bb364eed8e7b2d8bee49e5f8": {
          "#name": "tags",
          "Description": "Resource tags.",
          "Required": false,
          "Type": "object"
        },
        "@added_0a65aad715df45698ca8063255499ad1": {
          "#name": "location",
          "Description": "The Azure Region where the resource lives",
          "Required": false,
          "Type": "string"
        }
      }
    }
  }
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateZoneName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
privateZoneName:
{
Description: The name of the Private DNS zone (without a terminating dot). ,
Required: True ,
}
string ,
If-Match:
{
Description: The ETag of the Private DNS zone. Omit this value to always overwrite the current zone. Specify the last-seen ETag value to prevent accidentally overwriting any concurrent changes. ,
Required: False ,
}
string ,
If-None-Match:
{
Description: Set to '*' to allow a new Private DNS zone to be created, but to prevent updating an existing zone. Other values will be ignored. ,
Required: False ,
}
string ,
parameters:
{
Description: Parameters supplied to the CreateOrUpdate operation. ,
Required: True ,
}
{
tags:
{
Description: Resource tags. ,
Required: False ,
}
object ,
location:
{
Description: The Azure Region where the resource lives ,
Required: False ,
}
string ,
etag:
{
Description: The ETag of the zone. ,
Required: False ,
}
string ,
properties:
{
Description: Properties of the Private DNS zone. ,
Required: False ,
}
{
maxNumberOfRecordSets:
{
Description: The maximum number of record sets that can be created in this Private DNS zone. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
numberOfRecordSets:
{
Description: The current number of record sets in this Private DNS zone. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
maxNumberOfVirtualNetworkLinks:
{
Description: The maximum number of virtual networks that can be linked to this Private DNS zone. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
numberOfVirtualNetworkLinks:
{
Description: The current number of virtual networks that are linked to this Private DNS zone. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
maxNumberOfVirtualNetworkLinksWithRegistration:
{
Description: The maximum number of virtual networks that can be linked to this Private DNS zone with registration enabled. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
numberOfVirtualNetworkLinksWithRegistration:
{
Description: The current number of virtual networks that are linked to this Private DNS zone with registration enabled. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
provisioningState:
{
Description: The provisioning state of the resource. This is a read-only property and any attempt to set this value will be ignored. ,
Enum:
{
Creating: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
internalId:
{
Description: Private zone internal Id ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (200)

{
tags:
{
Description: Resource tags. ,
Required: False ,
}
object ,
location:
{
Description: The Azure Region where the resource lives ,
Required: False ,
}
string ,
etag:
{
Description: The ETag of the zone. ,
Required: False ,
}
string ,
properties:
{
Description: Properties of the Private DNS zone. ,
Required: False ,
}
{
maxNumberOfRecordSets:
{
Description: The maximum number of record sets that can be created in this Private DNS zone. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
numberOfRecordSets:
{
Description: The current number of record sets in this Private DNS zone. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
maxNumberOfVirtualNetworkLinks:
{
Description: The maximum number of virtual networks that can be linked to this Private DNS zone. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
numberOfVirtualNetworkLinks:
{
Description: The current number of virtual networks that are linked to this Private DNS zone. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
maxNumberOfVirtualNetworkLinksWithRegistration:
{
Description: The maximum number of virtual networks that can be linked to this Private DNS zone with registration enabled. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
numberOfVirtualNetworkLinksWithRegistration:
{
Description: The current number of virtual networks that are linked to this Private DNS zone with registration enabled. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
provisioningState:
{
Description: The provisioning state of the resource. This is a read-only property and any attempt to set this value will be ignored. ,
Enum:
{
Creating: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
internalId:
{
Description: Private zone internal Id ,
Required: False ,
}
string ,
}
,
}

⚐ Response (201)

{
$headers:
{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
string ,
retry-after:
{
Description: The Retry-After header can indicate how long the client should wait before polling the operation status. ,
}
integer ,
}
,
$schema:
{
Description: Describes a Private DNS zone. ,
}
{
tags:
{
Description: Resource tags. ,
Required: False ,
}
object ,
location:
{
Description: The Azure Region where the resource lives ,
Required: False ,
}
string ,
etag:
{
Description: The ETag of the zone. ,
Required: False ,
}
string ,
properties:
{
Description: Properties of the Private DNS zone. ,
Required: False ,
}
{
maxNumberOfRecordSets:
{
Description: The maximum number of record sets that can be created in this Private DNS zone. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
numberOfRecordSets:
{
Description: The current number of record sets in this Private DNS zone. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
maxNumberOfVirtualNetworkLinks:
{
Description: The maximum number of virtual networks that can be linked to this Private DNS zone. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
numberOfVirtualNetworkLinks:
{
Description: The current number of virtual networks that are linked to this Private DNS zone. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
maxNumberOfVirtualNetworkLinksWithRegistration:
{
Description: The maximum number of virtual networks that can be linked to this Private DNS zone with registration enabled. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
numberOfVirtualNetworkLinksWithRegistration:
{
Description: The current number of virtual networks that are linked to this Private DNS zone with registration enabled. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
provisioningState:
{
Description: The provisioning state of the resource. This is a read-only property and any attempt to set this value will be ignored. ,
Enum:
{
Creating: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
internalId:
{
Description: Private zone internal Id ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (202)

{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
string ,
retry-after:
{
Description: The Retry-After header can indicate how long the client should wait before polling the operation status. ,
}
integer ,
}

⚐ Response (default)

{
error:
{
Description: Cloud error body. ,
Required: False ,
}
{
code:
{
Description: An identifier for the error. Codes are invariant and are intended to be consumed programmatically. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error, intended to be suitable for display in a user interface. ,
Required: False ,
}
string ,
target:
{
Description: The target of the particular error. For example, the name of the property in error. ,
Required: False ,
}
string ,
details:
{
Description: A list of additional details about the error. ,
Required: False ,
}
[
string ,
]
,
}
,
}
PrivateZones_Update (updated)
Description :  Updates a Private DNS zone. Does not modify virtual network links or DNS records within the zone.
Reference :  Link ¶

⚶ Changes

{
  "#id": "PrivateZones_Update",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Gets subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The name of the resource group."
      }
    },
    {
      "parameters": {
        "$properties": {
          "@added_1877b8882b864136ad96c105d5862358": {
            "#name": "tags",
            "Description": "Resource tags.",
            "Required": false,
            "Type": "object"
          },
          "@added_860c8b8b76f5483cad19c590048a5d30": {
            "#name": "location",
            "Description": "The Azure Region where the resource lives",
            "Required": false,
            "Type": "string"
          }
        }
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "@added_f98228b7337e4ce8aeb59a3b359d10c9": {
          "#name": "tags",
          "Description": "Resource tags.",
          "Required": false,
          "Type": "object"
        },
        "@added_7ba9e2aa876e4077aae7821304349e2b": {
          "#name": "location",
          "Description": "The Azure Region where the resource lives",
          "Required": false,
          "Type": "string"
        }
      }
    }
  }
}

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateZoneName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
privateZoneName:
{
Description: The name of the Private DNS zone (without a terminating dot). ,
Required: True ,
}
string ,
If-Match:
{
Description: The ETag of the Private DNS zone. Omit this value to always overwrite the current zone. Specify the last-seen ETag value to prevent accidentally overwriting any concurrent changes. ,
Required: False ,
}
string ,
parameters:
{
Description: Parameters supplied to the Update operation. ,
Required: True ,
}
{
tags:
{
Description: Resource tags. ,
Required: False ,
}
object ,
location:
{
Description: The Azure Region where the resource lives ,
Required: False ,
}
string ,
etag:
{
Description: The ETag of the zone. ,
Required: False ,
}
string ,
properties:
{
Description: Properties of the Private DNS zone. ,
Required: False ,
}
{
maxNumberOfRecordSets:
{
Description: The maximum number of record sets that can be created in this Private DNS zone. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
numberOfRecordSets:
{
Description: The current number of record sets in this Private DNS zone. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
maxNumberOfVirtualNetworkLinks:
{
Description: The maximum number of virtual networks that can be linked to this Private DNS zone. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
numberOfVirtualNetworkLinks:
{
Description: The current number of virtual networks that are linked to this Private DNS zone. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
maxNumberOfVirtualNetworkLinksWithRegistration:
{
Description: The maximum number of virtual networks that can be linked to this Private DNS zone with registration enabled. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
numberOfVirtualNetworkLinksWithRegistration:
{
Description: The current number of virtual networks that are linked to this Private DNS zone with registration enabled. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
provisioningState:
{
Description: The provisioning state of the resource. This is a read-only property and any attempt to set this value will be ignored. ,
Enum:
{
Creating: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
internalId:
{
Description: Private zone internal Id ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (200)

{
tags:
{
Description: Resource tags. ,
Required: False ,
}
object ,
location:
{
Description: The Azure Region where the resource lives ,
Required: False ,
}
string ,
etag:
{
Description: The ETag of the zone. ,
Required: False ,
}
string ,
properties:
{
Description: Properties of the Private DNS zone. ,
Required: False ,
}
{
maxNumberOfRecordSets:
{
Description: The maximum number of record sets that can be created in this Private DNS zone. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
numberOfRecordSets:
{
Description: The current number of record sets in this Private DNS zone. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
maxNumberOfVirtualNetworkLinks:
{
Description: The maximum number of virtual networks that can be linked to this Private DNS zone. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
numberOfVirtualNetworkLinks:
{
Description: The current number of virtual networks that are linked to this Private DNS zone. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
maxNumberOfVirtualNetworkLinksWithRegistration:
{
Description: The maximum number of virtual networks that can be linked to this Private DNS zone with registration enabled. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
numberOfVirtualNetworkLinksWithRegistration:
{
Description: The current number of virtual networks that are linked to this Private DNS zone with registration enabled. This is a read-only property and any attempt to set this value will be ignored. ,
Format: int64 ,
Required: False ,
}
integer ,
provisioningState:
{
Description: The provisioning state of the resource. This is a read-only property and any attempt to set this value will be ignored. ,
Enum:
{
Creating: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
Canceled: No description available. ,
}
,
Required: False ,
}
enum ,
internalId:
{
Description: Private zone internal Id ,
Required: False ,
}
string ,
}
,
}

⚐ Response (202)

{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
string ,
retry-after:
{
Description: The Retry-After header can indicate how long the client should wait before polling the operation status. ,
}
integer ,
}

⚐ Response (default)

{
error:
{
Description: Cloud error body. ,
Required: False ,
}
{
code:
{
Description: An identifier for the error. Codes are invariant and are intended to be consumed programmatically. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error, intended to be suitable for display in a user interface. ,
Required: False ,
}
string ,
target:
{
Description: The target of the particular error. For example, the name of the property in error. ,
Required: False ,
}
string ,
details:
{
Description: A list of additional details about the error. ,
Required: False ,
}
[
string ,
]
,
}
,
}
PrivateZones_Delete (updated)
Description :  Deletes a Private DNS zone. WARNING: All DNS records in the zone will also be deleted. This operation cannot be undone. Private DNS zone cannot be deleted unless all virtual network links to it are removed.
Reference :  Link ¶

⚶ Changes

{
  "#id": "PrivateZones_Delete",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Gets subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The name of the resource group."
      }
    }
  ]
}

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateZoneName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
privateZoneName:
{
Description: The name of the Private DNS zone (without a terminating dot). ,
Required: True ,
}
string ,
If-Match:
{
Description: The ETag of the Private DNS zone. Omit this value to always delete the current zone. Specify the last-seen ETag value to prevent accidentally deleting any concurrent changes. ,
Required: False ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (202)

{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
string ,
retry-after:
{
Description: The Retry-After header can indicate how long the client should wait before polling the operation status. ,
}
integer ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: Cloud error body. ,
Required: False ,
}
{
code:
{
Description: An identifier for the error. Codes are invariant and are intended to be consumed programmatically. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error, intended to be suitable for display in a user interface. ,
Required: False ,
}
string ,
target:
{
Description: The target of the particular error. For example, the name of the property in error. ,
Required: False ,
}
string ,
details:
{
Description: A list of additional details about the error. ,
Required: False ,
}
[
string ,
]
,
}
,
}
RecordSets_ListByType (updated)
Description :  Lists the record sets of a specified type in a Private DNS zone.
Reference :  Link ¶

⚶ Changes

{
  "#id": "RecordSets_ListByType",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Gets subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The name of the resource group."
      }
    },
    {
      "#name": "privateZoneName",
      "Description": {
        "new": "The name of the DNS zone (without a terminating dot).",
        "old": "The name of the Private DNS zone (without a terminating dot)."
      }
    },
    {
      "#name": "recordType",
      "Description": {
        "new": "The type of DNS record in this record set.",
        "old": "The type of record sets to enumerate."
      }
    }
  ],
  "$responses": {
    "200": {
      "Description": {
        "new": "The response of a RecordSet list operation.",
        "old": "The response to a record set list operation."
      },
      "$properties": [
        {
          "#name": "value",
          "Description": {
            "new": "The RecordSet items on this page",
            "old": "Information about the record sets in the response."
          },
          "Required": {
            "new": true,
            "old": false
          },
          "$items": {
            "$properties": {
              "@removed_46fa2fd7d7df430697aa27a73d29a049": {
                "#name": "id",
                "Description": "The ID of the record set.",
                "Required": false,
                "Type": "string"
              },
              "@removed_c5a0493b680b4790b37113f04e54ba47": {
                "#name": "name",
                "Description": "The name of the record set.",
                "Required": false,
                "Type": "string"
              },
              "@removed_805b762baa5e4b42a1ae9e2a1ab81fc3": {
                "#name": "type",
                "Description": "The type of the record set.",
                "Required": false,
                "Type": "string"
              }
            }
          }
        },
        {
          "#name": "nextLink",
          "Description": {
            "new": "The link to the next page of items",
            "old": "The continuation token for the next page of results."
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateZoneName}/{recordType}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
privateZoneName:
{
Description: The name of the DNS zone (without a terminating dot). ,
Required: True ,
}
string ,
recordType:
{
Description: The type of DNS record in this record set. ,
Required: True ,
}
string ,
$top:
{
Description: The maximum number of record sets to return. If not specified, returns up to 100 record sets. ,
Format: int32 ,
Required: False ,
}
integer ,
$recordsetnamesuffix:
{
Description: The suffix label of the record set name to be used to filter the record set enumeration. If this parameter is specified, the returned enumeration will only contain records that end with ".". ,
Required: False ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The RecordSet items on this page ,
Required: True ,
}
[
{
etag:
{
Description: The ETag of the record set. ,
Required: False ,
}
string ,
properties:
{
Description: The properties of the record set. ,
Required: False ,
}
{
metadata:
{
Description: The metadata attached to the record set. ,
Required: False ,
}
object ,
ttl:
{
Description: The TTL (time-to-live) of the records in the record set. ,
Format: int64 ,
Required: False ,
}
integer ,
fqdn:
{
Description: Fully qualified domain name of the record set. ,
Required: False ,
}
string ,
isAutoRegistered:
{
Description: Is the record set auto-registered in the Private DNS zone through a virtual network link? ,
Required: False ,
}
boolean ,
aRecords:
{
Description: The list of A records in the record set. ,
Required: False ,
}
[
{
ipv4Address:
{
Description: The IPv4 address of this A record. ,
Required: False ,
}
string ,
}
,
]
,
aaaaRecords:
{
Description: The list of AAAA records in the record set. ,
Required: False ,
}
[
{
ipv6Address:
{
Description: The IPv6 address of this AAAA record. ,
Required: False ,
}
string ,
}
,
]
,
cnameRecord:
{
Description: The CNAME record in the record set. ,
Required: False ,
}
{
cname:
{
Description: The canonical name for this CNAME record. ,
Required: False ,
}
string ,
}
,
mxRecords:
{
Description: The list of MX records in the record set. ,
Required: False ,
}
[
{
preference:
{
Description: The preference value for this MX record. ,
Format: int32 ,
Required: False ,
}
integer ,
exchange:
{
Description: The domain name of the mail host for this MX record. ,
Required: False ,
}
string ,
}
,
]
,
ptrRecords:
{
Description: The list of PTR records in the record set. ,
Required: False ,
}
[
{
ptrdname:
{
Description: The PTR target domain name for this PTR record. ,
Required: False ,
}
string ,
}
,
]
,
soaRecord:
{
Description: The SOA record in the record set. ,
Required: False ,
}
{
host:
{
Description: The domain name of the authoritative name server for this SOA record. ,
Required: False ,
}
string ,
email:
{
Description: The email contact for this SOA record. ,
Required: False ,
}
string ,
serialNumber:
{
Description: The serial number for this SOA record. ,
Format: int64 ,
Required: False ,
}
integer ,
refreshTime:
{
Description: The refresh value for this SOA record. ,
Format: int64 ,
Required: False ,
}
integer ,
retryTime:
{
Description: The retry time for this SOA record. ,
Format: int64 ,
Required: False ,
}
integer ,
expireTime:
{
Description: The expire time for this SOA record. ,
Format: int64 ,
Required: False ,
}
integer ,
minimumTtl:
{
Description: The minimum value for this SOA record. By convention this is used to determine the negative caching duration. ,
Format: int64 ,
Required: False ,
}
integer ,
}
,
srvRecords:
{
Description: The list of SRV records in the record set. ,
Required: False ,
}
[
{
priority:
{
Description: The priority value for this SRV record. ,
Format: int32 ,
Required: False ,
}
integer ,
weight:
{
Description: The weight value for this SRV record. ,
Format: int32 ,
Required: False ,
}
integer ,
port:
{
Description: The port value for this SRV record. ,
Format: int32 ,
Required: False ,
}
integer ,
target:
{
Description: The target domain name for this SRV record. ,
Required: False ,
}
string ,
}
,
]
,
txtRecords:
{
Description: The list of TXT records in the record set. ,
Required: False ,
}
[
{
value:
{
Description: The text value of this TXT record. ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
}
,
}
,
]
,
nextLink:
{
Description: The link to the next page of items ,
Format: uri ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: Cloud error body. ,
Required: False ,
}
{
code:
{
Description: An identifier for the error. Codes are invariant and are intended to be consumed programmatically. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error, intended to be suitable for display in a user interface. ,
Required: False ,
}
string ,
target:
{
Description: The target of the particular error. For example, the name of the property in error. ,
Required: False ,
}
string ,
details:
{
Description: A list of additional details about the error. ,
Required: False ,
}
[
string ,
]
,
}
,
}
RecordSets_Get (updated)
Description :  Gets a record set.
Reference :  Link ¶

⚶ Changes

{
  "#id": "RecordSets_Get",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Gets subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The name of the resource group."
      }
    },
    {
      "#name": "privateZoneName",
      "Description": {
        "new": "The name of the DNS zone (without a terminating dot).",
        "old": "The name of the Private DNS zone (without a terminating dot)."
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "@removed_0771bbd768a5444291ce4aeaecebabe1": {
          "#name": "id",
          "Description": "The ID of the record set.",
          "Required": false,
          "Type": "string"
        },
        "@removed_3dfefd35dcb94c78ae7b474214dbb62e": {
          "#name": "name",
          "Description": "The name of the record set.",
          "Required": false,
          "Type": "string"
        },
        "@removed_d31a8b297eb543a68780d606c93f38a8": {
          "#name": "type",
          "Description": "The type of the record set.",
          "Required": false,
          "Type": "string"
        }
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateZoneName}/{recordType}/{relativeRecordSetName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
privateZoneName:
{
Description: The name of the DNS zone (without a terminating dot). ,
Required: True ,
}
string ,
recordType:
{
Description: The type of DNS record in this record set. ,
Required: True ,
}
string ,
relativeRecordSetName:
{
Description: The name of the record set, relative to the name of the zone. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: The ETag of the record set. ,
Required: False ,
}
string ,
properties:
{
Description: The properties of the record set. ,
Required: False ,
}
{
metadata:
{
Description: The metadata attached to the record set. ,
Required: False ,
}
object ,
ttl:
{
Description: The TTL (time-to-live) of the records in the record set. ,
Format: int64 ,
Required: False ,
}
integer ,
fqdn:
{
Description: Fully qualified domain name of the record set. ,
Required: False ,
}
string ,
isAutoRegistered:
{
Description: Is the record set auto-registered in the Private DNS zone through a virtual network link? ,
Required: False ,
}
boolean ,
aRecords:
{
Description: The list of A records in the record set. ,
Required: False ,
}
[
{
ipv4Address:
{
Description: The IPv4 address of this A record. ,
Required: False ,
}
string ,
}
,
]
,
aaaaRecords:
{
Description: The list of AAAA records in the record set. ,
Required: False ,
}
[
{
ipv6Address:
{
Description: The IPv6 address of this AAAA record. ,
Required: False ,
}
string ,
}
,
]
,
cnameRecord:
{
Description: The CNAME record in the record set. ,
Required: False ,
}
{
cname:
{
Description: The canonical name for this CNAME record. ,
Required: False ,
}
string ,
}
,
mxRecords:
{
Description: The list of MX records in the record set. ,
Required: False ,
}
[
{
preference:
{
Description: The preference value for this MX record. ,
Format: int32 ,
Required: False ,
}
integer ,
exchange:
{
Description: The domain name of the mail host for this MX record. ,
Required: False ,
}
string ,
}
,
]
,
ptrRecords:
{
Description: The list of PTR records in the record set. ,
Required: False ,
}
[
{
ptrdname:
{
Description: The PTR target domain name for this PTR record. ,
Required: False ,
}
string ,
}
,
]
,
soaRecord:
{
Description: The SOA record in the record set. ,
Required: False ,
}
{
host:
{
Description: The domain name of the authoritative name server for this SOA record. ,
Required: False ,
}
string ,
email:
{
Description: The email contact for this SOA record. ,
Required: False ,
}
string ,
serialNumber:
{
Description: The serial number for this SOA record. ,
Format: int64 ,
Required: False ,
}
integer ,
refreshTime:
{
Description: The refresh value for this SOA record. ,
Format: int64 ,
Required: False ,
}
integer ,
retryTime:
{
Description: The retry time for this SOA record. ,
Format: int64 ,
Required: False ,
}
integer ,
expireTime:
{
Description: The expire time for this SOA record. ,
Format: int64 ,
Required: False ,
}
integer ,
minimumTtl:
{
Description: The minimum value for this SOA record. By convention this is used to determine the negative caching duration. ,
Format: int64 ,
Required: False ,
}
integer ,
}
,
srvRecords:
{
Description: The list of SRV records in the record set. ,
Required: False ,
}
[
{
priority:
{
Description: The priority value for this SRV record. ,
Format: int32 ,
Required: False ,
}
integer ,
weight:
{
Description: The weight value for this SRV record. ,
Format: int32 ,
Required: False ,
}
integer ,
port:
{
Description: The port value for this SRV record. ,
Format: int32 ,
Required: False ,
}
integer ,
target:
{
Description: The target domain name for this SRV record. ,
Required: False ,
}
string ,
}
,
]
,
txtRecords:
{
Description: The list of TXT records in the record set. ,
Required: False ,
}
[
{
value:
{
Description: The text value of this TXT record. ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
}
,
}

⚐ Response (default)

{
error:
{
Description: Cloud error body. ,
Required: False ,
}
{
code:
{
Description: An identifier for the error. Codes are invariant and are intended to be consumed programmatically. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error, intended to be suitable for display in a user interface. ,
Required: False ,
}
string ,
target:
{
Description: The target of the particular error. For example, the name of the property in error. ,
Required: False ,
}
string ,
details:
{
Description: A list of additional details about the error. ,
Required: False ,
}
[
string ,
]
,
}
,
}
RecordSets_CreateOrUpdate (updated)
Description :  Creates or updates a record set within a Private DNS zone.
Reference :  Link ¶

⚶ Changes

{
  "#id": "RecordSets_CreateOrUpdate",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Gets subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The name of the resource group."
      }
    },
    {
      "#name": "privateZoneName",
      "Description": {
        "new": "The name of the DNS zone (without a terminating dot).",
        "old": "The name of the Private DNS zone (without a terminating dot)."
      }
    },
    {
      "#name": "recordType",
      "Description": {
        "new": "The type of DNS record in this record set.",
        "old": "The type of DNS record in this record set. Record sets of type SOA can be updated but not created (they are created when the Private DNS zone is created)."
      }
    },
    {
      "parameters": {
        "$properties": {
          "@removed_e3407284caa049d6b8f7bc39a00d03f2": {
            "#name": "id",
            "Description": "The ID of the record set.",
            "Required": false,
            "Type": "string"
          },
          "@removed_f84f47babe974339acf50b45c99021e3": {
            "#name": "name",
            "Description": "The name of the record set.",
            "Required": false,
            "Type": "string"
          },
          "@removed_473b497ae72445828f697d512d159195": {
            "#name": "type",
            "Description": "The type of the record set.",
            "Required": false,
            "Type": "string"
          }
        }
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "@removed_fa52915d9f914f53a8c258d5b66945e4": {
          "#name": "id",
          "Description": "The ID of the record set.",
          "Required": false,
          "Type": "string"
        },
        "@removed_cebee2a5bc7e4788a2d3b19825c852fb": {
          "#name": "name",
          "Description": "The name of the record set.",
          "Required": false,
          "Type": "string"
        },
        "@removed_5495613e8a5a4081bd1db2bc50310a1c": {
          "#name": "type",
          "Description": "The type of the record set.",
          "Required": false,
          "Type": "string"
        }
      }
    },
    "201": {
      "$properties": {
        "@removed_c43748a7bb7a4cd599130bdb1d089dab": {
          "#name": "id",
          "Description": "The ID of the record set.",
          "Required": false,
          "Type": "string"
        },
        "@removed_769da5629fde4c08a4b16dcd8532a30d": {
          "#name": "name",
          "Description": "The name of the record set.",
          "Required": false,
          "Type": "string"
        },
        "@removed_632bc7981fc447b38808afe0fe7fbb61": {
          "#name": "type",
          "Description": "The type of the record set.",
          "Required": false,
          "Type": "string"
        }
      }
    }
  }
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateZoneName}/{recordType}/{relativeRecordSetName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
privateZoneName:
{
Description: The name of the DNS zone (without a terminating dot). ,
Required: True ,
}
string ,
recordType:
{
Description: The type of DNS record in this record set. ,
Required: True ,
}
string ,
relativeRecordSetName:
{
Description: The name of the record set, relative to the name of the zone. ,
Required: True ,
}
string ,
If-Match:
{
Description: The ETag of the record set. Omit this value to always overwrite the current record set. Specify the last-seen ETag value to prevent accidentally overwriting any concurrent changes. ,
Required: False ,
}
string ,
If-None-Match:
{
Description: Set to '*' to allow a new record set to be created, but to prevent updating an existing record set. Other values will be ignored. ,
Required: False ,
}
string ,
parameters:
{
Description: Parameters supplied to the CreateOrUpdate operation. ,
Required: True ,
}
{
etag:
{
Description: The ETag of the record set. ,
Required: False ,
}
string ,
properties:
{
Description: The properties of the record set. ,
Required: False ,
}
{
metadata:
{
Description: The metadata attached to the record set. ,
Required: False ,
}
object ,
ttl:
{
Description: The TTL (time-to-live) of the records in the record set. ,
Format: int64 ,
Required: False ,
}
integer ,
fqdn:
{
Description: Fully qualified domain name of the record set. ,
Required: False ,
}
string ,
isAutoRegistered:
{
Description: Is the record set auto-registered in the Private DNS zone through a virtual network link? ,
Required: False ,
}
boolean ,
aRecords:
{
Description: The list of A records in the record set. ,
Required: False ,
}
[
{
ipv4Address:
{
Description: The IPv4 address of this A record. ,
Required: False ,
}
string ,
}
,
]
,
aaaaRecords:
{
Description: The list of AAAA records in the record set. ,
Required: False ,
}
[
{
ipv6Address:
{
Description: The IPv6 address of this AAAA record. ,
Required: False ,
}
string ,
}
,
]
,
cnameRecord:
{
Description: The CNAME record in the record set. ,
Required: False ,
}
{
cname:
{
Description: The canonical name for this CNAME record. ,
Required: False ,
}
string ,
}
,
mxRecords:
{
Description: The list of MX records in the record set. ,
Required: False ,
}
[
{
preference:
{
Description: The preference value for this MX record. ,
Format: int32 ,
Required: False ,
}
integer ,
exchange:
{
Description: The domain name of the mail host for this MX record. ,
Required: False ,
}
string ,
}
,
]
,
ptrRecords:
{
Description: The list of PTR records in the record set. ,
Required: False ,
}
[
{
ptrdname:
{
Description: The PTR target domain name for this PTR record. ,
Required: False ,
}
string ,
}
,
]
,
soaRecord:
{
Description: The SOA record in the record set. ,
Required: False ,
}
{
host:
{
Description: The domain name of the authoritative name server for this SOA record. ,
Required: False ,
}
string ,
email:
{
Description: The email contact for this SOA record. ,
Required: False ,
}
string ,
serialNumber:
{
Description: The serial number for this SOA record. ,
Format: int64 ,
Required: False ,
}
integer ,
refreshTime:
{
Description: The refresh value for this SOA record. ,
Format: int64 ,
Required: False ,
}
integer ,
retryTime:
{
Description: The retry time for this SOA record. ,
Format: int64 ,
Required: False ,
}
integer ,
expireTime:
{
Description: The expire time for this SOA record. ,
Format: int64 ,
Required: False ,
}
integer ,
minimumTtl:
{
Description: The minimum value for this SOA record. By convention this is used to determine the negative caching duration. ,
Format: int64 ,
Required: False ,
}
integer ,
}
,
srvRecords:
{
Description: The list of SRV records in the record set. ,
Required: False ,
}
[
{
priority:
{
Description: The priority value for this SRV record. ,
Format: int32 ,
Required: False ,
}
integer ,
weight:
{
Description: The weight value for this SRV record. ,
Format: int32 ,
Required: False ,
}
integer ,
port:
{
Description: The port value for this SRV record. ,
Format: int32 ,
Required: False ,
}
integer ,
target:
{
Description: The target domain name for this SRV record. ,
Required: False ,
}
string ,
}
,
]
,
txtRecords:
{
Description: The list of TXT records in the record set. ,
Required: False ,
}
[
{
value:
{
Description: The text value of this TXT record. ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
}
,
}
,
}

⚐ Response (200)

{
etag:
{
Description: The ETag of the record set. ,
Required: False ,
}
string ,
properties:
{
Description: The properties of the record set. ,
Required: False ,
}
{
metadata:
{
Description: The metadata attached to the record set. ,
Required: False ,
}
object ,
ttl:
{
Description: The TTL (time-to-live) of the records in the record set. ,
Format: int64 ,
Required: False ,
}
integer ,
fqdn:
{
Description: Fully qualified domain name of the record set. ,
Required: False ,
}
string ,
isAutoRegistered:
{
Description: Is the record set auto-registered in the Private DNS zone through a virtual network link? ,
Required: False ,
}
boolean ,
aRecords:
{
Description: The list of A records in the record set. ,
Required: False ,
}
[
{
ipv4Address:
{
Description: The IPv4 address of this A record. ,
Required: False ,
}
string ,
}
,
]
,
aaaaRecords:
{
Description: The list of AAAA records in the record set. ,
Required: False ,
}
[
{
ipv6Address:
{
Description: The IPv6 address of this AAAA record. ,
Required: False ,
}
string ,
}
,
]
,
cnameRecord:
{
Description: The CNAME record in the record set. ,
Required: False ,
}
{
cname:
{
Description: The canonical name for this CNAME record. ,
Required: False ,
}
string ,
}
,
mxRecords:
{
Description: The list of MX records in the record set. ,
Required: False ,
}
[
{
preference:
{
Description: The preference value for this MX record. ,
Format: int32 ,
Required: False ,
}
integer ,
exchange:
{
Description: The domain name of the mail host for this MX record. ,
Required: False ,
}
string ,
}
,
]
,
ptrRecords:
{
Description: The list of PTR records in the record set. ,
Required: False ,
}
[
{
ptrdname:
{
Description: The PTR target domain name for this PTR record. ,
Required: False ,
}
string ,
}
,
]
,
soaRecord:
{
Description: The SOA record in the record set. ,
Required: False ,
}
{
host:
{
Description: The domain name of the authoritative name server for this SOA record. ,
Required: False ,
}
string ,
email:
{
Description: The email contact for this SOA record. ,
Required: False ,
}
string ,
serialNumber:
{
Description: The serial number for this SOA record. ,
Format: int64 ,
Required: False ,
}
integer ,
refreshTime:
{
Description: The refresh value for this SOA record. ,
Format: int64 ,
Required: False ,
}
integer ,
retryTime:
{
Description: The retry time for this SOA record. ,
Format: int64 ,
Required: False ,
}
integer ,
expireTime:
{
Description: The expire time for this SOA record. ,
Format: int64 ,
Required: False ,
}
integer ,
minimumTtl:
{
Description: The minimum value for this SOA record. By convention this is used to determine the negative caching duration. ,
Format: int64 ,
Required: False ,
}
integer ,
}
,
srvRecords:
{
Description: The list of SRV records in the record set. ,
Required: False ,
}
[
{
priority:
{
Description: The priority value for this SRV record. ,
Format: int32 ,
Required: False ,
}
integer ,
weight:
{
Description: The weight value for this SRV record. ,
Format: int32 ,
Required: False ,
}
integer ,
port:
{
Description: The port value for this SRV record. ,
Format: int32 ,
Required: False ,
}
integer ,
target:
{
Description: The target domain name for this SRV record. ,
Required: False ,
}
string ,
}
,
]
,
txtRecords:
{
Description: The list of TXT records in the record set. ,
Required: False ,
}
[
{
value:
{
Description: The text value of this TXT record. ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
}
,
}

⚐ Response (201)

{
etag:
{
Description: The ETag of the record set. ,
Required: False ,
}
string ,
properties:
{
Description: The properties of the record set. ,
Required: False ,
}
{
metadata:
{
Description: The metadata attached to the record set. ,
Required: False ,
}
object ,
ttl:
{
Description: The TTL (time-to-live) of the records in the record set. ,
Format: int64 ,
Required: False ,
}
integer ,
fqdn:
{
Description: Fully qualified domain name of the record set. ,
Required: False ,
}
string ,
isAutoRegistered:
{
Description: Is the record set auto-registered in the Private DNS zone through a virtual network link? ,
Required: False ,
}
boolean ,
aRecords:
{
Description: The list of A records in the record set. ,
Required: False ,
}
[
{
ipv4Address:
{
Description: The IPv4 address of this A record. ,
Required: False ,
}
string ,
}
,
]
,
aaaaRecords:
{
Description: The list of AAAA records in the record set. ,
Required: False ,
}
[
{
ipv6Address:
{
Description: The IPv6 address of this AAAA record. ,
Required: False ,
}
string ,
}
,
]
,
cnameRecord:
{
Description: The CNAME record in the record set. ,
Required: False ,
}
{
cname:
{
Description: The canonical name for this CNAME record. ,
Required: False ,
}
string ,
}
,
mxRecords:
{
Description: The list of MX records in the record set. ,
Required: False ,
}
[
{
preference:
{
Description: The preference value for this MX record. ,
Format: int32 ,
Required: False ,
}
integer ,
exchange:
{
Description: The domain name of the mail host for this MX record. ,
Required: False ,
}
string ,
}
,
]
,
ptrRecords:
{
Description: The list of PTR records in the record set. ,
Required: False ,
}
[
{
ptrdname:
{
Description: The PTR target domain name for this PTR record. ,
Required: False ,
}
string ,
}
,
]
,
soaRecord:
{
Description: The SOA record in the record set. ,
Required: False ,
}
{
host:
{
Description: The domain name of the authoritative name server for this SOA record. ,
Required: False ,
}
string ,
email:
{
Description: The email contact for this SOA record. ,
Required: False ,
}
string ,
serialNumber:
{
Description: The serial number for this SOA record. ,
Format: int64 ,
Required: False ,
}
integer ,
refreshTime:
{
Description: The refresh value for this SOA record. ,
Format: int64 ,
Required: False ,
}
integer ,
retryTime:
{
Description: The retry time for this SOA record. ,
Format: int64 ,
Required: False ,
}
integer ,
expireTime:
{
Description: The expire time for this SOA record. ,
Format: int64 ,
Required: False ,
}
integer ,
minimumTtl:
{
Description: The minimum value for this SOA record. By convention this is used to determine the negative caching duration. ,
Format: int64 ,
Required: False ,
}
integer ,
}
,
srvRecords:
{
Description: The list of SRV records in the record set. ,
Required: False ,
}
[
{
priority:
{
Description: The priority value for this SRV record. ,
Format: int32 ,
Required: False ,
}
integer ,
weight:
{
Description: The weight value for this SRV record. ,
Format: int32 ,
Required: False ,
}
integer ,
port:
{
Description: The port value for this SRV record. ,
Format: int32 ,
Required: False ,
}
integer ,
target:
{
Description: The target domain name for this SRV record. ,
Required: False ,
}
string ,
}
,
]
,
txtRecords:
{
Description: The list of TXT records in the record set. ,
Required: False ,
}
[
{
value:
{
Description: The text value of this TXT record. ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
}
,
}

⚐ Response (default)

{
error:
{
Description: Cloud error body. ,
Required: False ,
}
{
code:
{
Description: An identifier for the error. Codes are invariant and are intended to be consumed programmatically. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error, intended to be suitable for display in a user interface. ,
Required: False ,
}
string ,
target:
{
Description: The target of the particular error. For example, the name of the property in error. ,
Required: False ,
}
string ,
details:
{
Description: A list of additional details about the error. ,
Required: False ,
}
[
string ,
]
,
}
,
}
RecordSets_Update (updated)
Description :  Updates a record set within a Private DNS zone.
Reference :  Link ¶

⚶ Changes

{
  "#id": "RecordSets_Update",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Gets subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The name of the resource group."
      }
    },
    {
      "#name": "privateZoneName",
      "Description": {
        "new": "The name of the DNS zone (without a terminating dot).",
        "old": "The name of the Private DNS zone (without a terminating dot)."
      }
    },
    {
      "parameters": {
        "$properties": {
          "@removed_02a92f3022654f7798331a2076793d9c": {
            "#name": "id",
            "Description": "The ID of the record set.",
            "Required": false,
            "Type": "string"
          },
          "@removed_f8a19db7bf134e1cb9644411f968ab03": {
            "#name": "name",
            "Description": "The name of the record set.",
            "Required": false,
            "Type": "string"
          },
          "@removed_aab488eb0fda4363a7d1554f3d7ef4aa": {
            "#name": "type",
            "Description": "The type of the record set.",
            "Required": false,
            "Type": "string"
          }
        }
      }
    }
  ],
  "$responses": {
    "200": {
      "$properties": {
        "@removed_96697e441c7141a3b8183457dbf64c7f": {
          "#name": "id",
          "Description": "The ID of the record set.",
          "Required": false,
          "Type": "string"
        },
        "@removed_b33f59ff8c99482a960f99be7ae8f131": {
          "#name": "name",
          "Description": "The name of the record set.",
          "Required": false,
          "Type": "string"
        },
        "@removed_45afd8bc962a4f41af499aeabf9a4960": {
          "#name": "type",
          "Description": "The type of the record set.",
          "Required": false,
          "Type": "string"
        }
      }
    }
  }
}

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateZoneName}/{recordType}/{relativeRecordSetName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
privateZoneName:
{
Description: The name of the DNS zone (without a terminating dot). ,
Required: True ,
}
string ,
recordType:
{
Description: The type of DNS record in this record set. ,
Required: True ,
}
string ,
relativeRecordSetName:
{
Description: The name of the record set, relative to the name of the zone. ,
Required: True ,
}
string ,
If-Match:
{
Description: The ETag of the record set. Omit this value to always overwrite the current record set. Specify the last-seen ETag value to prevent accidentally overwriting concurrent changes. ,
Required: False ,
}
string ,
parameters:
{
Description: Parameters supplied to the Update operation. ,
Required: True ,
}
{
etag:
{
Description: The ETag of the record set. ,
Required: False ,
}
string ,
properties:
{
Description: The properties of the record set. ,
Required: False ,
}
{
metadata:
{
Description: The metadata attached to the record set. ,
Required: False ,
}
object ,
ttl:
{
Description: The TTL (time-to-live) of the records in the record set. ,
Format: int64 ,
Required: False ,
}
integer ,
fqdn:
{
Description: Fully qualified domain name of the record set. ,
Required: False ,
}
string ,
isAutoRegistered:
{
Description: Is the record set auto-registered in the Private DNS zone through a virtual network link? ,
Required: False ,
}
boolean ,
aRecords:
{
Description: The list of A records in the record set. ,
Required: False ,
}
[
{
ipv4Address:
{
Description: The IPv4 address of this A record. ,
Required: False ,
}
string ,
}
,
]
,
aaaaRecords:
{
Description: The list of AAAA records in the record set. ,
Required: False ,
}
[
{
ipv6Address:
{
Description: The IPv6 address of this AAAA record. ,
Required: False ,
}
string ,
}
,
]
,
cnameRecord:
{
Description: The CNAME record in the record set. ,
Required: False ,
}
{
cname:
{
Description: The canonical name for this CNAME record. ,
Required: False ,
}
string ,
}
,
mxRecords:
{
Description: The list of MX records in the record set. ,
Required: False ,
}
[
{
preference:
{
Description: The preference value for this MX record. ,
Format: int32 ,
Required: False ,
}
integer ,
exchange:
{
Description: The domain name of the mail host for this MX record. ,
Required: False ,
}
string ,
}
,
]
,
ptrRecords:
{
Description: The list of PTR records in the record set. ,
Required: False ,
}
[
{
ptrdname:
{
Description: The PTR target domain name for this PTR record. ,
Required: False ,
}
string ,
}
,
]
,
soaRecord:
{
Description: The SOA record in the record set. ,
Required: False ,
}
{
host:
{
Description: The domain name of the authoritative name server for this SOA record. ,
Required: False ,
}
string ,
email:
{
Description: The email contact for this SOA record. ,
Required: False ,
}
string ,
serialNumber:
{
Description: The serial number for this SOA record. ,
Format: int64 ,
Required: False ,
}
integer ,
refreshTime:
{
Description: The refresh value for this SOA record. ,
Format: int64 ,
Required: False ,
}
integer ,
retryTime:
{
Description: The retry time for this SOA record. ,
Format: int64 ,
Required: False ,
}
integer ,
expireTime:
{
Description: The expire time for this SOA record. ,
Format: int64 ,
Required: False ,
}
integer ,
minimumTtl:
{
Description: The minimum value for this SOA record. By convention this is used to determine the negative caching duration. ,
Format: int64 ,
Required: False ,
}
integer ,
}
,
srvRecords:
{
Description: The list of SRV records in the record set. ,
Required: False ,
}
[
{
priority:
{
Description: The priority value for this SRV record. ,
Format: int32 ,
Required: False ,
}
integer ,
weight:
{
Description: The weight value for this SRV record. ,
Format: int32 ,
Required: False ,
}
integer ,
port:
{
Description: The port value for this SRV record. ,
Format: int32 ,
Required: False ,
}
integer ,
target:
{
Description: The target domain name for this SRV record. ,
Required: False ,
}
string ,
}
,
]
,
txtRecords:
{
Description: The list of TXT records in the record set. ,
Required: False ,
}
[
{
value:
{
Description: The text value of this TXT record. ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
}
,
}
,
}

⚐ Response (200)

{
etag:
{
Description: The ETag of the record set. ,
Required: False ,
}
string ,
properties:
{
Description: The properties of the record set. ,
Required: False ,
}
{
metadata:
{
Description: The metadata attached to the record set. ,
Required: False ,
}
object ,
ttl:
{
Description: The TTL (time-to-live) of the records in the record set. ,
Format: int64 ,
Required: False ,
}
integer ,
fqdn:
{
Description: Fully qualified domain name of the record set. ,
Required: False ,
}
string ,
isAutoRegistered:
{
Description: Is the record set auto-registered in the Private DNS zone through a virtual network link? ,
Required: False ,
}
boolean ,
aRecords:
{
Description: The list of A records in the record set. ,
Required: False ,
}
[
{
ipv4Address:
{
Description: The IPv4 address of this A record. ,
Required: False ,
}
string ,
}
,
]
,
aaaaRecords:
{
Description: The list of AAAA records in the record set. ,
Required: False ,
}
[
{
ipv6Address:
{
Description: The IPv6 address of this AAAA record. ,
Required: False ,
}
string ,
}
,
]
,
cnameRecord:
{
Description: The CNAME record in the record set. ,
Required: False ,
}
{
cname:
{
Description: The canonical name for this CNAME record. ,
Required: False ,
}
string ,
}
,
mxRecords:
{
Description: The list of MX records in the record set. ,
Required: False ,
}
[
{
preference:
{
Description: The preference value for this MX record. ,
Format: int32 ,
Required: False ,
}
integer ,
exchange:
{
Description: The domain name of the mail host for this MX record. ,
Required: False ,
}
string ,
}
,
]
,
ptrRecords:
{
Description: The list of PTR records in the record set. ,
Required: False ,
}
[
{
ptrdname:
{
Description: The PTR target domain name for this PTR record. ,
Required: False ,
}
string ,
}
,
]
,
soaRecord:
{
Description: The SOA record in the record set. ,
Required: False ,
}
{
host:
{
Description: The domain name of the authoritative name server for this SOA record. ,
Required: False ,
}
string ,
email:
{
Description: The email contact for this SOA record. ,
Required: False ,
}
string ,
serialNumber:
{
Description: The serial number for this SOA record. ,
Format: int64 ,
Required: False ,
}
integer ,
refreshTime:
{
Description: The refresh value for this SOA record. ,
Format: int64 ,
Required: False ,
}
integer ,
retryTime:
{
Description: The retry time for this SOA record. ,
Format: int64 ,
Required: False ,
}
integer ,
expireTime:
{
Description: The expire time for this SOA record. ,
Format: int64 ,
Required: False ,
}
integer ,
minimumTtl:
{
Description: The minimum value for this SOA record. By convention this is used to determine the negative caching duration. ,
Format: int64 ,
Required: False ,
}
integer ,
}
,
srvRecords:
{
Description: The list of SRV records in the record set. ,
Required: False ,
}
[
{
priority:
{
Description: The priority value for this SRV record. ,
Format: int32 ,
Required: False ,
}
integer ,
weight:
{
Description: The weight value for this SRV record. ,
Format: int32 ,
Required: False ,
}
integer ,
port:
{
Description: The port value for this SRV record. ,
Format: int32 ,
Required: False ,
}
integer ,
target:
{
Description: The target domain name for this SRV record. ,
Required: False ,
}
string ,
}
,
]
,
txtRecords:
{
Description: The list of TXT records in the record set. ,
Required: False ,
}
[
{
value:
{
Description: The text value of this TXT record. ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
}
,
}

⚐ Response (default)

{
error:
{
Description: Cloud error body. ,
Required: False ,
}
{
code:
{
Description: An identifier for the error. Codes are invariant and are intended to be consumed programmatically. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error, intended to be suitable for display in a user interface. ,
Required: False ,
}
string ,
target:
{
Description: The target of the particular error. For example, the name of the property in error. ,
Required: False ,
}
string ,
details:
{
Description: A list of additional details about the error. ,
Required: False ,
}
[
string ,
]
,
}
,
}
RecordSets_Delete (updated)
Description :  Deletes a record set from a Private DNS zone. This operation cannot be undone.
Reference :  Link ¶

⚶ Changes

{
  "#id": "RecordSets_Delete",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Client Api Version."
      }
    },
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription.",
        "old": "Gets subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call."
      }
    },
    {
      "#name": "resourceGroupName",
      "Description": {
        "new": "The name of the resource group. The name is case insensitive.",
        "old": "The name of the resource group."
      }
    },
    {
      "#name": "privateZoneName",
      "Description": {
        "new": "The name of the DNS zone (without a terminating dot).",
        "old": "The name of the Private DNS zone (without a terminating dot)."
      }
    },
    {
      "#name": "recordType",
      "Description": {
        "new": "The type of DNS record in this record set.",
        "old": "The type of DNS record in this record set. Record sets of type SOA cannot be deleted (they are deleted when the Private DNS zone is deleted)."
      }
    }
  ]
}

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateZoneName}/{recordType}/{relativeRecordSetName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
privateZoneName:
{
Description: The name of the DNS zone (without a terminating dot). ,
Required: True ,
}
string ,
recordType:
{
Description: The type of DNS record in this record set. ,
Required: True ,
}
string ,
relativeRecordSetName:
{
Description: The name of the record set, relative to the name of the zone. ,
Required: True ,
}
string ,
If-Match:
{
Description: The ETag of the record set. Omit this value to always delete the current record set. Specify the last-seen ETag value to prevent accidentally deleting any concurrent changes. ,
Required: False ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: Cloud error body. ,
Required: False ,
}
{
code:
{
Description: An identifier for the error. Codes are invariant and are intended to be consumed programmatically. ,
Required: False ,
}
string ,
message:
{
Description: A message describing the error, intended to be suitable for display in a user interface. ,
Required: False ,
}
string ,
target:
{
Description: The target of the particular error. For example, the name of the property in error. ,
Required: False ,
}
string ,
details:
{
Description: A list of additional details about the error. ,
Required: False ,
}
[
string ,
]
,
}
,
}