Pesan error

Halaman ini menjelaskan pesan error umum yang mungkin Anda terima saat menggunakan Cloud DNS, arti pesan tersebut, dan tindakan yang direkomendasikan untuk menyelesaikan error.

Error umum

Bagian ini menjelaskan error umum.

alreadyExists

Resource yang ditentukan sudah ada; Anda tidak dapat membuat duplikat.

Tindakan yang direkomendasikan: Saat membuat resource, gunakan get/list API yang sesuai untuk menemukan resource yang sudah ada.

Jika Anda mendapatkan error ini saat menambahkan data, hal ini karena setiap data dianggap sebagai kumpulan data, yang berarti setiap entri (jika Anda memiliki beberapa entri) bertindak sebagai data yang berbeda. Anda dapat menambahkan dua nilai atau string ke kumpulan data untuk nama Domain Name System (DNS) yang sama dengan menambahkan spasi di antara nilai pertama dan nilai kedua.

Untuk mengetahui informasi selengkapnya tentang cara mengatasi error ini, lihat Memperbaiki error data yang mengalami konflik.

accessNotConfigured

Akses tidak dikonfigurasi

Untuk mengatasi error ini, Anda harus mengaktifkan Cloud DNS API untuk project Anda.

inactiveBillingState

Project example_project tidak dapat menerima permintaan saat dalam status penagihan tidak aktif. Pembaruan status penagihan mungkin memerlukan waktu beberapa menit.

Tindakan yang direkomendasikan: Aktifkan penagihan untuk project Anda. Untuk mengaktifkan penagihan untuk project baru, atau mengaktifkan kembali penagihan untuk project yang ada, ikuti langkah-langkah yang sesuai di Mengaktifkan penagihan untuk project.

preconditionFailed

Ini adalah error umum yang berarti ada sesuatu tentang permintaan yang tidak kompatibel dengan status resource server saat ini. Klien harus melakukan sesuatu untuk memperbaikinya, lalu mencoba lagi. Hal ini dapat terjadi jika Anda mengirim permintaan perubahan create yang mencoba menghapus kumpulan data resource yang tidak cocok dengan kumpulan data yang sudah ada (nama dan jenis yang sama).

Baca status zona saat ini dan tentukan apa yang ingin Anda hapus. Halaman tersebut mungkin telah berubah sejak Anda terakhir kali melihatnya.

Pesan error menyertakan jalur ke bagian permintaan Anda yang bermasalah. Misalnya, entity.change.deletions[6] merujuk pada elemen ketujuh dalam array deletions objek perubahan dalam isi POST permintaan Anda.

Tindakan yang disarankan: Perbaiki bagian permintaan yang ditandai sebagai bermasalah.

required

Ini adalah error umum yang berarti bahwa beberapa bagian permintaan yang diperlukan tidak ada. Misalnya, permintaan untuk membuat zona terkelola memerlukan nama, nama DNS, dan deskripsi. Jika salah satu kolom ini tidak ada, permintaan akan gagal dengan error ini.

Tindakan yang disarankan: Isi parameter yang diperlukan, lalu coba lagi.

notFound

Resource yang ditentukan tidak ada.

Tindakan yang direkomendasikan: Pastikan Anda menggunakan nama resource yang ada.

quotaExceeded

Anda mendapatkan error ini jika perubahan yang akan datang akan melebihi kuota Anda saat ini. Kuota dikaitkan dengan project. Misalnya, Anda hanya diizinkan untuk membuat sejumlah kumpulan data resource tertentu di setiap zona. Jika Anda memerlukan peningkatan kuota, hubungi tim penjualan Google Cloud. Project baru memiliki kuota default seperti yang ditentukan dalam Kuota dan batas resource Cloud DNS. Untuk semua dimensi yang dibatasi DNS, lihat operasi Projects.get.

