Thông báo lỗi

Trang này mô tả các thông báo lỗi phổ biến mà bạn có thể nhận được khi sử dụng Cloud DNS, ý nghĩa của các thông báo đó và các hành động được đề xuất để giải quyết lỗi.

Lỗi chung

Phần này mô tả các lỗi chung.

alreadyExists

Tài nguyên đã chỉ định đã tồn tại; bạn không thể tạo tài nguyên trùng lặp.

Hành động được đề xuất: Khi tạo tài nguyên, hãy sử dụng API get/list thích hợp để khám phá những tài nguyên đã tồn tại.

Nếu bạn gặp lỗi này khi thêm bản ghi, thì đó là do một bản ghi riêng lẻ được coi là một tập hợp bản ghi, nghĩa là mỗi mục nhập (nếu bạn có nhiều mục nhập) sẽ đóng vai trò là một bản ghi khác. Bạn có thể thêm hai giá trị hoặc chuỗi vào tập hợp bản ghi cho cùng một tên Hệ thống tên miền (DNS) bằng cách thêm một dấu cách giữa giá trị đầu tiên và giá trị thứ hai.

Để biết thêm thông tin về cách giải quyết lỗi này, hãy xem phần Khắc phục lỗi xung đột bản ghi.

accessNotConfigured

Chưa định cấu hình quyền truy cập

Để giải quyết lỗi này, bạn phải bật Cloud DNS API cho dự án của mình.

inactiveBillingState

Dự án example_project không thể chấp nhận yêu cầu khi ở trạng thái thanh toán không hoạt động. Có thể mất vài phút để cập nhật trạng thái thanh toán.

Việc nên làm: Bật thông tin thanh toán cho dự án của bạn. Để bật tính năng thanh toán cho một dự án mới hoặc để bật lại tính năng thanh toán cho một dự án hiện có, hãy làm theo các bước thích hợp trong bài viết Bật tính năng thanh toán cho một dự án.

preconditionFailed

Đây là lỗi chung có nghĩa là có gì đó về yêu cầu không tương thích với trạng thái hiện tại của tài nguyên máy chủ. Ứng dụng phải làm gì đó để khắc phục rồi thử lại. Điều này có thể xảy ra nếu bạn gửi một yêu cầu thay đổi create để xoá một nhóm bản ghi tài nguyên không khớp với nhóm bản ghi hiện có (cùng tên và loại).

Đọc trạng thái hiện tại của vùng và quyết định những gì bạn muốn xoá. Thông tin này có thể đã thay đổi kể từ lần gần đây nhất bạn xem.

Thông báo lỗi bao gồm đường dẫn đến phần có vấn đề trong yêu cầu của bạn. Ví dụ: entity.change.deletions[6] đề cập đến phần tử thứ bảy trong mảng deletions của đối tượng thay đổi trong phần nội dung POST của yêu cầu.

Việc nên làm: Khắc phục phần yêu cầu bị gắn cờ là có vấn đề.

required

Đây là lỗi chung có nghĩa là thiếu một số phần bắt buộc của yêu cầu. Ví dụ: yêu cầu tạo vùng được quản lý cần có tên, tên DNS và nội dung mô tả. Nếu thiếu bất kỳ trường nào trong số này, yêu cầu sẽ không thành công và báo lỗi này.

Việc nên làm: Điền tham số bắt buộc rồi thử lại.

notFound

Tài nguyên được chỉ định không tồn tại.

Hành động đề xuất: Đảm bảo rằng bạn đang sử dụng tên của một tài nguyên hiện có.

quotaExceeded

Bạn gặp lỗi này khi một thay đổi sắp tới sẽ vượt quá hạn mức hiện tại của bạn. Hạn mức này được liên kết với dự án. Ví dụ: bạn chỉ được phép có một số lượng nhất định các nhóm bản ghi tài nguyên trong mỗi vùng. Nếu bạn cần tăng hạn mức, hãy liên hệ với nhóm bán hàng Google Cloud . Các dự án mới có hạn mức mặc định như được chỉ định trong phần Hạn mức và hạn mức tài nguyên của Cloud DNS. Đối với tất cả các phương diện mà DNS giới hạn, hãy xem thao tác Projects.get.

Việc nên làm: Kiểm tra dự án của bạn để tìm hiểu lý do bạn đang sử dụng nhiều tài nguyên đó. Bạn có thể yêu cầu tăng hạn mức cho một dự án trên trang Hạn mức của bảng điều khiển Google Cloud cho dự án đó. Bạn cũng có thể tham khảo bài viết Yêu cầu điều chỉnh hạn mức.

