Anda dapat memanggil operasi BatchSetVodDomainConfigs untuk mengonfigurasi fitur pada beberapa nama domain secara bersamaan. Topik ini menjelaskan fitur yang dapat dikonfigurasi melalui operasi ini serta parameter yang perlu ditentukan saat memanggilnya.
Fitur yang dijelaskan dalam topik ini dapat dirujuk saat Anda memanggil operasi API berikut: BatchSetVodDomainConfigs dan DescribeVodDomainConfigs.
Pengaturan dasar
ipv6
Deskripsi fitur: Mengonfigurasi IPv6. Untuk informasi lebih lanjut, lihat Konfigurasi IPv6.
Tabel berikut menjelaskan parameter.
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
saklar
String
Ya
Menentukan apakah akan mengaktifkan IPv6.
on
off
on
wilayah
String
Ya
Wilayah tempat Anda ingin mengaktifkan IPv6.
CatatanAnda dapat memasukkan tanda bintang (*) untuk menentukan semua wilayah. Jika Anda ingin mengaktifkan IPv6 di wilayah tertentu, ajukan tiket.
Jika Anda tidak mengisi parameter ini, IPv6 diaktifkan di semua wilayah.
*
Kode contoh:
{ "Functions": [{ "functionArgs": [{ "argName": "switch", "argValue": "on" }, { "argName": "region", "argValue": "*" }], "functionName": "ipv6" }], "DomainNames": "example.com" }
Pengaturan kembali ke asal
set_req_host_header
Deskripsi fitur: mengonfigurasi host asal default. Untuk informasi lebih lanjut, lihat Konfigurasi host asal.
Tabel berikut menjelaskan parameter yang digunakan.
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
domain_name
String
Ya
Host asal.
example.comContoh:
{ "Functions": [{ "functionArgs": [{ "argName": "domain_name", "argValue": "example.com" }], "functionName": "set_req_host_header" }], "DomainNames": "example.com" }
forward_scheme
Deskripsi fitur: mengonfigurasi kebijakan protokol asal. Untuk informasi lebih lanjut, lihat Konfigurasi kebijakan protokol asal.
Tabel berikut menjelaskan parameter yang digunakan.
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
enable
String
Ya
Menentukan apakah akan mengaktifkan kebijakan protokol asal. Nilai valid:
on
off
on
scheme_origin
String
Tidak
Protokol untuk pengambilan asal. Nilai valid:
http: Alibaba Cloud CDN mengarahkan permintaan ke server asal melalui HTTP.
https: Alibaba Cloud CDN mengarahkan permintaan ke server asal melalui HTTPS.
follow: Saat klien menggunakan HTTP atau HTTPS untuk meminta sumber daya, Alibaba Cloud CDN mengarahkan permintaan ke server asal melalui protokol yang digunakan oleh klien.
CatatanNilai default: follow.
follow
scheme_origin_port
String
Tidak
Port asal kustom. Parameter ini harus digunakan bersama dengan parameter scheme_origin. Nilai valid:
Jika scheme_origin disetel ke http, Anda hanya perlu mengonfigurasi port HTTP asal, seperti 80.
Jika scheme_origin disetel ke https, Anda hanya perlu mengonfigurasi port HTTPS asal, seperti 443.
Jika scheme_origin disetel ke follow, Anda perlu mengonfigurasi port HTTP dan HTTPS asal. Pisahkan port dengan titik dua (:). Contoh: 80:443.
80:443
Kode contoh:
{ "Functions": [{ "functionArgs": [{ "argName": "enable", "argValue": "on" }, { "argName": "scheme_origin", "argValue": "follow" }], "functionName": "forward_scheme" }], "DomainNames": "example.com" }
l2_oss_key
Deskripsi fitur: Mengonfigurasi kontrol akses pada bucket Object Storage Service (OSS) pribadi. Untuk informasi lebih lanjut, lihat Aktifkan akses ke bucket OSS pribadi.
Tabel berikut menjelaskan parameter yang digunakan.
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
private_oss_auth
String
Ya
Menentukan apakah akan mengaktifkan akses ke bucket OSS pribadi. Nilai valid:
on
off
Setelah Anda mengaktifkan fitur ini, sistem secara otomatis mengonfigurasi token keamanan yang dikeluarkan oleh Security Token Service (STS). Namun, Alibaba Cloud CDN hanya dapat mengakses bucket OSS pribadi di akun Alibaba Cloud yang sama. Untuk informasi lebih lanjut tentang token STS, lihat Apa itu STS?
on
perm_private_oss_tbl
String
Tidak
Token keamanan permanen dalam format
access_id=123 access_secret=123abc(dipisahkan dengan spasi).Setelah Anda mengonfigurasi token keamanan permanen, Alibaba Cloud CDN dapat mengakses bucket OSS pribadi di akun Alibaba Cloud yang sama atau akun Alibaba Cloud yang berbeda. Untuk informasi lebih lanjut tentang token keamanan permanen, lihat Buat pasangan AccessKey.
access_id=123 access_secret=123abc
Contoh:
{ "Functions": [{ "functionArgs": [{ "argName": "private_oss_auth", "argValue": "on" },{ "argName": "perm_private_oss_tbl", "argValue": "access_id=123 access_secret=123abc" }], "functionName": "l2_oss_key" }], "DomainNames": "example.com" }
https_origin_sni
Deskripsi fitur: mengonfigurasi Server Name Indication (SNI) asal. Untuk informasi lebih lanjut, lihat Konfigurasi SNI asal.
Tabel berikut menjelaskan parameter yang digunakan.
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
enabled
String
Ya
Menentukan apakah akan mengaktifkan SNI asal. Nilai valid:
on
off
on
https_origin_sni
String
Ya
Informasi SNI yang dibawa dalam permintaan asal. Informasi SNI menentukan alamat server asal.
origin.example.comContoh:
{ "Functions": [{ "functionArgs": [{ "argName": "https_origin_sni", "argValue": "origin.example.com" }, { "argName": "enabled", "argValue": "on" }], "functionName": "https_origin_sni" }], "DomainNames": "example.com" }
forward_timeout
Deskripsi fitur: mengonfigurasi periode timeout untuk permintaan kembali ke asal. Untuk informasi lebih lanjut, lihat Konfigurasi periode timeout untuk permintaan HTTP kembali ke asal.
Tabel berikut menjelaskan parameter yang digunakan.
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
forward_timeout
Integer
Ya
Periode timeout untuk permintaan. Unit: detik.
CatatanKami merekomendasikan Anda menyetel parameter ini kurang dari 100 detik.
30
Contoh:
{ "Functions": [{ "functionArgs": [{ "argName": "forward_timeout", "argValue": "30" }], "functionName": "forward_timeout" }], "DomainNames": "example.com" }
advanced_origin
Deskripsi fitur: mengonfigurasi pengaturan routing asal tingkat lanjut. Untuk detail lebih lanjut, lihat Konfigurasi Pengaturan Asal Tingkat Lanjut.
Tabel berikut menjelaskan parameter yang digunakan.
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
variable_type
String
Ya
Tipe variabel. Nilai valid:
header: header permintaan.
arg: parameter string query dalam URL permintaan.
uri: jalur dalam URL permintaan.
cookie: cookie permintaan.
uri
variable
String
Ya
Nama variabel.
CatatanJika Anda menyetel parameter variable_type ke uri, nilai parameter variable hanya bisa uri.
uri
conditions
String
Ya
Kondisi. Nilai valid:
==: sama dengan.
!=: tidak sama dengan.
==
value
String
Ya
Nilai variabel.
/image
origin
String
Ya
Nama domain server as yang dibawa dalam variabel di permintaan pengguna. Permintaan yang ditujukan untuk nama domain tersebut dialihkan ke server asal yang ditentukan.
origin.example.com
Contoh:
{ "Functions": [{ "functionArgs": [{ "argName": "conditions", "argValue": "==" }, { "argName": "variable_type", "argValue": "uri" }, { "argName": "value", "argValue": "/image" }, { "argName": "origin", "argValue": "origin.example.com" }, { "argName": "variable", "argValue": "uri" }], "functionName": "advanced_origin" }], "DomainNames": "example.com", }
follow_302
Deskripsi fitur: Mengonfigurasi pengalihan 302. Untuk informasi lebih lanjut, lihat Konfigurasi pengalihan 301/302.
Tabel berikut menjelaskan parameter yang digunakan.
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
enable
String
Ya
Menentukan apakah akan mengaktifkan pengalihan 302.
on
off
on
max_tries
Integer
Tidak
Jumlah maksimum pengalihan 302.
Nilai default: 2.
Nilai valid: 1 hingga 5.
CatatanJumlah kali pengambilan asal - 1 = Jumlah pengalihan 302. Nilai default jumlah maksimum kali pengambilan asal adalah 3, dan nilai validnya adalah 2 hingga 6.
2
retain_args
String
Tidak
Menentukan apakah akan mempertahankan parameter permintaan selama pengalihan 302. Nilai default: off. Nilai valid:
on
off
off
retain_header
String
Tidak
Menentukan apakah akan mempertahankan header permintaan selama pengalihan 302. Nilai default: off. Nilai valid:
on
off
off
response_header
String
Tidak
Header respons dari pengalihan 302 yang dikembalikan dari server asal. Nilai default: Location.
X-Alicdn-Redirect
retain_host
String
Tidak
Menentukan apakah akan mempertahankan nama domain asal selama pengalihan 302. Fitur ini tersedia hanya ketika nama domain tujuan diperoleh dari header respons. Nilai default: off. Nilai valid:
on
off
off
modify_host
String
Tidak
Menentukan apakah akan memodifikasi nama domain asal selama pengalihan 302. Fitur ini tersedia hanya ketika nama domain tujuan diperoleh dari header respons. Secara default, nama domain asal tidak dimodifikasi.
example.com
cache
String
Tidak
Menentukan apakah akan menyimpan hasil pengalihan URL yang sama selama pengalihan 302. Ini dapat membantu meningkatkan kinerja respons Alibaba Cloud CDN. Nilai default: off. Nilai valid:
on
off
off
expired_time
Integer
Tidak
Periode timeout untuk hasil pengalihan URL yang disimpan selama pengalihan 302. Parameter ini valid saat parameter cache disetel ke on. Unit: detik. Nilai default: 3600.
7200
follow_origin_host
String
Tidak
Menentukan apakah nama domain asal digunakan sebagai host asal selama pengalihan 302. Jika parameter ini disetel ke on, nama domain asal digunakan sebagai host asal dan nama domain asal terbaru digunakan untuk switchover primer/sekunder. Nilai default: off. Nilai valid:
on
off
off
follow_5xx_retry_origin
String
Tidak
Menentukan apakah akan mengaktifkan switchover asal primer/sekunder. Jika fitur ini diaktifkan, ketika Alibaba Cloud CDN menerima kode status HTTP 5xx dari server asal, Alibaba Cloud CDN beralih ke server asal lain yang tersedia. Nilai default: off. Nilai valid:
on
off
off
Contoh:
{ "Functions": [{ "functionArgs": [{ "argName": "enable", "argValue": "on" }, { "argName": "max_tries", "argValue": 2 }, { "argName": "retain_args", "argValue": "off" }, { "argName": "retain_header", "argValue": "off" }, { "argName": "response_header", "argValue": "X-Alicdn-Redirect" }, { "argName": "retain_header", "argValue": "off" }, { "argName": "modify_host", "argValue": "example.com" }, { "argName": "cache", "argValue": "off" }, { "argName": "expired_time", "argValue": "7200" }, { "argName": "follow_origin_host", "argValue": "off" }, { "argName": "follow_5xx_retry_origin", "argValue": "off" }], "functionName": "follow_302" }], "DomainNames": "example.com" }
ipv6_origin
Deskripsi fitur: Mengonfigurasi routing kembali ke asal melalui IPv6. Untuk informasi lebih lanjut, lihat Konfigurasi routing kembali ke asal melalui IPv6.
Tabel berikut menjelaskan parameter yang digunakan.
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
enable
String
Ya
Menentukan apakah akan mengaktifkan pengambilan asal melalui IPv6.
on
off
CatatanSetelah Anda mengaktifkan fitur ini, server asal menyediakan layanan IPv6.
Jika baik POP maupun server asal memiliki alamat IPv6 yang tersedia, koneksi IPv6 digunakan.
Koneksi IPv4 digunakan dalam skenario berikut:
POP tidak memiliki alamat IPv6 yang tersedia.
Server asal tidak memiliki alamat IPv6 yang tersedia.
POP dan server asal tidak memiliki alamat IPv6 yang tersedia.
on
follow
String
Ya
Menentukan apakah akan mengikuti versi protokol IP yang digunakan oleh klien.
on
off
CatatanSetelah Anda mengaktifkan fitur ini, versi IP dari permintaan klien digunakan untuk pengambilan asal.
Jika permintaan klien menggunakan IPv6, server asal yang menggunakan IPv6 digunakan untuk pengambilan asal. Jika tidak ada server asal yang menggunakan IPv6, server asal yang menggunakan IPv4 digunakan untuk pengambilan asal.
Jika permintaan klien menggunakan IPv4, server asal yang menggunakan IPv4 digunakan untuk pengambilan asal. Jika tidak ada server asal yang menggunakan IPv4, server asal yang menggunakan IPv6 digunakan untuk pengambilan asal.
on
ipv6_v4_mix_used
String
Tidak
Menentukan apakah akan mengaktifkan fitur polling IPv4/IPv6.
on
off
CatatanFitur ini saling eksklusif dengan pengambilan asal melalui IPv6 dan pengikutan protokol IP.
Ketika fitur polling IPv4/IPv6 diaktifkan, polling digunakan untuk menentukan alamat IP server asal untuk pengambilan asal, terlepas dari apakah permintaan dikirim melalui IPv4 atau IPv6, atau berapa banyak alamat IPv4 dan IPv6 yang dimiliki server asal.
Jika Anda mengonfigurasi rasio bobot alamat IPv4 dan IPv6, pengambilan asal dilakukan berdasarkan rasio bobot.
off
Contoh:
{ "Functions": [{ "functionArgs": [{ "argName": "enable", "argValue": "on" },{ "argName": "follow", "argValue": "on" }], "functionName": "ipv6_origin" }], "DomainNames": "example.com" }
Pengaturan header permintaan asal
Deskripsi fitur: Mengonfigurasi header permintaan HTTP asal. Untuk informasi lebih lanjut, lihat Konfigurasi Header Permintaan HTTP.
Tabel berikut menjelaskan parameter.
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
header_operation_type
String
Ya
Operasi yang ingin Anda lakukan pada header permintaan. Nilai valid:
add
delete
modify
rewrite
add
header_name
String
Ya
Nama header permintaan.
Accept-Encoding
header_value
String
Tidak
Nilai header permintaan. Anda dapat menentukan satu atau lebih nilai untuk header permintaan. Pisahkan nilai dengan koma (,).
gzip
duplicate
String
Tidak
Menentukan apakah akan mengizinkan header permintaan duplikat. Parameter ini diperlukan jika Anda menyetel parameter header_operation_type ke add. Nilai valid:
on
off
off
header_source
String
Tidak
Nilai header yang ingin Anda ganti. Jika header_operation_type disetel ke rewrite, Anda perlu menentukan parameter ini. Ekspresi reguler didukung.
value1
header_destination
String
Tidak
Nilai header yang digunakan untuk menggantikan nilai header asli. Jika Anda menyetel parameter header_operation_type ke rewrite, Anda perlu menentukan parameter ini. Nilai valid:
value123
match_all
String
Tidak
Mode pencocokan. Jika Anda menyetel parameter header_operation_type ke rewrite, Anda perlu menentukan mode pencocokan. Nilai valid:
on: Semua nilai header yang cocok dengan kondisi pencarian diganti.
off: Hanya nilai pertama yang cocok dengan kondisi pencarian yang diganti.
off
Contoh: Tambahkan header permintaan asal ke permintaan yang ditujukan untuk
example.com. Atur nama header menjadi Accept-Encoding, dan nilai headernya menjadi gzip.{ "Functions": [{ "functionArgs": [{ "argName": "header_operation_type", "argValue": "add" }, { "argName": "header_name", "argValue": "Accept-Encoding" }, { "argName": "header_value", "argValue": "gzip" }, { "argName": "duplicate", "argValue": "off" }], "functionName": "origin_request_header" }], "DomainNames": "example.com" }
origin_response_header
Deskripsi fitur: Mengonfigurasi header respons HTTP asal. Untuk informasi lebih lanjut, lihat Konfigurasi header respons HTTP.
Tabel berikut menjelaskan parameter yang digunakan.
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
header_operation_type
String
Ya
Operasi yang ingin Anda lakukan pada header respons. Nilai valid:
add
delete
modify
rewrite
add
header_name
String
Ya
Nama header respons.
Cache-Control
header_value
String
Tidak
Nilai header respons. Anda dapat menentukan satu atau lebih nilai untuk header respons. Pisahkan nilai dengan koma (,).
no-cache
duplicate
String
Tidak
Menentukan apakah akan mengizinkan header respons duplikat. Parameter ini diperlukan jika Anda menyetel parameter header_operation_type ke add. Nilai valid:
on
off
off
header_source
String
Tidak
Nilai header yang ingin Anda ganti. Jika header_operation_type disetel ke rewrite, Anda perlu menentukan parameter ini. Ekspresi reguler didukung.
value1
header_destination
String
Tidak
Nilai header yang digunakan untuk menggantikan nilai header asli. Jika Anda menyetel parameter header_operation_type ke rewrite, Anda perlu menentukan parameter ini. Nilai valid:
value123
match_all
String
Tidak
Mode pencocokan. Jika Anda menyetel parameter header_operation_type ke rewrite, Anda perlu menentukan mode pencocokan. Nilai valid:
on: Semua nilai header yang cocok dengan kondisi pencarian diganti.
off: Hanya nilai pertama yang cocok dengan kondisi pencarian yang diganti.
off
Contoh:
{ "Functions": [{ "functionArgs": [{ "argName": "header_operation_type", "argValue": "add" }, { "argName": "header_name", "argValue": "Cache-Control" }, { "argName": "header_value", "argValue": "no-cache" }, { "argName": "duplicate", "argValue": "off" }], "functionName": "origin_response_header" }], "DomainNames": "example.com" }
back_to_origin_url_rewrite
Deskripsi fitur: Menulis ulang URL dalam permintaan kembali ke asal. Untuk informasi lebih lanjut, lihat Tulis ulang URL dalam permintaan kembali ke asal.
Tabel berikut menjelaskan parameter yang digunakan.
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
source_url
String
Ya
URL yang ingin Anda tulis ulang.
^/hello$
target_url
String
Ya
URL akhir.
/hello/test
flag
String
Tidak
Flag penulisan ulang. Nilai valid:
None: Jika aturan saat ini cocok, sistem melanjutkan mencocokkan URL terhadap aturan lainnya.
break: Jika aturan saat ini cocok, sistem melewati aturan lainnya.
enhance_break: Flag ini mirip dengan break tetapi flag ini menulis parameter URL dan berlaku untuk streaming video Flash (FLV) langsung.
break
Contoh:
{ "Functions": [{ "functionArgs": [{ "argName": "flag", "argValue": "break" }, { "argName": "source_url", "argValue": "^/hello$" }, { "argName": "target_url", "argValue": "/hello/test" }], "functionName": "back_to_origin_url_rewrite" }], "DomainNames": "example.com", }
Pengaturan cache
filetype_based_ttl_set
Deskripsi fitur: mengonfigurasi time-to-live (TTL) untuk file. Untuk informasi lebih lanjut, lihat Pengaturan cache.
Tabel berikut menjelaskan parameter yang digunakan.
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
ttl
Integer
Ya
TTL. Unit: detik. Nilai valid: 1 hingga 99999999, yang lebih dari 3 tahun.
500000
file_type
String
Ya
Ekstensi nama file, yang peka huruf besar-kecil. Pisahkan ekstensi nama file dengan koma (,). Contoh: jpg,txt.
jpg
weight
Integer
Tidak
Bobot. Nilai valid: 1 hingga 99.
CatatanNilai default: 1. Nilai yang lebih tinggi menunjukkan prioritas yang lebih tinggi.
1
swift_origin_cache_high
String
Tidak
Menentukan apakah kebijakan cache pada server asal berlaku ketika server asal merespons header terkait cache, seperti Cache-Control dan Pragma. Nilai default: off. Nilai valid:
on
off
off
swift_no_cache_low
String
Tidak
Menentukan apakah akan mengabaikan header respons berikut dari server asal. Jika parameter ini disetel ke on, sumber daya tidak di-cache.
Cache-Control: no-store
Cache-Control: no-cache
Cache-Control: max-age=0
Pragma: no-cache
Nilai default: off. Nilai valid:
on
off
off
swift_follow_cachetime
String
Tidak
Menentukan apakah klien menggunakan kebijakan cache yang digunakan oleh Alibaba Cloud CDN. Nilai default: off. Nilai valid:
on
off
off
Contoh:
{ "Functions": [{ "functionArgs": [{ "argName": "file_type", "argValue": "jpg" }, { "argName": "weight", "argValue": "1" }, { "argName": "ttl", "argValue": "500000" }, { "argName": "swift_origin_cache_high", "argValue": "off" }, { "argName": "swift_no_cache_low", "argValue": "off" }, { "argName": "swift_follow_cachetime", "argValue": "off" }], "functionName": "filetype_based_ttl_set" }], "DomainNames": "example.com" }
path_based_ttl_set
Deskripsi fitur: mengonfigurasi TTL untuk direktori. Untuk informasi lebih lanjut, lihat Pengaturan cache.
Tabel berikut menjelaskan parameter.
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
ttl
Integer
Ya
TTL. Unit: detik. Nilai valid: 1 hingga 99999999, yang lebih dari 3 tahun.
500000
path
String
Ya
Direktori. Direktori harus dimulai dengan garis miring (/).
/example/demo
weight
Integer
Tidak
Bobot. Nilai valid: 1 hingga 99.
CatatanNilai default: 1. Nilai yang lebih tinggi menunjukkan prioritas yang lebih tinggi.
1
swift_origin_cache_high
String
Tidak
Menentukan apakah kebijakan cache pada server asal berlaku ketika server asal merespons header terkait cache, seperti Cache-Control dan Pragma. Nilai default: off. Nilai valid:
on
off
nonaktif
swift_no_cache_low
String
Tidak
Menentukan apakah akan mengabaikan header respons berikut dari server asal. Jika parameter ini disetel ke on, sumber daya tidak di-cache.
Cache-Control: no-store
Cache-Control: no-cache
Cache-Control: max-age=0
Pragme: no-cache
Nilai default: off. Nilai valid:
on
off
off
swift_follow_cachetime
String
Tidak
Menentukan apakah klien menggunakan kebijakan cache yang digunakan oleh Alibaba Cloud CDN. Nilai default: off. Nilai valid:
on
off
off
Contoh:
{ "Functions": [{ "functionArgs": [{ "argName": "path", "argValue": "/example/demo" }, { "argName": "weight", "argValue": "1" }, { "argName": "ttl", "argValue": "500000" }, { "argName": "swift_origin_cache_high", "argValue": "off" }, { "argName": "swift_no_cache_low", "argValue": "off" }, { "argName": "swift_follow_cachetime", "argValue": "off" }], "functionName": "path_based_ttl_set" }], "DomainNames": "example.com" }
filetype_force_ttl_code
Deskripsi fitur: Mengonfigurasi TTL untuk kode status HTTP file. Untuk detail lebih lanjut, lihat Konfigurasikan periode validitas untuk kode status.
Tabel berikut menjelaskan parameter yang digunakan.
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
file_type
String
Ya
Ekstensi nama file. Ekstensi nama file bersifat peka huruf besar-kecil. Pisahkan beberapa nilai dengan koma (,). Contoh: jpg,txt.
jpg
code_string
String
Ya
Kode status dan TTL-nya. Unit: detik. Nilai valid: 1 hingga 99999999 (lebih dari tiga tahun). Pisahkan beberapa pasangan kunci-nilai dengan koma (,). Contoh: 302=0,301=0,4xx=2.
403=10
swift_origin_cache_high
String
Tidak
Menentukan apakah kebijakan cache pada server asal berlaku ketika server asal merespons header terkait cache, seperti Cache-Control dan Pragma. Nilai default: off. Nilai valid:
on
off
off
swift_no_cache_low
String
Tidak
Menentukan apakah akan mengabaikan header respons berikut dari server asal. Jika parameter ini disetel ke on, sumber daya tidak di-cache.
Cache-Control: no-store
Cache-Control: no-cache
Cache-Control: max-age=0
Pragme: no-cache
Nilai default: off. Nilai valid:
on
off
off
swift_follow_cachetime
String
Tidak
Menentukan apakah klien menggunakan kebijakan cache yang digunakan oleh Alibaba Cloud CDN. Nilai default: off. Nilai valid:
on
off
off
Contoh:
{ "Functions": [{ "functionArgs": [{ "argName": "file_type", "argValue": "jpg" }, { "argName": "code_string", "argValue": "403=10" }, { "argName": "swift_origin_cache_high", "argValue": "off" }, { "argName": "swift_no_cache_low", "argValue": "off" }, { "argName": "swift_follow_cachetime", "argValue": "off" }], "functionName": "filetype_force_ttl_code" }], "DomainNames": "example.com" }
path_force_ttl_code
Deskripsi fitur: Mengonfigurasi TTL untuk kode status HTTP dari jalur. Untuk detail lebih lanjut, lihat Konfigurasikan periode validitas untuk kode status.
Tabel berikut menjelaskan parameter yang digunakan.
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
path
String
Ya
Direktori. Direktori harus dimulai dengan garis miring (/). Contoh: /image.
/example/demo
code_string
String
Ya
Kode status dan TTL-nya. Unit: detik. Nilai valid: 1 hingga 99999999 (lebih dari tiga tahun). Pisahkan beberapa pasangan kunci-nilai dengan koma (,). Contoh: 302=0,301=0,4xx=2.
403=10,404=15
swift_origin_cache_high
String
Tidak
Menentukan apakah kebijakan cache pada server asal berlaku ketika server asal merespons header terkait cache, seperti Cache-Control dan Pragma. Nilai default: off. Nilai valid:
on
off
off
swift_no_cache_low
String
Tidak
Menentukan apakah akan mengabaikan header respons berikut dari server asal. Jika parameter ini disetel ke on, sumber daya tidak di-cache.
Cache-Control: no-store
Cache-Control: no-cache
Cache-Control: max-age=0
Pragma: no-cache
Nilai default: off. Nilai valid:
on
off
off
swift_follow_cachetime
String
Tidak
Menentukan apakah klien menggunakan kebijakan cache yang digunakan oleh Alibaba Cloud CDN. Nilai default: off. Nilai valid:
on
off
off
Contoh:
{ "Functions": [{ "functionArgs": [{ "argName": "path", "argValue": "/example/demo" }, { "argName": "code_string", "argValue": "403=10,404=15" }, { "argName": "swift_origin_cache_high", "argValue": "off" }, { "argName": "swift_no_cache_low", "argValue": "off" }, { "argName": "swift_follow_cachetime", "argValue": "off" }], "functionName": "path_force_ttl_code" }], "DomainNames": "example.com" }
set_resp_header
Deskripsi fitur: Mengonfigurasi header respons HTTP kustom. Untuk informasi lebih lanjut, lihat Konfigurasikan header respons HTTP kustom.
Tabel berikut menjelaskan parameter yang digunakan.
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
key
String
Ya
Header respons.
Cache-Control
value
String
Ya
Nilai header. Pisahkan nilai header dengan koma (,).
CatatanJika Anda ingin menghapus header respons, atur nilai headernya menjadi null.
no-cache
header_operation_type
String
Tidak
Operasi yang ingin Anda lakukan pada header. Nilai valid:
add
delete
modify
rewrite: mengganti header.
add
duplicate
String
Tidak
Menentukan apakah akan mengizinkan header permintaan duplikat. Parameter ini diperlukan jika Anda menyetel parameter header_operation_type ke add. Nilai valid:
on
off
off
header_source
String
Tidak
Nilai header yang ingin Anda ganti. Jika header_operation_type disetel ke rewrite, Anda perlu menentukan parameter ini. Ekspresi reguler didukung.
value1
header_destination
String
Tidak
Nilai header yang digunakan untuk menggantikan nilai header asli. Jika Anda menyetel parameter header_operation_type ke rewrite, Anda perlu menentukan parameter ini. Nilai valid:
value123
match_all
String
Tidak
Mode pencocokan. Jika Anda menyetel parameter header_operation_type ke rewrite, Anda perlu menentukan mode pencocokan. Nilai valid:
on: Semua nilai header yang cocok dengan kondisi pencarian diganti.
off: Hanya nilai pertama yang cocok dengan kondisi pencarian yang diganti.
/
access_origin_control
String
Tidak
Menentukan apakah akan mengaktifkan berbagi sumber daya lintas domain (CORS). Nilai valid:
on
off
/
Contoh:
{ "Functions": [{ "functionArgs": [{ "argName": "header_operation_type", "argValue": "add" }, { "argName": "key", "argValue": "Cache-Control" }, { "argName": "value", "argValue": "no-cache" }, { "argName": "duplicate", "argValue": "off" }], "functionName": "set_resp_header" }], "DomainNames": "example.com" }
error_page
Deskripsi fitur: mengonfigurasi halaman kustom. Untuk informasi lebih lanjut, lihat Sesuaikan halaman.
Tabel berikut menjelaskan parameter yang digunakan.
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
error_code
Integer
Ya
Kode status HTTP.
404
rewrite_page
String
Ya
Halaman ke mana permintaan dialihkan.
http://example.aliyundoc.com/error404.htmlContoh:
{ "Functions": [{ "functionArgs": [{ "argName": "error_code", "argValue": "404" }, { "argName": "rewrite_page", "argValue": "http://example.aliyundoc.com/error404.html" }], "functionName": "error_page" }], "DomainNames": "example.com" }
rewrite_host
Deskripsi fitur: Mengonfigurasi berbagi cache.
Tabel berikut menjelaskan parameter yang digunakan.
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
share_host
String
Ya
Nama domain dengan mana Anda ingin nama domain saat ini berbagi cache. Mengonfigurasi parameter ini tidak memodifikasi host asal dari permintaan. Nilai share_host digunakan untuk menghasilkan kunci cache untuk query.
example.com
Contoh:
{ "Functions": [{ "functionArgs": [{ "argName": "share_host", "argValue": "example.com" }], "functionName": "rewrite_host" }], "DomainNames": "example.com" }
Pengaturan HTTPS
https_option
Deskripsi fitur: Mengonfigurasi parameter dasar HTTPS. Hanya HTTP/2 yang didukung. Untuk informasi lebih lanjut, lihat Aktifkan HTTP/2.
Tabel berikut menjelaskan parameter.
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
http2
String
Tidak
Menentukan apakah akan mengaktifkan HTTP/2.
on
off
on
Kode contoh:
{ "Functions": [{ "functionArgs": [{ "argName": "http2", "argValue": "on" }], "functionName": "https_option" }], "DomainNames": "example.com" }
http_force
Deskripsi fitur: Mengonfigurasi pengalihan URL paksa ke HTTP. Untuk informasi lebih lanjut, lihat Pengalihan paksa.
CatatanFitur pengalihan URL paksa ke HTTP bertentangan dengan fitur pengalihan URL paksa ke HTTPS (fungsi: https_force). Anda hanya dapat menggunakan salah satu dari dua fitur tersebut.
Jika Anda telah mengonfigurasi salah satu fitur, Anda harus menghapus konfigurasi fitur tersebut sebelum mengonfigurasi fitur lainnya. Anda dapat memanggil operasi DeleteVodSpecificConfig untuk menghapus konfigurasi nama domain. Jika suatu fitur memiliki parameter saklar dan parameternya disetel ke off, fitur tersebut dianggap dikonfigurasi.
Tabel berikut menjelaskan parameter.
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
enable
String
Ya
Menentukan apakah akan mengaktifkan pengalihan URL ke HTTP.
on
off
on
http_rewrite
String
Tidak
Metode pengalihan. Nilai valid: 301 dan 308.
301: Metode permintaan GET tidak berubah. Metode permintaan lainnya mungkin berubah menjadi GET.
308: Metode permintaan dan badan pesan tetap tidak berubah.
301
Contoh:
{ "Functions": [{ "functionArgs": [{ "argName": "enable", "argValue": "on" }, { "argName": "http_rewrite", "argValue": "301" }], "functionName": "http_force" }], "DomainNames": "example.com" }
https_force
Deskripsi fitur: Mengonfigurasi pengalihan URL paksa ke HTTPS. Untuk informasi lebih lanjut, lihat Pengalihan paksa.
CatatanFitur pengalihan URL paksa ke HTTPS bertentangan dengan fitur pengalihan URL paksa ke HTTP (fungsi: http_force). Anda hanya dapat menggunakan salah satu dari dua fitur tersebut.
Jika Anda telah mengonfigurasi salah satu fitur, Anda harus menghapus konfigurasi fitur tersebut sebelum mengonfigurasi fitur lainnya. Anda dapat memanggil operasi DeleteVodSpecificConfig untuk menghapus konfigurasi nama domain. Jika suatu fitur memiliki parameter saklar dan parameternya disetel ke off, fitur tersebut dianggap dikonfigurasi.
Tabel berikut menjelaskan parameter.
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
enable
String
Ya
Menentukan apakah akan mengaktifkan pengalihan paksa ke HTTPS. Nilai valid:
on
off
on
https_rewrite
String
Tidak
Metode pengalihan. Nilai valid: 301 dan 308.
301: Metode permintaan GET tidak berubah. Metode permintaan lainnya mungkin berubah menjadi GET.
308: Metode permintaan dan badan pesan tetap tidak berubah.
301
Contoh:
{ "Functions": [{ "functionArgs": [{ "argName": "enable", "argValue": "on" }, { "argName": "https_rewrite", "argValue": "301" }], "functionName": "https_force" }], "DomainNames": "example.com" }
https_tls_version
Deskripsi fitur: Mengonfigurasi versi Transport Layer Security (TLS). Untuk informasi lebih lanjut, lihat Konfigurasikan kontrol versi TLS.
Tabel berikut menjelaskan parameter.
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
tls10
String
Tidak
Menentukan apakah akan mengaktifkan TLS 1.0. Nilai default: on. Nilai valid:
on
off
on
tls11
String
Tidak
Menentukan apakah akan mengaktifkan TLS 1.1. Nilai default: on. Nilai valid:
on
off
on
tls12
String
Tidak
Menentukan apakah akan mengaktifkan TLS 1.2. Nilai default: on. Nilai valid:
on
off
on
tls13
String
Tidak
Menentukan apakah akan mengaktifkan TLS 1.3. Nilai default: on. Nilai valid:
on
off
on
ciphersuitegroup
String
Tidak
Grup cipher suite. Nilai default: all. Nilai valid:
all: semua cipher suite.
strict: cipher suite yang ditingkatkan.
custom: cipher suite kustom.
all
String
Tidak
Cipher suite. Parameter ini digunakan bersama dengan parameter ciphersuitegroup. Pisahkan beberapa cipher suite dengan koma (,).
TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256,TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
Contoh:
TLS 1.0, 1.1, dan 1.2 diaktifkan, dan semua cipher suite digunakan. Ini adalah konfigurasi default.
{ "Functions": [{ "functionArgs": [ { "ArgValue": "on", "ArgName": "tls10" }, { "ArgValue": "on", "ArgName": "tls11" }, { "ArgValue": "on", "ArgName": "tls12" }, { "ArgValue": "off", "ArgName": "tls13" }, { "ArgValue": "all", "ArgName": "ciphersuitegroup" } ], "functionName": "https_tls_version" }], "DomainNames": "example.com" }TLS 1.2 dan 1.3 diaktifkan dan cipher suite yang ditingkatkan digunakan.
{ "Functions": [{ "functionArgs": [ { "ArgValue": "off", "ArgName": "tls10" }, { "ArgValue": "off", "ArgName": "tls11" }, { "ArgValue": "on", "ArgName": "tls12" }, { "ArgValue": "on", "ArgName": "tls13" }, { "ArgValue": "strict", "ArgName": "ciphersuitegroup" } ], "functionName": "https_tls_version" }], "DomainNames": "example.com" }TLS 1.2 dan 1.3 diaktifkan dan cipher suite kustom digunakan.
{ "Functions": [{ "functionArgs": [ { "ArgValue": "off", "ArgName": "tls10" }, { "ArgValue": "off", "ArgName": "tls11" }, { "ArgValue": "on", "ArgName": "tls12" }, { "ArgValue": "on", "ArgName": "tls13" }, { "ArgValue": "custom", "ArgName": "ciphersuitegroup" }, { "ArgValue": "TLS_ECDHE_ECDSA_WITH_AES_128_CCM_8,TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256,TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256", "ArgName": "ciphersuite" } ], "functionName": "https_tls_version" }], "DomainNames": "example.com" }
Pengaturan kontrol akses
referer_white_list_set
Deskripsi fitur: mengonfigurasi daftar putih Referer. Untuk informasi lebih lanjut, lihat Perlindungan Hotlinking.
CatatanFitur daftar putih Referer bertentangan dengan fitur daftar hitam Referer (fungsi: referer_black_list_set). Hanya satu dari kedua fitur tersebut yang dapat digunakan.
Jika salah satu fitur telah dikonfigurasi, Anda harus menghapus konfigurasinya sebelum mengaktifkan fitur lainnya. Gunakan operasi DeleteVodSpecificConfig untuk menghapus konfigurasi nama domain. Jika suatu fitur memiliki parameter saklar dan parameternya disetel ke off, fitur tersebut dianggap terkonfigurasi.
Tabel berikut menjelaskan parameter:
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
refer_domain_allow_list
String
Ya
Nama domain yang ingin Anda tambahkan ke daftar putih Referer. Anda dapat menentukan beberapa nama domain. Pisahkan nama domain dengan koma (,).
example.aliyundoc.com,demo.aliyundoc.comallow_empty
String
Tidak
Menentukan apakah permintaan dengan header Referer kosong dapat mengakses sumber daya pada Alibaba Cloud CDN POP. Nilai default: off. Nilai valid:
on
off
off
redirect_url
String
Tidak
URL pengalihan. Jika informasi Referer dalam permintaan tidak cocok dengan informasi dalam daftar putih, kode status 403 tidak dikembalikan setelah permintaan diblokir. Dalam hal ini, kode status 302 dan header Lokasi dikembalikan. Parameter ini adalah nilai dari header Lokasi dan dimulai dengan http:// atau https://.
http://www.example.comdisable_ast
String
Tidak
Menentukan apakah pencocokan tepat untuk nama domain dalam daftar putih diaktifkan. Nilai default: off. Jika Anda menyetel parameter ini ke on, pencocokan tepat untuk nama domain diaktifkan.
Jika Anda menyetel parameter ini ke on, aturan berikut berlaku:
Pencocokan tepat didukung.
Jika Anda menambahkan
example.comke daftar putih,example.comcocok.Jika Anda menambahkan
a*b.example.comke daftar putih,a<Karakter apa saja>b.example.comcocok.
Pencocokan akhiran tidak didukung.
Jika Anda menyetel parameter ini ke off, aturan berikut berlaku:
Pencocokan tepat tidak didukung.
Pencocokan akhiran didukung.
Jika Anda menambahkan
example.comke daftar putih,example.comdan<Karakter apa saja>.example.comcocok.Jika Anda menambahkan
a*b.example.comke daftar putih,a<Karakter apa saja>b.example.comdan<Karakter apa saja>.a<Karakter apa saja>b.example.comcocok.
off
ignore_scheme
String
Tidak
Menentukan apakah mengabaikan parameter skema. Nilai default: off. Setelah Anda mengaktifkan fitur ini, jika Referer dalam permintaan tidak memiliki header HTTP atau HTTPS, Referer masih dianggap valid.
Jika Anda menyetel parameter ini ke on, format Referer adalah sebagai berikut:
referer: www.example.comJika Anda menyetel parameter ini ke off, format Referer adalah sebagai berikut:
referer: https://www.example.com
off
Kode contoh:
{ "Functions": [ { "functionArgs": [ { "argName": "allow_empty", "argValue": "off" }, { "argName": "refer_domain_allow_list", "argValue": "example.aliyundoc.com,demo.aliyundoc.com" }, { "argName": "disable_ast", "argValue": "on" }, { "argName": "ignore_scheme", "argValue": "on" }, { "argName": "redirect_url", "argValue": "http://www.example.com" } ], "functionName": "referer_white_list_set" } ], "DomainNames": "example.com" }
referer_black_list_set
Deskripsi fitur: mengonfigurasi daftar hitam Referer. Untuk informasi lebih lanjut, lihat Perlindungan Hotlinking.
CatatanFitur daftar hitam Referer bertentangan dengan fitur daftar putih Referer (fungsi: referer_white_list_set). Hanya satu dari kedua fitur tersebut yang dapat digunakan.
Jika salah satu fitur telah dikonfigurasi, Anda harus menghapus konfigurasinya sebelum mengaktifkan fitur lainnya. Gunakan operasi DeleteVodSpecificConfig untuk menghapus konfigurasi nama domain. Jika suatu fitur memiliki parameter saklar dan parameternya disetel ke off, fitur tersebut dianggap terkonfigurasi.
Tabel berikut menjelaskan parameter:
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
refer_domain_deny_list
String
Ya
Nama domain yang ingin Anda tambahkan ke daftar hitam Referer. Anda dapat menentukan beberapa nama domain. Pisahkan nama domain dengan koma (,).
example.aliyundoc.com,demo.aliyundoc.comallow_empty
String
Tidak
Menentukan apakah permintaan dengan header Referer kosong dapat mengakses sumber daya pada Alibaba Cloud CDN POP. Nilai valid:
on
off
off
redirect_url
String
Tidak
URL pengalihan. Jika informasi Referer dalam permintaan cocok dengan informasi dalam daftar hitam, kode status 403 tidak dikembalikan setelah permintaan diblokir. Dalam hal ini, kode status 302 dan header Lokasi dikembalikan. Parameter ini adalah nilai dari header Lokasi dan dimulai dengan http:// atau https://.
http://www.example.comdisable_ast
String
Tidak
Menentukan apakah pencocokan tepat untuk nama domain dalam daftar hitam diaktifkan. Nilai default: off. Jika Anda menyetel parameter ini ke on, pencocokan tepat untuk nama domain diaktifkan.
Jika Anda menyetel parameter ini ke on, aturan berikut berlaku:
Pencocokan tepat didukung.
Jika Anda menambahkan
example.comke daftar hitam,example.comcocok.Jika Anda menambahkan
a*b.example.comke daftar hitam,a<Karakter apa saja>b.example.comcocok.
Pencocokan akhiran tidak didukung.
Jika Anda menyetel parameter ini ke off, aturan berikut berlaku:
Pencocokan tepat tidak didukung.
Pencocokan akhiran didukung.
Jika Anda menambahkan
example.comke daftar hitam,example.comdan<Karakter apa saja>.example.comcocok.Jika Anda menambahkan
a*b.example.comke daftar hitam,a<Karakter apa saja>b.example.comdan<Karakter apa saja>.a<Karakter apa saja>b.example.comcocok.
off
ignore_scheme
String
Tidak
Menentukan apakah mengabaikan parameter skema. Nilai default: off. Setelah Anda mengaktifkan fitur ini, jika Referer dalam permintaan tidak memiliki header HTTP atau HTTPS, Referer masih dianggap valid. Contoh:
Jika Anda menyetel parameter ini ke on, format Referer adalah sebagai berikut:
referer: www.example.comJika Anda menyetel parameter ini ke off, format Referer adalah sebagai berikut:
referer: https://www.example.com
off
Kode contoh:
{ "Functions": [ { "functionArgs": [ { "argName": "allow_empty", "argValue": "off" }, { "argName": "refer_domain_deny_list", "argValue": "example.aliyundoc.com,demo.aliyundoc.com" }, { "argName": "disable_ast", "argValue": "on" }, { "argName": "ignore_scheme", "argValue": "on" }, { "argName": "redirect_url", "argValue": "http://www.example.com" } ], "functionName": "referer_black_list_set" } ], "DomainNames": "example.com" }
aliauth
Deskripsi fitur: mengonfigurasi penandatanganan URL. Untuk informasi lebih lanjut, lihat Penandatanganan URL.
Tabel berikut menjelaskan parameter:
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
auth_m3u8
String
Tidak
Menentukan apakah akan mengaktifkan penulisan ulang M3U8. Penulisan ulang M3U8 mengotentikasi akses ke file TS. Jika penulisan ulang M3U8 dinonaktifkan, akses ke file TS mungkin ditolak. Nilai valid: on dan off. Nilai default: on.
on
auth_type
String
Ya
Tipe penandatanganan. Nilai valid:
no_auth: menonaktifkan penandatanganan URL.
type_a: mengaktifkan penandatanganan tipe A.
type_b: mengaktifkan penandatanganan tipe B.
type_c: mengaktifkan penandatanganan tipe C.
type_d: mengaktifkan penandatanganan tipe D.
type_e: mengaktifkan penandatanganan tipe E.
type_f: mengaktifkan penandatanganan tipe F.
type_a
auth_key1
String
Ya
Kunci kriptografi 1. Kunci harus memiliki panjang 16 hingga 128 karakter dan dapat berisi huruf dan angka.
1234567890123456789
auth_key2
String
Tidak
Kunci kriptografi 2. Kunci harus memiliki panjang 16 hingga 128 karakter dan dapat berisi huruf dan angka.
1234567890123456789
ali_auth_delta
Integer
Tidak
Periode validitas URL terenkripsi. Unit: detik. Nilai default: 1800.
1800
req_auth_ip_white
String
Tidak
Daftar putih alamat IP. Alamat IP dalam daftar putih tidak diverifikasi untuk otentikasi.
Anda dapat memasukkan beberapa alamat IP. Pisahkan beberapa alamat IP dengan koma (,).
192.168.0.1
req_auth_ip_acl_xfwd
String
Tidak
Mode verifikasi alamat IP. Nilai valid:
on: Ini adalah mode default. Mode ini hanya memverifikasi alamat IP klien pertama dalam header XFF dalam permintaan klien.
off: Mode ini hanya memverifikasi alamat IP yang digunakan oleh klien untuk terhubung ke POP.
all: Mode ini memverifikasi alamat IP berikut:
Alamat IP pertama dalam header XFF, yaitu alamat IP klien.
Alamat IP yang digunakan oleh klien untuk terhubung ke POP.
all
sign_param
String
Tidak
Nama parameter tanda tangan. Parameter ini berlaku hanya ketika parameter auth_type disetel ke type_f.
sign
time_param
String
Tidak
Nama parameter timestamp. Parameter ini berlaku hanya ketika parameter auth_type disetel ke type_f.
time
time_format
String
Tidak
Format timestamp. Parameter ini berlaku hanya ketika parameter auth_type disetel ke type_f.
dec: desimal.
hex: heksadesimal.
hec
path_encoding
String
Tidak
Menentukan apakah mengaktifkan pengkodean URL. Nilai valid: on dan off. Parameter ini berlaku hanya ketika parameter auth_type disetel ke type_f.
on
Contoh:
Saat parameter auth_type disetel ke type_a:
{ "Functions": [{ "functionArgs": [{ "argName": "auth_type", "argValue": "type_a" }, { "argName": "auth_key1", "argValue": "1234567890123456789" }, { "argName": "auth_key2", "argValue": "1234567890123456789" }, { "argName": "ali_auth_delta", "argValue": 1800 }, { "argName": "req_auth_ip_white", "argValue": "192.168.0.1" }, { "argName": "req_auth_ip_acl_xfwd", "argValue": "all" },{ "argName": "sign_param", "argValue": "sign" }, { "argName": "time_param", "argValue": "time", }, { "argName": "time_format", "argValue": "hec" }, { "argName": "path_encoding", "argValue": "on" }], "functionName": "aliauth" }], "domainNames": "example.com" }Saat parameter auth_type disetel ke type_f:
{ "Functions": [{ "functionArgs": [{ "argName": "auth_type", "argValue": "type_f" },{ "argName": "auth_key1", "argValue": "1234567890123456789" },{ "argName": "auth_key2", "argValue": "1234567890123456789" },{ "argName": "ali_auth_delta", "argValue": 1800 },{ "argName": "sign_param", "argValue": "sign" },{ "argName": "time_param", "argValue": "time", },{ "argName": "time_format", "argValue": "hec" },{ "argName": "path_encoding", "argValue": "on" }], "functionName": "aliauth" }], "domainNames": "example.com" }
cdn_remote_auth
Deskripsi fitur: mengonfigurasi otentikasi jarak jauh. Untuk informasi lebih lanjut, lihat Otentikasi Jarak Jauh.
Tabel berikut menjelaskan parameter:
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
enable
String
Ya
Menentukan apakah mengaktifkan otentikasi jarak jauh.
on
off
on
remote_auth_addr
String
Ya
Alamat server otentikasi. Format valid:
https://cdn.aliyun.com/authdanhttp://10.10.10.10/auth.https://example.aliyundoc.com/auth
remote_auth_method
String
Ya
Metode permintaan. Nilai valid: get, post, dan head.
get
remote_auth_type
String
Ya
Tipe file otentikasi. Nilai all menentukan semua tipe. Pisahkan tipe file dengan batang vertikal (|). Nilainya peka huruf besar-kecil. Misalnya, jpg berbeda dari JPG.
all
remote_auth_reserve_args
String
Ya
Parameter yang ingin Anda pertahankan. Pisahkan parameter dengan batang vertikal (|). Nilainya tidak peka huruf besar-kecil. Misalnya, key setara dengan KEY.
all: mempertahankan semua parameter.
ali_delete_all_args: menghapus semua parameter.
all
remote_auth_custom_args
String
Tidak
Parameter yang ingin Anda tambahkan. Pisahkan parameter dengan batang vertikal (|). Nilainya peka huruf besar-kecil. Misalnya, key berbeda dari KEY.
None
remote_auth_reserve_header
String
Ya
Header permintaan yang ingin Anda pertahankan. Pisahkan header permintaan dengan batang vertikal (|). Nilainya tidak peka huruf besar-kecil. Misalnya, http_remote_addr setara dengan HTTP_Remote_Addr.
all: mempertahankan semua header permintaan.
ali_delete_all_headers: menghapus semua header permintaan.
all
remote_auth_custom_header
String
Tidak
Header permintaan yang ingin Anda tambahkan. Pisahkan beberapa header permintaan dengan batang vertikal (|). Nilainya tidak peka huruf besar-kecil. Misalnya, http_remote_addr setara dengan HTTP_Remote_Addr.
None
remote_auth_success_code
Integer
Ya
Kode status HTTP yang dikembalikan ke Alibaba Cloud CDN saat permintaan lolos otentikasi. Contoh: 200. Anda dapat mengonfigurasi beberapa kode status HTTP. Pisahkan kode status HTTP dengan koma (,).
200
remote_auth_fail_code
Integer
Ya
Kode status HTTP yang dikembalikan ke Alibaba Cloud CDN saat permintaan gagal otentikasi. Contoh: 403. Anda dapat mengonfigurasi beberapa kode status HTTP. Pisahkan kode status HTTP dengan koma (,).
403,404
remote_auth_other_code_act
String
Tidak
Tindakan yang dilakukan ketika kode status HTTP yang dikembalikan ke Alibaba Cloud CDN tidak menunjukkan bahwa permintaan lolos atau gagal otentikasi. Nilai valid:
pass (default): Alibaba Cloud CDN mengizinkan permintaan.
reject: Alibaba Cloud CDN menolak permintaan.
pass
remote_auth_fail_resp_code
Integer
Ya
Kode status HTTP yang dikembalikan oleh Alibaba Cloud CDN kepada pengguna saat permintaan gagal otentikasi. Misalnya, jika Anda menyetel parameter ini ke 403, Alibaba Cloud CDN mengembalikan kode status HTTP 403 kepada pengguna saat permintaan gagal otentikasi.
403
remote_auth_timeout
Integer
Ya
Periode timeout otentikasi. Unit: milidetik. Nilai maksimum: 3000.
500
remote_auth_timeout_action
String
Ya
Tindakan yang dilakukan saat otentikasi timeout. Nilai valid:
pass: Alibaba Cloud CDN mengizinkan permintaan.
reject: Alibaba Cloud CDN mengembalikan kode status HTTP untuk kegagalan otentikasi kepada pengguna.
pass
Contoh:
{ "Functions": [{ "functionArgs": [{ "argName": "enable", "argValue": "on" }, { "argName": "remote_auth_addr", "argValue": "https://example.aliyundoc.com/auth" }, { "argName": "remote_auth_method", "argValue": "get" }, { "argName": "remote_auth_type", "argValue": "all" }, { "argName": "remote_auth_reserve_args", "argValue": "all" }, { "argName": "remote_auth_custom_args", "argValue": "" }, { "argName": "remote_auth_reserve_header", "argValue": "all" }, { "argName": "remote_auth_custom_header", "argValue": "" }, { "argName": "remote_auth_success_code", "argValue": "200" }, { "argName": "remote_auth_fail_code", "argValue": "403" }, { "argName": "remote_auth_other_code_act", "argValue": "pass" }, { "argName": "remote_auth_fail_resp_code", "argValue": "403" }, { "argName": "remote_auth_timeout", "argValue": 500 }, { "argName": "remote_auth_timeout_action", "argValue": "pass" }], "functionName": "cdn_remote_auth" }], "DomainNames": "example.com" }
ip_allow_list_set
Deskripsi fitur: mengonfigurasi daftar putih alamat IP. Untuk informasi lebih lanjut, lihat Daftar Hitam atau Putih Alamat IP.
CatatanFitur daftar putih alamat IP bertentangan dengan fitur daftar hitam alamat IP (fungsi: ip_black_list_set). Hanya satu dari kedua fitur tersebut yang dapat digunakan.
Jika salah satu fitur telah dikonfigurasi, Anda harus menghapus konfigurasinya sebelum mengaktifkan fitur lainnya. Gunakan operasi DeleteVodSpecificConfig untuk menghapus konfigurasi nama domain. Jika suatu fitur memiliki parameter saklar dan parameternya disetel ke off, fitur tersebut dianggap terkonfigurasi.
Tabel berikut menjelaskan parameter:
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
ip_list
String
Ya
Alamat IP yang ingin Anda tambahkan ke daftar hitam. Anda dapat menentukan beberapa alamat IP, dipisahkan dengan koma (,).
192.168.0.1/24
ip_acl_xfwd
String
Tidak
Menentukan apakah menggunakan alamat IP dalam header X-Forwarded-For untuk verifikasi. Nilai valid:
on (default): menggunakan alamat IP pertama dalam header permintaan
X-Forwarded-Foruntuk verifikasi.nonaktif: menggunakan
alamat IP yang digunakan untuk terhubung ke POPuntuk verifikasi.semua: menggunakan baik alamat IP pertama di dalam
header permintaan X-Forwarded-Formaupunalamat IP yang digunakan untuk terhubung ke POPuntuk verifikasi.
all
Kode contoh:
{ "Functions": [ { "functionArgs": [ { "argName": "ip_list", "argValue": "192.168.0.1/24" }, { "argName": "ip_acl_xfwd", "argValue": "all" } ], "functionName": "ip_allow_list_set" } ], "DomainNames": "example.com" }
ip_black_list_set
Deskripsi fitur: mengonfigurasi daftar hitam alamat IP. Untuk informasi lebih lanjut, lihat Daftar Hitam atau Putih Alamat IP.
CatatanFitur daftar hitam alamat IP bertentangan dengan fitur daftar putih alamat IP (fungsi: ip_allow_list_set). Hanya satu dari kedua fitur tersebut yang dapat digunakan.
Jika salah satu fitur telah dikonfigurasi, Anda harus menghapus konfigurasinya sebelum mengaktifkan fitur lainnya. Gunakan operasi DeleteVodSpecificConfig untuk menghapus konfigurasi nama domain. Jika suatu fitur memiliki parameter saklar dan parameternya disetel ke off, fitur tersebut dianggap terkonfigurasi.
Tabel berikut menjelaskan parameter:
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
ip_list
String
Ya
Alamat IP yang ingin Anda tambahkan ke daftar hitam. Anda dapat menentukan beberapa alamat IP. Pisahkan alamat IP dengan koma (,).
192.168.0.1
ip_acl_xfwd
String
Tidak
Menentukan apakah menggunakan alamat IP dalam header X-Forwarded-For untuk verifikasi. Nilai valid:
on (default): menggunakan alamat IP pertama dalam header permintaan
X-Forwarded-Foruntuk verifikasi.off: menggunakan
alamat IP yang digunakan untuk terhubung ke POPuntuk verifikasi.semua: menggunakan baik alamat IP pertama di dalam
header permintaan X-Forwarded-Formaupunalamat IP yang digunakan untuk terhubung ke POPuntuk verifikasi.
all
Kode contoh:
{ "Functions": [ { "functionArgs": [ { "argName": "ip_list", "argValue": "192.168.0.1" }, { "argName": "ip_acl_xfwd", "argValue": "all" } ], "functionName": "ip_black_list_set" } ], "DomainNames": "example.com" }
ali_ua
Deskripsi fitur: mengonfigurasi daftar putih atau daftar hitam User-Agent. Untuk informasi lebih lanjut, lihat Konfigurasikan Daftar Hitam atau Daftar Putih User-Agent.
Tabel berikut menjelaskan parameter:
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
ua
String
Ya
User agent yang ingin Anda tambahkan ke daftar putih atau daftar hitam. Anda dapat menggunakan tanda bintang (*) untuk mencocokkan karakter apa saja dan menentukan beberapa nilai. Pisahkan nilai dengan batang vertikal (|). Contoh:
*curl*|*IE*|*chrome*|*firefox*.*curl*|*IE*|*chrome*|*firefox*
type
String
Ya
Tipe daftar. Nilai valid:
black: daftar hitam.
white: daftar putih.
CatatanDaftar hitam dan daftar putih saling eksklusif. Anda hanya dapat mengaktifkan satu jenis daftar.
black
Contoh:
{ "Functions": [{ "functionArgs": [{ "argName": "ua", "argValue": "*curl*|*IE*|*chrome*|*firefox*" }, { "argName": "type", "argValue": "black" }], "functionName": "ali_ua" }], "DomainNames": "example.com" }
Pengaturan EdgeScript
edge_function
Deskripsi fitur: Mengonfigurasi EdgeScript. Untuk detail lebih lanjut, lihat Ikhtisar EdgeScript.
Tabel berikut menjelaskan parameter yang digunakan.
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
rule
String
Ya
Skrip bahasa domain-spesifik (DSL).
if eq($uri, '/') {\n rewrite('https://example.com/index.html', 'redirect')\n}
pri
Integer
Ya
Prioritas. Nilai valid: 0 hingga 999. Nilai yang lebih kecil menunjukkan prioritas yang lebih tinggi.
CatatanPrioritas posisi eksekusi head dan foot tidak saling mempengaruhi.
0
enable
String
Ya
Menentukan apakah akan mengaktifkan skrip. Nilai valid:
on
off
on
name
String
Ya
Nama skrip. Nama hanya dapat berisi huruf dan garis bawah (_).
test
pos
String
Tidak
Posisi tempat Anda ingin mengeksekusi skrip. Nilai default: head. Nilai valid:
head: Skrip dieksekusi di awal pipeline.
foot: Skrip dieksekusi di akhir pipeline.
head
brk
String
Tidak
Menentukan apakah akan melewati skrip lain setelah skrip saat ini dieksekusi. Nilai default: off. Nilai valid:
on: Setelah skrip saat ini cocok, skrip setelah posisi tertentu dilewati.
off: Jika skrip saat ini cocok, sistem melanjutkan mencocokkan permintaan terhadap skrip lain.
off
option
String
Tidak
Ekstensi.
None
grammar
String
Tidak
Sintaks skrip. Nilai valid: es2 dan js. Nilai default: es2.
/
jsmode
String
Tidak
Mode eksekusi JavaScript. Nilai default: bypass. Nilai valid:
redirect: mode blokir.
bypass: mode bypass.
/
Contoh:
{ "Functions": [{ "functionArgs": [{ "argName": "name", "argValue": "test" }, { "argName": "rule", "argValue": "if eq($uri, '/') {\n rewrite('https://example.com/index.html', 'redirect')\n}" }, { "argName": "pri", "argValue": "0" }, { "argName": "pos", "argValue": "head" }, { "argName": "enable", "argValue": "on" }, { "argName": "brk", "argValue": "off" }, { "argName": "option", "argValue": "" }], "functionName": "edge_function" }], "DomainName": "example.com" }
Peningkatan kinerja
set_hashkey_args
Deskripsi fitur: Mempertahankan parameter URL. Untuk informasi lebih lanjut, lihat Penyaringan Parameter.
CatatanFitur penyimpanan parameter URL bertentangan dengan fitur penghapusan parameter URL (fungsi: ali_remove_args). Hanya satu dari kedua fitur tersebut yang dapat digunakan.
Jika salah satu fitur telah dikonfigurasi, Anda harus menghapus konfigurasinya sebelum mengonfigurasi fitur lainnya. Gunakan operasi DeleteVodSpecificConfig untuk menghapus konfigurasi nama domain. Jika suatu fitur memiliki parameter saklar dan parameternya disetel ke off, fitur tersebut dianggap telah dikonfigurasi.
Tabel berikut menjelaskan parameter.
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
hashkey_args
String
Tidak
Parameter yang ingin Anda pertahankan. Anda dapat menentukan hingga 10 parameter. Pisahkan parameter dengan koma (,).
key1,key2
disable
String
Ya
Menentukan apakah akan mengabaikan semua parameter. Nilai default: off. Nilai yang valid:
on: mengabaikan semua parameter. Hanya aturan Tambah yang berlaku.
off: tidak mengabaikan parameter. Aturan Pertahankan, Tambah, dan Hapus berlaku.
CatatanPengaturan hashkey_args memiliki prioritas lebih tinggi. Bahkan jika Anda mengatur parameter ini ke on, parameter yang ditentukan oleh parameter hashkey_args tetap dipertahankan.
on
keep_oss_args
String
Ya
Menentukan apakah mempertahankan parameter selama pengambilan asal. Nilai valid:
on: Semua parameter dipertahankan selama pengambilan asal.
off: Hanya parameter yang ditentukan dalam hashkey yang dipertahankan.
on
Contoh:
{ "Functions": [{ "functionArgs": [{ "argName": "hashkey_args", "argValue": "" }, { "argName": "keep_oss_args", "argValue": "on" }, { "argName": "disable", "argValue": "on" }], "functionName": "set_hashkey_args" }], "DomainNames": "example.com" }
ali_remove_args
Deskripsi fitur: Menghapus parameter URL. Untuk informasi lebih lanjut, lihat Penyaringan Parameter.
CatatanFitur penghapusan parameter URL bertentangan dengan fitur penyimpanan parameter URL (fungsi: set_hashkey_args). Hanya satu dari kedua fitur tersebut yang dapat digunakan.
Jika salah satu fitur telah dikonfigurasi, Anda harus menghapus konfigurasinya sebelum mengonfigurasi fitur lainnya. Gunakan operasi DeleteVodSpecificConfig untuk menghapus konfigurasi nama domain. Jika suatu fitur memiliki parameter saklar dan parameternya disetel ke off, fitur tersebut dianggap telah dikonfigurasi.
Tabel berikut menjelaskan parameter.
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
ali_remove_args
String
Ya
Parameter yang ingin Anda hapus. Pisahkan beberapa parameter dengan spasi.
CatatanParameter yang dipertahankan digunakan sebagai parameter URL dalam hashkey.
test
keep_oss_args
String
Ya
Menentukan apakah mempertahankan parameter selama pengambilan asal. Nilai valid:
on: Semua parameter dipertahankan selama pengambilan asal.
off: Hanya parameter yang ditentukan dalam hashkey yang dipertahankan.
off
Contoh:
{ "Functions": [{ "functionArgs": [{ "argName": "ali_remove_args", "argValue": "test" }, { "argName": "keep_oss_args", "argValue": "off" }], "functionName": "ali_remove_args" }], "DomainNames": "example.com" }
image_transform
Deskripsi fitur: Mengonfigurasi pemrosesan gambar. Untuk informasi lebih lanjut, lihat Pemrosesan Gambar.
Tabel berikut menjelaskan parameter.
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
enable
String
Ya
Menentukan apakah akan mengaktifkan pengeditan gambar.
on
off
on
filetype
String
Ya
Format gambar yang ingin Anda konversi. Pisahkan beberapa nilai dengan batang vertikal (|). Nilai valid:
JPEG
JPG
PNG
WEBP
BMP
GIF
TIFF
JP2: JPEG 2000
jpg|jpeg|png
webp
String
Tidak
Menentukan apakah mengaktifkan konversi otomatis ke WebP.
on
off
on
orient
String
Tidak
Menentukan apakah mengaktifkan rotasi otomatis.
on
off
CatatanFitur ini hanya berlaku untuk gambar yang membawa properti rotasi.
on
slim
Integer
Tidak
Tingkat kompresi gambar. Nilai valid: 0 hingga 100. Kompresi gambar mengurangi transfer data tanpa mengubah resolusi, ukuran, atau format gambar.
10
Contoh:
{ "Functions": [{ "functionArgs": [{ "argName": "filetype", "argValue": "jpg|jpeg|png" }, { "argName": "webp", "argValue": "on" }, { "argName": "orient", "argValue": "on" }, { "argName": "slim", "argValue": "" }, { "argName": "enable", "argValue": "on" }], "functionName": "image_transform" }], "DomainNames": "example.com" }
Pengaturan terkait video
range
Deskripsi fitur: Mengonfigurasi chunking objek. Untuk informasi lebih lanjut, lihat Chunking Objek.
Tabel berikut menjelaskan parameter.
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
enable
String
Ya
Menentukan apakah mengaktifkan pengambilan asal range. Nilai valid:
on: mengaktifkan pengambilan asal range.
off: menonaktifkan pengambilan asal range.
force: secara paksa mengaktifkan pengambilan asal range.
on
Contoh:
{ "Functions": [{ "functionArgs": [{ "argName": "enable", "argValue": "on" }], "functionName": "range" }], "DomainNames": "example.com" }
video_seek
Deskripsi fitur: Mengonfigurasi pencarian video. Untuk informasi lebih lanjut, lihat Pencarian Video.
Tabel berikut menjelaskan parameter.
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
enable
String
Ya
Menentukan apakah mengaktifkan pencarian video. Nilai valid:
on
off
on
Kode contoh:
{ "Functions": [{ "functionArgs": [{ "argName": "enable", "argValue": "on" }], "functionName": "video_seek" }], "DomainNames": "example.com" }
ali_video_split
Deskripsi fitur: Mengonfigurasi ekstraksi audio. Untuk informasi lebih lanjut, lihat Ekstraksi Audio.
Tabel berikut menjelaskan parameter.
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
enable
String
Ya
Menentukan apakah mengaktifkan ekstraksi audio.
on
off
on
Contoh:
{ "Functions": [{ "functionArgs": [{ "argName": "enable", "argValue": "on" }], "functionName": "ali_video_split" }], "DomainNames": "example.com" }
ali_video_preview
Deskripsi fitur: Mengonfigurasi pratinjau video. Untuk informasi lebih lanjut, lihat Pratinjau Audio dan Video.
Tabel berikut menjelaskan parameter.
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
enable
String
Ya
Menentukan apakah mengaktifkan pratinjau video.
on
off
CatatanFormat file berikut didukung: TS, MP3, FLV, dan MP4.
on
ali_video_preview_argument
String
Ya
Parameter pratinjau kustom. Unit parameter ini: detik.
fds
Contoh:
{ "Functions": [{ "functionArgs": [{ "argName": "enable", "argValue": "on" }, { "argName": "ali_video_preview_argument", "argValue": "fds" }], "functionName": "ali_video_preview" }], "DomainNames": "example.com" }
hls_token_rewrite
Deskripsi fitur: Mengonfigurasi enkripsi M3U8 dan penulisan ulang. Untuk informasi lebih lanjut, lihat Pass-through Parameter untuk Enkripsi HLS.
Tabel berikut menjelaskan parameter.
Parameter
Tipe
Diperlukan
Deskripsi
Contoh
enable
String
Ya
Menentukan apakah mengaktifkan enkripsi M3U8 dan penulisan ulang.
on
off
on
hls_token_arg_name
String
Tidak
Nama parameter kustom untuk token HLS. Jika Anda tidak menentukan nama, MtsHlsUriToken digunakan sebagai nama.
example
Contoh:
{ "Functions": [{ "functionArgs": [{ "argName": "enable", "argValue": "on" }], "functionName": "hls_token_rewrite" }], "DomainNames": "example.com", }