Dns Forwarding Rulesets - List By Virtual Network

服务:

DNS

API 版本:

2025-05-01

列出附加到虚拟网络的 DNS 转发规则集资源 ID。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/listDnsForwardingRulesets?api-version=2025-05-01

具有可选参数:

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/listDnsForwardingRulesets?api-version=2025-05-01&$top={$top}

URI 参数

名称	在	必需	类型	说明
resourceGroupName	path	True	string minLength: 1 maxLength: 90	资源组的名称。 此名称不区分大小写。
subscriptionId	path	True	string (uuid)	目标订阅的 ID。 该值必须是 UUID。
virtualNetworkName	path	True	string	VirtualNetwork 的名称
api-version	query	True	string minLength: 1	要用于此操作的 API 版本。
$top	query		integer (int32)	要返回的最大结果数。 如果未指定，则最多返回 100 个结果。

响应

名称	类型	说明
200 OK	VirtualNetworkDnsForwardingRulesetListResult	Azure作已成功完成。
Other Status Codes	CloudError	意外错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流。

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

List DNS forwarding rulesets by virtual network

示例请求

HTTP

POST https://management.azure.com/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/virtualNetworks/sampleVirtualNetwork/listDnsForwardingRulesets?api-version=2025-05-01

示例响应

状态代码:

200

{
  "nextLink": null,
  "value": [
    {
      "id": "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsForwardingRulesets/sampleDnsForwardingRuleset",
      "properties": {
        "virtualNetworkLink": {
          "id": "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsForwardingRuleset/sampleDnsForwardingRuleset/virtualNetworkLinks/sampleVirtualNetworkLink"
        }
      }
    }
  ]
}

定义

名称	说明
CloudError	错误消息
CloudErrorBody	错误消息的正文
SubResource	对另一个 ARM 资源的引用。
VirtualNetworkDnsForwardingRuleset	对 DNS 转发规则集和关联的虚拟网络链接的引用。
VirtualNetworkDnsForwardingRulesetListResult	对虚拟网络 DNS 转发规则集上的枚举作的响应。

CloudError

Object

错误消息

名称	类型	说明
error	CloudErrorBody	错误消息正文

CloudErrorBody

Object

错误消息的正文

名称	类型	说明
code	string	错误代码
details	CloudErrorBody[]	额外的错误信息
message	string	导致错误的原因的说明
target	string	错误消息的目标资源

SubResource

Object

对另一个 ARM 资源的引用。

名称	类型	说明
id	string	资源 ID。

VirtualNetworkDnsForwardingRuleset

Object

对 DNS 转发规则集和关联的虚拟网络链接的引用。

名称	类型	说明
id	string	DNS 转发规则集资源 ID。
properties.virtualNetworkLink	SubResource	对虚拟网络链接的引用。

VirtualNetworkDnsForwardingRulesetListResult

Object

对虚拟网络 DNS 转发规则集上的枚举作的响应。

名称	类型	说明
nextLink	string (uri)	指向下一页项目的链接
value	VirtualNetworkDnsForwardingRuleset[]	此页上的 VirtualNetworkDnsForwardingRuleset 项