Dns Forwarding Rulesets - List

Service:: DNS

API-versie:: 2025-05-01

Een lijst met regelsets voor DNS-doorsturen in alle resourcegroepen van een abonnement.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Network/dnsForwardingRulesets?api-version=2025-05-01

Met optionele parameters:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Network/dnsForwardingRulesets?api-version=2025-05-01&$top={$top}

URI-parameters

Name	In	Vereist	Type	Description
subscriptionId	path	True	string (uuid)	De id van het doelabonnement. De waarde moet een UUID zijn.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.
$top	query		integer (int32)	Het maximum aantal resultaten dat moet worden geretourneerd. Als dit niet is opgegeven, worden maximaal 100 resultaten geretourneerd.

Antwoorden

Name	Type	Description
200 OK	DnsForwardingRulesetListResult	Azure-bewerking is voltooid.
Other Status Codes	CloudError	Een onverwachte foutreactie.

Beveiliging

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

List DNS forwarding rulesets by subscription

Voorbeeldaanvraag

HTTP

GET https://management.azure.com/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/providers/Microsoft.Network/dnsForwardingRulesets?api-version=2025-05-01

Voorbeeldrespons

Statuscode:: 200

{
  "nextLink": "https://management.azure.com/api/mresolver/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/providers/Microsoft.Network/dnsForwardingRulesets?$skipToken=skipToken&api-version=2025-05-01",
  "value": [
    {
      "name": "sampleDnsForwardingRuleset",
      "type": "Microsoft.Network/dnsForwardingRulesets",
      "etag": "00000000-0000-0000-0000-000000000000",
      "id": "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsForwardingRulesets/sampleDnsForwardingRuleset",
      "location": "westus2",
      "properties": {
        "dnsResolverOutboundEndpoints": [
          {
            "id": "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsResolvers/sampleDnsResolver/outboundEndpoints/sampleOutboundEndpoint0"
          },
          {
            "id": "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsResolvers/sampleDnsResolver/outboundEndpoints/sampleOutboundEndpoint1"
          }
        ],
        "provisioningState": "Succeeded",
        "resourceGuid": "a7e1a32c-498c-401c-a805-5bc3518257b8"
      },
      "systemData": {
        "createdAt": "2021-04-03T01:01:01.1075056Z",
        "createdByType": "Application",
        "lastModifiedAt": "2021-04-04T02:03:01.1974346Z",
        "lastModifiedByType": "Application"
      },
      "tags": {
        "key1": "value1"
      }
    },
    {
      "name": "sampleDnsForwardingRuleset",
      "type": "Microsoft.Network/dnsForwardingRulesets",
      "etag": "00000000-0000-0000-0000-000000000000",
      "id": "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsForwardingRulesets/sampleDnsForwardingRuleset1",
      "location": "westus2",
      "properties": {
        "dnsResolverOutboundEndpoints": [
          {
            "id": "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsResolvers/sampleDnsResolver/outboundEndpoints/sampleOutboundEndpoint2"
          },
          {
            "id": "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsResolvers/sampleDnsResolver/outboundEndpoints/sampleOutboundEndpoint3"
          }
        ],
        "provisioningState": "Succeeded",
        "resourceGuid": "a7e1a32c-498c-401c-a805-5bc3518257b8"
      },
      "systemData": {
        "createdAt": "2021-04-04T01:01:01.1075056Z",
        "createdByType": "Application",
        "lastModifiedAt": "2021-04-05T02:03:01.1974346Z",
        "lastModifiedByType": "Application"
      },
      "tags": {
        "key1": "value1"
      }
    }
  ]
}

Definities

Name	Description
CloudError	Een foutbericht
CloudErrorBody	De hoofdtekst van een foutbericht
createdByType	Het type identiteit waarmee de resource is gemaakt.
DnsForwardingRuleset	Beschrijft een dns-regelset voor doorsturen.
DnsForwardingRulesetListResult	Het antwoord van een DnsForwardingRuleset-lijstbewerking.
ProvisioningState	De huidige inrichtingsstatus van de resource.
SubResource	Verwijzing naar een andere ARM-resource.
systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

CloudError

Object

Een foutbericht

Name	Type	Description
error	CloudErrorBody	De hoofdtekst van het foutbericht

CloudErrorBody

Object

De hoofdtekst van een foutbericht

Name	Type	Description
code	string	De foutcode
details	CloudErrorBody[]	Extra foutinformatie
message	string	Een beschrijving van wat de fout heeft veroorzaakt
target	string	De doelresource van het foutbericht

createdByType

Inventarisatie

Het type identiteit waarmee de resource is gemaakt.

Waarde	Description
User
Application
ManagedIdentity
Key

DnsForwardingRuleset

Object

Beschrijft een dns-regelset voor doorsturen.

Name	Type	Description
etag	string	"Als etag wordt verstrekt in de hoofdtekst van het antwoord, kan het ook worden verstrekt als een header volgens de normale etag-conventie. Entiteitstags worden gebruikt voor het vergelijken van twee of meer entiteiten uit dezelfde aangevraagde resource. HTTP/1.1 gebruikt entiteitstags in de headervelden etag (sectie 14.19), If-Match (sectie 14.24), If-None-Match (sectie 14.26) en If-Range (sectie 14.27).
id	string (arm-id)	Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceType}/{resourceName}"
location	string	De geografische locatie waar de resource zich bevindt
name	string	De naam van de resource
properties.dnsResolverOutboundEndpoints	SubResource[]	De verwijzing naar de uitgaande eindpunten van de DNS-resolver die worden gebruikt om DNS-query's te routeren die overeenkomen met de doorstuurregels in de regelset naar de doel-DNS-servers.
properties.provisioningState	ProvisioningState	De huidige inrichtingsstatus van de dns-regelset voor doorsturen. Dit is een alleen-lezen eigenschap en elke poging om deze waarde in te stellen, wordt genegeerd.
properties.resourceGuid	string	De resourceGuid voor de dns-regelset voor doorsturen.
systemData	systemData	Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens.
tags	object	Resourcetags.
type	string	Het type bron. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

DnsForwardingRulesetListResult

Object

Het antwoord van een DnsForwardingRuleset-lijstbewerking.

Name	Type	Description
nextLink	string (uri)	De link naar de volgende pagina met items
value	DnsForwardingRuleset[]	De DnsForwardingRuleset-items op deze pagina

ProvisioningState

Inventarisatie

De huidige inrichtingsstatus van de resource.

Waarde	Description
Creating
Updating
Deleting
Succeeded
Failed
Canceled

SubResource

Object

Verwijzing naar een andere ARM-resource.

Name	Type	Description
id	string	Resource-id.

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name	Type	Description
createdAt	string (date-time)	De tijdstempel van het maken van resources (UTC).
createdBy	string	De identiteit waarmee de resource is gemaakt.
createdByType	createdByType	Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt	string (date-time)	De tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType	createdByType	Het type identiteit dat de resource voor het laatst heeft gewijzigd.

Delen via

Dns Forwarding Rulesets - List

URI-parameters

Antwoorden

Beveiliging

azure_auth

Bereiken

Voorbeelden

List DNS forwarding rulesets by subscription

Voorbeeldaanvraag

Voorbeeldrespons

Definities

CloudError

CloudErrorBody

createdByType

DnsForwardingRuleset

DnsForwardingRulesetListResult

ProvisioningState

SubResource

systemData