全部产品
Search
文档中心

ApsaraVideo Live:BatchDeleteLiveDomainConfigs

更新时间:Dec 13, 2025

Menghapus konfigurasi beberapa domain sekaligus.

Deskripsi operasi

Tentukan domain yang ingin Anda hapus konfigurasinya, lalu panggil operasi ini untuk menghapus konfigurasi domain tersebut secara bersamaan.

Batas QPS

Anda dapat memanggil operasi ini hingga 30 kali per detik per akun. Permintaan yang melebihi batas ini akan dijatuhkan dan dapat menyebabkan gangguan layanan. Pastikan Anda memperhatikan batas ini saat melakukan pemanggilan.

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

live:BatchDeleteLiveDomainConfigs

delete

*Domain

acs:cdn:*:{#accountId}:domain/{#DomainName}

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

DomainNames

string

Yes

Domain ingest atau domain streaming. Pisahkan beberapa nama domain dengan koma (,).

demo.aliyundoc.com,example.aliyundoc.com,example.com

FunctionNames

string

Yes

Nama fitur-fitur tersebut. Pisahkan beberapa fitur dengan koma (,). Untuk informasi selengkapnya, lihat Fitur yang ditentukan oleh parameter Functions.

referer_white_list_set,ip_black_list_set

Format parameter FunctionNames

  • Contoh: [{"functionArgs":[{"argName":"domain_name","argValue":"developer.aliyundoc.com"}],"functionName":"set_req_host_header"}]

  • Beberapa fitur, seperti filetype_based_ttl_set, mendukung beberapa catatan konfigurasi. Untuk memperbarui salah satu catatan tersebut, gunakan configId sebagai pengenal. Contoh: [{"functionArgs":[{"argName":"file_type","argValue":"jpg"},{"argName":"ttl","argValue":"18"},{"argName":"weight","argValue":"30"}],"functionName":"filetype_based_ttl_set","configId":506***}]

Fitur yang ditentukan oleh parameter FunctionNames

FiturAtribut
referer_white_list_set: menentukan daftar putih Referer.refer_domain_allow_list: Referer yang akan ditambahkan ke daftar putih. Pisahkan beberapa nilai dengan koma (,).allow_empty: menentukan apakah Referer kosong diizinkan. Nilai yang valid: on dan off.
referer_black_list_set: menentukan daftar hitam Referer.refer_domain_deny_list: Referer yang akan ditambahkan ke daftar hitam. Pisahkan beberapa nilai dengan koma (,).allow_empty: menentukan apakah Referer kosong diizinkan. Nilai yang valid: on dan off.
filetype_based_ttl_set: menentukan masa berlaku cache berdasarkan jenis file.ttl: durasi cache dalam detik. Rentang nilai: 1 hingga 99.999.999 (lebih dari tiga tahun).file_type: jenis file. Pisahkan beberapa jenis dengan koma (,).weight: bobot jenis file. Rentang nilai: 1 hingga 99.
path_based_ttl_set: menentukan masa berlaku cache berdasarkan path direktori.ttl: durasi cache dalam detik. Rentang nilai: 1 hingga 99.999.999 (lebih dari tiga tahun).path: path direktori, harus diawali dengan garis miring (/).weight: bobot direktori. Rentang nilai: 1 hingga 99.
oss_auth: mengotentikasi akses ke bucket Object Storage Service (OSS).oss_bucket_id: path bucket OSS Anda.
ip_black_list_set: menentukan daftar hitam alamat IP.ip_list: alamat IP yang akan ditambahkan ke daftar hitam. Pisahkan beberapa alamat dengan koma (,).
ip_allow_list_set: menentukan daftar putih alamat IP.ip_list: alamat IP yang akan ditambahkan ke daftar putih. Pisahkan beberapa alamat dengan koma (,).
ip_white_list_set: menentukan daftar putih alamat IP untuk pembatasan laju.ip_list: alamat IP yang akan ditambahkan ke daftar putih. Pisahkan beberapa alamat dengan koma (,).
error_page: mengalihkan halaman error ke halaman tertentu.error_code: kode kesalahan.rewrite_page: halaman tujuan pengalihan.
set_req_host_header: memodifikasi header Host pada permintaan kembali-ke-asal.domain_name: nilai header Host untuk permintaan kembali-ke-asal.
set_hashkey_args: mengabaikan parameter URL tertentu dalam proses caching.on (semua diabaikan) dan off (tidak ada yang diabaikan).
aliauth: mengonfigurasi autentikasi Alibaba Cloud.auth_type: jenis autentikasi. Nilai yang valid: type_a (autentikasi tipe A diaktifkan) dan no_auth (autentikasi dinonaktifkan).auth_key1: kunci autentikasi utama. Kunci ini dapat berisi huruf dan angka; disarankan panjangnya antara 8 hingga 32 karakter.auth_key2: kunci autentikasi sekunder.ali_auth_delta: buffer waktu kustom untuk autentikasi, dalam satuan menit. Disarankan minimal 1 menit.auth_m3u8: menentukan apakah penulisan ulang M3U8 diaktifkan. Jika diaktifkan, sistem akan melakukan autentikasi terhadap segmen TS dalam playlist M3U8 untuk mencegah kegagalan akses. Nilai yang valid: on (default) dan off.
remote_auth: mengonfigurasi otentikasi jarak jauh untuk live streaming.remote_auth_pattern: mode otentikasi. Opsi yang tersedia:– param: menentukan apakah parameter dalam URL ingest diteruskan ke server otentikasi. Nilai yang valid: pass (default) dan fail.– args_white: parameter yang ingin diteruskan. Pisahkan dengan koma (,).– args_black: parameter yang tidak ingin diteruskan. Pisahkan dengan koma (,).– code: kode status HTTP yang dikembalikan oleh server otentikasi ke ApsaraVideo Live. Format code=XXX menunjukkan keberhasilan (contoh: code=200), sedangkan code=~XXX menunjukkan kegagalan (contoh: code=~403).– delta: durasi timeout untuk otentikasi.– retry: jumlah percobaan ulang saat terjadi timeout.– timeout: aksi saat timeout terjadi. Nilai yang valid: pass (permintaan diteruskan) dan fail (mengembalikan kode status HTTP 403).– async: menentukan apakah otentikasi asinkron diaktifkan. Nilai yang valid: on dan off (default).
set_resp_header: mengonfigurasi header respons. Verifikasi konfigurasi dengan memeriksa respons di browser.Content-Type, Cache-Control, Content-Disposition, Content-Language, Expires, Access-Control-Allow-Origin, Access-Control-Allow-Methods, Access-Control-Allow-Headers, Access-Control-Max-Age, Access-Control-Expose-Headers.value: konten header respons. Masukkan null untuk menghapus header.
https_force: mengonfigurasi pengalihan paksa ke HTTPS.off. Fitur https_force dan http_force saling eksklusif—tidak dapat dikonfigurasi bersamaan. Jika salah satu telah dikonfigurasi, hapus terlebih dahulu sebelum mengaktifkan yang lain.
http_force: mengonfigurasi pengalihan paksa ke HTTP.off. Fitur https_force dan http_force saling eksklusif—tidak dapat dikonfigurasi bersamaan. Jika salah satu telah dikonfigurasi, hapus terlebih dahulu sebelum mengaktifkan yang lain.
forward_scheme: mengonfigurasi kembali-ke-asal adaptif.follow.scheme_origin_port: nomor port origin. Nilai yang valid: 80, 443, dan 80:443.
green_manager: mengonfigurasi deteksi konten tidak pantas.enable: menentukan apakah deteksi konten tidak pantas diaktifkan. Nilai yang valid: on dan off.
tmd_signature: mengonfigurasi aturan pembatasan laju kustom.name: nama aturan, harus unik secara global.path: URI (Uniform Resource Identifier). URI duplikat diperbolehkan, tetapi validitasnya harus diverifikasi.pathType: aturan pencocokan. Nilai yang valid: 0 (pencocokan awalan) dan 1 (pencocokan persis).interval: interval pemantauan, dalam detik. Harus ≥10 detik.count: jumlah kunjungan dari satu alamat IP dalam interval tertentu.action: aksi saat kondisi terpenuhi. Nilai yang valid: 0 (blokir akses) dan 1 (deteksi bot).ttl: durasi pemblokiran akses, dalam detik.
l2_oss_key: mengonfigurasi autentikasi kunci privat untuk permintaan kembali-ke-asal dari node L2 ke bucket OSS pribadi.private_oss_auth: menentukan apakah akses ke bucket OSS pribadi diautentikasi. Nilai yang valid: on dan off.
video_seek: mengonfigurasi pencarian video.enable: menentukan apakah fitur diaktifkan. Nilai yang valid: on dan off.
gzip: mengonfigurasi kompresi Gzip.enable: menentukan apakah fitur diaktifkan. Nilai yang valid: on dan off.
tesla: mengonfigurasi optimasi halaman untuk mempercepat akses.enable: menentukan apakah fitur diaktifkan. Nilai yang valid: on dan off.
ali_ua: mengonfigurasi kontrol akses berbasis User-Agent.ua: nilai User-Agent.type: jenis daftar. Nilai yang valid: black (daftar hitam) dan white (daftar putih).
host_redirect: mengonfigurasi penulisan ulang URL.flag: flag penulisan ulang. Nilai yang valid: redirect dan break.
ipv6: mengonfigurasi IPv6.apsoutheast-1 (Singapura), eu-central-1 (Jerman (Frankfurt)), ap-northeast-1 (Jepang (Tokyo)), dan ap-southeast-5 (Indonesia (Jakarta)).
ali_location: mengonfigurasi kontrol akses berbasis wilayah geografis.location: daftar wilayah.type: jenis daftar. Nilai yang valid: black (daftar hitam) dan white (daftar putih).
cc_defense: mengonfigurasi perlindungan terhadap serangan banjir HTTP.enable: menentukan apakah perlindungan terhadap serangan banjir HTTP diaktifkan. Nilai yang valid: on dan off.
alilive: mengonfigurasi pengaturan live streaming.notify_url: URL untuk menerima notifikasi dari ApsaraVideo Live.enable: menentukan apakah fitur diaktifkan. Nilai yang valid: on dan off.live_forbid_flv: menentukan apakah pemutaran FLV (Flash Video) dilarang. Nilai yang valid: on dan off.live_forbid_rtmp: menentukan apakah pemutaran RTMP (Real-Time Messaging Protocol) dilarang. Nilai yang valid: on dan off.live_forbid_hls: menentukan apakah pemutaran HLS (HTTP Live Streaming) dilarang. Nilai yang valid: on dan off.
ali_grtn: menentukan apakah terhubung ke Global Realtime Transport Network (GRTN).grtn_rts_pub: menentukan apakah pengambilan aliran melalui RTS (Real-Time Streaming) diaktifkan. Berlaku untuk domain ingest. Nilai yang valid: on dan off.grtn_rts_play: menentukan apakah streaming melalui RTS diaktifkan. Berlaku untuk domain streaming. Nilai yang valid: on dan off.grtn_rts_transcode: menentukan apakah transkoding otomatis untuk pemutaran HTML5 berbasis RTS diaktifkan. Nilai yang valid: on dan off.
edge_function: mengonfigurasi fungsi edge.Atribut wajib:rule: aturan dalam bahasa domain-spesifik (DSL).pri: prioritas aturan.enable: menentukan apakah aturan diaktifkan. Nilai yang valid: on dan off.Atribut opsional:name: nama aturan.pos: posisi eksekusi aturan.brk: jika aturan terpicu, aturan setelah posisi yang ditentukan akan dilewati.option: opsi tambahan.grammar: tata bahasa. Nilai yang valid: es2 dan js. Bisa dibiarkan kosong.jsmode: mode penanganan daftar putih nama domain dalam JavaScript. Nilai yang valid: redirect dan bypass.
https_tls_version: mengonfigurasi versi protokol Transport Layer Security (TLS).tls10: menentukan apakah TLS 1.0 diaktifkan. Default: on. Nilai yang valid: on dan off.tls11: menentukan apakah TLS 1.1 diaktifkan. Default: on. Nilai yang valid: on dan off.tls12: menentukan apakah TLS 1.2 diaktifkan. Default: on. Nilai yang valid: on dan off.tls13: menentukan apakah TLS 1.3 diaktifkan. Default: on. Nilai yang valid: on dan off.
https_option: mengonfigurasi pengaturan HTTP.http2: menentukan apakah HTTP/2 diaktifkan. Default: off. Nilai yang valid: on dan off.live_http2: menentukan apakah live_http2 diaktifkan. Default: off. Nilai yang valid: on dan off.

Elemen respons

Element

Type

Description

Example

object

RequestId

string

ID permintaan.

04F0F334-1335-436C-A1D7-6C044FE73368

Contoh

Respons sukses

JSONformat

{
  "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 Invalid%s.ValueNotSupported FunctionName [%s] is not supported.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.