All Products
Search
Document Center

Alibaba Cloud DNS:AddRecursionRecord

Last Updated:Jun 10, 2026

Menambahkan catatan otoritatif untuk resolusi rekursif.

Deskripsi operasi

  • Anda dapat menentukan nama domain (DomainName), nomor halaman (PageNumber), dan ukuran halaman (PageSize) untuk mengambil daftar catatan DNS untuk nama domain tersebut.

  • Untuk menemukan catatan DNS yang berisi kata kunci tertentu, Anda dapat menentukan kata kunci untuk catatan host (RRKeyWord), tipe catatan (TypeKeyWord), atau nilai catatan (ValueKeyWord).

  • Secara default, daftar catatan DNS diurutkan dari yang terbaru ke yang terlama.

  • Anda dapat menentukan ID grup domain (GroupId). Grup `All Domains` mencakup semua nama domain. Grup `Default Group` mencakup nama domain yang tidak ditugaskan ke grup.

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

pubdns:AddRecursionRecord

create

*recursionZone

acs:pubdns::{#accountId}:recursionZone/{#zoneId}

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

UserClientIp

string

No

Alamat IP klien.

192.168.0.1

ZoneId

string

No

ID zona.

173671468000011

Rr

string

No

Catatan host. Catatan host adalah prefiks dari nama domain. Contoh umum meliputi www, @, * (untuk DNS wildcard), dan mail (untuk kotak surat).

Misalnya, untuk meresolusi @.example.com, atur catatan host ke "@", bukan string kosong.

www

Type

string

No

Tipe catatan DNS. Tipe catatan berikut didukung: A: Catatan IPv4 yang memetakan nama domain ke alamat IPv4. AAAA: Catatan IPv6 yang memetakan nama domain ke alamat IPv6. CNAME: Catatan nama kanonik yang menunjuk nama domain ke nama domain lain. MX: Catatan mail exchanger yang menunjuk nama domain ke alamat server email. TXT: Catatan teks yang berisi teks apa pun yang dapat dibaca manusia. SRV: Catatan layanan yang mengidentifikasi server yang menyediakan layanan tertentu. Ini umum dalam manajemen direktori untuk sistem Microsoft. NS: Catatan name server yang mendelegasikan subdomain ke penyedia DNS lain untuk resolusi. CAA: Catatan Certification Authority Authorization yang membatasi otoritas sertifikasi (CA) mana yang dapat menerbitkan sertifikat untuk suatu domain. URL: Catatan URL yang menunjuk nama domain ke situs yang sudah ada. SVCB: Catatan service binding yang digunakan untuk penemuan layanan. Catatan ini menyediakan informasi tentang protokol yang didukung dan parameter layanan melalui catatan DNS. HTTPS: Tipe catatan khusus untuk layanan HTTPS. Catatan HTTPS dapat mendefinisikan protokol koneksi HTTPS yang aman dan alamat endpoint layanan yang optimal.

A

RequestSource

string

No

Baris resolusi DNS. Nilai default-nya adalah default. Untuk informasi lebih lanjut, lihat:

Baris resolusi DNS

default

Weight

integer

No

Bobot catatan. Nilai yang valid adalah bilangan bulat dari 1 hingga 100. Nilai default-nya adalah 1. Atur bobot yang berbeda untuk setiap alamat. Kueri DNS kemudian mengembalikan alamat berdasarkan rasio bobot yang ditentukan.

2

Priority

integer

No

Prioritas catatan MX. Nilai yang lebih kecil menunjukkan prioritas yang lebih tinggi. Nilai yang valid: 1 hingga 99.

1

Ttl

integer

No

Time to live (TTL) dalam detik. Ini adalah durasi catatan di-cache. Nilai yang didukung: 5, 30, 60, 3600 (1 jam), 43200 (12 jam), dan 86400 (24 jam). Nilai default: 60.

60

Value

string

No

Nilai catatan. Masukkan nilai yang sesuai dengan tipe catatan yang ditentukan.

1.1.1.1

ClientToken

string

No

Token klien untuk memastikan idempotensi permintaan. Buat nilai unik pada klien Anda. Token harus unik untuk setiap permintaan. Token hanya boleh berisi karakter ASCII dan tidak boleh melebihi 64 karakter.

6447728c8578e66aacf062d2df4446dc

Elemen respons

Element

Type

Description

Example

object

RequestId

string

ID unik permintaan.

29D0F8F8-5499-4F6C-9FDC-1EE13BF55925

Success

boolean

Menunjukkan apakah operasi berhasil:

  • true: Operasi berhasil.

  • false: Operasi gagal.

true

RecordId

string

ID catatan DNS.

173671468000010

Contoh

Respons sukses

JSONformat

{
  "RequestId": "29D0F8F8-5499-4F6C-9FDC-1EE13BF55925",
  "Success": true,
  "RecordId": "173671468000010"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.