全部产品
Search
文档中心

Alibaba Cloud DNS:AddZone

更新时间:Dec 19, 2025

Panggil operasi AddZone untuk membuat zona otoritatif bawaan, yang dapat berupa zona standar atau zona terakselerasi.

Deskripsi operasi

Mulai 30 April 2025 (UTC+8), zona yang ditambahkan oleh pengguna baru Alibaba Cloud DNS PrivateZone akan diatur sebagai zona terakselerasi secara default. Mulai 30 April 2026 (UTC+8), semua zona standar otoritatif bawaan akan secara otomatis dialihkan ke zona terakselerasi. Setelah pengalihan, jumlah kueri DNS dapat meningkat, yang berpotensi menaikkan biaya Anda. Untuk mengurangi peningkatan kueri DNS akibat tidak adanya cache lokal, aktifkan NSCD pada Instance ECS Anda.

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:AddZone

create

*Zone

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

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

Lang

string

No

Bahasa dalam respons. Nilai yang valid:

  • zh: Bahasa Tiongkok.

  • en: Bahasa Inggris.

Nilai default: en.

en

ZoneName

string

No

Nama zona yang akan ditambahkan.

example.com

ProxyPattern

string

No

Menentukan apakah akan mengaktifkan proxy rekursif subdomain. Nilai yang valid:

  • ZONE: Menonaktifkan fitur ini. Jika menerima kueri DNS untuk subdomain yang tidak ada di bawah nama domain saat ini, kesalahan NXDOMAIN dikembalikan.

  • RECORD: Mengaktifkan fitur ini. Jika menerima kueri DNS untuk subdomain yang tidak ada di bawah nama domain saat ini, kueri tersebut diproses secara berurutan oleh modul forwarding dan rekursi. Hasil akhir digunakan untuk merespons kueri DNS tersebut.

Nilai default: ZONE.

ZONE

ResourceGroupId

string

No

ID kelompok sumber daya.

rg-acfmykd63gt****

ZoneType

string

No

Parameter ini tidak tersedia untuk pengguna. Anda tidak perlu menentukan parameter ini.

CLOUD_PRODUCT_ZONE

ZoneTag

string

No

Parameter ini tidak tersedia untuk pengguna. Anda tidak perlu menentukan parameter ini.

BLINK

ClientToken

string

No

Token client yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan client untuk menghasilkan token, tetapi harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. Token hanya boleh berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter.

21079fa016944979537637959d09bc

DnsGroup

string

No

Lokasi zona otoritatif bawaan. Nilai yang valid:

  • NORMAL_ZONE: Zona standar. Respons DNS di-cache. Jika terjadi cache miss, kueri dikirim ke zona standar otoritatif bawaan. Nilai time to live (TTL) memengaruhi waktu penerapan perubahan rekaman DNS. Anda tidak dapat menggunakan jalur DNS kustom atau round-robin berbobot.

  • FAST_ZONE: Zona terakselerasi (disarankan). Kueri DNS langsung direspons dengan latensi terendah. Perubahan rekaman DNS berlaku secara real time. Anda dapat menggunakan jalur DNS kustom dan round-robin berbobot.

Nilai default: NORMAL_ZONE.

Catatan

Zona otoritatif terakselerasi bawaan berada sebelum modul cache. Respons DNS tidak di-cache. Hal ini dapat meningkatkan jumlah kueri DNS dan biaya Anda.

FAST_ZONE

Elemen respons

Element

Type

Description

Example

object

ZoneName

string

Nama zona.

example.com

ZoneId

string

ID unik zona.

6fc186295683a131f63bb8b0cddc****

RequestId

string

ID unik permintaan.

54F10A2A-C3CF-59D4-810F-F18DDD93FE20

Success

boolean

Menunjukkan apakah permintaan berhasil.

true

Contoh

Respons sukses

JSONformat

{
  "ZoneName": "example.com",
  "ZoneId": "6fc186295683a131f63bb8b0cddc****",
  "RequestId": "54F10A2A-C3CF-59D4-810F-F18DDD93FE20",
  "Success": true
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.