Record Sets - List By Type

서비스:

DNS

API 버전:

2018-05-01

DNS 영역에 지정된 형식의 레코드 집합을 나열합니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/{recordType}?api-version=2018-05-01

선택적 매개 변수:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/{recordType}?$top={$top}&$recordsetnamesuffix={$recordsetnamesuffix}&api-version=2018-05-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
recordType	path	True	RecordType	열거할 레코드 집합의 형식입니다.
resourceGroupName	path	True	string	리소스 그룹의 이름입니다.
subscriptionId	path	True	string	Microsoft Azure 구독을 고유하게 식별하는 Azure 구독 ID를 지정합니다.
zoneName	path	True	string	DNS 영역의 이름입니다(종료 점 제외).
api-version	query	True	string	API 버전을 지정합니다.
$recordsetnamesuffix	query		string	레코드 집합 열거형을 필터링하는 데 사용해야 하는 레코드 집합 이름의 접미사 레이블입니다. 이 매개 변수를 지정하면 열거형은 로 끝나는 레코드만 반환합니다.<recordSetName접미사>
$top	query		integer (int32)	반환할 레코드 집합의 최대 수입니다. 지정하지 않으면 최대 100개의 레코드 집합을 반환합니다.

응답

Name	형식	Description
200 OK	RecordSetListResult	성공.
Other Status Codes	CloudError	기본 응답입니다. 오류 정의에 따라 역직렬화됩니다.

예제

List A recordsets

List AAAA recordsets

List CAA recordsets

List CNAME recordsets

List MX recordsets

List NS recordsets

List PTR recordsets

List SOA recordsets

List SRV recordsets

List TXT recordsets

List A recordsets

샘플 요청

HTTP

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/A?api-version=2018-05-01

샘플 응답

상태 코드:

200

{
  "nextLink": "https://servicehost/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/A?api-version=2018-05-01&$skipToken=skipToken",
  "value": [
    {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/A/record1",
      "etag": "00000000-0000-0000-0000-000000000000",
      "name": "record1",
      "type": "Microsoft.Network/dnsZones/A",
      "properties": {
        "metadata": {
          "key1": "value1"
        },
        "TTL": 3600,
        "fqdn": "record1.zone1",
        "ARecords": [
          {
            "ipv4Address": "127.0.0.1"
          }
        ]
      }
    }
  ]
}

List AAAA recordsets

샘플 요청

HTTP

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/AAAA?api-version=2018-05-01

샘플 응답

상태 코드:

200

{
  "nextLink": "https://servicehost/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/AAAA?api-version=2018-05-01&$skipToken=skipToken",
  "value": [
    {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/AAAA/record1",
      "etag": "00000000-0000-0000-0000-000000000000",
      "name": "record1",
      "type": "Microsoft.Network/dnsZones/AAAA",
      "properties": {
        "metadata": {
          "key1": "value1"
        },
        "TTL": 3600,
        "fqdn": "record1.zone1",
        "AAAARecords": [
          {
            "ipv6Address": "::1"
          }
        ]
      }
    }
  ]
}

List CAA recordsets

샘플 요청

HTTP

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/CAA?api-version=2018-05-01

샘플 응답

상태 코드:

200

{
  "nextLink": "https://servicehost/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/CAA?api-version=2018-05-01&$skipToken=skipToken",
  "value": [
    {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/CAA/record1",
      "etag": "00000000-0000-0000-0000-000000000000",
      "name": "record1",
      "type": "Microsoft.Network/dnsZones/CAA",
      "properties": {
        "metadata": {
          "key1": "value1"
        },
        "TTL": 3600,
        "fqdn": "record1.zone1",
        "caaRecords": [
          {
            "flags": 0,
            "tag": "issue",
            "value": "ca.contoso.com"
          }
        ]
      }
    }
  ]
}

List CNAME recordsets

샘플 요청

HTTP

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/CNAME?api-version=2018-05-01

