Private Dns Zone Groups - List
Gets all private dns zone groups in a private endpoint.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateEndpoints/{privateEndpointName}/privateDnsZoneGroups?api-version=2023-09-01
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
private
|
path | True |
string |
The name of the private endpoint. |
resource
|
path | True |
string |
The name of the resource group. |
subscription
|
path | True |
string |
The subscription credentials which uniquely identify the Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. |
api-version
|
query | True |
string |
Client API version. |
Responses
Name | Type | Description |
---|---|---|
200 OK |
Request successful. The operation returns a list of private dns zone group resources. |
|
Other Status Codes |
Error. |
Security
azure_auth
Azure Active Directory OAuth2 Flow.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | impersonate your user account |
Examples
List private endpoints in resource group
Sample Request
Sample Response
{
"value": [
{
"name": "testPdnsgroup1",
"id": "/subscriptions/subId/resourceGroups/rg1/providers/Microsoft.Network/privateLinkServices/testPe/privateDnsZoneGroups/testPdnsgroup1",
"properties": {
"provisioningState": "Succeeded",
"privateDnsZoneConfigs": [
{
"properties": {
"privateDnsZoneId": "/subscriptions/subId/resourceGroups/rg1/providers/Microsoft.Network/privateDnsZones/zone1.com",
"recordSets": [
{
"recordType": "A",
"recordSetName": "abc",
"fqdn": "abc.zone1.com",
"ipAddresses": [
"10.0.0.4"
]
},
{
"recordType": "A",
"recordSetName": "abc2",
"fqdn": "abc2.zone1.com",
"ipAddresses": [
"10.0.0.5"
]
}
]
}
}
]
}
},
{
"name": "testPdnsgroup2",
"id": "/subscriptions/subId/resourceGroups/rg1/providers/Microsoft.Network/privateLinkServices/testPe/privateDnsZoneGroups/testPdnsgroup2",
"properties": {
"provisioningState": "Succeeded",
"privateDnsZoneConfigs": [
{
"properties": {
"privateDnsZoneId": "/subscriptions/subId/resourceGroups/rg1/providers/Microsoft.Network/privateDnsZones/zone2.com",
"recordSets": [
{
"recordType": "A",
"recordSetName": "abc3",
"fqdn": "abc3.zone2.com",
"ipAddresses": [
"10.0.0.6"
]
},
{
"recordType": "A",
"recordSetName": "abc4",
"fqdn": "abc4.zone2.com",
"ipAddresses": [
"10.0.0.7"
]
}
]
}
}
]
}
}
]
}
Definitions
Name | Description |
---|---|
Error |
Common error representation. |
Error |
Common error details representation. |
Private |
PrivateDnsZoneConfig resource. |
Private |
Private dns zone group resource. |
Private |
Response for the ListPrivateDnsZoneGroups API service call. |
Provisioning |
The current provisioning state. |
Record |
A collective group of information about the record set information. |
Error
Common error representation.
Name | Type | Description |
---|---|---|
code |
string |
Error code. |
details |
Error details. |
|
innerError |
string |
Inner error message. |
message |
string |
Error message. |
target |
string |
Error target. |
ErrorDetails
Common error details representation.
Name | Type | Description |
---|---|---|
code |
string |
Error code. |
message |
string |
Error message. |
target |
string |
Error target. |
PrivateDnsZoneConfig
PrivateDnsZoneConfig resource.
Name | Type | Description |
---|---|---|
name |
string |
Name of the resource that is unique within a resource group. This name can be used to access the resource. |
properties.privateDnsZoneId |
string |
The resource id of the private dns zone. |
properties.recordSets |
A collection of information regarding a recordSet, holding information to identify private resources. |
PrivateDnsZoneGroup
Private dns zone group resource.
Name | Type | Description |
---|---|---|
etag |
string |
A unique read-only string that changes whenever the resource is updated. |
id |
string |
Resource ID. |
name |
string |
Name of the resource that is unique within a resource group. This name can be used to access the resource. |
properties.privateDnsZoneConfigs |
A collection of private dns zone configurations of the private dns zone group. |
|
properties.provisioningState |
The provisioning state of the private dns zone group resource. |
PrivateDnsZoneGroupListResult
Response for the ListPrivateDnsZoneGroups API service call.
Name | Type | Description |
---|---|---|
nextLink |
string |
The URL to get the next set of results. |
value |
A list of private dns zone group resources in a private endpoint. |
ProvisioningState
The current provisioning state.
Name | Type | Description |
---|---|---|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
RecordSet
A collective group of information about the record set information.
Name | Type | Description |
---|---|---|
fqdn |
string |
Fqdn that resolves to private endpoint ip address. |
ipAddresses |
string[] |
The private ip address of the private endpoint. |
provisioningState |
The provisioning state of the recordset. |
|
recordSetName |
string |
Recordset name. |
recordType |
string |
Resource record type. |
ttl |
integer |
Recordset time to live. |