Dns Forwarding Rulesets - List

Szolgáltatás:

DNS

API-verzió:

2025-05-01

Az előfizetés összes erőforráscsoportjában található DNS-továbbítási szabálykészleteket sorolja fel.

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

Opcionális paraméterekkel:

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
subscriptionId	path	True	string (uuid)	A cél-előfizetés azonosítója. Az értéknek UUID-nek kell lennie.
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.
$top	query		integer (int32)	A visszaadandó eredmények maximális száma. Ha nincs megadva, legfeljebb 100 eredményt ad vissza.

Válaszok

Name	Típus	Description
200 OK	DnsForwardingRulesetListResult	Az Azure-művelet sikeresen befejeződött.
Other Status Codes	CloudError	Váratlan hibaválasz.

Biztonság

azure_auth

Azure Active Directory OAuth2-folyamat.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	Megszemélyesíti a felhasználói fiókját

Példák

List DNS forwarding rulesets by subscription

Mintakérelem

HTTP

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

Mintaválasz

Állapotkó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"
      }
    }
  ]
}

Definíciók

Name	Description
CloudError	Hibaüzenet
CloudErrorBody	Egy hibaüzenet törzse
createdByType	Az erőforrást létrehozó identitás típusa.
DnsForwardingRuleset	Egy DNS-továbbítási szabálykészletet ismertet.
DnsForwardingRulesetListResult	A DnsForwardingRuleset listaművelet válasza.
ProvisioningState	Az erőforrás aktuális kiépítési állapota.
SubResource	Hivatkozás egy másik ARM-erőforrásra.
systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

CloudError

Objektum

Hibaüzenet

Name	Típus	Description
error	CloudErrorBody	A hibaüzenet törzse

CloudErrorBody

Objektum

Egy hibaüzenet törzse

Name	Típus	Description
code	string	A hibakód
details	CloudErrorBody[]	További hibainformációk
message	string	A hiba okainak leírása
target	string	A hibaüzenet célerőforrása

createdByType

Enumerálás

Az erőforrást létrehozó identitás típusa.

Érték	Description
User
Application
ManagedIdentity
Key

DnsForwardingRuleset

Objektum

Egy DNS-továbbítási szabálykészletet ismertet.

Name	Típus	Description
etag	string	"Ha az etag meg van adva a válasz törzsében, akkor a normál etag konvenció szerint fejlécként is megadható. Az entitáscímkék két vagy több entitás egyazon kért erőforrásból való összehasonlítására szolgálnak. A HTTP/1.1 entitáscímkéket használ az etag (14.19. szakasz), a If-Match (14.24. szakasz), az If-None-Match (14.26. szakasz) és a If-Range (14.27. szakasz) fejlécmezőkben.")
id	string (arm-id)	Az erőforrás teljes erőforrás-azonosítója. Például: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Az a földrajzi hely, ahol az erőforrás él
name	string	Az erőforrás neve
properties.dnsResolverOutboundEndpoints	SubResource[]	Hivatkozás a DNS-feloldó kimenő végpontjaira, amelyek a szabálykészlet továbbítási szabályainak megfelelő DNS-lekérdezéseket a cél DNS-kiszolgálókhoz irányítják.
properties.provisioningState	ProvisioningState	A DNS-továbbítási szabálykészlet jelenlegi kiépítési állapota. Ez egy írásvédett tulajdonság, és az érték beállítására tett kísérletek figyelmen kívül lesznek hagyva.
properties.resourceGuid	string	A DNS-továbbítási szabálykészlet resourceGuid fájlja.
systemData	systemData	A createdBy és a modifiedBy adatokat tartalmazó Azure Resource Manager-metaadatok.
tags	object	Erőforráscímkék.
type	string	Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

DnsForwardingRulesetListResult

Objektum

A DnsForwardingRuleset listaművelet válasza.

Name	Típus	Description
nextLink	string (uri)	A következő oldalra mutató link
value	DnsForwardingRuleset[]	A DnsForwardingRulesset elemei ezen a lapon

ProvisioningState

Enumerálás

Az erőforrás aktuális kiépítési állapota.

Érték	Description
Creating
Updating
Deleting
Succeeded
Failed
Canceled

SubResource

Objektum

Hivatkozás egy másik ARM-erőforrásra.

Name	Típus	Description
id	string	Erőforrás-azonosító.

systemData

Objektum

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name	Típus	Description
createdAt	string (date-time)	Az erőforrás-létrehozás időbélyege (UTC).
createdBy	string	Az erőforrást létrehozó identitás.
createdByType	createdByType	Az erőforrást létrehozó identitás típusa.
lastModifiedAt	string (date-time)	Az erőforrás utolsó módosításának időbélyege (UTC)
lastModifiedBy	string	Az erőforrást legutóbb módosító identitás.
lastModifiedByType	createdByType	Az erőforrást legutóbb módosító identitás típusa.