샘플 응답

상태 코드:

200

{
  "nextLink": "https://servicehost/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/CNAME?api-version=2018-05-01&$skipToken=skipToken",
  "value": [
    {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/CNAME/record1",
      "etag": "00000000-0000-0000-0000-000000000000",
      "name": "record1",
      "type": "Microsoft.Network/dnsZones/CNAME",
      "properties": {
        "metadata": {
          "key1": "value1"
        },
        "TTL": 3600,
        "fqdn": "record1.zone1",
        "CNAMERecord": {
          "cname": "contoso.com"
        }
      }
    }
  ]
}

List MX recordsets

샘플 요청

HTTP

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/MX?api-version=2018-05-01

샘플 응답

상태 코드:

200

{
  "nextLink": "https://servicehost/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/MX?api-version=2018-05-01&$skipToken=skipToken",
  "value": [
    {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/MX/record1",
      "etag": "00000000-0000-0000-0000-000000000000",
      "name": "record1",
      "type": "Microsoft.Network/dnsZones/MX",
      "properties": {
        "metadata": {
          "key1": "value1"
        },
        "TTL": 3600,
        "fqdn": "record1.zone1",
        "MXRecords": [
          {
            "preference": 0,
            "exchange": "mail.contoso.com"
          }
        ]
      }
    }
  ]
}

List NS recordsets

샘플 요청

HTTP

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/NS?api-version=2018-05-01

샘플 응답

상태 코드:

200

{
  "nextLink": "https://servicehost/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/NS?api-version=2018-05-01&$skipToken=skipToken",
  "value": [
    {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/NS/record1",
      "etag": "00000000-0000-0000-0000-000000000000",
      "name": "record1",
      "type": "Microsoft.Network/dnsZones/NS",
      "properties": {
        "metadata": {
          "key1": "value1"
        },
        "TTL": 3600,
        "fqdn": "record1.zone1",
        "NSRecords": [
          {
            "nsdname": "ns1.contoso.com"
          }
        ]
      }
    }
  ]
}

List PTR recordsets

샘플 요청

HTTP

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/0.0.127.in-addr.arpa/PTR?api-version=2018-05-01

샘플 응답

상태 코드:

200

{
  "nextLink": "https://servicehost/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/0.0.127.in-addr.arpa/PTR?api-version=2018-05-01&$skipToken=skipToken",
  "value": [
    {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/0.0.127.in-addr.arpa/PTR/1",
      "etag": "00000000-0000-0000-0000-000000000000",
      "name": "1",
      "type": "Microsoft.Network/dnsZones/PTR",
      "properties": {
        "metadata": {
          "key1": "value1"
        },
        "TTL": 3600,
        "fqdn": "1.0.0.127.in-addr.arpa",
        "PTRRecords": [
          {
            "ptrdname": "localhost"
          }
        ]
      }
    }
  ]
}

List SOA recordsets

샘플 요청

HTTP

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/SOA?api-version=2018-05-01

샘플 응답

상태 코드:

200

{
  "nextLink": "https://servicehost/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/SOA?api-version=2018-05-01&$skipToken=skipToken",
  "value": [
    {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/SOA/@",
      "etag": "00000000-0000-0000-0000-000000000000",
      "name": "@",
      "type": "Microsoft.Network/dnsZones/SOA",
      "properties": {
        "metadata": {
          "key1": "value1"
        },
        "TTL": 3600,
        "fqdn": "zone1",
        "SOARecord": {
          "host": "ns1.contoso.com",
          "email": "hostmaster.contoso.com",
          "serialNumber": 1,
          "refreshTime": 3600,
          "retryTime": 300,
          "expireTime": 2419200,
          "minimumTTL": 300
        }
      }
    }
  ]
}

List SRV recordsets

샘플 요청

HTTP

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/SRV?api-version=2018-05-01

샘플 응답

상태 코드:

200

