AddZoneRecord - Alibaba Cloud DNS

Panggil operasi AddZoneRecord untuk menambahkan Rekaman DNS ke zona otoritatif. Dalam cakupan efektif zona tersebut, Rekaman DNS internal untuk suatu Nama domain akan menggantikan Rekaman DNS publiknya.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

pvtz:AddZoneRecord

create

*Zone

acs:pvtz::{#accountId}:zone/{#ZoneId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
ZoneId	string	Yes	ID zona. Ini adalah pengidentifikasi unik dari zona tersebut.	df2d03865266bd9842306db586d3****
Lang	string	No	Bahasa dalam respons. Nilai yang valid: zh: Bahasa Tionghoa. en: Bahasa Inggris. Nilai default: en	en
Rr	string	Yes	Rekaman host. Rekaman host adalah awalan dari Nama domain. Rekaman host umum meliputi www, @, * (untuk DNS wildcard), dan mail (untuk kotak surat). Misalnya, untuk melakukan resolusi @.example.com, atur rekaman host menjadi "@", bukan string kosong.	www
Type	string	Yes	Tipe Rekaman DNS. Tipe berikut didukung: A: Memetakan Nama domain ke Alamat IPv4 dalam notasi desimal bertitik. AAAA: Memetakan Nama domain ke Alamat IPv6. CNAME: Memetakan Nama domain ke Nama domain lain. TXT: Rekaman teks. Teks dapat memiliki panjang hingga 255 karakter. Rekaman TXT sering digunakan untuk Rekaman Sender Policy Framework (SPF) guna mencegah spam. MX: Memetakan Nama domain ke Nama domain server surat. PTR: Memetakan alamat IP ke Nama domain. SRV: Menentukan server untuk layanan tertentu. Formatnya: Priority Weight Port Target. Pisahkan setiap nilai dengan spasi. Catatan Sebelum menambahkan Rekaman PTR, konfigurasikan Zona pencarian balik. Untuk informasi selengkapnya, lihat Reverse DNS lookups and PTR records.	A
Line	string	No	Sumber permintaan resolusi DNS. Nilai yang valid: default: Jalur default. Ini setara dengan jalur global. Konfigurasikan jalur default untuk memastikan bahwa Rekaman DNS dikembalikan meskipun tidak ada jalur pintar yang terkena. Alibaba Cloud line: Permintaan resolusi DNS berasal dari Alibaba Cloud, termasuk Public Cloud, Cloud Keuangan, dan Alibaba Gov Cloud. Custom line: Sesuaikan resolusi Nama domain internal agar mengembalikan alamat IP tertentu untuk permintaan kueri DNS dari segmen alamat IP tertentu. Catatan Hanya zona di Wilayah akselerasi otoritatif bawaan yang mendukung penambahan jalur sumber permintaan resolusi DNS. Untuk menggunakan jalur default, masukkan "default". Untuk jalur Alibaba Cloud dan jalur kustom, masukkan kode jalur yang ditentukan. Contoh: aliyun_r_cn-beijing-a	default
Weight	integer	No	Bobot. Nilai yang valid adalah bilangan bulat dari 1 hingga 100. Nilai default adalah 1. Atur bobot berbeda untuk setiap alamat agar alamat dikembalikan berdasarkan rasio bobot pada kueri DNS.	1
Ttl	integer	No	Masa hidup data (TTL). Satuan dalam detik (s). Nilai yang valid adalah 5, 30, 60, 3600 (1 jam), 43200 (12 jam), dan 86400 (1 hari). Nilai default adalah 60.	60
Priority	integer	No	Prioritas Rekaman MX. Nilai yang lebih kecil menunjukkan prioritas yang lebih tinggi. Nilai yang valid: [1, 99].	5
Value	string	Yes	Nilai rekaman. Masukkan nilai berdasarkan tipe Rekaman DNS.	114.55.XX.XX
UserClientIp	string	No	Alamat IP client.	127.0.XX.XX
Remark	string	No	Keterangan.	en
ClientToken	string	No	Token client yang digunakan untuk memastikan idempotensi permintaan. Client menghasilkan nilai ini untuk memastikan keunikannya di antara permintaan yang berbeda. Nilainya dapat mencapai panjang maksimum 64 karakter ASCII.	6447728c8578e66aacf062d2df4446dc

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID unik dari permintaan.	0B7AD377-7E86-44A8-B9A8-53E8666E72FE
RecordId	integer	ID Rekaman DNS.	429570****
Success	boolean	Menunjukkan apakah permintaan berhasil.	true

Contoh

Respons sukses

JSONformat

{
  "RequestId": "0B7AD377-7E86-44A8-B9A8-53E8666E72FE",
  "RecordId": 0,
  "Success": true
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.