Lỗi liên quan đến các vùng được quản lý

Phần này liệt kê các lỗi liên quan đến các vùng được quản lý.

invalidFieldValue

Giá trị không hợp lệ cho entity.managedZone.name.

Thao tác tạo vùng được quản lý có thể không thành công do lỗi này nếu tên vùng được quản lý không bắt đầu bằng chữ cái, kết thúc bằng chữ cái hoặc chữ số và chỉ chứa chữ cái viết thường, chữ số hoặc dấu gạch ngang.

managedZoneDnsNameNotAvailable

Vùng được quản lý đã chỉ định không có sẵn nên không thể tạo.

Thao tác tạo vùng được quản lý có thể không thành công với lỗi này vì những lý do sau:

• Tên DNS của vùng đề xuất đã được đặt trước, ví dụ: dấu chấm (.), .com hoặc .co.uk.
• Không còn máy chủ định danh nào để lưu trữ tên DNS của vùng. Cloud DNS sử dụng một nhóm máy chủ định danh và nhóm đó có giới hạn. Truy vấn DNS đến bất kỳ máy chủ định danh nào phải liên kết rõ ràng với một vùng được quản lý. Để biết thêm thông tin chi tiết, hãy xem phần giới hạn về máy chủ định danh.

Hành động nên làm: Nếu bạn là chủ sở hữu đã đăng ký của tên DNS có liên quan, hãy kiểm tra xem có vùng trùng lặp hay không. Để thiết lập DNS cho một miền và các miền con của miền đó, trước tiên, bạn nên tạo một vùng gốc và thêm các bản ghi cho từng miền con trong vùng đó.

verifyManagedZoneDnsNameOwnership

Xác minh quyền sở hữu miền example.com (hoặc miền mẹ), rồi thử lại.

Hành động đề xuất: Khi gặp lỗi này, bạn phải xác minh quyền sở hữu miền rồi thử lại.

Lỗi liên quan đến bản ghi được quản lý

Các lỗi trong phần này liên quan đến bản ghi.

containerNotEmpty

Không thể xoá tài nguyên đã chỉ định vì tài nguyên đó không trống.

Việc nên làm: Nếu muốn xoá tài nguyên, trước tiên, bạn phải làm trống tài nguyên đó.

invalidZoneApex

Tập hợp bản ghi tài nguyên được chỉ định là không hợp lệ vì một vùng phải chứa đúng một tập hợp bản ghi tài nguyên thuộc một loại nhất định ở đỉnh.

Apex trong ngữ cảnh DNS có nghĩa là tên DNS có số lượng nhãn ít nhất được phép trong vùng. Đây cũng là cấp cao nhất của hệ phân cấp vùng. Đỉnh của một vùng là tên DNS bằng với ManagedZone.dnsName.

Lỗi này có nghĩa là bạn đã cố gắng thực hiện một thay đổi vi phạm quy tắc DNS rằng một vùng phải chứa đúng một tập hợp bản ghi tài nguyên thuộc một loại nhất định ở đỉnh. Các thao tác sau đây có thể gây ra lỗi này:

• Bạn đã cố gắng xoá nhóm bản ghi tài nguyên NS bắt buộc ở đỉnh.
• Bạn đã cố gắng xoá nhóm bản ghi tài nguyên SOA bắt buộc ở đỉnh.
• Bạn đã cố gắng tạo một tập hợp bản ghi tài nguyên thuộc loại SOA không ở đỉnh.

Hành động đề xuất: Nếu gặp lỗi này, tức là bạn đang cố gắng làm một việc không được phép theo quy tắc của DNS. Kiểm tra yêu cầu của bạn để tìm lỗi. Bạn không cần xoá các nhóm bản ghi tài nguyên bắt buộc.

invalidRecordCount

Tập hợp bản ghi tài nguyên entity.change.additions[XX] chỉ được phép có một bản ghi vì thuộc loại <SOA_OR_CNAME>.

Quy tắc của DNS cho biết rằng các nhóm bản ghi tài nguyên SOA và CNAME chỉ có thể có một bản ghi tài nguyên. Bạn sẽ gặp lỗi này nếu cố gắng tạo một thay đổi vi phạm các quy tắc đó. Ví dụ:

  {
    kind: "dns#rrset"
    name: "blog.foo.com.",
    type: "CNAME",
    rrdata: [ "www.foo.com.", "www2.foo.com." ],
    ...
  }

Việc bạn nên làm: Nếu bạn gặp lỗi này, hãy kiểm tra yêu cầu của mình. Bạn đang cố gắng làm một việc không được phép.

