레코드 형식(JSON)

이 페이지에서는 다양한 Cloud DNS 레코드 유형을 JSON 형식으로 보여줍니다. Cloud DNS 사용을 시작하려면 빠른 시작을 참조하세요.

지원되는 DNS 레코드 유형

Cloud DNS는 다음 유형의 레코드를 지원합니다.

레코드 유형 설명
A

주소 레코드입니다. 호스트 이름을 IPv4 주소로 매핑하는 데 사용됩니다.

리소스 레코드 집합 표현의 예는 다음과 같습니다.


{
  "kind": "dns#resourceRecordSet",
  "name": "example.com.",
  "rrdatas": [
      "1.2.3.4"
  ],
  "ttl": 86400,
  "type": "A"
}
AAAA

IPv6 주소 레코드입니다. 호스트 이름을 IPv6 주소로 매핑하는 데 사용됩니다.

리소스 레코드 집합 표현의 예는 다음과 같습니다.


{
  "kind": "dns#resourceRecordSet",
  "name": "example.com.",
  "rrdatas": [
      "2607:f8b0:400a:801::1005"
  ],
  "ttl": 86400,
  "type": "AAAA"
}
CNAME

표준 이름 레코드입니다. 별칭 이름을 지정하는 데 사용됩니다.

리소스 레코드 모음 표현의 예는 다음과 같습니다.


{
  "kind": "dns#resourceRecordSet",
  "name": "mail.example.com.",
  "rrdatas": [
      "example.com."
  ],
  "ttl": 86400,
  "type": "CNAME"
}

호스트 이름이 정규화된 DNS 이름이 되려면 rrdatas 필드가 마침표(.)로 끝나야 합니다.

MX

메일 교환 레코드입니다. 요청을 메일 서버로 라우팅하는 데 사용됩니다.

리소스 레코드 모음 표현의 예는 다음과 같습니다.


{
  "kind": "dns#resourceRecordSet",
  "name": "example.com.",
  "rrdatas": [
      "10 mail.example.com.",
      "20 mail2.example.com."
  ],
  "ttl": 86400,
  "type": "MX"
}

호스트 이름이 정규화된 DNS 이름이 되려면 rrdatas 필드가 마침표(.)로 끝나야 합니다.

NAPTR

이름 지정 기관 포인터 레코드입니다. RFC 3403에 의해 정의됩니다.

리소스 레코드 모음 표현의 예는 다음과 같습니다.


{
  "kind": "dns#resourceRecordSet",
  "name": "2.1.2.1.5.5.5.0.7.7.1.e164.arpa.",
  "rrdatas": [
      "100 10 \"u\" \"sip+E2U\" \"!^.*$!sip:information@foo.se!i\" .",
      "102 10 \"u\" \"smtp+E2U\" \"!^.*$!mailto:information@foo.se!i\" ."
  ],
  "ttl": 300,
  "type": "NAPTR"
}

정규화된 DNS 이름이 되려면 각 rrdatas의 마지막 '대체' 필드 값이 마침표(.)로 끝나야 합니다.

이 레코드 유형에는 몇 가지 이스케이프 문제가 발생합니다. 위와 같이 내장된 따옴표를 이스케이프 처리해야만 JSON에서 사용할 수 있습니다. 또한 'regexp' 필드에는 백슬래시 문자가 자주 포함되며, 백슬래시 문자는 두 번 이스케이프 처리해야 합니다. 즉, 영역 파일 형식에서 한 번 필요하고, JSON 형식에서 다시 한 번 필요합니다. 이를 보여주기 위해 RFC 3403 섹션 6.1의 예는 JSON API에서 다음과 같이 표현됩니다.


{
  "kind": "dns#resourceRecordSet",
  "name": "cid.urn.arpa.",
  "rrdatas": [
      "100 10 \"\" \"\" \"!^urn:cid:.+@([^\\\\.]+\\\\.)(.*)$!\\\\2!i\" ."
  ],
  "ttl": 300,
  "type": "NAPTR"
}
NS

네임서버 레코드입니다. DNS 영역을 권한 서버에 위임합니다.

리소스 레코드 모음 표현의 예는 다음과 같습니다.


{
  "kind": "dns#resourceRecordSet",
  "name": "example.com.",
  "rrdatas": [
      "ns-cloud1.googledomains.com."
  ],
  "ttl": 86400,
  "type": "NS"
}

호스트 이름이 정규화된 DNS 이름이 되려면 rrdatas 필드가 마침표(.)로 끝나야 합니다.

