이 페이지에서는 Cloud DNS를 사용할 때 발생할 수 있는 일반적인 오류 메시지, 메시지 의미, 오류 해결에 권장되는 조치를 설명합니다.
일반적인 오류
이 섹션에서는 일반적인 오류를 설명합니다.
alreadyExists
지정된 리소스가 이미 있습니다. 복제본을 만들 수 없습니다.
권장 조치: 리소스 생성 시 적절한 get/list API를 사용하여 이미 있는 리소스를 검색하세요.
레코드를 추가할 때 이 오류가 발생하면 개별 레코드가 레코드 모음으로 처리되기 때문입니다. 즉, 각 항목(여러 항목이 있는 경우)이 하나의 서로 다른 레코드로 작동합니다. 첫 번째 값과 두 번째 값 사이에 공백을 추가하여 동일한 DNS(도메인 이름 시스템) 이름의 레코드 집합에 두 개의 값 또는 문자열을 추가할 수 있습니다.
이 오류를 해결하는 방법에 대한 자세한 내용은 충돌하는 레코드 오류 해결을 참조하세요.
accessNotConfigured
액세스 권한이 구성되지 않았습니다.
이 오류를 해결하려면 프로젝트에 Cloud DNS API를 사용 설정해야 합니다.
inactiveBillingState
example_project프로젝트는 비활성 결제 상태에서 요청을 수락할 수 없습니다. 결제 상태를 업데이트하는 데 수 분이 걸릴 수 있습니다.
권장 조치: 프로젝트에 결제를 사용 설정합니다. 새 프로젝트의 결제를 사용 설정하거나 기존 프로젝트의 결제를 다시 사용 설정하려면 프로젝트 결제 사용 설정의 적절한 단계를 따릅니다.
preconditionFailed
요청의 특정 부분이 서버 리소스의 현재 상태와 호환되지 않음을 의미하는 일반 오류입니다. 클라이언트가 문제를 해결한 후 다시 시도해야 합니다. 이미 있는 리소스 레코드 모음(동일한 이름과 유형)과 일치하지 않는 리소스 레코드 모음을 삭제하려는 create 변경 요청을 전송하는 경우에 발생할 수 있습니다.
현재 영역의 상태를 읽고 삭제할 항목을 결정합니다. 마지막으로 본 이후로 변경되었을 수 있습니다.
오류 메시지에는 요청의 문제가 있는 부분에 대한 경로가 포함됩니다. 예를 들어 entity.change.deletions[6]은 요청의 POST 본문에서 변경 객체의 deletions 배열에 있는 7번째 요소를 가리킵니다.
권장 조치: 문제가 있는 것으로 신고된 요청 부분을 수정하세요.
required
요청의 일부 필수 부분이 누락되었음을 의미하는 일반 오류입니다. 예를 들어 관리형 영역을 만들려면 이름, DNS 이름, 설명이 필요합니다. 이러한 필드 중 하나라도 누락되면 이 오류가 발생하며 요청이 실패합니다.
권장 조치: 필수 매개변수를 입력하고 다시 시도하세요.
notFound
지정된 리소스가 없습니다.
권장 조치: 기존 리소스 이름을 사용하고 있는지 확인하세요.
quotaExceeded
임박한 변경이 현재 할당량을 초과하면 이 오류가 발생합니다.
할당량은 프로젝트와 관련됩니다. 예를 들어 각 영역에는 특정 수의 리소스 레코드 모음만 허용됩니다. 할당량을 늘려야 하는 경우 Google Cloud 영업팀에 문의하세요. 새 프로젝트에는 Cloud DNS 리소스 할당량 및 한도에 지정된 기본 할당량이 있습니다.
DNS가 제한하는 모든 측정기준은 Projects.get 작업을 참조하세요.
권장 조치: 프로젝트를 점검하여 해당 리소스를 많이 사용하고 있는 이유를 확인하세요. 프로젝트의 Google Cloud Console 할당량 페이지에서 프로젝트의 할당량 증가를 요청할 수 있습니다. 또한 할당량 작업을 참조하세요.
관리형 영역 관련 오류
이 섹션에는 관리형 영역과 관련된 오류가 나열되어 있습니다.
invalidFieldValue
잘못된
entity.managedZone.name값입니다.
관리형 영역 이름이 문자로 시작되지 않거나, 문자 또는 숫자로 끝나지 않거나, 소문자, 숫자 또는 대시 외 다른 문자를 포함하지 않는 경우 이 오류가 발생하며 관리형 영역을 만드는 작업이 실패할 수 있습니다.
managedZoneDnsNameNotAvailable
지정된 관리형 영역을 사용할 수 없으므로 만들 수 없습니다.
다음과 같은 이유로 관리형 영역을 만드는 작업은 이 오류가 발생하며 실패할 수 있습니다.
- 제안된 영역의 DNS 이름이 예약된 이름입니다(예: 점(
.),.com,.co.uk). - 영역의 DNS 이름을 호스트할 수 있는 네임서버가 더 이상 없습니다. Cloud DNS는 네임서버 풀을 사용하며 이 풀은 유한합니다. 각 네임서버에서의 DNS 쿼리는 관리형 영역 한 개와 명확하게 매핑되어야 합니다. 자세한 내용은 네임서버 한도를 참조하세요.
권장 조치: 해당 DNS 이름의 등록된 소유자인 경우 중첩 영역이 있는지 확인하세요. 도메인과 하위 도메인에 DNS를 설정하려면 먼저 상위 영역 하나를 만들고 이 영역의 하위 도메인마다 레코드를 추가하는 것이 좋습니다.
verifyManagedZoneDnsNameOwnership
example.com도메인(또는 상위)의 소유권을 확인한 후 다시 시도하세요.
권장 조치: 이 오류가 발생하면 도메인 소유권을 확인한 후 다시 시도해야 합니다.
관리형 레코드 관련 오류
이 섹션의 오류는 레코드와 관련이 있습니다.
containerNotEmpty
지정된 리소스가 비어 있지 않으므로 삭제될 수 없습니다.
권장 조치: 리소스를 삭제하려면 먼저 리소스를 비워야 합니다.
invalidZoneApex
영역의 루트에는 특정 유형의 리소스 레코드 집합이 하나만 포함되어야 하므로, 지정된 리소스 레코드 집합이 유효하지 않습니다.
DNS 컨텍스트에서 Apex는 영역에서 허용되는 라벨 수가 최소인 DNS 이름을 의미합니다. 또한 영역 계층 구조 맨 위에 있습니다.
영역의 루트는 ManagedZone.dnsName과 동일한 DNS 이름입니다.
이 오류는 영역이 루트에서 특정 유형의 리소스 레코드 모음을 하나만 포함해야 한다는 DNS 규칙을 위반하는 변경을 시도했음을 의미합니다. 다음 작업으로 인해 이 오류가 발생할 수 있습니다.
- 루트에서 필요한
NS리소스 레코드 모음을 삭제하려 했습니다. - 루트에서 필요한
SOA리소스 레코드 모음을 삭제하려 했습니다. - 루트가 아닌 곳에
SOA유형의 리소스 레코드 모음을 만들려 했습니다.
권장 조치: 이 오류가 발생한다는 것은 DNS 규칙에서 허용되지 않는 작업을 수행하려고 한다는 것입니다. 요청에 잘못된 부분이 있는지 확인하세요. 필수 리소스 레코드 모음을 삭제할 필요는 없습니다.
invalidRecordCount
리소스 레코드 모음
entity.change.additions[XX]는<SOA_OR_CNAME>유형이므로 레코드 한 개만 포함할 수 있습니다.
DNS 규칙에서는 SOA 및 CNAME 리소스 레코드 집합에 리소스 레코드 하나만 포함될 수 있다고 규정합니다. 이러한 규칙을 위반하여 항목을 변경하려고 시도하면 이 오류가 발생합니다. 예를 들면 다음과 같습니다.
{
kind: "dns#rrset"
name: "blog.foo.com.",
type: "CNAME",
rrdata: [ "www.foo.com.", "www2.foo.com." ],
...
}
권장 조치: 이 오류가 발생하면 요청을 확인하세요. 허용되지 않는 작업을 수행하려 하는 중입니다.
cnameResourceRecordSetConflict
DNS 이름
example.com에는 하나의 CNAME 리소스 레코드 모음 또는 다른 유형의 리소스 레코드 모음이 있을 수 있으나 둘 다 있을 수는 없으므로 리소스 레코드 모음entity.change.additions[XX]은 유효하지 않습니다.
이 오류는 동일한 DNS 이름에 대해 A 레코드와 CNAME 레코드와 같은 두 가지 유형의 리소스 레코드 모음을 만드는 경우에 발생합니다. 이 오류의 일반적인 원인은 영역 루트에 CNAME 레코드를 만들려고 시도하는 것입니다. 동일한 이름의 필수 SOA 및 NS 레코드와 충돌하므로, 이 작업은 불가능합니다.
권장 조치: 둘 중 하나를 선택합니다
wildcardNotAllowed
지정된 리소스 레코드 모음의 유형이 와일드 카드가 아닙니다.
DNS에서 와일드 카드는 존재하지 않는 도메인 이름에 대한 요청과 일치하는 특수 유형의 리소스 레코드 집합입니다. Cloud DNS의 한 가지 제한사항은 NS 유형의 와일드 카드 리소스 레코드 모음을 만들 수 없다는 점입니다.
권장 조치: 현재 와일드 카드 NS 리소스 레코드 집합은 지원되지 않습니다. Cloud DNS 지원팀에 문의하거나 cloud-dns-discuss에 가입하여 수행하려는 작업을 알려주세요.
recordTypeDisallowedAtZoneApex
영역 루트에 필요한
SOA레코드를 포함하여 지정된 리소스 레코드는 다른 레코드 유형과 함께 존재할 수 없습니다.
영역 루트에 필요한 SOA 리소스 레코드를 포함하여 CNAME 리소스 레코드가 다른 레코드 유형과 함께 존재할 수 없으므로 이 리소스 레코드를 루트에 배치할 수 없습니다.
권장 조치: ALIAS 리소스 레코드를 사용합니다. ALIAS 리소스 레코드는 CNAME 리소스 레코드처럼 작동하지만 영역 루트에서만 사용할 수 있으며 주소 레코드(A 또는 AAAA) 쿼리에만 응답하는 Cloud DNS 커스텀 레코드 유형입니다. 자세한 내용은 별칭 레코드를 참조하세요.
invalidValue
서버의 상태와 관계없이 요청의 특정 부분이 유효하지 않음을 의미하는 일반 오류입니다. 오류 메시지에는 요청의 문제가 있는 부분에 대한 경로와 유효하지 않은 값이 포함됩니다. 이 오류는 다음과 같은 여러 가지 이유로 트리거될 수 있습니다.
- 잘못된 이름의 리소스 레코드 모음을 지정했습니다. 예를 들어
foo...bar는 유효한 DNS 이름이 아닙니다(중간 라벨이 비어 있음). - 잘못된 유형의 리소스 레코드 모음을 지정했습니다. 예를 들어 A와 CNAME는 유효한 유형이지만 XXX는 유효한 유형이 아닙니다.
- 레코드가 없는 리소스 레코드 모음을 지정했습니다.
- 잘못된 리소스 레코드 데이터를 지정했습니다. 예를 들어
1.1.1.1은 유형 A에 대한 유효한 리소스 레코드 데이터입니다. XXX는 유형 A에 대한 잘못된 리소스 레코드 데이터입니다. - TTL이 잘못된 리소스 레코드 모음을 지정했습니다. TTL은 음수가 아닌 정수여야 합니다.
- 너무 긴 리소스 이름을 지정했습니다.
권장 조치: 요청을 수정하세요.
다음 단계
- 기능에 대한 자세한 내용은 Cloud DNS 개요를 참조하세요.
- Cloud DNS를 사용할 때 발생할 수 있는 일반적인 문제에 대한 해결책을 찾으려면 문제 해결을 참조하세요.
- 추가 도움을 받으려면 지원을 참조하세요.