Dns Forwarding Rulesets - List

Služba:: DNS

Verze rozhraní API:: 2025-05-01

Zobrazí seznam sad pravidel předávání DNS ve všech skupinách prostředků předplatného.

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

S volitelnými parametry:

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
subscriptionId	path	True	string (uuid)	ID cílového předplatného. Hodnota musí být UUID.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.
$top	query		integer (int32)	Maximální počet výsledků, které se mají vrátit. Pokud není zadaný, vrátí až 100 výsledků.

Odpovědi

Name	Typ	Description
200 OK	DnsForwardingRulesetListResult	Operace Azure byla úspěšně dokončena.
Other Status Codes	CloudError	Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2.

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

List DNS forwarding rulesets by subscription

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kód:: 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"
      }
    }
  ]
}

Definice

Name	Description
CloudError	Chybová zpráva
CloudErrorBody	Text chybové zprávy
createdByType	Typ identity, která prostředek vytvořila.
DnsForwardingRuleset	Popisuje sadu pravidel předávání DNS.
DnsForwardingRulesetListResult	Odpověď operace se seznamem DnsForwardingRuleset.
ProvisioningState	Aktuální stav zřizování prostředku.
SubResource	Odkaz na jiný prostředek ARM
systemData	Metadata týkající se vytvoření a poslední změny prostředku.

CloudError

Objekt

Chybová zpráva

Name	Typ	Description
error	CloudErrorBody	Text chybové zprávy

CloudErrorBody

Objekt

Text chybové zprávy

Name	Typ	Description
code	string	Kód chyby
details	CloudErrorBody[]	Další informace o chybě
message	string	Popis toho, co způsobilo chybu
target	string	Cílový prostředek chybové zprávy

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
User
Application
ManagedIdentity
Key

DnsForwardingRuleset

Objekt

Popisuje sadu pravidel předávání DNS.

Name	Typ	Description
etag	string	"Pokud je v těle odpovědi uveden etag, může být také poskytnut jako hlavička podle normální konvence etag. Značky entit se používají k porovnání dvou nebo více entit ze stejného požadovaného prostředku. Protokol HTTP/1.1 používá značky entit v polích záhlaví značek etag (oddíl 14.19), If-Match (oddíl 14.24), If-None-Match (oddíl 14.26) a If-Range (oddíl 14.27).")
id	string (arm-id)	Plně kvalifikované ID prostředku pro prostředek. Například /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Geografické umístění, ve kterém se nachází zdroj
name	string	Název prostředku
properties.dnsResolverOutboundEndpoints	SubResource[]	Odkaz na odchozí koncové body překladače DNS, které se používají ke směrování dotazů DNS odpovídajících pravidlům předávání v sadě pravidel na cílové servery DNS.
properties.provisioningState	ProvisioningState	Aktuální stav zřizování sady pravidel předávání DNS. Toto je vlastnost jen pro čtení a všechny pokusy o nastavení této hodnoty budou ignorovány.
properties.resourceGuid	string	ResourceGuid pro sadu pravidel předávání DNS.
systemData	systemData	Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil.
tags	object	Značky prostředků
type	string	Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

DnsForwardingRulesetListResult

Objekt

Odpověď operace se seznamem DnsForwardingRuleset.

Name	Typ	Description
nextLink	string (uri)	Odkaz na další stránku položek
value	DnsForwardingRuleset[]	Položky DnsForwardingRuleset na této stránce

ProvisioningState

Výčet

Aktuální stav zřizování prostředku.

Hodnota	Description
Creating
Updating
Deleting
Succeeded
Failed
Canceled

SubResource

Objekt

Odkaz na jiný prostředek ARM

Name	Typ	Description
id	string	ID prostředku.

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.

Sdílet prostřednictvím

Dns Forwarding Rulesets - List

Parametry identifikátoru URI

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

List DNS forwarding rulesets by subscription

Ukázkový požadavek

Ukázková odpověď

Definice

CloudError

CloudErrorBody

createdByType

DnsForwardingRuleset

DnsForwardingRulesetListResult

ProvisioningState

SubResource

systemData