Pesan error

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

Error umum

Bagian ini menjelaskan error umum.

alreadyExists

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

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

Jika Anda mendapatkan error ini saat menambahkan kumpulan data, hal ini karena setiap kumpulan data diperlakukan sebagai kumpulan kumpulan data, yang berarti setiap entri (jika Anda memiliki beberapa entri) bertindak sebagai kumpulan data yang berbeda. Anda dapat menambahkan dua nilai atau string ke kumpulan data untuk nama Domain Name System (DNS) yang sama dengan menambahkan spasi 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 disarankan: Aktifkan penagihan untuk project Anda. Guna mengaktifkan penagihan untuk project baru, atau mengaktifkan kembali penagihan untuk project yang sudah ada, ikuti langkah-langkah yang sesuai di Mengaktifkan penagihan untuk project.

preconditionFailed

Ini adalah error umum yang berarti bahwa sesuatu terkait permintaan tidak kompatibel dengan status resource server saat ini. Klien harus melakukan sesuatu untuk memperbaikinya dan kemudian 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, lalu tentukan apa yang ingin Anda hapus. Mungkin telah berubah sejak terakhir kali Anda melihatnya.

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

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

required

Ini adalah error umum yang berarti bahwa beberapa bagian yang diperlukan dalam permintaan 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 disarankan: Pastikan Anda menggunakan nama resource yang sudah ada.

quotaExceeded

Anda mendapatkan error ini saat perubahan yang akan datang melebihi kuota saat ini. Kuota tersebut terkait dengan project. Misalnya, Anda hanya diizinkan memiliki jumlah set data resource tertentu di setiap zona. Jika Anda perlu penambahan kuota, hubungi tim penjualan Google Cloud. Project baru memiliki kuota default seperti yang ditentukan dalam kuota dan batas resource Cloud DNS. Untuk semua dimensi lain yang dibatasi DNS, lihat operasi Projects.get.

Tindakan yang disarankan: Periksa project Anda untuk memahami alasan Anda menggunakan begitu banyak resource tersebut. Anda dapat meminta penambahan kuota untuk project di halaman Quotas di Google Cloud Console untuk project tersebut. Anda juga dapat membaca bagian Bekerja dengan 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 pembuatan zona terkelola dapat gagal dengan error ini jika nama zona terkelola tidak diawali 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 sudah dicadangkan, misalnya, titik (.), .com, atau .co.uk.
  • Tidak ada lagi server nama yang tersedia untuk menghosting nama DNS zona. Cloud DNS menggunakan sekumpulan server nama, dan kumpulan tersebut terbatas. Kueri DNS ke server nama apa pun harus dipetakan secara jelas ke satu zona terkelola. Untuk mengetahui detail selengkapnya, lihat batas server nama.

Tindakan yang disarankan: Jika Anda adalah pemilik terdaftar dari nama DNS yang dimaksud, periksa apakah ada zona yang tumpang-tindih. Untuk menyiapkan DNS untuk 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 disarankan: Jika menerima error ini, Anda harus memverifikasi kepemilikan domain, lalu mencoba lagi.

Error yang terkait dengan data yang dikelola

Error di bagian ini berkaitan 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 suatu zona harus berisi persis satu kumpulan data resource dari jenis tertentu di apex.

Apex dalam konteks DNS berarti nama DNS dengan jumlah label paling sedikit 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 suatu 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 yang bukan di apex.

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

invalidRecordCount

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

Aturan DNS menyatakan bahwa kumpulan data resource SOA dan CNAME hanya dapat memiliki satu data resource. Anda 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 menerima pesan error ini, periksa permintaan Anda. Anda mencoba melakukan sesuatu yang tidak diperbolehkan.

cnameResourceRecordSetConflict

Kumpulan data resource entity.change.additions[XX] tidak valid karena nama DNS example.com mungkin memiliki satu kumpulan data resource CNAME atau 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 puncak zona. Hal ini tidak memungkinkan karena akan bertentangan dengan data SOA dan NS yang diperlukan dengan nama yang sama.

Tindakan yang disarankan: Pilih salah satu.

wildcardNotAllowed

Kumpulan data resource yang ditentukan memiliki jenis yang salah sebagai karakter pengganti.

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

Tindakan yang disarankan: Kumpulan data resource NS karakter pengganti tidak didukung untuk saat ini. Hubungi Dukungan Cloud DNS atau gabung dengan cloud-dns-discuss dan bagikan apa yang ingin Anda capai.

recordTypeDisallowedAtZoneApex

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

Anda tidak dapat menempatkan data resource CNAME di apex karena data tersebut tidak boleh 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 puncak zona dan hanya merespons kueri data alamat (A atau AAAA). Untuk informasi selengkapnya, lihat Data alias.

invalidValue

Ini adalah error umum yang berarti permintaan Anda tidak valid, apa pun status servernya. Pesan error menyertakan jalur ke bagian yang bermasalah pada permintaan, 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 kumpulan data resource tanpa data di dalamnya.
  • Anda menentukan data pencatatan resource yang tidak valid. Misalnya, 1.1.1.1 adalah data data resource yang valid untuk tipe A. XXX adalah data pencatatan resource yang tidak valid untuk tipe A.
  • Anda menentukan kumpulan data resource dengan TTL yang tidak valid. TTL harus berupa bilangan bulat non-negatif.
  • Anda menentukan nama resource yang 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.