Dns Forwarding Rulesets - List

Hizmet:: DNS

API Sürümü:: 2025-05-01

Bir aboneliğin tüm kaynak gruplarında DNS iletme kural kümelerini listeler.

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

İsteğe bağlı parametrelerle:

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
subscriptionId	path	True	string (uuid)	Hedef aboneliğin kimliği. Değer bir UUID olmalıdır.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.
$top	query		integer (int32)	Döndürülecek en fazla sonuç sayısı. Belirtilmezse en fazla 100 sonuç döndürür.

Yanıtlar

Name	Tür	Description
200 OK	DnsForwardingRulesetListResult	Azure işlemi başarıyla tamamlandı.
Other Status Codes	CloudError	Beklenmeyen bir hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 akışı.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

List DNS forwarding rulesets by subscription

Örnek isteği

HTTP

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

Örnek yanıt

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

Tanımlar

Name	Description
CloudError	Hata iletisi
CloudErrorBody	Hata iletisinin gövdesi
createdByType	Kaynağı oluşturan kimliğin türü.
DnsForwardingRuleset	DNS iletme kural kümesini açıklar.
DnsForwardingRulesetListResult	DnsForwardingRuleset liste işleminin yanıtı.
ProvisioningState	Kaynağın geçerli sağlama durumu.
SubResource	Başka bir ARM kaynağına başvuru.
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

CloudError

Object

Hata iletisi

Name	Tür	Description
error	CloudErrorBody	Hata iletisi gövdesi

CloudErrorBody

Object

Hata iletisinin gövdesi

Name	Tür	Description
code	string	Hata kodu
details	CloudErrorBody[]	Ek hata bilgileri
message	string	Hataya neyin neden olduğunu açıklayan açıklama
target	string	Hata iletisinin hedef kaynağı

createdByType

Listeleme

Kaynağı oluşturan kimliğin türü.

Değer	Description
User
Application
ManagedIdentity
Key

DnsForwardingRuleset

Object

DNS iletme kural kümesini açıklar.

Name	Tür	Description
etag	string	"Yanıt gövdesinde etag sağlanmışsa, normal etag kuralına göre bir başlık olarak da sağlanabilir. Varlık etiketleri, aynı istenen kaynaktan iki veya daha fazla varlığı karşılaştırmak için kullanılır. HTTP/1.1, etag (bölüm 14.19), If-Match (bölüm 14.24), If-None-Match (bölüm 14.26) ve If-Range (bölüm 14.27) başlık alanlarında varlık etiketlerini kullanır.")
id	string (arm-id)	Kaynağın tam kaynak kimliği. Örneğin, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Kaynağın bulunduğu coğrafi konum
name	string	Kaynağın adı
properties.dnsResolverOutboundEndpoints	SubResource[]	Kural kümesindeki iletme kurallarıyla eşleşen DNS sorgularını hedef DNS sunucularına yönlendirmek için kullanılan DNS çözümleyici giden uç noktalarına başvuru.
properties.provisioningState	ProvisioningState	DNS iletme kural kümesinin geçerli sağlama durumu. Bu salt okunur bir özelliktir ve bu değeri ayarlama girişimleri yoksayılır.
properties.resourceGuid	string	DNS iletme kural kümesi için resourceGuid.
systemData	systemData	createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri.
tags	object	Kaynak etiketleri.
type	string	Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

DnsForwardingRulesetListResult

Object

DnsForwardingRuleset liste işleminin yanıtı.

Name	Tür	Description
nextLink	string (uri)	Öğelerin bir sonraki sayfasına bağlantı
value	DnsForwardingRuleset[]	Bu sayfadaki DnsForwardingRuleset öğeleri

ProvisioningState

Listeleme

Kaynağın geçerli sağlama durumu.

Değer	Description
Creating
Updating
Deleting
Succeeded
Failed
Canceled

SubResource

Object

Başka bir ARM kaynağına başvuru.

Name	Tür	Description
id	string	Kaynak Kimliği.

systemData

Object

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name	Tür	Description
createdAt	string (date-time)	Kaynak oluşturma (UTC) zaman damgası.
createdBy	string	Kaynağı oluşturan kimlik.
createdByType	createdByType	Kaynağı oluşturan kimliğin türü.
lastModifiedAt	string (date-time)	Kaynağın son değişikliğinin zaman damgası (UTC)
lastModifiedBy	string	Kaynağı en son değiştiren kimlik.
lastModifiedByType	createdByType	Kaynağı en son değiştiren kimlik türü.

Aracılığıyla paylaş

Dns Forwarding Rulesets - List

URI Parametreleri

Yanıtlar

Güvenlik

azure_auth

Kapsamlar

Örnekler

List DNS forwarding rulesets by subscription

Örnek isteği

Örnek yanıt

Tanımlar

CloudError

CloudErrorBody

createdByType

DnsForwardingRuleset

DnsForwardingRulesetListResult

ProvisioningState

SubResource

systemData