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.

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 API get/list yang sesuai untuk menemukan resource yang sudah ada.

Jika Anda mendapatkan error ini saat menambahkan data, hal ini terjadi karena tiap data diperlakukan sebagai kumpulan data, yang berarti tiap 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, baca 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 disarankan: Aktifkan penagihan untuk project Anda. Untuk mengaktifkan penagihan untuk project baru, atau untuk mengaktifkan kembali penagihan untuk project yang sudah ada, ikuti langkah-langkah yang sesuai di bagian Mengaktifkan penagihan untuk project.

preconditionFailed

Ini adalah error umum yang berarti ada sesuatu terkait 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 hal yang ingin Anda hapus. Status 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 disarankan: Pastikan Anda menggunakan nama resource yang ada.

quotaExceeded

Anda akan mendapatkan error ini jika perubahan yang akan terjadi akan melebihi kuota Anda saat ini. Kuota ini terkait dengan project. Misalnya, Anda hanya diizinkan untuk memiliki kumpulan data resource tertentu di tiap zona. Jika Anda memerlukan peningkatan kuota, hubungi tim penjualan Google Cloud Anda. 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 begitu banyak resource tersebut. Anda dapat meminta penambahan kuota untuk project di halaman Quotas di konsol Google Cloud untuk project tersebut. Anda juga dapat merujuk ke artikel 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

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 direservasi, 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 mana pun harus dipetakan secara jelas ke satu zona terkelola. Untuk mengetahui detail selengkapnya, baca bagian batas server nama.

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

verifyManagedZoneDnsNameOwnership

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

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

Error terkait 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 nama domain utama.

Apex dalam konteks DNS berarti nama DNS dengan jumlah label paling sedikit yang diizinkan di zona. Ini juga merupakan bagian teratas hierarki zona. Nama domain utama 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 persis satu kumpulan data resource dari jenis tertentu di nama domain utama. Tindakan berikut dapat menyebabkan error ini:

• Anda mencoba menghapus kumpulan data resource NS yang diperlukan di nama domain utama.
• Anda mencoba menghapus kumpulan data resource SOA yang diperlukan di nama domain utama.
• Anda mencoba membuat kumpulan data resource dengan jenis SOA bukan di nama domain utama.

Tindakan yang disarankan: Jika Anda 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 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 Anda mencoba membuat data CNAME di nama domain utama zona. Hal ini tidak dapat diterapkan 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 dengan jenis NS.

Tindakan yang disarankan: Kumpulan data resource NS karakter pengganti tidak didukung saat ini. Hubungi Dukungan Cloud DNS atau bergabunglah dengan cloud-dns-discuss dan sampaikan hal yang ingin Anda lakukan.

recordTypeDisallowedAtZoneApex

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

Anda tidak dapat menempatkan data resource CNAME di nama domain utama karena tidak boleh ada bersama jenis data resource lainnya, termasuk data resource SOA yang diperlukan di nama domain utama 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 nama domain utama zona dan hanya merespons kueri data alamat (A atau AAAA). Untuk mengetahui informasi selengkapnya, baca bagian Data alias.

invalidValue

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

• Anda menentukan kumpulan data resource dengan nama yang tidak valid. Misalnya, cymbal...group 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 group bukan jenis yang valid.
• Anda menentukan kumpulan data resource tanpa data di dalamnya.
• Anda menentukan data resource yang tidak valid. Misalnya, 1.1.1.1 adalah data resource yang valid untuk jenis A. X.X.X.X adalah 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.

Error terkait deteksi ancaman

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Spesifik per Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Bagian ini menjelaskan error umum saat mengaktifkan deteksi ancaman.

Akses istimewa hanya diizinkan dari ThreatDetectorAdmin

Anda harus memiliki peran Threat Detector Admin untuk mengaktifkan deteksi ancaman DNS.

Tindakan yang disarankan: Anda harus diberi peran roles/networksecurity.dnsThreatDetectorAdmin.

FAILED_PRECONDITION

Detektor ancaman DNS lain sudah ada di induk yang diberikan.

Tindakan yang disarankan: Periksa status konfigurasi Anda saat ini, dan gunakan detektor ancaman DNS yang ada atau hapus dan buat yang baru.

gcloud

gcloud beta network-security dns-threat-detectors describe --location=global  RESOURCE_REPORTED_IN_ERROR_MESSAGE

Ganti RESOURCE_REPORTED_IN_ERROR_MESSAGE dengan detektor ancaman DNS lain yang sudah ada di induk yang diberikan dalam pesan error.

Langkah berikutnya

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