{
  "nextLink": "https://servicehost/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/SRV?api-version=2018-05-01&$skipToken=skipToken",
  "value": [
    {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/SRV/record1",
      "etag": "00000000-0000-0000-0000-000000000000",
      "name": "record1",
      "type": "Microsoft.Network/dnsZones/SRV",
      "properties": {
        "metadata": {
          "key1": "value1"
        },
        "TTL": 3600,
        "fqdn": "record1.zone1",
        "SRVRecords": [
          {
            "priority": 0,
            "weight": 10,
            "port": 80,
            "target": "contoso.com"
          }
        ]
      }
    }
  ]
}

List TXT recordsets

샘플 요청

HTTP

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/TXT?api-version=2018-05-01

샘플 응답

상태 코드:

200

{
  "nextLink": "https://servicehost/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/TXT?api-version=2018-05-01&$skipToken=skipToken",
  "value": [
    {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1/TXT/record1",
      "etag": "00000000-0000-0000-0000-000000000000",
      "name": "record1",
      "type": "Microsoft.Network/dnsZones/TXT",
      "properties": {
        "metadata": {
          "key1": "value1"
        },
        "TTL": 3600,
        "fqdn": "record1.zone1",
        "TXTRecords": [
          {
            "value": [
              "string1",
              "string2"
            ]
          }
        ]
      }
    }
  ]
}

정의

Name	Description
AaaaRecord	AAAA 레코드입니다.
ARecord	A 레코드입니다.
CaaRecord	CAA 레코드입니다.
CloudError	서비스의 오류 응답입니다.
CloudErrorBody	서비스의 오류 응답입니다.
CnameRecord	CNAME 레코드입니다.
MxRecord	MX 레코드입니다.
NsRecord	NS 레코드입니다.
PtrRecord	PTR 레코드입니다.
RecordSet	DNS 레코드 집합(이름과 형식이 같은 DNS 레코드 컬렉션)에 대해 설명합니다.
RecordSetListResult	레코드 집합 목록 작업에 대한 응답입니다.
RecordType	열거할 레코드 집합의 형식입니다.
SoaRecord	SOA 레코드입니다.
SrvRecord	SRV 레코드입니다.
SubResource	다른 리소스에 대한 참조
TxtRecord	TXT 레코드입니다.

AaaaRecord

Object

AAAA 레코드입니다.

Name	형식	Description
ipv6Address	string	이 AAAA 레코드의 IPv6 주소입니다.

ARecord

Object

A 레코드입니다.

Name	형식	Description
ipv4Address	string	이 A 레코드의 IPv4 주소입니다.

CaaRecord

Object

CAA 레코드입니다.

Name	형식	Description
flags	integer (int32)	이 CAA 레코드의 플래그는 0에서 255 사이의 정수입니다.
tag	string	이 CAA 레코드의 태그입니다.
value	string	이 CAA 레코드의 값입니다.

CloudError

Object

서비스의 오류 응답입니다.

Name	형식	Description
error	CloudErrorBody	클라우드 오류 본문입니다.

CloudErrorBody

Object

서비스의 오류 응답입니다.

Name	형식	Description
code	string	오류의 식별자입니다. 코드는 고정적이며 프로그래밍 방식으로 사용할 수 있습니다.
details	CloudErrorBody[]	오류에 대한 추가 세부 정보 목록입니다.
message	string	사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다.
target	string	특정 오류의 대상입니다. 예를 들어 오류가 발생한 속성의 이름입니다.

CnameRecord

Object

CNAME 레코드입니다.

Name	형식	Description
cname	string	이 CNAME 레코드의 정식 이름입니다.

MxRecord

Object

MX 레코드입니다.

Name	형식	Description
exchange	string	이 MX 레코드에 대한 메일 호스트의 도메인 이름입니다.
preference	integer (int32)	이 MX 레코드의 기본 설정 값입니다.

NsRecord

Object

NS 레코드입니다.