cnameResourceRecordSetConflict

Tập hợp bản ghi tài nguyên entity.change.additions[XX] không hợp lệ vì tên DNS example.com có thể có một tập hợp bản ghi tài nguyên CNAME hoặc tập hợp bản ghi tài nguyên thuộc các loại khác, nhưng không thể có cả hai.

Lỗi này xảy ra khi bạn tạo hai loại nhóm bản ghi tài nguyên, chẳng hạn như cả bản ghi A và bản ghi CNAME cho cùng một tên DNS. Một nguyên nhân phổ biến gây ra lỗi này là khi cố gắng tạo bản ghi CNAME ở đỉnh vùng. Bạn không thể làm như vậy vì sẽ xung đột với các bản ghi SOA và NS bắt buộc có cùng tên.

Hành động được đề xuất: Chọn một trong hai.

wildcardNotAllowed

Tập hợp bản ghi tài nguyên được chỉ định có loại không chính xác để làm ký tự đại diện.

Trong DNS, ký tự đại diện là một loại tập hợp bản ghi tài nguyên đặc biệt giúp so khớp các yêu cầu về tên miền không tồn tại. Một hạn chế của DNS trên đám mây là bạn không thể tạo một nhóm bản ghi tài nguyên ký tự đại diện thuộc loại NS.

Hành động đề xuất: Chúng tôi hiện không hỗ trợ các nhóm bản ghi tài nguyên NS có ký tự đại diện. Hãy liên hệ với Nhóm hỗ trợ Cloud DNS hoặc tham gia nhóm cloud-dns-discuss để chia sẻ những gì bạn đang cố gắng thực hiện.

recordTypeDisallowedAtZoneApex

Bản ghi tài nguyên được chỉ định không thể tồn tại cùng với bất kỳ loại bản ghi nào khác, bao gồm cả bản ghi SOA bắt buộc ở đỉnh vùng.

Bạn không thể đặt bản ghi tài nguyên CNAME ở đỉnh vì bản ghi này không thể tồn tại cùng với bất kỳ loại bản ghi tài nguyên nào khác, bao gồm cả bản ghi tài nguyên SOA bắt buộc ở đỉnh vùng.

Hành động được đề xuất: Sử dụng bản ghi tài nguyên ALIAS. Bản ghi tài nguyên ALIAS là một loại bản ghi tuỳ chỉnh của Cloud DNS hoạt động giống như bản ghi tài nguyên CNAME nhưng chỉ có thể được sử dụng ở đỉnh vùng và chỉ phản hồi các truy vấn bản ghi địa chỉ (A hoặc AAAA). Để biết thêm thông tin, hãy xem phần Bản ghi bí danh.

invalidValue

Đây là lỗi chung có nghĩa là có gì đó không hợp lệ về yêu cầu của bạn, không phụ thuộc vào trạng thái của máy chủ. Thông báo lỗi bao gồm đường dẫn đến phần có vấn đề của yêu cầu, cũng như giá trị không hợp lệ. Lỗi này có thể được kích hoạt bởi nhiều yếu tố, chẳng hạn như:

• Bạn đã chỉ định một tập hợp bản ghi tài nguyên có tên không hợp lệ. Ví dụ: foo...bar không phải là tên DNS hợp lệ (nhãn giữa trống).
• Bạn đã chỉ định một nhóm bản ghi tài nguyên có loại không hợp lệ. Ví dụ: A và CNAME là các loại hợp lệ, nhưng XXX thì không.
• Bạn đã chỉ định một tập hợp bản ghi tài nguyên không có bản ghi nào trong đó.
• Bạn đã chỉ định dữ liệu bản ghi tài nguyên không hợp lệ. Ví dụ: 1.1.1.1 là dữ liệu bản ghi tài nguyên hợp lệ cho loại A. XXX là dữ liệu bản ghi tài nguyên không hợp lệ cho loại A.
• Bạn đã chỉ định một tập hợp bản ghi tài nguyên có TTL không hợp lệ. TTL phải là một số nguyên không âm.
• Bạn đã chỉ định tên tài nguyên quá dài.

Việc nên làm: Sửa yêu cầu của bạn.

Bước tiếp theo

• Để tìm hiểu thêm về các tính năng, hãy xem bài viết Tổng quan về Cloud DNS.
• Để tìm giải pháp cho các vấn đề thường gặp mà bạn có thể gặp phải khi sử dụng Cloud DNS, hãy xem phần Khắc phục sự cố.
• Để được trợ giúp thêm, hãy xem phần Hỗ trợ.