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 diperlakukan 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 set 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 artikel 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 berada 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 create permintaan perubahan yang mencoba menghapus set data resource yang tidak cocok dengan set data yang sudah ada (nama dan jenis yang sama).

Baca status zona saat ini dan tentukan apa yang ingin Anda hapus. Mungkin sudah berubah sejak terakhir kali Anda melihatnya.

Pesan error mencakup jalur ke bagian permintaan Anda yang bermasalah. Misalnya, entity.change.deletions[6] merujuk ke elemen ketujuh dalam array deletions dari 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 akan mendapatkan error ini jika perubahan yang akan segera terjadi akan melebihi kuota Anda saat ini. Kuota ini terkait dengan project. Misalnya, Anda hanya diizinkan untuk memiliki sejumlah set data resource tertentu di setiap zona. Jika Anda memerlukan peningkatan kuota, hubungi tim penjualan Anda. Trusted Cloud Project baru memiliki kuota default seperti yang ditentukan dalam Kuota dan batas resource Cloud DNS. Untuk semua dimensi berbeda yang dibatasi DNS, lihat operasi Projects.get.

Tindakan yang disarankan: Periksa project Anda untuk memahami alasan Anda sudah menggunakan banyak resource tersebut. Anda dapat meminta penambahan kuota untuk project di halaman Kuota di konsol Trusted Cloud untuk project tersebut. Anda juga dapat melihat Meminta penyesuaian kuota.

Error terkait 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 diawali dengan huruf, diakhiri dengan huruf atau angka, dan hanya berisi huruf kecil, angka, atau tanda pisah.

managedZoneDnsNameNotAvailable

Managed zone yang ditentukan tidak tersedia sehingga tidak dapat dibuat.

Operasi untuk membuat managed zone dapat gagal dengan error ini karena alasan berikut:

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

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

verifyManagedZoneDnsNameOwnership

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

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

Error terkait catatan 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 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 melakukan perubahan yang akan melanggar aturan DNS bahwa zona harus berisi tepat satu set catatan 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 bukan di puncak.

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

invalidRecordCount

Kumpulan data resource entity.change.additions[XX] hanya diizinkan 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.example.com.",
    type: "CNAME",
    rrdata: [ "www.example.com.", "www2.example.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 puncak zona. Hal ini tidak mungkin dilakukan karena akan berkonflik dengan rekaman SOA dan NS yang diperlukan dengan nama yang sama.

Tindakan yang disarankan: Pilih salah satu.

wildcardNotAllowed

Jenis kumpulan data resource yang ditentukan salah untuk menjadi karakter pengganti.

Dalam 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 record NS karakter pengganti tidak didukung saat ini. Hubungi Dukungan Cloud DNS atau bergabung ke cloud-dns-discuss dan sampaikan apa yang ingin Anda lakukan.

recordTypeDisallowedAtZoneApex

Pencatatan sumber daya yang ditentukan tidak boleh ada bersama jenis pencatatan lainnya, termasuk pencatatan SOA yang diperlukan di puncak zona.

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

Tindakan yang disarankan: Gunakan catatan 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 mengetahui informasi selengkapnya, lihat Kumpulan data alias.

invalidValue

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

  • Anda menentukan set data resource dengan nama yang tidak valid. Misalnya, cymbal...group bukan nama DNS yang valid (label tengah kosong).
  • Anda menentukan set catatan resource dengan jenis yang tidak valid. Misalnya, A dan CNAME adalah jenis yang valid, tetapi group bukan jenis yang valid.
  • Anda menentukan set data resource tanpa data di dalamnya.
  • Anda menentukan data catatan resource yang tidak valid. Misalnya, 1.1.1.1 adalah data catatan resource yang valid untuk jenis A. X.X.X.X adalah data resource record yang tidak valid untuk jenis A.
  • Anda menentukan set 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 berikutnya

  • 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.