Gunakan BatchSetLiveDomainConfigs - ApsaraVideo Live - Alibaba Cloud - ApsaraVideo Live

Deskripsi operasi

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

Batas QPS

Anda dapat memanggil operasi ini hingga 30 kali per detik per akun. Permintaan yang melebihi batas ini akan dijatuhkan dan Anda akan mengalami gangguan layanan. Kami menyarankan Anda untuk memperhatikan batas ini saat memanggil operasi ini.

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

Parameter permintaan

Parameter	Type	Required	Description	Example
DomainNames	string	Yes	Nama domain yang ingin Anda konfigurasi secara batch. Nama domain yang didukung mencakup ingest domain, main streaming domain, dan sub-streaming domain. 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 konfigurasi. Untuk memperbarui salah satu catatan konfigurasi, gunakan `configId` untuk mengidentifikasi catatan tersebut. Untuk informasi selengkapnya, lihat Format parameter Functions dan Fitur yang ditentukan oleh parameter Functions.	[{"functionArgs":[{"argName":"file_type","argValue":"jpg"},{"argName":"ttl","argValue":"18"},{"argName":"weight","argValue":"30"}],"functionName":"filetype_based_ttl_set","configId":506***}]

Format parameter Functions

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 konfigurasi, gunakan configId untuk mengidentifikasi catatan tersebut. 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 Functions

