Dns Forwarding Rulesets - List

Layanan:: DNS

Versi API:: 2025-05-01

Mencantumkan aturan penerusan DNS di semua grup sumber daya langganan.

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

Dengan parameter opsional:

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
subscriptionId	path	True	string (uuid)	ID langganan target. Nilainya harus sebuah UUID.
api-version	query	True	string minLength: 1	Versi API yang digunakan untuk operasi ini.
$top	query		integer (int32)	Jumlah maksimum hasil yang akan dikembalikan. Jika tidak ditentukan, mengembalikan hingga 100 hasil.

Respons

Nama	Jenis	Deskripsi
200 OK	DnsForwardingRulesetListResult	Operasi Azure berhasil diselesaikan.
Other Status Codes	CloudError	Respons kesalahan tak terduga.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

List DNS forwarding rulesets by subscription

Permintaan sampel

HTTP

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

Respon sampel

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

Definisi

Nama	Deskripsi
CloudError	Pesan kesalahan
CloudErrorBody	Isi pesan kesalahan
createdByType	Jenis identitas yang membuat sumber daya.
DnsForwardingRuleset	Menjelaskan kumpulan aturan penerusan DNS.
DnsForwardingRulesetListResult	Respons operasi daftar DnsForwardingRulesset.
ProvisioningState	Status provisi sumber daya saat ini.
SubResource	Referensi ke sumber daya ARM lain.
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

CloudError

Objek

Pesan kesalahan

Nama	Jenis	Deskripsi
error	CloudErrorBody	Isi pesan kesalahan

CloudErrorBody

Objek

Isi pesan kesalahan

Nama	Jenis	Deskripsi
code	string	Kode kesalahan
details	CloudErrorBody[]	Informasi kesalahan tambahan
message	string	Deskripsi tentang apa yang menyebabkan kesalahan
target	string	Sumber daya target pesan kesalahan

createdByType

Enumeration

Jenis identitas yang membuat sumber daya.

Nilai	Deskripsi
User
Application
ManagedIdentity
Key

DnsForwardingRuleset

Objek

Menjelaskan kumpulan aturan penerusan DNS.

Nama	Jenis	Deskripsi
etag	string	"Jika etag disediakan dalam badan respons, itu juga dapat disediakan sebagai header sesuai konvensi etag normal. Tag entitas digunakan untuk membandingkan dua entitas atau lebih dari sumber daya yang diminta yang sama. HTTP/1.1 menggunakan tag entitas di bidang header etag (bagian 14.19), If-Match (bagian 14.24), If-None-Match (bagian 14.26), dan If-Range (bagian 14.27).")
id	string (arm-id)	ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Lokasi geografis tempat sumber daya berada
name	string	Nama sumber daya
properties.dnsResolverOutboundEndpoints	SubResource[]	Referensi ke titik akhir keluar pemecah masalah DNS yang digunakan untuk merutekan kueri DNS yang cocok dengan aturan penerusan dalam set aturan ke server DNS target.
properties.provisioningState	ProvisioningState	Status provisi saat ini dari kumpulan aturan penerusan DNS. Ini adalah properti baca-saja dan setiap upaya untuk mengatur nilai ini akan diabaikan.
properties.resourceGuid	string	ResourceGuid untuk kumpulan aturan penerusan DNS.
systemData	systemData	Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy.
tags	object	Tag sumber daya.
type	string	Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

DnsForwardingRulesetListResult

Objek

Respons operasi daftar DnsForwardingRulesset.

Nama	Jenis	Deskripsi
nextLink	string (uri)	Tautan ke halaman item berikutnya
value	DnsForwardingRuleset[]	Item DnsForwardingRuleset di halaman ini

ProvisioningState

Enumeration

Status provisi sumber daya saat ini.

Nilai	Deskripsi
Creating
Updating
Deleting
Succeeded
Failed
Canceled

SubResource

Objek

Referensi ke sumber daya ARM lain.

Nama	Jenis	Deskripsi
id	string	ID Sumber Daya.

systemData

Objek

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama	Jenis	Deskripsi
createdAt	string (date-time)	Tanda waktu pembuatan sumber daya (UTC).
createdBy	string	Identitas yang membuat sumber daya.
createdByType	createdByType	Jenis identitas yang membuat sumber daya.
lastModifiedAt	string (date-time)	Tanda waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir mengubah sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir memodifikasi sumber daya.

Bagikan melalui

Dns Forwarding Rulesets - List

Parameter URI

Respons

Keamanan

azure_auth

Cakupan

Contoh

List DNS forwarding rulesets by subscription

Permintaan sampel

Respon sampel

Definisi

CloudError

CloudErrorBody

createdByType

DnsForwardingRuleset

DnsForwardingRulesetListResult

ProvisioningState

SubResource

systemData