Name	형식	Description
nsdname	string	이 NS 레코드의 이름 서버 이름입니다.

PtrRecord

Object

PTR 레코드입니다.

Name	형식	Description
ptrdname	string	이 PTR 레코드의 PTR 대상 도메인 이름입니다.

RecordSet

Object

DNS 레코드 집합(이름과 형식이 같은 DNS 레코드 컬렉션)에 대해 설명합니다.

Name	형식	Description
etag	string	레코드 집합의 etag입니다.
id	string	레코드 집합의 ID입니다.
name	string	레코드 집합의 이름입니다.
properties.AAAARecords	AaaaRecord[]	레코드 집합의 AAAA 레코드 목록입니다.
properties.ARecords	ARecord[]	레코드 집합의 A 레코드 목록입니다.
properties.CNAMERecord	CnameRecord	레코드 집합의 CNAME 레코드입니다.
properties.MXRecords	MxRecord[]	레코드 집합의 MX 레코드 목록입니다.
properties.NSRecords	NsRecord[]	레코드 집합의 NS 레코드 목록입니다.
properties.PTRRecords	PtrRecord[]	레코드 집합의 PTR 레코드 목록입니다.
properties.SOARecord	SoaRecord	레코드 집합의 SOA 레코드입니다.
properties.SRVRecords	SrvRecord[]	레코드 집합의 SRV 레코드 목록입니다.
properties.TTL	integer (int64)	레코드 집합에 있는 레코드의 TTL(Time-to-live)입니다.
properties.TXTRecords	TxtRecord[]	레코드 집합의 TXT 레코드 목록입니다.
properties.caaRecords	CaaRecord[]	레코드 집합의 CAA 레코드 목록입니다.
properties.fqdn	string	레코드 집합의 정규화된 도메인 이름입니다.
properties.metadata	object	레코드 집합에 연결된 메타데이터입니다.
properties.provisioningState	string	레코드 집합의 프로비전 상태입니다.
properties.targetResource	SubResource	dns 리소스 값을 사용하는 Azure 리소스에 대한 참조입니다.
type	string	레코드 집합의 형식입니다.

RecordSetListResult

Object

레코드 집합 목록 작업에 대한 응답입니다.

Name	형식	Description
nextLink	string	결과의 다음 페이지에 대한 연속 토큰입니다.
value	RecordSet[]	응답의 레코드 집합에 대한 정보입니다.

RecordType

열거형

열거할 레코드 집합의 형식입니다.

값	Description
A
AAAA
CAA
CNAME
MX
NS
PTR
SOA
SRV
TXT

SoaRecord

Object

SOA 레코드입니다.

Name	형식	Description
email	string	이 SOA 레코드의 전자 메일 연락처입니다.
expireTime	integer (int64)	이 SOA 레코드의 만료 시간입니다.
host	string	이 SOA 레코드에 대한 신뢰할 수 있는 이름 서버의 도메인 이름입니다.
minimumTTL	integer (int64)	이 SOA 레코드의 최소값입니다. 규칙에 따라 이는 음수 캐싱 기간을 결정하는 데 사용됩니다.
refreshTime	integer (int64)	이 SOA 레코드의 새로 고침 값입니다.
retryTime	integer (int64)	이 SOA 레코드의 재시도 시간입니다.
serialNumber	integer (int64)	이 SOA 레코드의 일련 번호입니다.

SrvRecord

Object

SRV 레코드입니다.

Name	형식	Description
port	integer (int32)	이 SRV 레코드의 포트 값입니다.
priority	integer (int32)	이 SRV 레코드의 우선 순위 값입니다.
target	string	이 SRV 레코드의 대상 도메인 이름입니다.
weight	integer (int32)	이 SRV 레코드의 가중치 값입니다.

SubResource

Object

다른 리소스에 대한 참조

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

TxtRecord

Object

TXT 레코드입니다.

Name	형식	Description
value	string[]	이 TXT 레코드의 텍스트 값입니다.