All Products
Search

This Product

    ApsaraVideo Live:BatchSetLiveDomainConfigs

    Document Center

    ApsaraVideo Live:BatchSetLiveDomainConfigs

    Last Updated:Sep 07, 2026

    Mengonfigurasi nama domain secara batch.

    Deskripsi operasi

    Dapatkan nama domain streaming langsung yang ingin Anda konfigurasi, lalu panggil operasi ini untuk mengonfigurasi nama domain secara batch.

    Batas QPS

    Jumlah maksimum kueri per detik (QPS) per pengguna untuk operasi ini adalah 30. 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 konfigurasi secara batch. Nilainya dapat berupa domain ingest, domain streaming primer, atau 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, mendukung beberapa catatan. Untuk memperbarui catatan tertentu, tentukan configId dari catatan tersebut. Untuk informasi lebih lanjut, lihat tabel Deskripsi format fungsi dan Deskripsi fitur fungsi di bawah ini.

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

    boolean

    No

    Apakah akan menjalankan dry run saja tanpa benar-benar mengeksekusi operasi. Nilai valid:

    • true: Mengirim permintaan dry run. Operasi tidak benar-benar dieksekusi setelah permintaan lulus validasi.

    • false (default): Mengirim permintaan Normal. Operasi benar-benar dieksekusi setelah permintaan lulus validasi.

    Dry run memvalidasi validitas parameter, izin RAM, dan status Sumber daya. Jika dry run gagal, kode kesalahan yang sesuai dikembalikan. Jika dry run berhasil, operasi tidak benar-benar dieksekusi.

    false

    Deskripsi format fungsi

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

    • Beberapa fitur, seperti filetype_based_ttl_set, mendukung beberapa catatan. Untuk memperbarui catatan tertentu, tentukan configId dari catatan tersebut. Contoh: [{"functionArgs":[{"argName":"file_type","argValue":"jpg"},{"argName":"ttl","argValue":"18"},{"argName":"weight","argValue":"30"}],"functionName":"filetype_based_ttl_set","configId":506***}]

    Deskripsi fitur fungsi

    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 hitam Referer.refer_domain_deny_list: Daftar hitam. 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: seconds. 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: seconds. Nilai valid: 1 hingga 99999999 (sedikit lebih dari 3 tahun).
    path: Direktori. Harus diawali 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 hitam 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 akan 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 Cloud.auth_type: Tipe autentikasi. Nilai valid: type_a (tipe autentikasi A), no_auth (nonaktifkan autentikasi).
    auth_key1: Kunci autentikasi 1. Kunci mendukung huruf besar, huruf kecil, dan digit. Kami menyarankan Anda mengatur panjangnya menjadi 8 hingga 32 karakter.
    auth_key2: Kunci autentikasi 2.
    ali_auth_delta: Waktu buffer autentikasi kustom. Unit: seconds. Kami menyarankan nilai minimum 60 detik. Tidak ada batas atas.
    auth_m3u8: Apakah akan mengaktifkan penulisan ulang konten M3U8, yang menambahkan informasi autentikasi ke segmen TS dalam file M3U8 untuk mencegah kegagalan autentikasi akses TS. Nilai valid: on (default) atau off.










    remote_auth: Autentikasi jarak jauh streaming langsung.enable: Apakah akan mengaktifkan autentikasi jarak jauh. Parameter ini wajib diisi. Nilai valid: on atau off.
    remote_auth_path: Alamat server autentikasi. Parameter ini wajib diisi.
    remote_auth_pattern: String mode autentikasi. Pengaturan berikut tersedia:
    - param: Apakah akan meneruskan parameter dalam URL ingest ke server autentikasi. Nilai valid: pass (default) atau fail.
    - args_white: Parameter yang ditentukan untuk diteruskan. Pisahkan beberapa parameter dengan koma (,).
    - args_black: Parameter yang ditentukan untuk tidak 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 saat autentikasi gagal. Contoh: code=~403.
    - delta: Periode waktu tunggu autentikasi.
    - retry: Jumlah percobaan ulang saat waktu tunggu autentikasi habis.
    - timeout: Perilaku saat waktu tunggu autentikasi habis. 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 ini ke null untuk menghapus header.

































    https_force: Memaksa pengalihan HTTPS.enable: Sakelar fitur. Nilai valid: on atau off. https_force dan http_force saling eksklusif. Hanya satu yang dapat ada dalam satu waktu. Untuk mengonfigurasi yang lain, hapus konfigurasi yang ada terlebih dahulu.
    http_force: Memaksa pengalihan HTTP.enable: Sakelar fitur. Nilai valid: on atau off. https_force dan http_force saling eksklusif. Hanya satu yang dapat ada dalam satu waktu. Untuk mengonfigurasi yang lain, hapus konfigurasi yang ada terlebih dahulu.
    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: Moderasi konten.enable: Apakah akan mengaktifkan moderasi konten. Nilai valid: on atau off.
    tmd_signature: Aturan kontrol frekuensi akses kustom.name: Nama aturan. Harus unik dalam domain.
    path: Dapat diulang. Validitas jalur URI diverifikasi.
    pathType: Aturan pencocokan. 0: pencocokan awalan. 1: pencocokan tepat.
    interval: Durasi pemantauan. Unit: seconds. Nilai harus ≥ 10.
    count: Jumlah kunjungan dari satu alamat IP.
    action: Tipe pemblokiran. 0: blokir. 1: identifikasi manusia-mesin.
    ttl: Durasi pemblokiran. Unit: seconds.
















    l2_oss_key: Kunci privat back-to-origin L2 OSS.private_oss_auth: Apakah akan mengaktifkan autentikasi OSS privat. Nilai valid: on atau off.
    video_seek: Sakelar pencarian potongan 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 yang akan ditulis ulang. Contoh: ^/$.
    replacement: URL target. Contoh: /go/act/sale/tbzlsy.php.
    flag: Hanya redirect atau break yang didukung.




    ipv6: Konfigurasi IPv6.switch: Sakelar (wajib). Nilai valid: on atau off. Setelah diaktifkan, untuk menonaktifkannya, hapus centang pada opsi alih-alih menghapus konfigurasi. Jika tidak, perubahan tidak akan berlaku.
    region: Wilayah tempat IPv6 diaktifkan. Nilai valid: cn-beijing (Beijing), cn-shanghai (Shanghai), cn-shenzhen (Shenzhen), cn-qingdao (Qingdao), apsoutheast-1 (Singapore), eu-central-1 (Germany), 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: Mengaktifkan atau menonaktifkan perlindungan anti-serangan CC. Nilai valid: on atau off.
    alilive: Konfigurasi ApsaraVideo Live.notify_url: URL notifikasi streaming langsung.
    enable: Sakelar fitur. Nilai valid: on atau off.
    live_forbid_flv: Apakah akan melarang pemutaran FLV. Nilai valid: on atau off.
    live_forbid_rtmp: Apakah akan melarang pemutaran RTMP. Nilai valid: on atau off.
    live_forbid_hls: Apakah akan melarang pemutaran HLS. Nilai valid: on atau off.










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




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




























    https_tls_version: Versi protokol TLS.tls10: Mengaktifkan TLSv1.0. Nilai default: on. Nilai valid: on atau off.
    tls11: Mengaktifkan TLSv1.1. Nilai default: on. Nilai valid: on atau off.
    tls12: Mengaktifkan TLSv1.2. Nilai default: on. Nilai valid: on atau off.
    tls13: Mengaktifkan 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. Lingkungan rilis canary memiliki konfigurasi aktif. Anda tidak dapat mengubah konfigurasi lingkungan produksi.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.