Dns Forwarding Rulesets - List

서비스:: DNS

API 버전:: 2025-05-01

구독의 모든 리소스 그룹에 DNS 전달 규칙 집합을 나열합니다.

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

선택적 매개 변수:

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
subscriptionId	path	True	string (uuid)	대상 구독의 ID입니다. 값은 UUID여야 합니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.
$top	query		integer (int32)	반환할 최대 결과 수입니다. 지정하지 않으면 최대 100개의 결과를 반환합니다.

응답

Name	형식	Description
200 OK	DnsForwardingRulesetListResult	Azure 작업이 성공적으로 완료되었습니다.
Other Status Codes	CloudError	예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

List DNS forwarding rulesets by subscription

샘플 요청

HTTP

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

샘플 응답

상태 코드:: 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"
      }
    }
  ]
}

정의

Name	Description
CloudError	오류 메시지
CloudErrorBody	오류 메시지의 본문
createdByType	리소스를 만든 ID의 형식입니다.
DnsForwardingRuleset	DNS 전달 규칙 집합에 대해 설명합니다.
DnsForwardingRulesetListResult	DnsForwardingRuleset 목록 작업의 응답입니다.
ProvisioningState	리소스의 현재 프로비저닝 상태입니다.
SubResource	다른 ARM 리소스에 대한 참조입니다.
systemData	리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

CloudError

Object

오류 메시지

Name	형식	Description
error	CloudErrorBody	오류 메시지 본문

CloudErrorBody

Object

오류 메시지의 본문

Name	형식	Description
code	string	오류 코드
details	CloudErrorBody[]	추가 오류 정보
message	string	오류의 원인에 대한 설명
target	string	오류 메시지의 대상 리소스

createdByType

열거형

리소스를 만든 ID의 형식입니다.

값	Description
User
Application
ManagedIdentity
Key

DnsForwardingRuleset

Object

DNS 전달 규칙 집합에 대해 설명합니다.

Name	형식	Description
etag	string	"etag가 응답 본문에 제공되면 일반 etag 규칙에 따라 헤더로 제공될 수도 있습니다. 엔터티 태그는 동일한 요청된 리소스에서 둘 이상의 엔터티를 비교하는 데 사용됩니다. HTTP/1.1은 etag(섹션 14.19), If-Match(섹션 14.24), If-None-Match(섹션 14.26) 및 If-Range(섹션 14.27) 헤더 필드에서 엔터티 태그를 사용합니다.")
id	string (arm-id)	리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	리소스가 있는 지리적 위치
name	string	리소스의 이름
properties.dnsResolverOutboundEndpoints	SubResource[]	규칙 집합의 전달 규칙과 일치하는 DNS 쿼리를 대상 DNS 서버로 라우팅하는 데 사용되는 DNS 확인자 아웃바운드 엔드포인트에 대한 참조입니다.
properties.provisioningState	ProvisioningState	DNS 전달 규칙 집합의 현재 프로비전 상태입니다. 읽기 전용 속성이며 이 값을 설정하려는 시도는 무시됩니다.
properties.resourceGuid	string	DNS 전달 규칙 집합에 대한 resourceGuid입니다.
systemData	systemData	createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.
tags	object	리소스 태그.
type	string	리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

DnsForwardingRulesetListResult

Object

DnsForwardingRuleset 목록 작업의 응답입니다.

Name	형식	Description
nextLink	string (uri)	항목의 다음 페이지에 대한 링크
value	DnsForwardingRuleset[]	이 페이지의 DnsForwardingRuleset 항목

ProvisioningState

열거형

리소스의 현재 프로비저닝 상태입니다.

값	Description
Creating
Updating
Deleting
Succeeded
Failed
Canceled

SubResource

Object

다른 ARM 리소스에 대한 참조입니다.

Name	형식	Description
id	string	리소스 ID입니다.

systemData

Object

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name	형식	Description
createdAt	string (date-time)	리소스 만들기의 타임스탬프(UTC)입니다.
createdBy	string	리소스를 만든 ID입니다.
createdByType	createdByType	리소스를 만든 ID의 형식입니다.
lastModifiedAt	string (date-time)	리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy	string	리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType	createdByType	리소스를 마지막으로 수정한 ID의 형식입니다.

다음을 통해 공유

Dns Forwarding Rulesets - List

URI 매개 변수

응답

보안

azure_auth

범위

예제

List DNS forwarding rulesets by subscription

샘플 요청

샘플 응답

정의

CloudError

CloudErrorBody

createdByType

DnsForwardingRuleset

DnsForwardingRulesetListResult

ProvisioningState

SubResource

systemData