Dns Forwarding Rulesets - List

Tjänst:: DNS

API-version:: 2025-05-01

Visar en lista med regler för DNS-vidarebefordran i alla resursgrupper i en prenumeration.

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

Med valfria parametrar:

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
subscriptionId	path	True	string (uuid)	ID för målprenumerationen. Värdet måste vara ett UUID.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.
$top	query		integer (int32)	Det maximala antalet resultat som ska returneras. Om det inte anges returneras upp till 100 resultat.

Svar

Name	Typ	Description
200 OK	DnsForwardingRulesetListResult	Azure-åtgärden har slutförts.
Other Status Codes	CloudError	Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2-flöde.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

List DNS forwarding rulesets by subscription

Exempelbegäran

HTTP

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

Exempelsvar

Statuskod:: 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"
      }
    }
  ]
}

Definitioner

Name	Description
CloudError	Ett felmeddelande
CloudErrorBody	Brödtexten i ett felmeddelande
createdByType	Den typ av identitet som skapade resursen.
DnsForwardingRuleset	Beskriver en regeluppsättning för DNS-vidarebefordran.
DnsForwardingRulesetListResult	Svaret från en DnsForwardingRuleset-liståtgärd.
ProvisioningState	Det aktuella etableringstillståndet för resursen.
SubResource	Referens till en annan ARM-resurs.
systemData	Metadata som rör skapande och senaste ändring av resursen.

CloudError

Objekt

Ett felmeddelande

Name	Typ	Description
error	CloudErrorBody	Felmeddelandetexten

CloudErrorBody

Objekt

Brödtexten i ett felmeddelande

Name	Typ	Description
code	string	Felkoden
details	CloudErrorBody[]	Extra felinformation
message	string	En beskrivning av vad som orsakade felet
target	string	Målresursen för felmeddelandet

createdByType

Uppräkning

Den typ av identitet som skapade resursen.

Värde	Description
User
Application
ManagedIdentity
Key

DnsForwardingRuleset

Objekt

Beskriver en regeluppsättning för DNS-vidarebefordran.

Name	Typ	Description
etag	string	"Om etag anges i svarstexten kan det också anges som en rubrik enligt den normala etag-konventionen. Entitetstaggar används för att jämföra två eller flera entiteter från samma begärda resurs. HTTP/1.1 använder entitetstaggar i rubrikfälten etag (avsnitt 14.19), If-Match (avsnitt 14.24), If-None-Match (avsnitt 14.26) och If-Range (avsnitt 14.27).
id	string (arm-id)	Fullständigt kvalificerat resurs-ID för resursen. Till exempel "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Den geo-plats där resursen finns
name	string	Namnet på resursen
properties.dnsResolverOutboundEndpoints	SubResource[]	Referensen till utgående DNS-matchningsslutpunkter som används för att dirigera DNS-frågor som matchar vidarebefordringsreglerna i regeluppsättningen till dns-målservrarna.
properties.provisioningState	ProvisioningState	Det aktuella etableringstillståndet för regeluppsättningen för DNS-vidarebefordran. Det här är en skrivskyddad egenskap och alla försök att ange det här värdet ignoreras.
properties.resourceGuid	string	ResourceGuid för regeluppsättningen för DNS-vidarebefordran.
systemData	systemData	Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information.
tags	object	Resursetiketter.
type	string	Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

DnsForwardingRulesetListResult

Objekt

Svaret från en DnsForwardingRuleset-liståtgärd.

Name	Typ	Description
nextLink	string (uri)	Länken till nästa sida med objekt
value	DnsForwardingRuleset[]	Objekten DnsForwardingRuleset på den här sidan

ProvisioningState

Uppräkning

Det aktuella etableringstillståndet för resursen.

Värde	Description
Creating
Updating
Deleting
Succeeded
Failed
Canceled

SubResource

Objekt

Referens till en annan ARM-resurs.

Name	Typ	Description
id	string	Resurs-ID.

systemData

Objekt

Metadata som rör skapande och senaste ändring av resursen.

Name	Typ	Description
createdAt	string (date-time)	Tidsstämpeln för resursskapande (UTC).
createdBy	string	Identiteten som skapade resursen.
createdByType	createdByType	Den typ av identitet som skapade resursen.
lastModifiedAt	string (date-time)	Tidsstämpeln för resursens senaste ändring (UTC)
lastModifiedBy	string	Identiteten som senast ändrade resursen.
lastModifiedByType	createdByType	Den typ av identitet som senast ändrade resursen.

Dela via

Dns Forwarding Rulesets - List

URI-parametrar

Svar

Säkerhet

azure_auth

Omfattningar

Exempel

List DNS forwarding rulesets by subscription

Exempelbegäran

Exempelsvar

Definitioner

CloudError

CloudErrorBody

createdByType

DnsForwardingRuleset

DnsForwardingRulesetListResult

ProvisioningState

SubResource

systemData