Tindakan yang disarankan: Periksa project Anda untuk memahami alasan Anda sudah menggunakan resource tersebut dalam jumlah besar. Anda dapat meminta peningkatan kuota untuk project di halaman Quotas di konsol Google Cloud untuk project tersebut. Anda juga dapat membaca artikel Mengelola kuota.

Error yang terkait dengan zona terkelola

Bagian ini mencantumkan error yang terkait dengan zona terkelola.

invalidFieldValue

Nilai tidak valid untuk entity.managedZone.name.

Operasi untuk membuat zona terkelola dapat gagal dengan error ini jika nama zona terkelola tidak dimulai dengan huruf, diakhiri dengan huruf atau angka, dan hanya berisi huruf kecil, angka, atau tanda hubung.

managedZoneDnsNameNotAvailable

Zona terkelola yang ditentukan tidak tersedia sehingga tidak dapat dibuat.

Operasi untuk membuat zona terkelola dapat gagal dengan error ini karena alasan berikut:

  • Nama DNS zona yang diusulkan dicadangkan, misalnya, titik (.), .com, atau .co.uk.
  • Tidak ada lagi server nama yang tersedia untuk menghosting nama DNS zona. Cloud DNS menggunakan kumpulan server nama, dan kumpulan tersebut terbatas. Kueri DNS ke server nama apa pun harus dipetakan secara tidak ambigu ke satu zona terkelola. Untuk mengetahui detail selengkapnya, lihat batas server nama.

Tindakan yang direkomendasikan: Jika Anda adalah pemilik terdaftar dari nama DNS yang dipermasalahkan, periksa zona yang tumpang-tindih. Untuk menyiapkan DNS bagi domain dan subdomainnya, sebaiknya buat satu zona induk terlebih dahulu dan tambahkan data untuk setiap subdomain di zona tersebut.

verifyManagedZoneDnsNameOwnership

Verifikasi kepemilikan domain example.com (atau induk), lalu coba lagi.

Tindakan yang direkomendasikan: Jika menerima error ini, Anda harus memverifikasi kepemilikan domain, lalu coba lagi.

Error yang terkait dengan kumpulan data terkelola

Error di bagian ini terkait dengan data.

containerNotEmpty

Resource yang ditentukan tidak dapat dihapus karena tidak kosong.

Tindakan yang disarankan: Jika ingin menghapus resource, Anda harus mengosongkannya terlebih dahulu.

invalidZoneApex

Kumpulan data resource yang ditentukan tidak valid karena zona harus berisi tepat satu kumpulan data resource dari jenis tertentu di puncak.

Apex dalam konteks DNS berarti nama DNS dengan jumlah label terkecil yang diizinkan di zona. Ini juga merupakan bagian atas hierarki zona. Apex zona adalah nama DNS yang sama dengan ManagedZone.dnsName.

Error ini berarti Anda mencoba membuat perubahan yang akan melanggar aturan DNS bahwa zona harus berisi tepat satu kumpulan data resource dari jenis tertentu di apex. Tindakan berikut dapat menyebabkan error ini:

  • Anda mencoba menghapus kumpulan data resource NS yang diperlukan di apex.
  • Anda mencoba menghapus kumpulan data resource SOA yang diperlukan di apex.
  • Anda mencoba membuat kumpulan data resource jenis SOA not di apex.

Tindakan yang direkomendasikan: Jika mendapatkan error ini, Anda mencoba melakukan sesuatu yang tidak diizinkan berdasarkan aturan DNS. Periksa permintaan Anda untuk menemukan kesalahan. Tidak perlu menghapus kumpulan data resource yang diperlukan.

invalidRecordCount

Kumpulan data resource entity.change.additions[XX] hanya diizinkan untuk memiliki satu data karena jenisnya adalah <SOA_OR_CNAME>.

Aturan DNS menyatakan bahwa kumpulan data resource SOA dan CNAME hanya dapat memiliki satu data resource. Anda akan mendapatkan error ini jika mencoba membuat perubahan yang akan melanggar aturan tersebut. Contoh:

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