PTR

포인터 레코드입니다. 주로 역방향 DNS 조회에 사용됩니다.

리소스 레코드 모음 표현의 예는 다음과 같습니다.


{
  "kind": "dns#resourceRecordSet",
  "name": "2.1.0.10.in-addr.arpa.",
  "rrdatas": [
    "server.example.com."
  ],
  "ttl": 60,
  "type": "PTR"
}

주소 10.0.1.2에서 호스트 이름 server.example.com까지의 매핑을 만듭니다. 이는 0.10.in-addr.arpa이라는 관리형 영역에서 정의할 수 있습니다.

SOA

기관 레코드의 시작입니다. DNS 영역에 대한 권한 정보를 지정합니다. SOA 리소스 레코드는 관리형 영역을 만들면 생성됩니다. 필요에 따라 이 레코드를 수정할 수 있습니다.

리소스 레코드 모음 표현의 예는 다음과 같습니다.


{
  "kind": "dns#resourceRecordSet",
  "name": "example.com.",
  "rrdatas": [
    "ns-cloud1.googledomains.com. dns-admin.google.com. 1 21600 3600 1209600 300"
  ],
  "ttl": 21600,
  "type": "SOA"
}

호스트 이름이 정규화된 DNS 이름이 되려면 rrdatas 필드가 마침표(.)로 끝나야 합니다.

SPF

보내는 사람 정책 프레임워크 레코드입니다. 이메일 유효성 검사 시스템에서 사용됩니다.

리소스 레코드 집합 표현의 예는 다음과 같습니다.


{
  "kind": "dns#resourceRecordSet",
  "name": "example.com.",
  "rrdatas": [
    "v=spf1 mx:example.com -all"
  ],
  "ttl": 21600,
  "type": "SPF"
}
SRV

서비스 로케이터 레코드입니다. 일부 VoIP, 채팅 프로토콜, 기타 애플리케이션에서 사용됩니다.

리소스 레코드 모음 표현의 예는 다음과 같습니다.


{
  "kind": "dns#resourceRecordSet",
  "name": "sip.example.com.",
  "rrdatas": [
    "0 5 5060 sip.example.com."
  ],
  "ttl": 21600,
  "type": "SRV"
}

호스트 이름이 정규화된 DNS 이름이 되려면 rrdatas 필드가 마침표(.)로 끝나야 합니다.

TXT

텍스트 레코드입니다. 임의 텍스트가 포함될 수 있으며 보안 또는 악용 방지 정보와 같은 머신이 읽을 수 있는 데이터를 정의하는 데 사용됩니다.

리소스 레코드 모음 표현의 예는 다음과 같습니다.


{
  "kind": "dns#resourceRecordSet",
  "name": "example.com.",
  "rrdatas": [
    "google-site-verification=xxxxxxxxxxxxYYYYYYXXX"
  ],
  "ttl": 21600,
  "type": "TXT"
}

TXT 레코드는 문자열 목록(RFC 1035)으로 구성됩니다. 영역 파일 형식에서는 이 목록을 공백으로 구분된 문자열의 시퀀스로 작성합니다. 각 문자열을 따옴표로 묶거나 묶지 않을 수 있습니다. 문자열 중 하나에 공백이 포함되어 있으면 따옴표로 묶는 형태를 사용해야 합니다. 예를 들면 다음과 같습니다.


{
  "kind": "dns#resourceRecordSet",
  "name": "example.com.",
  "rrdatas": [
    "\"v=spf1 include:_spf.google.com ~all\""
  ],
  "ttl": 21600,
  "type": "TXT"
}

이전 리소스 레코드 집합은 단일 문자열과 공백이 포함된 단일 TXT 리소스 레코드로 구성됩니다.

와일드 카드 DNS 레코드

와일드 카드 레코드는 NS 레코드를 제외한 모든 레코드 유형에 지원됩니다. 예를 들어 다음 Change 요청을 사용하여 모든 하위 도메인을 IP 주소 1.2.3.4에 매핑할 수 있습니다.

{
"additions": [
    {
      "kind": "dns#resourceRecordSet",
      "name": "*.example.com.",
      "rrdatas": [
        "1.2.3.4"
       ],
       "ttl": 21600,
       "type": "A"
    }
]
}

다음 단계

  • 레코드 관리에서는 이들 형식을 사용하는 방법을 설명합니다.
  • 개요에서는 전체 프레임워크에서 이들 형식이 어떤 위치를 차지하는지 보여줍니다.