你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Record Sets - List All By Dns Zone
Lists DNS 区域中的所有记录集。
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/all?api-version=2018-05-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/all?$top={$top}&$recordsetnamesuffix={$recordsetnamesuffix}&api-version=2018-05-01
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
resource
|
path | True |
string |
资源组的名称。 |
subscription
|
path | True |
string |
指定唯一标识 Microsoft Azure 订阅的 Azure 订阅 ID。 |
zone
|
path | True |
string |
不带终止点) (DNS 区域的名称。 |
api-version
|
query | True |
string |
指定 API 版本。 |
$recordsetnamesuffix
|
query |
string |
必须用于筛选记录集枚举的记录集名称的后缀标签。 如果指定此参数,枚举将仅返回以 结尾的记录。 |
|
$top
|
query |
integer int32 |
要返回的最大记录集数。 如果未指定,则最多返回 100 个记录集。 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
成功。 |
|
Other Status Codes |
默认响应。 它将根据错误定义进行反序列化。 |
示例
List recordsets by zone
Sample Request
GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/all?api-version=2018-05-01
Sample Response
{
"nextLink": "https://servicehost/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/CAA?api-version=2018-05-01&$skipToken=skipToken",
"value": [
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/CAA/record1",
"etag": "00000000-0000-0000-0000-000000000000",
"name": "record1",
"type": "Microsoft.Network/dnsZones/CAA",
"properties": {
"metadata": {
"key1": "value1"
},
"TTL": 3600,
"fqdn": "record1.zone1",
"caaRecords": [
{
"flags": 0,
"tag": "issue",
"value": "ca.contoso.com"
}
]
}
},
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/A/record1",
"etag": "00000000-0000-0000-0000-000000000000",
"name": "record1",
"type": "Microsoft.Network/dnsZones/A",
"properties": {
"metadata": {
"key1": "value1"
},
"TTL": 3600,
"fqdn": "record1.zone1",
"ARecords": [
{
"ipv4Address": "127.0.0.1"
}
]
}
},
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/CNAME/record2",
"etag": "00000000-0000-0000-0000-000000000000",
"name": "record2",
"type": "Microsoft.Network/dnsZones/CNAME",
"properties": {
"metadata": {
"key1": "value1"
},
"TTL": 3600,
"fqdn": "record2.zone1",
"CNAMERecord": {
"cname": "contoso.com"
}
}
}
]
}
定义
名称 | 说明 |
---|---|
Aaaa |
AAAA 记录。 |
ARecord |
A 记录。 |
Caa |
CAA 记录。 |
Cloud |
来自服务的错误响应。 |
Cloud |
来自服务的错误响应。 |
Cname |
CNAME 记录。 |
Mx |
MX 记录。 |
Ns |
NS 记录。 |
Ptr |
PTR 记录。 |
Record |
描述 (具有相同名称和类型) 的 DNS 记录集合的 DNS 记录集。 |
Record |
对记录集列表操作的响应。 |
Soa |
SOA 记录。 |
Srv |
SRV 记录。 |
Sub |
对另一个资源的引用 |
Txt |
TXT 记录。 |
AaaaRecord
AAAA 记录。
名称 | 类型 | 说明 |
---|---|---|
ipv6Address |
string |
此 AAAA 记录的 IPv6 地址。 |
ARecord
A 记录。
名称 | 类型 | 说明 |
---|---|---|
ipv4Address |
string |
此 A 记录的 IPv4 地址。 |
CaaRecord
CAA 记录。
名称 | 类型 | 说明 |
---|---|---|
flags |
integer |
此 CAA 记录的标志为介于 0 和 255 之间的整数。 |
tag |
string |
此 CAA 记录的标记。 |
value |
string |
此 CAA 记录的值。 |
CloudError
来自服务的错误响应。
名称 | 类型 | 说明 |
---|---|---|
error |
云错误正文。 |
CloudErrorBody
来自服务的错误响应。
名称 | 类型 | 说明 |
---|---|---|
code |
string |
错误的标识符。 代码是固定的,旨在以编程方式使用。 |
details |
有关错误的其他详细信息的列表。 |
|
message |
string |
描述错误的消息,该消息适用于在用户界面中显示。 |
target |
string |
特定错误的目标。 例如,属性的名称出错。 |
CnameRecord
CNAME 记录。
名称 | 类型 | 说明 |
---|---|---|
cname |
string |
此 CNAME 记录的规范名称。 |
MxRecord
MX 记录。
名称 | 类型 | 说明 |
---|---|---|
exchange |
string |
此 MX 记录的邮件主机的域名。 |
preference |
integer |
此 MX 记录的首选项值。 |
NsRecord
NS 记录。
名称 | 类型 | 说明 |
---|---|---|
nsdname |
string |
此 NS 记录的名称服务器名称。 |
PtrRecord
PTR 记录。
名称 | 类型 | 说明 |
---|---|---|
ptrdname |
string |
此 PTR 记录的 PTR 目标域名。 |
RecordSet
描述 (具有相同名称和类型) 的 DNS 记录集合的 DNS 记录集。
名称 | 类型 | 说明 |
---|---|---|
etag |
string |
记录集的 etag。 |
id |
string |
记录集的 ID。 |
name |
string |
记录集的名称。 |
properties.AAAARecords |
记录集中 AAAA 记录的列表。 |
|
properties.ARecords |
ARecord[] |
记录集中 A 记录的列表。 |
properties.CNAMERecord |
记录集中的 CNAME 记录。 |
|
properties.MXRecords |
Mx |
记录集中 MX 记录的列表。 |
properties.NSRecords |
Ns |
记录集中 NS 记录的列表。 |
properties.PTRRecords |
记录集中 PTR 记录的列表。 |
|
properties.SOARecord |
记录集中的 SOA 记录。 |
|
properties.SRVRecords |
记录集中 SRV 记录的列表。 |
|
properties.TTL |
integer |
TTL (记录集中记录的生存时间) 。 |
properties.TXTRecords |
记录集中 TXT 记录的列表。 |
|
properties.caaRecords |
记录集中 CAA 记录的列表。 |
|
properties.fqdn |
string |
记录集的完全限定域名。 |
properties.metadata |
object |
附加到记录集的元数据。 |
properties.provisioningState |
string |
记录集的预配状态。 |
properties.targetResource |
对从中获取 dns 资源值的 Azure 资源的引用。 |
|
type |
string |
记录集的类型。 |
RecordSetListResult
对记录集列表操作的响应。
名称 | 类型 | 说明 |
---|---|---|
nextLink |
string |
下一页结果的继续标记。 |
value |
有关响应中的记录集的信息。 |
SoaRecord
SOA 记录。
名称 | 类型 | 说明 |
---|---|---|
string |
此 SOA 记录的电子邮件联系人。 |
|
expireTime |
integer |
此 SOA 记录的过期时间。 |
host |
string |
此 SOA 记录的权威名称服务器的域名。 |
minimumTTL |
integer |
此 SOA 记录的最小值。 按照约定,这用于确定负缓存持续时间。 |
refreshTime |
integer |
此 SOA 记录的刷新值。 |
retryTime |
integer |
此 SOA 记录的重试时间。 |
serialNumber |
integer |
此 SOA 记录的序列号。 |
SrvRecord
SRV 记录。
名称 | 类型 | 说明 |
---|---|---|
port |
integer |
此 SRV 记录的端口值。 |
priority |
integer |
此 SRV 记录的优先级值。 |
target |
string |
此 SRV 记录的目标域名。 |
weight |
integer |
此 SRV 记录的权重值。 |
SubResource
对另一个资源的引用
名称 | 类型 | 说明 |
---|---|---|
id |
string |
资源 ID。 |
TxtRecord
TXT 记录。
名称 | 类型 | 说明 |
---|---|---|
value |
string[] |
此 TXT 记录的文本值。 |