Tindakan yang disarankan: Jika Anda mendapatkan error ini, periksa permintaan Anda. Anda mencoba melakukan sesuatu yang tidak diizinkan.

cnameResourceRecordSetConflict

Kumpulan data resource entity.change.additions[XX] tidak valid karena nama DNS example.com mungkin memiliki satu kumpulan data resource CNAME atau beberapa kumpulan data resource jenis lainnya, tetapi tidak keduanya.

Error ini terjadi saat Anda membuat dua jenis kumpulan data resource, seperti data A dan data CNAME untuk nama DNS yang sama. Penyebab umum error ini adalah mencoba membuat data CNAME di apex zona. Hal ini tidak mungkin karena akan bertentangan dengan data SOA dan NS yang diperlukan dengan nama yang sama.

Tindakan yang disarankan: Pilih salah satunya.

wildcardNotAllowed

Kumpulan data resource yang ditentukan memiliki jenis yang salah untuk menjadi karakter pengganti.

Di DNS, karakter pengganti adalah jenis kumpulan data resource khusus yang cocok dengan permintaan untuk nama domain yang tidak ada. Salah satu batasan Cloud DNS adalah Anda tidak dapat membuat kumpulan data resource karakter pengganti jenis NS.

Tindakan yang direkomendasikan: Kumpulan data resource NS karakter pengganti tidak didukung saat ini. Hubungi Dukungan Cloud DNS atau bergabunglah ke cloud-dns-discuss dan bagikan hal yang ingin Anda capai.

recordTypeDisallowedAtZoneApex

Data resource yang ditentukan tidak dapat ada bersama jenis data lainnya, termasuk data SOA yang diperlukan di puncak zona.

Anda tidak dapat menempatkan data resource CNAME di apex karena tidak dapat ada bersama jenis data resource lainnya, termasuk data resource SOA yang diperlukan di apex zona.

Tindakan yang disarankan: Gunakan data resource ALIAS. Data resource ALIAS adalah jenis data kustom Cloud DNS yang berperilaku seperti data resource CNAME, tetapi hanya dapat digunakan di apex zona dan hanya merespons kueri data alamat (A atau AAAA). Untuk informasi selengkapnya, lihat Kumpulan data alias.

invalidValue

Ini adalah error umum yang berarti ada sesuatu tentang permintaan Anda yang tidak valid, terlepas dari status server. Pesan error menyertakan jalur ke bagian permintaan yang bermasalah, serta nilai yang tidak valid. Error ini dapat dipicu oleh berbagai hal, seperti:

  • Anda menentukan kumpulan data resource dengan nama yang tidak valid. Misalnya, foo...bar bukan nama DNS yang valid (label tengah kosong).
  • Anda menentukan kumpulan data resource dengan jenis yang tidak valid. Misalnya, A dan CNAME adalah jenis yang valid, tetapi XXX bukan jenis yang valid.
  • Anda menentukan set data resource tanpa data di dalamnya.
  • Anda menentukan data kumpulan data resource yang tidak valid. Misalnya, 1.1.1.1 adalah data data resource yang valid untuk jenis A. XXX adalah data data resource yang tidak valid untuk jenis A.
  • Anda menentukan kumpulan data resource dengan TTL yang tidak valid. TTL harus berupa bilangan bulat non-negatif.
  • Nama resource yang Anda tentukan terlalu panjang.

Tindakan yang disarankan: Perbaiki permintaan Anda.

Langkah selanjutnya

  • Untuk mempelajari fitur lebih lanjut, lihat Ringkasan Cloud DNS.
  • Untuk menemukan solusi atas masalah umum yang mungkin Anda alami saat menggunakan Cloud DNS, lihat Pemecahan masalah.
  • Untuk mendapatkan bantuan tambahan, lihat Dukungan.