All Products
Search

This Product

    ApsaraVideo Live:BatchSetLiveDomainConfigs

    Document Center

    ApsaraVideo Live:BatchSetLiveDomainConfigs

    Last Updated:Jul 23, 2026

    Mengonfigurasi nama domain secara massal.

    Deskripsi operasi

    Dapatkan nama domain ApsaraVideo Live yang akan dikonfigurasi, lalu panggil operasi ini untuk mengonfigurasi nama domain secara massal.

    Batas laju

    Batas QPS per pengguna tunggal untuk operasi ini adalah 30 panggilan per detik. Jika batas terlampaui, panggilan API akan dibatasi (throttled), yang dapat memengaruhi bisnis Anda. Panggil operasi ini sesuai kebutuhan.

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

    update

    *Domain.

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

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    DomainNames

    string

    Yes

    Nama domain yang ingin Anda konfigurasikan secara massal. Nilai valid: nama domain ingest, nama domain streaming utama, dan nama domain streaming sekunder. Pisahkan beberapa nama domain dengan koma (,).

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

    string

    Yes

    Daftar fitur.

    Beberapa fitur, seperti filetype_based_ttl_set, memungkinkan Anda menetapkan beberapa catatan. Jika Anda ingin memperbarui catatan tertentu, Anda dapat menentukan catatan tersebut melalui configId. Untuk informasi lebih lanjut, lihat Deskripsi format Functions dan Deskripsi fitur Functions di bawah ini.

    [{"functionArgs":[{"argName":"file_type","argValue":"jpg"},{"argName":"ttl","argValue":"18"},{"argName":"weight","argValue":"30"}],"functionName":"filetype_based_ttl_set","configId":506***}]

    Deskripsi format Functions

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

    • Beberapa fitur, seperti filetype_based_ttl_set, memungkinkan Anda menetapkan beberapa catatan. Jika Anda ingin memperbarui catatan tertentu, Anda dapat menentukan catatan tersebut melalui configId. Contoh: [{"functionArgs":[{"argName":"file_type","argValue":"jpg"},{"argName":"ttl","argValue":"18"},{"argName":"weight","argValue":"30"}],"functionName":"filetype_based_ttl_set","configId":506***}]

    Deskripsi fitur Functions

    NamaParameter
    referer_white_list_set: Daftar putih Referer.refer_domain_allow_list: Daftar putih. Pisahkan beberapa nilai dengan koma (,).
    allow_empty: Apakah akan mengizinkan Referer kosong. Nilai valid: on atau off.

    referer_black_list_set: Daftar blokir Referer.refer_domain_deny_list: Daftar blokir. Pisahkan beberapa nilai dengan koma (,).
    allow_empty: Apakah akan mengizinkan Referer kosong. Nilai valid: on atau off.

    filetype_based_ttl_set: Pengaturan waktu kedaluwarsa file.ttl: Waktu cache. Unit: detik. Nilai valid: 1 hingga 99999999 (sedikit lebih dari 3 tahun).
    file_type: Tipe file. Pisahkan beberapa nilai dengan koma (,).
    weight: Bobot. Nilai valid: 1 hingga 99.




    path_based_ttl_set: Pengaturan waktu kedaluwarsa direktori.ttl: Waktu cache. Unit: detik. Nilai valid: 1 hingga 99999999 (sedikit lebih dari 3 tahun).
    path: Direktori. Harus dimulai dengan garis miring (/).
    weight: Bobot. Nilai valid: 1 hingga 99.




    oss_auth: Bucket autentikasi OSS.oss_bucket_id: Alamat bucket pengguna.
    ip_black_list_set: Daftar blokir IP.ip_list: Daftar IP. Pisahkan beberapa nilai dengan koma (,).
    ip_allow_list_set: Daftar putih IP.ip_list: Daftar IP. Pisahkan beberapa nilai dengan koma (,).
    ip_white_list_set: Pengecualian kontrol frekuensi akses.ip_list: Daftar IP. Pisahkan beberapa nilai dengan koma (,).
    error_page: Pengalihan halaman error.error_code: Kode kesalahan.
    rewrite_page: Halaman pengalihan.

    set_req_host_header: Mengubah header host back-to-origin.domain_name: Konten header host back-to-origin.
    set_hashkey_args: Mengabaikan parameter URL.hashkey_args: Daftar parameter yang dipertahankan. Pisahkan beberapa nilai dengan koma (,).
    disable: Apakah akan mengabaikan semua parameter. Nilai valid: on (abaikan semua parameter) atau off (jangan abaikan).

    aliauth: Autentikasi Alibaba.auth_type: Tipe autentikasi. Nilai valid: type_a (autentikasi A), no_auth (nonaktifkan autentikasi).
    auth_key1: Kunci autentikasi 1. Kunci autentikasi mendukung huruf besar, huruf kecil, dan angka. Kami menyarankan Anda mengatur panjangnya menjadi 8 hingga 32 karakter.
    auth_key2: Kunci autentikasi 2.
    ali_auth_delta: Waktu buffer autentikasi kustom. Unit: detik. Kami menyarankan nilai minimum 60 detik. Tidak ada batas atas.
    auth_m3u8: Apakah akan mengaktifkan penulisan ulang konten m3u8, yang menambahkan informasi autentikasi ke URI ts dalam file m3u8 untuk mencegah kegagalan autentikasi akses ts. Nilai valid: on (nilai default) atau off.










    remote_auth: Autentikasi jarak jauh live streaming.enable: Apakah akan mengaktifkan autentikasi jarak jauh. Wajib diisi. Nilai valid: on atau off.
    remote_auth_path: Alamat server autentikasi. Wajib diisi.
    remote_auth_pattern: String pola autentikasi. Opsi berikut dapat dikonfigurasi:
    - param: Apakah akan meneruskan parameter dalam URL ingest ke server autentikasi. Nilai valid: pass (default) atau fail.
    - args_white: Menentukan parameter yang akan diteruskan. Pisahkan beberapa parameter dengan koma (,).
    - args_black: Menentukan parameter yang tidak akan diteruskan. Pisahkan beberapa parameter dengan koma (,).
    - code: Kode status autentikasi. code=XXX menentukan kode status HTTP yang dikembalikan oleh server autentikasi ke ApsaraVideo Live saat autentikasi berhasil. Contoh: code=200. code=~XXX menentukan kode status HTTP yang dikembalikan oleh server autentikasi ke ApsaraVideo Live saat autentikasi gagal. Contoh: code=~403.
    - delta: Durasi timeout autentikasi.
    - retry: Jumlah percobaan ulang timeout autentikasi.
    - timeout: Perilaku timeout autentikasi. Nilai valid: pass atau fail. pass: ApsaraVideo Live langsung meneruskan permintaan pengguna. fail: ApsaraVideo Live merespons dengan kode status kegagalan autentikasi (403) kepada pengguna.
    - async: Autentikasi asinkron. Nilai valid: on (aktifkan autentikasi asinkron) atau off (default, nonaktifkan autentikasi asinkron).




























    set_resp_header: Mengatur header respons (terlihat di sisi browser).key: Header respons. Nilai valid:
    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. Atur ke null untuk menghapus.

































    https_force: Paksa pengalihan HTTPS.enable: Sakelar fitur. Nilai valid: on atau off. https_force dan http_force saling eksklusif. Hanya satu yang dapat ada pada satu waktu. Untuk mengonfigurasi yang lain, Anda harus terlebih dahulu menghapus konfigurasi yang ada.
    http_force: Paksa pengalihan HTTP.enable: Sakelar fitur. Nilai valid: on atau off. https_force dan http_force saling eksklusif. Hanya satu yang dapat ada pada satu waktu. Untuk mengonfigurasi yang lain, Anda harus terlebih dahulu menghapus konfigurasi yang ada.
    forward_scheme: Back-to-origin adaptif.enable: Sakelar fitur. Nilai valid: on atau off.
    scheme_origin: Protokol back-to-origin (http, https, atau follow).
    scheme_origin_port: Port protokol back-to-origin (80, 443, atau 80:443).




    green_manager: Deteksi pornografi Tiongkok.enable: Apakah akan mengaktifkan deteksi pornografi Tiongkok. Nilai valid: on atau off.
    tmd_signature: Aturan kontrol frekuensi akses kustom.name: Nama aturan. Harus unik dalam nama domain.
    path: Dapat diulang. Validitas jalur URI diverifikasi.
    pathType: Aturan pencocokan. 0: pencocokan awalan. 1: pencocokan eksak.
    interval: Durasi pemantauan. Unit: detik. Harus >= 10.
    count: Jumlah kunjungan dari satu alamat IP.
    action: Tipe pemblokiran. 0: blokir. 1: identifikasi manusia-mesin.
    ttl: Durasi pemblokiran. Unit: detik.
















    l2_oss_key: Kunci privat L2 OSS back-to-origin.private_oss_auth: Apakah akan mengaktifkan autentikasi OSS privat. Nilai valid: on atau off.
    video_seek: Sakelar pencarian slice video.enable: Sakelar fitur. Nilai valid: on atau off.
    gzip: Optimasi Gzip halaman.enable: Sakelar fitur. Nilai valid: on atau off.
    tesla: Akselerasi optimasi halaman.enable: Sakelar fitur. Nilai valid: on atau off.
    ali_ua: Pembatasan akses User-Agent.ua: User-Agent.
    type: Tipe daftar. Nilai valid: black atau white.

    host_redirect: Fitur penulisan ulang.regex: URL untuk ditulis ulang. Contoh: ^/$.
    replacement: URL target. Contoh: /go/act/sale/tbzlsy.php.
    flag: Hanya mendukung: redirect atau break.




    ipv6: Konfigurasi IPv6.switch: Sakelar (wajib). Nilai valid: on atau off. Untuk mengaktifkan fitur, setelah diaktifkan, untuk menonaktifkannya, hapus centang alih-alih menghapus konfigurasi, jika tidak maka tidak akan berlaku.
    region: Wilayah tempat IPv6 diaktifkan. Nilai valid: cn-beijing (Beijing), cn-shanghai (Shanghai), cn-shenzhen (Shenzhen), cn-qingdao (Qingdao), apsoutheast-1 (Singapura), eu-central-1 (Jerman), ap-northeast-1 (Tokyo), ap-southeast-5 (Jakarta).

    ali_location: Pembatasan akses berbasis wilayah.location: Daftar wilayah.
    type: Tipe daftar. Nilai valid: black atau white.

    cc_defense: Anti-serangan CC.enable: Apakah akan mengaktifkan perlindungan anti-serangan CC. Nilai valid: on atau off.
    alilive: Konfigurasi ApsaraVideo Live.notify_url: URL notifikasi live streaming.
    enable: Sakelar fitur. Nilai valid: on atau off.
    live_forbid_flv: Larangan pemutaran FLV. Nilai valid: on atau off.
    live_forbid_rtmp: Larangan pemutaran RTMP. Nilai valid: on atau off.
    live_forbid_hls: Larangan pemutaran HLS. Nilai valid: on atau off.










    ali_grtn: Sakelar akses layanan GRTN.grtn_rts_pub: Sakelar ingest RTS, digunakan untuk nama domain ingest. Nilai valid: on atau off.
    grtn_rts_play: Sakelar streaming RTS, digunakan untuk nama domain streaming. Nilai valid: on atau off.
    grtn_rts_transcode: Sakelar transkoding otomatis pemutaran H5 RTS. Nilai valid: on atau off.




    edge_function: Fungsi edge.Parameter wajib:
    rule: Aturan DSL.
    pri: Prioritas.
    enable: Apakah aturan ini berlaku. Nilai valid: on atau off.
    Parameter opsional:
    name: Nama aturan.
    pos: Posisi eksekusi aturan.
    brk: Jika aturan ini terpenuhi, aturan sisanya pada posisi eksekusi saat ini dilewati.
    option: Kontrol opsi.
    grammar: Kontrol tata bahasa. Nilai valid: kosong, es2, atau js.
    jsmode: Kontrol daftar putih domain name JS. Nilai valid: redirect atau bypass.




























    https_tls_version: Versi protokol TLS.tls10: Aktifkan TLSv1.0. Nilai default: on. Nilai valid: on atau off.
    tls11: Aktifkan TLSv1.1. Nilai default: on. Nilai valid: on atau off.
    tls12: Aktifkan TLSv1.2. Nilai default: on. Nilai valid: on atau off.
    tls13: Aktifkan TLSv1.3. Nilai default: on. Nilai valid: on atau off.







    https_option: Pengaturan protokol HTTP.http2: Apakah akan mengaktifkan HTTP/2. Nilai default: off. Nilai valid: on atau off.
    live_http2: Apakah akan mengaktifkan live_http2. Nilai default: off. Nilai valid: on atau 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 InvalidFunctions.Malformed Specified Functions is malformed.
    400 InvalidFunctionArgs.Malformed The specified FunctionArgs is invalid.
    400 InvalidArgValue.Malformed Specified ArgValue is malformed.
    400 Invalid%s.ValueNotSupported FunctionName [%s] is not supported.
    400 Invalid%s.Malformed ArgValue [%s] is malformed.
    400 MissingParameter%s The specified value of ArgName[%s] is missing.
    400 FunctionMutex Function is mutex with other function.
    400 RewriteHostRely Domain name is configured as rewrite host by others.
    400 ConfigurationConflicts The staging environment has a configuration in effect and cannot modify the production environment configuration. Terdapat konfigurasi aktif di lingkungan staging. Konfigurasi lingkungan produksi tidak dapat diubah.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.