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