Fitur	Atribut
referer_white_list_set: menentukan daftar putih (whitelist) Referer.	refer_domain_allow_list: Referer yang akan ditambahkan ke whitelist. Pisahkan beberapa Referer dengan koma (,).allow_empty: menentukan apakah Referer kosong diizinkan. Nilai yang valid: on dan off.
referer_black_list_set: menentukan daftar hitam (blacklist) Referer.	refer_domain_deny_list: Referer yang akan ditambahkan ke blacklist. Pisahkan beberapa Referer dengan koma (,).allow_empty: menentukan apakah Referer kosong diizinkan. Nilai yang valid: on dan off.
filetype_based_ttl_set: menentukan periode waktu setelah file akan kedaluwarsa.	ttl: durasi cache. Satuan: detik. Nilai yang valid: 1 hingga 99999999 (lebih dari tiga tahun).file_type: tipe file. Pisahkan beberapa tipe file dengan koma (,).weight: bobot tipe file. Nilai yang valid: 1 hingga 99.
path_based_ttl_set: menentukan periode waktu setelah direktori akan kedaluwarsa.	ttl: durasi cache. Satuan: detik. Nilai yang valid: 1 hingga 99999999 (lebih dari tiga tahun).path: direktori, yang harus diawali dengan garis miring (/).weight: bobot direktori. Nilai yang valid: 1 hingga 99.
oss_auth: mengautentikasi akses ke bucket Object Storage Service (OSS).	oss_bucket_id: path dari bucket OSS Anda.
ip_black_list_set: menentukan blacklist alamat IP.	ip_list: alamat IP yang akan ditambahkan ke blacklist. Pisahkan beberapa alamat IP dengan koma (,).
ip_allow_list_set: menentukan whitelist alamat IP.	ip_list: alamat IP yang akan ditambahkan ke whitelist. Pisahkan beberapa alamat IP dengan koma (,).
ip_white_list_set: menentukan whitelist alamat IP untuk pembatasan kecepatan (rate limiting).	ip_list: alamat IP yang akan ditambahkan ke whitelist. Pisahkan beberapa alamat IP dengan koma (,).
error_page: mengalihkan halaman error ke halaman yang ditentukan.	error_code: kode error.rewrite_page: halaman tujuan pengalihan halaman error.
set_req_host_header: memodifikasi Host header dari permintaan back-to-origin.	domain_name: Host header dari permintaan back-to-origin.
set_hashkey_args: mengabaikan parameter URL yang ditentukan.	hashkey_args: parameter yang akan dipertahankan. Pisahkan beberapa parameter dengan koma (,).disable: menentukan apakah akan mengabaikan semua parameter. Nilai yang valid: on dan off. Nilai on menentukan bahwa semua parameter diabaikan. Nilai off menentukan bahwa tidak ada parameter yang diabaikan.
aliauth: mengonfigurasi autentikasi Alibaba Cloud.	auth_type: tipe autentikasi. Nilai yang valid: type_a dan no_auth. Nilai type_a menentukan bahwa autentikasi tipe A diaktifkan. Nilai no_auth menentukan bahwa autentikasi dinonaktifkan.auth_key1: kunci autentikasi utama. Kunci autentikasi dapat berisi huruf dan angka. Kami menyarankan Anda mengatur kunci autentikasi dengan nilai sepanjang 8 hingga 32 karakter.auth_key2: kunci autentikasi sekunder.ali_auth_delta: waktu buffer kustom untuk autentikasi. Satuan: detik. Kami menyarankan Anda mengatur nilainya minimal 60 detik.auth_m3u8: menentukan apakah akan mengaktifkan M3U8 rewrite. Jika Anda mengaktifkan M3U8 rewrite, sistem akan menyelesaikan autentikasi untuk segmen TS dalam playlist M3U8 untuk mencegah kegagalan dalam mengakses segmen TS. Nilai yang valid: on (default) dan off.
remote_auth: mengonfigurasi autentikasi jarak jauh (remote) untuk live streaming.	enable: menentukan apakah akan mengaktifkan autentikasi jarak jauh. Atribut ini wajib. Nilai yang valid: on dan off.remote_auth_path: alamat server autentikasi. Atribut ini wajib.remote_auth_pattern: mode autentikasi. Bidang-bidang berikut tersedia:- param: menentukan apakah akan meneruskan parameter dalam URL ingest ke server autentikasi. Nilai yang valid: pass (default) dan fail.- args_white: parameter yang ingin Anda teruskan. Pisahkan beberapa parameter dengan koma (,).- args_black: parameter yang tidak ingin Anda teruskan. Pisahkan beberapa parameter dengan koma (,).- code: kode status HTTP. Nilai dalam bentuk code=XXX dikembalikan oleh server autentikasi ke ApsaraVideo Live setelah autentikasi berhasil. Contoh: code=200. Nilai dalam bentuk code=~XXX dikembalikan oleh server autentikasi ke ApsaraVideo Live setelah autentikasi gagal. Contoh: code=~403.- delta: durasi timeout untuk autentikasi.- retry: jumlah percobaan ulang saat timeout autentikasi.- timeout: tindakan yang dilakukan saat timeout autentikasi. Nilai yang valid: pass dan fail. pass: ApsaraVideo Live meneruskan permintaan. fail: ApsaraVideo Live mengembalikan kode status HTTP 403 yang menunjukkan kegagalan.- async: menentukan apakah akan mengaktifkan autentikasi asinkron. Nilai yang valid: on dan off (default).
set_resp_header: mengonfigurasi response header. Untuk memverifikasi konfigurasi, Anda dapat memeriksa pesan respons di browser.	key: nama response header. Nilai yang 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 response header. Jika Anda ingin menghapus header, masukkan null.
https_force: mengonfigurasi pengalihan paksa ke HTTPS.	enable: menentukan apakah akan mengaktifkan fitur. Nilai yang valid: on dan off. Fitur https_force dan http_force saling eksklusif. Anda tidak dapat mengonfigurasi keduanya. Jika Anda telah mengonfigurasi salah satu fitur, Anda harus menghapusnya sebelum dapat mengonfigurasi fitur lainnya.
http_force: mengonfigurasi pengalihan paksa ke HTTP.	enable: menentukan apakah akan mengaktifkan fitur. Nilai yang valid: on dan off. Fitur https_force dan http_force saling eksklusif. Anda tidak dapat mengonfigurasi keduanya. Jika Anda telah mengonfigurasi salah satu fitur, Anda harus menghapusnya sebelum dapat mengonfigurasi fitur lainnya.
forward_scheme: mengonfigurasi back-to-origin adaptif.	enable: menentukan apakah akan mengaktifkan fitur. Nilai yang valid: on dan off.scheme_origin: protokol origin. Nilai yang valid: http, https, dan follow.scheme_origin_port: nomor port origin. Nilai yang valid: 80, 443, dan 80:443.
green_manager: mengonfigurasi deteksi pornografi.	enable: menentukan apakah akan mengaktifkan deteksi pornografi. Nilai yang valid: on dan off.
tmd_signature: mengonfigurasi aturan rate limiting kustom.	name: nama aturan, yang harus unik secara global.path: uniform resource identifier (URI). Anda dapat menentukan URI yang duplikat. Namun, Anda harus memverifikasi validitasnya.pathType: aturan pencocokan. Nilai yang valid: 0 dan 1. Nilai 0 menentukan pencocokan awalan (prefix match). Nilai 1 menentukan pencocokan persis (exact match).interval: interval di mana data dipantau. Satuan: detik. Interval harus lebih besar dari atau sama dengan 10 detik.count: jumlah kunjungan dari alamat IP.action: tindakan yang dilakukan setelah kondisi yang ditentukan terpenuhi. Nilai yang valid: 0 dan 1. Nilai 0 menentukan bahwa akses diblokir. Nilai 1 menentukan bahwa deteksi bot dilakukan.ttl: periode waktu di mana akses diblokir. Satuan: detik.
l2_oss_key: mengonfigurasi autentikasi kunci pribadi untuk permintaan back-to-origin dari node L2 ke bucket OSS pribadi.	private_oss_auth: menentukan apakah akan mengautentikasi akses ke bucket OSS pribadi. Nilai yang valid: on dan off.
video_seek: mengonfigurasi video seeking.	enable: menentukan apakah akan mengaktifkan fitur. Nilai yang valid: on dan off.
gzip: mengonfigurasi kompresi Gzip.	enable: menentukan apakah akan mengaktifkan fitur. Nilai yang valid: on dan off.
tesla: mengonfigurasi optimasi halaman untuk mempercepat akses.	enable: menentukan apakah akan mengaktifkan fitur. Nilai yang valid: on dan off.
ali_ua: mengonfigurasi kontrol akses berbasis User-Agent.	ua: User-Agent.type: tipe daftar. Nilai yang valid: black dan white.
host_redirect: mengonfigurasi URL rewrite.	regex: URL yang akan ditulis ulang. Contoh: ^/$.replacement: URL tujuan. Contoh: /go/act/sale/tbzlsy.php.flag: flag. Nilai yang valid: redirect dan break.
ipv6: mengonfigurasi IPv6.	switch: menentukan apakah akan mengaktifkan IPv6. Atribut ini wajib. Nilai yang valid: on dan off. Jika Anda ingin menonaktifkan fitur ini setelah fitur ini diaktifkan, batalkan pilihan fitur di konsol. Jangan hapus konfigurasi. Jika tidak, fitur akan tetap aktif.region: region di mana Anda ingin mengaktifkan IPv6. Nilai yang valid: cn-beijing, cn-shanghai, cn-shenzhen, cn-qingdao, apsoutheast-1, eu-central-1, ap-northeast-1, dan ap-southeast-5, yang masing-masing menunjukkan Tiongkok (Beijing), Tiongkok (Shanghai), Tiongkok (Shenzhen), Tiongkok (Qingdao), Singapura, Jerman (Frankfurt), Jepang (Tokyo), dan Indonesia (Jakarta).
ali_location: mengonfigurasi kontrol akses berbasis wilayah (region).	location: wilayah.type: tipe daftar. Nilai yang valid: black dan white.
cc_defense: mengonfigurasi perlindungan terhadap serangan HTTP flood.	enable: menentukan apakah akan mengaktifkan perlindungan terhadap serangan HTTP flood. Nilai yang valid: on dan off.
alilive: mengonfigurasi pengaturan live streaming.	notify_url: URL untuk menerima notifikasi dari ApsaraVideo Live.enable: menentukan apakah akan mengaktifkan fitur. Nilai yang valid: on dan off.live_forbid_flv: menentukan apakah akan melarang pemutaran Flash Video (FLV). Nilai yang valid: on dan off.live_forbid_rtmp: menentukan apakah akan melarang pemutaran video Real-Time Messaging Protocol (RTMP). Nilai yang valid: on dan off.live_forbid_hls: menentukan apakah akan melarang pemutaran video HTTP Live Streaming (HLS). Nilai yang valid: on dan off.
ali_grtn: menentukan apakah akan terhubung ke Global Realtime Transport Network (GRTN).	grtn_rts_pub: menentukan apakah akan mengaktifkan stream ingest melalui Real-Time Streaming (RTS). Atribut ini berlaku untuk ingest domain. Nilai yang valid: on dan off.grtn_rts_play: menentukan apakah akan mengaktifkan streaming melalui RTS. Atribut ini berlaku untuk streaming domain. Nilai yang valid: on dan off.grtn_rts_transcode: menentukan apakah akan mengaktifkan transcoding otomatis untuk pemutaran HTML5 berbasis RTS. Nilai yang valid: on dan off.
edge_function: mengonfigurasi edge function.	Atribut wajib:rule: aturan domain-specific language (DSL).pri: prioritas aturan.enable: menentukan apakah akan mengaktifkan aturan. Nilai yang valid: on dan off.Atribut opsional:name: nama aturan.pos: posisi dari mana aturan akan dieksekusi.brk: Setelah aturan dipicu, aturan setelah posisi yang ditentukan dilewati.option: opsi.grammar: tata bahasa. Nilai yang valid: es2 dan js. Anda juga dapat membiarkan atribut ini kosong.jsmode: mode untuk mengelola whitelist nama domain dalam JavaScript. Nilai yang valid: redirect dan bypass.
https_tls_version: mengonfigurasi versi protokol Transport Layer Security (TLS).	tls10: menentukan apakah akan mengaktifkan TLS 1.0. Nilai default: on. Nilai yang valid: on dan off.tls11: menentukan apakah akan mengaktifkan TLS 1.1. Nilai default: on. Nilai yang valid: on dan off.tls12: menentukan apakah akan mengaktifkan TLS 1.2. Nilai default: on. Nilai yang valid: on dan off.tls13: menentukan apakah akan mengaktifkan TLS 1.3. Nilai default: on. Nilai yang valid: on dan off.
https_option: mengonfigurasi pengaturan HTTP.	http2: menentukan apakah akan mengaktifkan HTTP/2. Nilai default: off. Nilai yang valid: on dan off.live_http2: menentukan apakah akan mengaktifkan live_http2. Nilai 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
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.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.