Anda dapat memanggil operasi BatchSetDcdnDomainConfigs untuk mengonfigurasi fitur pada beberapa nama domain yang dipercepat sekaligus. Topik ini menjelaskan fitur-fitur yang dapat dikonfigurasi melalui operasi API tersebut beserta parameter terkaitnya.
Fitur-fitur yang dijelaskan dalam topik ini dapat dirujuk oleh operasi API berikut: BatchSetDcdnDomainConfigs, DescribeDcdnDomainConfigs, BatchDeleteDcdnDomainConfigs, dan DescribeDcdnUserDomainsByFunc.
Anda dapat memanggil BatchSetDcdnDomainConfigs untuk mengonfigurasi fitur pada beberapa nama domain yang dipercepat sekaligus dan menghasilkan ConfigId unik. Anda dapat menggunakan ConfigId tersebut untuk memperbarui atau menghapus konfigurasi tertentu. Untuk informasi selengkapnya, lihat Penggunaan ConfigId.
Informasi dasar
dynamic
Deskripsi fitur: Konfigurasi terkait DCDN. Untuk informasi selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Aturan untuk akselerasi konten statis dan dinamis.
ID Fitur (FunctionID/FuncId): 46.
Deskripsi parameter:
Parameter
Type
Wajib
Deskripsi
Contoh
enable
String
Ya
Aktifkan Akselerasi Statis:
on: mengaktifkan fitur.
off: menonaktifkan fitur.
on
static_route_type
String
Tidak
Ekstensi file untuk akselerasi konten statis.
.txt
static_route_url
String
Tidak
URI untuk akselerasi konten statis.
/domain/detail/log.txt
static_route_path
String
Tidak
Jalur file untuk akselerasi konten statis.
CatatanAnda dapat menggunakan karakter wildcard, seperti tanda bintang (*) dan tanda tanya (?), untuk pencocokan kabur jalur file statis. Tanda bintang (*) cocok dengan nol atau lebih karakter. Tanda tanya (?) cocok dengan satu karakter.
/abc/test/*
dynamic_route_origin
String
Tidak
Kebijakan protokol asal untuk konten dinamis. Nilai yang valid:
http: DCDN menggunakan HTTP untuk meminta resource dari server asal.
https: DCDN menggunakan HTTPS untuk meminta resource dari server asal.
follow: DCDN menggunakan protokol yang sama dengan klien untuk meminta resource dari server asal.
follow-port: DCDN menggunakan protokol yang sesuai dengan port server asal untuk meminta resource dari server asal.
CatatanJika Anda tidak mengatur dynamic_route_origin, nilai default follow digunakan.
https
dynamic_route_round_robin
String
Tidak
Menentukan apakah akan mengaktifkan load balancing. Nilai yang valid:
on: mengaktifkan fitur.
off (default): menonaktifkan fitur.
off
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "enable", "argValue": "on" }, { "argName": "static_route_type", "argValue": ".txt" }, { "argName": "static_route_url", "argValue": "/domain/detail/log.txt" },{ "argName": "static_route_path", "argValue": "/abc/test/*" }, { "argName": "dynamic_route_origin", "argValue": "https" }, { "argName": "dynamic_route_round_robin", "argValue": "off" }], "functionName": "dynamic" }], "DomainNames": "example.com" }
ipv6
Deskripsi fitur: Konfigurasi akses IPv6. Untuk informasi selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Aktifkan IPv6.
ID Fitur (FunctionID/FuncId): 194.
Deskripsi parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
switch
String
Ya
Aktifkan akses IPv6:
on: mengaktifkan fitur.
off: menonaktifkan fitur.
on
region
String
Ya
Wilayah tempat Anda ingin mengaktifkan IPv6. Karakter wildcard (*) didukung.
CatatanTanda bintang (*) menunjukkan bahwa IPv6 diaktifkan untuk semua wilayah. Saat ini, Anda hanya dapat mengaktifkan IPv6 untuk semua wilayah. Jika Anda ingin mengaktifkan IPv6 untuk wilayah tertentu, kirim tiket untuk mengajukan permohonan.
Jika Anda tidak mengatur parameter ini, IPv6 diaktifkan untuk semua wilayah secara default.
*
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "switch", "argValue": "on" }, { "argName": "region", "argValue": "*" }], "functionName": "ipv6" }], "DomainNames": "example.com" }
Konfigurasi asal
set_req_host_header
Deskripsi fitur: Mengonfigurasi host asal. Untuk informasi selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Konfigurasi host asal default.
ID Fitur (FunctionID/FuncId): 18.
Deskripsi parameter:
Parameter
Type
Wajib
Deskripsi
Contoh
domain_name
String
Ya
Konten header host asal.
example.comContoh konfigurasi:
{ "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 selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Konfigurasi tindak lanjut protokol statis untuk pengambilan asal.
ID Fitur (FunctionID/FuncId): 47.
Deskripsi parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
enable
String
Ya
Menentukan apakah akan mengaktifkan kebijakan protokol asal. Nilai yang valid:
on: mengaktifkan fitur.
off: menonaktifkan fitur.
on
scheme_origin
String
Tidak
Kebijakan protokol asal. Nilai yang valid:
http: DCDN menggunakan HTTP untuk pengambilan asal.
https: DCDN menggunakan HTTPS untuk pengambilan asal.
follow: DCDN menggunakan protokol yang sama dengan permintaan klien untuk pengambilan asal.
CatatanJika Anda tidak mengatur scheme_origin, nilai default follow digunakan.
follow
scheme_origin_port
String
Tidak
Port asal kustom. Parameter ini harus digunakan bersama parameter scheme_origin. Nilai yang valid:
Jika Anda mengatur scheme_origin ke http, Anda hanya perlu mengonfigurasi port asal HTTP. Contoh: 80.
Jika Anda mengatur scheme_origin ke https, Anda hanya perlu mengonfigurasi port asal HTTPS. Contoh: 443.
Jika Anda mengatur scheme_origin ke follow, Anda harus mengonfigurasi port asal HTTP dan HTTPS. Pisahkan dengan titik dua (:). Contoh: 80:443.
80:443
Contoh konfigurasi 1: DCDN menggunakan protokol yang sama dengan permintaan klien untuk pengambilan asal. Port asal adalah port default untuk protokol tersebut. Port 80 digunakan untuk HTTP dan Port 443 digunakan untuk HTTPS.
{ "Functions": [{ "functionArgs": [{ "argName": "enable", "argValue": "on" }, { "argName": "scheme_origin", "argValue": "follow" }], "functionName": "forward_scheme" }], "DomainNames": "example.com" }Contoh konfigurasi 2: DCDN menggunakan protokol yang sama dengan permintaan klien untuk pengambilan asal. Port asal adalah port kustom. Port 8080 digunakan untuk HTTP dan Port 4433 digunakan untuk HTTPS.
{ "Functions": [{ "functionArgs": [{ "argName": "enable", "argValue": "on" }, { "argName": "scheme_origin", "argValue": "follow" }, { "argName": "scheme_origin_port", "argValue": "8080:4433" }], "functionName": "forward_scheme" }], "DomainNames": "example.com" }
l2_oss_key
Deskripsi fitur: Mengonfigurasi pengambilan asal dari bucket pribadi. Catatan: Pertama kali menggunakan fitur ini, Anda harus mengaktifkan kebijakan akses default dengan sekali klik. Setelah kebijakan diaktifkan, DCDN diberikan akses read-only ke semua bucket OSS yang dimiliki oleh Akun Alibaba Cloud Anda. Untuk informasi selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Pengambilan asal dari bucket OSS pribadi.
ID Fitur (FunctionID/FuncId): 85.
Deskripsi parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
private_oss_auth
String
Ya
Menentukan apakah akan mengaktifkan pengambilan asal dari bucket pribadi. Nilai yang valid:
on: mengaktifkan fitur.
off: menonaktifkan fitur.
Setelah Anda mengaktifkan fitur ini, sistem secara otomatis mengonfigurasi token Layanan Keamanan (STS). Hal ini menyederhanakan konfigurasi. Namun, metode ini hanya mendukung pengambilan asal dari bucket OSS pribadi yang dimiliki oleh Akun Alibaba Cloud yang sama dengan nama domain yang dipercepat DCDN. Untuk informasi selengkapnya tentang token STS, lihat Apa itu STS?.
on
perm_private_oss_tbl
String
Tidak
Konfigurasi token keamanan permanen. Formatnya adalah
access_id=123 access_secret=123abc. Pisahkan parameter dengan spasi.Setelah Anda mengonfigurasi token keamanan permanen, Anda dapat mengonfigurasi pengambilan asal dari bucket OSS pribadi yang dimiliki oleh Akun Alibaba Cloud yang sama dengan nama domain yang dipercepat DCDN, serta dari bucket OSS pribadi yang dimiliki oleh Akun Alibaba Cloud lainnya. Untuk informasi selengkapnya tentang token keamanan permanen, lihat Buat AccessKey.
access_id=123 access_secret=123abc
Contoh konfigurasi:
{ "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" }
oss_key_list
Deskripsi fitur: Daftar kunci pribadi untuk pengambilan asal dari OSS. Anda dapat mengonfigurasi satu atau beberapa aturan untuk menentukan beberapa bucket OSS pribadi dan token keamanannya masing-masing.
ID Fitur (FunctionID/FuncId): 183.
Deskripsi parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
host
String
Ya
Alamat lengkap bucket OSS.
example.oss-cn-hangzhou.aliyuncs.com
key
String
Ya
Konfigurasi token keamanan permanen. Formatnya adalah
access_id=123 access_secret=123abc. Pisahkan parameter dengan spasi.Setelah Anda mengonfigurasi token keamanan permanen, Anda dapat mengonfigurasi pengambilan asal dari bucket OSS pribadi yang dimiliki oleh Akun Alibaba Cloud yang sama dengan nama domain yang dipercepat DCDN, serta dari bucket OSS pribadi yang dimiliki oleh Akun Alibaba Cloud lainnya. Untuk informasi selengkapnya tentang token keamanan permanen, lihat Buat AccessKey.
access_id=123 access_secret=123abc
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "host", "argValue": "example.oss-cn-hangzhou.aliyuncs.com" },{ "argName": "key", "argValue": "access_id=123 access_secret=123abc" }], "functionName": "oss_key_list" }], "DomainNames": "example.com" }
https_origin_sni
Deskripsi fitur: Mengonfigurasi SNI asal. Anda dapat mengatur SNI asal tertentu untuk server asal tertentu. Untuk informasi selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Konfigurasi SNI asal tertentu. Untuk informasi selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Konfigurasi SNI asal.
ID Fitur (FunctionID/FuncId): 114.
Deskripsi parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
enabled
String
Ya
Menentukan apakah akan mengaktifkan fitur SNI asal. Nilai yang valid:
on: mengaktifkan fitur.
off: menonaktifkan fitur.
on
https_origin_sni
String
Ya
Informasi SNI yang dibawa dalam permintaan asal. Ini adalah alamat server asal yang perlu diakses oleh permintaan asal.
origin.example.comContoh konfigurasi:
{ "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 waktu habis permintaan asal. Untuk informasi selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Waktu habis permintaan asal.
ID Fitur (FunctionID/FuncId): 124.
Deskripsi parameter:
Parameter
Type
Wajib
Deskripsi
Contoh
forward_timeout
Integer
Ya
Periode waktu habis permintaan. Satuan: detik.
CatatanKami menyarankan agar Anda mengatur periode waktu habis kurang dari 100 detik.
30
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "forward_timeout", "argValue": "30" }], "functionName": "forward_timeout" }], "DomainNames": "example.com" }
advanced_origin
Deskripsi fitur: Mengonfigurasi asal lanjutan. Untuk informasi selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Asal lanjutan. Fitur ini hanya tersedia untuk pengguna yang ditambahkan ke daftar putih. Untuk menggunakan fitur ini, kirim tiket.
Konflik fitur: Fitur asal lanjutan bertentangan dengan fitur asal bersyarat (fungsi: origin_dns_host, ID fitur: 212). Anda hanya dapat mengaktifkan salah satunya. Jika salah satu fitur telah dikonfigurasi, Anda harus menghapus konfigurasinya sebelum dapat mengonfigurasi yang lain. Fitur dianggap telah dikonfigurasi meskipun parameter switch-nya diatur ke `off`. Anda dapat memanggil operasi DeleteDcdnSpecificConfig untuk menghapus konfigurasi tertentu untuk nama domain.
ID Fitur (FunctionID/FuncId): 235.
Deskripsi parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
variable_type
String
Ya
Jenis variabel. Nilai yang valid:
header: header permintaan yang dibawa dalam permintaan pengguna.
arg: parameter string kueri yang dibawa dalam URL permintaan pengguna.
uri: jalur yang dibawa dalam URL permintaan pengguna.
cookie: cookie permintaan yang dibawa dalam permintaan pengguna.
uri
variable
String
Ya
Nama variabel.
CatatanJika Anda mengatur variable_type ke uri, Anda harus mengatur variable ke uri.
uri
conditions
String
Ya
Kondisi. Nilai yang valid:
==: sama dengan.
!=: tidak sama dengan.
==
value
String
Ya
Nilai variabel.
/image
origin
String
Ya
Nama domain yang digunakan untuk kueri DNS selama pengambilan asal. Ini adalah nilai variabel dalam permintaan pengguna. Jika nilainya cocok, permintaan dialihkan ke URL asal yang ditentukan.
origin.example.com
Contoh konfigurasi:
{ "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 pengambilan asal. Untuk informasi selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Konfigurasi pengalihan 301/302 untuk pengambilan asal. Fitur ini hanya tersedia untuk pengguna yang ditambahkan ke daftar putih. Untuk menggunakan fitur ini, kirim tiket.
ID Fitur (FunctionID/FuncId): 219.
Deskripsi parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
enable
String
Ya
Menentukan apakah akan mengaktifkan pengalihan 302 untuk pengambilan asal. Nilai yang valid:
on: mengaktifkan fitur.
off: menonaktifkan fitur.
on
max_tries
Integer
Tidak
Jumlah maksimum pengalihan 302.
Nilai default: 2.
Nilai yang valid: [1,5].
CatatanJumlah pengambilan asal - 1 = jumlah pengalihan 302. Artinya jumlah maksimum pengambilan asal default adalah 3, dan rentang nilai yang valid adalah [2,6].
2
retain_args
String
Tidak
Menentukan apakah akan mempertahankan parameter permintaan asli saat mengalihkan ke server asal tujuan. Nilai yang valid:
on: mempertahankan parameter.
off (default): tidak mempertahankan parameter.
off
retain_header
String
Tidak
Menentukan apakah akan mempertahankan header permintaan asli saat mengalihkan ke server asal tujuan. Nilai yang valid:
On: Pertahankan.
off (default): tidak mempertahankan header.
off
response_header
String
Tidak
Header respons pengalihan 302. Ini adalah nama header respons pengalihan 302 yang dikirim server asal ke DCDN. Nama header default adalah Location.
X-Alicdn-Redirect
retain_host
String
Tidak
Pertahankan nama domain asal untuk pengalihan 302. Saat diaktifkan, DCDN mempertahankan nama domain asal selama pengalihan 302. Ini hanya berlaku saat mengalihkan ke nama domain tujuan. Nilai yang valid:
on: mengaktifkan fitur.
off (default): menonaktifkan fitur.
off
modify_host
String
Tidak
Ubah nama domain asal untuk pengalihan 302. DCDN mengubah nama domain asal selama pengalihan 302. Ini hanya berlaku saat mengalihkan ke nama domain tujuan. Secara default, nama domain asal tidak diubah.
example.com
cache
String
Tidak
Cache hasil pengalihan 302. Saat diaktifkan, DCDN menyimpan cache hasil pengalihan untuk URL yang sama selama pengalihan 302 untuk meningkatkan performa respons DCDN. Nilai yang valid:
on: mengaktifkan fitur.
off (default): menonaktifkan fitur.
off
expired_time
Integer
Tidak
Periode waktu habis untuk caching hasil pengalihan 302. Ini adalah periode waktu habis untuk DCDN menyimpan cache hasil pengalihan untuk URL yang sama selama pengalihan 302. Parameter ini harus digunakan bersama fitur cache. Satuan: detik. Nilai default: 3600.
7200
follow_origin_host
String
Tidak
Gunakan nama domain asal sebagai host asal untuk pengalihan 302. Saat diaktifkan, DCDN menggunakan nama domain asal sebagai host asal. Nama domain asal terbaru digunakan bahkan setelah alih bencana primer/sekunder. Nilai yang valid:
on: mengaktifkan fitur.
off (default): menonaktifkan fitur.
off
follow_5xx_retry_origin
String
Tidak
Alih bencana server asal primer/sekunder. Saat diaktifkan, DCDN beralih ke server asal berikutnya yang tersedia jika menerima kode status 5xx dari server asal. Nilai yang valid:
on: mengaktifkan fitur.
off (default): menonaktifkan fitur.
off
Contoh konfigurasi:
{ "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_host", "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" }
set_req_header
Deskripsi fitur: Mengonfigurasi header HTTP asal kustom. Untuk informasi selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Ubah header permintaan inbound.
Catatan`set_req_header` adalah v1. Kami menyarankan Anda menggunakan v2, yaitu `origin_request_header`. Versi v2 mendukung lebih banyak fitur untuk header HTTP asal kustom.
ID Fitur (FunctionID/FuncId): 39.
Deskripsi parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
key
String
Ya
Nama header asal.
Accept-Encoding
value
String
Ya
Nilai header asal. Untuk menghapus header asal, atur nilainya ke null.
gzip
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "value", "argValue": "gzip" }, { "argName": "key", "argValue": "Accept-Encoding" }], "functionName": "set_req_header" }], "DomainNames": "example.com" }
origin_request_header
Deskripsi fitur: Mengonfigurasi header permintaan HTTP asal (versi baru). Untuk informasi selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Konfigurasi header permintaan HTTP asal. Fitur ini hanya tersedia untuk pengguna yang ditambahkan ke daftar putih. Untuk menggunakan fitur ini, kirim tiket.
ID Fitur (FunctionID/FuncId): 228.
Deskripsi parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
header_operation_type
String
Ya
Operasi header permintaan. Nilai yang valid:
add: Menambahkan entri baru.
delete: hapus.
Modify
Gunakan replace alih-alih rewrite.
add
header_name
String
Ya
Nama header permintaan.
Accept-Encoding
header_value
String
Tidak
Nilai header permintaan. Anda dapat mengonfigurasi beberapa nilai untuk parameter header permintaan. Pisahkan beberapa nilai dengan koma (,).
gzip
duplicate
String
Tidak
Menentukan apakah akan mengizinkan penambahan header permintaan dengan nama yang sama. Jika Anda mengatur header_operation_type ke add, Anda harus menentukan apakah duplikat diizinkan. Nilai yang valid:
On: Izinkan.
Off: Dinonaktifkan.
off
header_source
String
Tidak
Nilai parameter yang akan diganti. Jika Anda mengatur header_operation_type ke rewrite, Anda harus mengatur parameter ini. Ekspresi reguler didukung.
value1
header_destination
String
Tidak
Nilai parameter baru. Jika Anda mengatur header_operation_type ke rewrite, Anda harus mengatur parameter ini.
value123
match_all
String
Tidak
Mode pencocokan. Jika Anda mengatur header_operation_type ke rewrite, Anda harus mengatur mode pencocokan. Nilai yang valid:
on: mencocokkan semua nilai. Semua nilai yang cocok diganti.
off: hanya mencocokkan nilai pertama. Hanya nilai pertama yang cocok yang diganti.
off
Contoh konfigurasi: Menambahkan header permintaan asal kustom ke nama domain yang dipercepat
example.com. Nama header permintaan diatur ke `Accept-Encoding` dan nilai header permintaan diatur ke `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 selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Ubah header respons inbound. Fitur ini hanya tersedia untuk pengguna yang ditambahkan ke daftar putih. Untuk menggunakan fitur ini, kirim tiket.
ID Fitur (FunctionID/FuncId): 229.
Deskripsi parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
header_operation_type
String
Ya
Operasi header respons. Nilai yang valid:
add: Menambahkan item.
Delete: Menghapus item.
To modify is to make a change.
Replace.
add
header_name
String
Ya
Nama header respons.
Cache-Control
header_value
String
Tidak
Nilai header respons. Anda dapat mengonfigurasi beberapa nilai untuk parameter header respons. Pisahkan beberapa nilai dengan koma (,).
no-cache
duplicate
String
Tidak
Menentukan apakah akan mengizinkan penambahan header respons dengan nama yang sama. Jika Anda mengatur header_operation_type ke add, Anda harus menentukan apakah duplikat diizinkan. Nilai yang valid:
on: mengizinkan duplikat.
off: tidak mengizinkan duplikat.
off
header_source
String
Tidak
Nilai parameter yang akan diganti. Jika Anda mengatur header_operation_type ke rewrite, Anda harus mengatur parameter ini. Ekspresi reguler didukung.
value1
header_destination
String
Tidak
Nilai parameter baru. Jika Anda mengatur header_operation_type ke rewrite, Anda harus mengatur parameter ini.
value123
match_all
String
Tidak
Mode pencocokan. Jika Anda mengatur header_operation_type ke rewrite, Anda harus mengatur mode pencocokan. Nilai yang valid:
on: mencocokkan semua nilai. Semua nilai yang cocok diganti.
off: hanya mencocokkan nilai pertama. Hanya nilai pertama yang cocok yang diganti.
off
Contoh konfigurasi:
{ "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 URI asal. Untuk informasi selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Tulis ulang URI asal. Fitur ini hanya tersedia untuk pengguna yang ditambahkan ke daftar putih. Untuk menggunakan fitur ini, kirim tiket.
ID Fitur (FunctionID/FuncId): 225.
Deskripsi parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
source_url
String
Ya
URI yang akan ditulis ulang.
^/hello$
target_url
String
Ya
URI tujuan.
/hello/test
flag
String
Tidak
Aturan eksekusi untuk operasi penulisan ulang. Nilai yang valid:
Kosong: Jika parameter ini tidak diatur, aturan penulisan ulang berikutnya terus dieksekusi setelah aturan saat ini dieksekusi.
break: Setelah aturan saat ini dieksekusi, aturan penulisan ulang berikutnya tidak lagi dieksekusi.
enhance_break: Mirip dengan break, tetapi memproses permintaan dengan parameter dan juga berlaku untuk stream live FLV.
break
Contoh konfigurasi:
{ "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", }
back_to_origin_argument_rewrite
Deskripsi fitur: Menulis ulang parameter asal. Untuk informasi selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Tulis ulang parameter asal. Fitur ini hanya tersedia untuk pengguna yang ditambahkan ke daftar putih. Untuk menggunakan fitur ini, kirim tiket.
CatatanPenulisan ulang parameter asal memodifikasi parameter kueri dari URL permintaan asal. Anda dapat mengonfigurasi beberapa aturan penulisan ulang. Prioritas tindakan penulisan ulang adalah sebagai berikut: Add > Delete > Reserve Only > Modify. Jika aturan penulisan ulang yang berbeda berlaku untuk parameter yang sama, hanya aturan dengan prioritas tertinggi yang berlaku.
ID Fitur (FunctionID/FuncId): 224.
Deskripsi parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
delete_argument
String
Tidak
Daftar parameter yang akan dihapus. Pisahkan beberapa parameter dengan spasi.
code1
save_argument
String
Tidak
Daftar parameter yang akan dipertahankan. Pisahkan beberapa parameter dengan spasi. Hanya parameter yang tercantum yang dipertahankan. Tindakan tambah dan hapus parameter masih berlaku.
Kosong
ignore_all_argument
String
Tidak
Menentukan apakah akan mengabaikan semua parameter. Nilai yang valid:
on: mengabaikan semua parameter. Hanya fitur tambah parameter yang tetap efektif. Fitur hapus, pertahankan hanya, dan ubah parameter menjadi tidak efektif.
off (default): tidak mengabaikan semua parameter. Fitur pertahankan, tambah, dan hapus parameter tetap efektif.
on
add_argument
String
Tidak
Parameter yang akan ditambahkan. Ini memiliki prioritas tertinggi. Pisahkan beberapa parameter dengan spasi.
value=123
modify_argument
String
Tidak
Parameter yang akan diubah. Ini memiliki prioritas terendah. Jika parameter dihapus, parameter tersebut tidak dipertahankan. Pisahkan beberapa parameter dengan spasi.
value=321
enable
String
Ya
Menentukan apakah akan mengaktifkan penulisan ulang parameter asal. Nilai yang valid:
on: mengaktifkan fitur.
off: menonaktifkan fitur.
on
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "delete_argument", "argValue": "" }, { "argName": "save_argument", "argValue": "" }, { "argName": "add_argument", "argValue": "" }, { "argName": "modify_argument", "argValue": "" }, { "argName": "ignore_all_argument", "argValue": "on" }, { "argName": "enable", "argValue": "on" }], "functionName": "back_to_origin_argument_rewrite" }], "DomainNames": "example.com" }
aws_s3_bucket
Deskripsi fitur: Mengonfigurasi bucket Amazon S3 untuk penandatanganan. Fitur ini hanya tersedia untuk pengguna yang ditambahkan ke daftar putih. Untuk menggunakan fitur ini, kirim tiket.
ID Fitur (FunctionID/FuncId): 186.
Deskripsi parameter:
Parameter
Type
Wajib
Deskripsi
Contoh
enabled
String
Ya
Aktifkan autentikasi bucket Amazon S3:
L2 diaktifkan.
off: menonaktifkan fitur.
l2
bucketname
String
Tidak
Nama bucket Amazon S3.
/
accesskey
String
Ya
AWS AccessKey.
123456789
secretkey
String
Ya
AWS SecretKey.
12345678
region
String
Ya
Wilayah penyimpanan Amazon S3.
us-east-2
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "enabled", "argValue": "l2" }, { "argName": "accesskey", "argValue": "123456789" }, { "argName": "secretkey", "argValue": "123456789" }, { "argName": "region", "argValue": "us-east-2" }], "functionName": "aws_s3_bucket" }], "DomainNames": "example.com" }
origin_certificate_verification
Deskripsi fitur: Mengonfigurasi verifikasi sertifikat asal (daftar putih SNI). Untuk informasi selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Konfigurasi daftar putih Common Name. Fitur ini hanya tersedia untuk pengguna yang ditambahkan ke daftar putih. Untuk menggunakan fitur ini, kirim tiket.
ID Fitur (FunctionID/FuncId): 223.
Deskripsi parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
enabled
String
Ya
Menentukan apakah akan mengaktifkan verifikasi sertifikat asal. Nilai yang valid:
on: mengaktifkan fitur.
off: menonaktifkan fitur.
on
common_name_whitelist
String
Tidak
Daftar nama domain yang masuk daftar putih untuk sertifikat. Anda dapat mengonfigurasi beberapa nama domain. Pisahkan dengan koma (,). Sertifikat yang cocok dengan nama domain dalam daftar putih ini dapat lolos verifikasi.
example.comContoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "enable", "argValue": "on" }, { "argName": "common_name_whitelist", "argValue": "example.com" }], "functionName": "origin_certificate_verification" }], "DomainNames": "example.com" }
origin_dns_host
Deskripsi fitur: Mengonfigurasi asal bersyarat. Anda dapat menggunakan fitur ini dengan fitur mesin aturan (fungsi: condition, ID fitur: 250) untuk mengalihkan permintaan ke server asal tertentu berdasarkan informasi seperti jalur, parameter URL, dan header permintaan dalam permintaan pengguna. Fitur ini hanya tersedia untuk pengguna yang ditambahkan ke daftar putih. Untuk menggunakan fitur ini, kirim tiket.
Prasyarat: Sebelum mengonfigurasi asal bersyarat, Anda harus membuat setidaknya satu kondisi aturan untuk mesin aturan. Saat mengonfigurasi asal bersyarat, Anda harus mengaitkannya dengan kondisi aturan. Untuk informasi selengkapnya, lihat Mesin aturan. Jika Anda tidak mengaitkan konfigurasi asal bersyarat dengan kondisi aturan, semua lalu lintas asal DCDN diarahkan ke URL asal tunggal ini. Hal ini menggagalkan tujuan mengontrol URL asal dengan kondisi aturan.
Konflik fitur: Fitur asal bersyarat bertentangan dengan fitur asal lanjutan (fungsi: advanced_origin, ID fitur: 235). Anda hanya dapat mengaktifkan salah satunya. Jika salah satu fitur telah dikonfigurasi, Anda harus menghapus konfigurasinya sebelum dapat mengonfigurasi yang lain. Fitur dianggap telah dikonfigurasi meskipun parameter switch-nya diatur ke `off`. Anda dapat memanggil operasi DeleteDcdnSpecificConfig untuk menghapus konfigurasi tertentu untuk nama domain.
ID Fitur (FunctionID/FuncId): 212.
Deskripsi parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
ali_origin_dns_host
String
Ya
Nama domain yang digunakan untuk kueri DNS selama pengambilan asal.
example.comContoh konfigurasi: Atur `parentid` untuk merujuk kondisi aturan yang telah dibuat menggunakan fitur mesin aturan (fungsi: condition, ID fitur: 250). Referensi dibuat melalui `configid` yang dihasilkan saat konfigurasi ditambahkan. Hal ini memastikan bahwa ketika permintaan pengguna memenuhi kondisi aturan ini, permintaan tersebut dialihkan ke URL asal yang ditentukan.
{ "Functions": [{ "functionArgs": [{ "argName": "ali_origin_dns_host", "argValue": "example.com" }], "functionName": "origin_dns_host", "parentId":30119730104**** }], "DomainNames": "example.com" }
origin_host
Deskripsi fitur: Mengonfigurasi host asal untuk server asal tertentu. Anda dapat mengatur host asal tertentu untuk server asal tertentu. Fitur ini hanya tersedia untuk pengguna yang ditambahkan ke daftar putih. Untuk menggunakan fitur ini, kirim tiket.
ID Fitur (FunctionID/FuncId): 242.
Deskripsi parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
origin
String
Ya
URL asal tertentu. Anda juga dapat tidak menentukannya dengan mengatur parameter origin ke all, yang merepresentasikan semua server asal.
example.comhost
String
Ya
Host tertentu. Anda juga dapat tidak menentukannya dengan mengatur parameter host ke
ali_follow_origin, yang berarti nilai host mengikuti URL asal.host.example.comContoh konfigurasi 1: Saat permintaan pengguna dialihkan ke server asal
example.com, nilai `host` yang digunakan adalahhost.example.com.{ "Functions": [{ "functionArgs": [{ "argName": "origin", "argValue": "example.com" }, { "argName": "host", "argValue": "host.example.com" }], "functionName": "origin_host" }], "DomainNames": "example.com" }Contoh konfigurasi 2: Permintaan pengguna yang dialihkan ke semua server asal (direpresentasikan oleh `all`) menggunakan nilai `host` yang sama
host.example.com.{ "Functions": [{ "functionArgs": [{ "argName": "origin", "argValue": "all" }, { "argName": "host", "argValue": "host.example.com" }], "functionName": "origin_host" }], "DomainNames": "example.com" }Contoh konfigurasi 3: Untuk permintaan pengguna yang dialihkan ke semua server asal (direpresentasikan oleh `all`), nilai `host` mengikuti URL asal (direpresentasikan oleh
ali_follow_origin).{ "Functions": [{ "functionArgs": [{ "argName": "origin", "argValue": "all" }, { "argName": "host", "argValue": "ali_follow_origin" }], "functionName": "origin_host" }], "DomainNames": "example.com" }
ali_origin_port_scheme
Deskripsi fitur: Mengonfigurasi port dan protokol asal. Fitur ini hanya tersedia untuk pengguna yang ditambahkan ke daftar putih. Untuk menggunakan fitur ini, kirim tiket.
ID Fitur (FunctionID/FuncId): 276.
Deskripsi parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
port
String
Ya
Port asal.
CatatanJika Anda mengatur scheme ke follow, Anda harus menggunakan format
http:80|https:443.80
scheme
String
Ya
Protokol asal. Anda dapat menyesuaikan protokol asal. Nilai yang valid: http, https, follow, https_sm, dan follow_sm.
http: Pengambilan asal dilakukan melalui HTTP.
https: Pengambilan asal dilakukan melalui HTTPS dengan algoritma internasional.
follow: Alibaba Cloud CDN mengikuti protokol, HTTP atau HTTPS, yang digunakan oleh klien. Saat protokol HTTPS digunakan, hanya algoritma Rivest-Shamir-Adleman (RSA) yang didukung.
Jika klien menggunakan HTTP, pengambilan asal juga menggunakan HTTP.
Klien berkomunikasi menggunakan protokol HTTPS.
Jika klien menggunakan algoritma internasional, pengambilan asal menggunakan HTTPS dengan algoritma internasional.
Jika klien menggunakan algoritma kriptografi Tiongkok, pengambilan asal menggunakan HTTPS dengan algoritma internasional.
https_sm: Pengambilan asal dilakukan melalui HTTPS dengan algoritma kriptografi Tiongkok.
follow_sm: Layanan mengikuti protokol, HTTP atau HTTPS, yang digunakan oleh klien. Algoritma RSA dan SM didukung.
Klien menggunakan protokol HTTP untuk pengambilan asal.
Klien menggunakan protokol HTTPS.
Jika klien menggunakan algoritma internasional, pengambilan asal menggunakan HTTPS dan algoritma internasional.
Jika klien menggunakan algoritma kriptografi Tiongkok, pengambilan asal menggunakan HTTPS dan algoritma kriptografi Tiongkok.
CatatanAlgoritma internasional adalah algoritma enkripsi standar internasional. Algoritma kriptografi Tiongkok adalah algoritma enkripsi domestik yang disertifikasi oleh Administrasi Kriptografi Negara Tiongkok.
http
Contoh konfigurasi 1: Mengatur protokol asal ke `http` dan port asal ke 80.
{ "Functions": [{ "functionArgs": [{ "argName": "port", "argValue": "80" }, { "argName": "scheme", "argValue": "http" }], "functionName": "ali_origin_port_scheme" }], "DomainNames": "example.com" }Contoh konfigurasi 2: Protokol asal mengikuti protokol yang digunakan oleh permintaan pengguna. Saat pengambilan asal dilakukan melalui HTTP, permintaan dialihkan ke port 80 server asal. Saat pengambilan asal dilakukan melalui HTTPS, permintaan dialihkan ke port 443 server asal.
{ "Functions":[{ "functionArgs": [{ "argName": "port", "argValue": "http:80|https:443" }, { "argName": "scheme", "argValue": "follow" }], "functionName":"ali_origin_port_scheme" }], "DomainNames":"example.com" }
origin_sni
Deskripsi fitur: Mengonfigurasi SNI asal tertentu. Anda dapat mengatur SNI asal tertentu untuk server asal tertentu. Untuk informasi selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Konfigurasi SNI asal tertentu. Fitur ini hanya tersedia untuk pengguna yang ditambahkan ke daftar putih. Untuk menggunakan fitur ini, kirim tiket.
ID Fitur (FunctionID/FuncId): 262.
Deskripsi parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
origin
String
Ya
URL asal. Anda juga dapat tidak menentukannya dengan mengatur parameter origin ke all.
example.comsni_host
String
Ya
Nilai host SNI:
Anda dapat mengaturnya ke bidang statis, seperti
example.org.Untuk mengikuti URL asal sebagai SNI, atur ke
ali_follow_origin.Untuk mengikuti host asal sebagai SNI, atur ke
ali_follow_host.
example.orgkeepalive_sni
String
Tidak
Menentukan apakah akan mengaktifkan pencocokan SNI untuk koneksi persisten. Nilai yang valid:
on: mengaktifkan fitur.
off: menonaktifkan fitur.
CatatanJika Anda mengaktifkan fitur ini, koneksi persisten yang berbeda digunakan untuk SNI asal yang berbeda.
/
Contoh konfigurasi 1: Saat permintaan pengguna dialihkan ke server asal
origin.example.com, nilai SNI yang digunakan adalahhost.example.com.{ "Functions": [{ "functionArgs": [{ "argName": "origin", "argValue": "origin.example.com" }, { "argName": "sni_host", "argValue": "host.example.com" }], "functionName": "origin_sni" }], "DomainNames": "example.com" }Contoh konfigurasi 2: Permintaan pengguna yang dialihkan ke semua server asal (direpresentasikan oleh
all) menggunakan nilai SNI yang samahost.example.com.{ "Functions": [{ "functionArgs": [{ "argName": "origin", "argValue": "all" }, { "argName": "sni_host", "argValue": "host.example.com" }], "functionName":"origin_sni" }], "DomainNames":"example.com" }Contoh konfigurasi 3: Untuk permintaan pengguna yang dialihkan ke semua server asal (direpresentasikan oleh
all), nilai SNI mengikuti URL asal (direpresentasikan oleh nilai parameterali_follow_origin).{ "Functions": [{ "functionArgs": [{ "argName": "origin", "argValue": "all" }, { "argName": "sni_host", "argValue": "ali_follow_origin" }], "functionName": "origin_sni" }], "DomainNames": "example.com" }Contoh konfigurasi 4: Untuk permintaan pengguna yang dialihkan ke semua server asal (direpresentasikan oleh
all), nilai SNI mengikuti host asal (direpresentasikan oleh nilai parameterali_follow_host).{ "Functions": [{ "functionArgs": [{ "argName": "origin", "argValue": "all" }, { "argName": "sni_host", "argValue": "ali_follow_host" }], "functionName": "origin_sni" }], "DomainNames": "example.com" }
source_group
Deskripsi fitur: Mengonfigurasi pengaturan grup asal. Fitur ini hanya tersedia untuk pengguna yang ditambahkan ke daftar putih. Untuk menggunakan fitur ini, kirim tiket.
ID Fitur (FunctionID/FuncId): 294.
Deskripsi parameter:
Parameter
Type
Wajib
Deskripsi
Contoh
source_group_name
String
Ya
Nama grup asal. Dapat berisi huruf kecil, angka, dan garis bawah (_). Panjang maksimum adalah 128 byte.
example_origin
source_info
String
Ya
Informasi tentang server asal. Format: Alamat Server Asal_Prioritas_Bobot_Port. Gunakan garis bawah (_) untuk memisahkan nilai parameter yang berbeda. Gunakan koma (,) untuk memisahkan beberapa server asal.
Alamat Server Asal: Mendukung IPv4, IPv6, dan nama domain.
Prioritas: Nilai yang valid: 1 hingga 65535. Nilai yang lebih kecil menunjukkan prioritas yang lebih tinggi.
Bobot: Nilai yang valid: 1 hingga 100. DCDN mendistribusikan permintaan ke server asal yang berbeda berdasarkan bobotnya.
Port: Nilai yang valid: 1 hingga 65535.
Sumber tunggal: 192.168.0.1_10_33_80
Beberapa sumber: 192.168.0.1_10_33_80, 192.0.2.1_10_67_80
retry_times
Integer
Tidak
Jumlah upaya pengambilan asal ulang.
3
retry_status_rule
Integer
Tidak
Kode status yang memicu pengambilan asal ulang. Saat ini, hanya lima nilai berikut yang didukung: 4xx, 5xx, 404, 404-or-5xx, dan 4xx-or-5xx. Anda dapat mengonfigurasi salah satunya.
404-or-5xx
failback_source
String
Tidak
Gunakan informasi asal dasar untuk cadangan. Nilai yang valid:
on: Jika semua server asal dalam grup asal tidak tersedia, URL asal dalam Informasi Dasar - Informasi Asal digunakan.
off: Jika semua server asal dalam grup asal tidak tersedia, kode status 5xx yang menunjukkan bahwa server asal tidak tersedia dikembalikan langsung ke klien.
on
CatatanLogika pengambilan asal ulang:
Jumlah pengulangan: Jumlah kali mencoba pengambilan asal ulang.
Pengulangan hanya dilakukan antara alamat IP yang berbeda dalam grup asal yang sama.
Jumlah maksimum pengulangan sebenarnya dibatasi oleh jumlah alamat IP yang tersedia dalam grup asal yang sama.
Jika `retry_times` tidak dikonfigurasi, jumlah pengulangan default adalah minimum antara 3 dan jumlah alamat IP asal yang tersedia.
Jika `retry_times` dikonfigurasi, jumlah pengulangan adalah minimum antara nilai yang dikonfigurasi dan jumlah alamat IP asal yang tersedia.
Kode status untuk pengulangan: Node melakukan pengulangan saat menerima kode status tertentu.
Jika `retry_status_rule` tidak dikonfigurasi, pengulangan dipicu secara default saat server asal merespons dengan kode status 5xx.
Jika `retry_status_rule` dikonfigurasi, pengulangan failover dipicu berdasarkan kode status yang dikonfigurasi. Saat ini, hanya lima nilai berikut yang didukung: 4xx, 5xx, 404, 404-or-5xx, dan 4xx-or-5xx. Anda dapat mengonfigurasi salah satunya.
Setelah Anda mengonfigurasi `retry_status_rule`, kode status 5xx default tetap berlaku. Misalnya, jika Anda mengonfigurasi `404`, node DCDN melakukan pengulangan saat menerima kode status 404 atau 5xx.
Urutan pengambilan asal ulang: Pengulangan dilakukan dalam urutan prioritas menurun dari alamat IP dalam grup asal yang sama.
Skenario waktu habis pengambilan asal: Saat server asal secara aktif merespons dengan kode status pengulangan, node DCDN melakukan pengulangan permintaan. Jika server asal tidak merespons dengan kode status pengulangan, node DCDN mengikuti proses penanganan waktu habis dan melakukan pengulangan permintaan setelah periode waktu habis tercapai.
Waktu habis koneksi TCP asal: 10 detik.
Waktu habis penulisan asal: 30 detik. Ini adalah waktu habis untuk menulis konten setelah koneksi dibuat dengan server asal.
Waktu habis pembacaan asal: 30 detik. Waktu habis ini terjadi jika server asal gagal mengirim konten lengkap yang diminta oleh node DCDN dalam periode yang ditentukan.
Logika probing asal:
Koneksi Layer 4 abnormal: Jika node DCDN gagal membuat koneksi Layer 4 dengan alamat IP asal, alamat IP asal tersebut ditambahkan ke tabel mati. Permintaan pengambilan asal berikutnya tidak mengakses alamat IP asal ini. Node DCDN kemudian melakukan probing alamat IP asal tersebut di Layer 4 setiap 5 detik. Jika koneksi berhasil dibuat, alamat IP asal dipulihkan ke daftar yang tersedia.
Koneksi Layer 4 normal: Jika node DCDN memiliki koneksi Layer 4 normal dengan alamat IP asal tetapi menerima kode status pengulangan (seperti 5xx) dari server asal, logika pengulangan dipicu. Namun, alamat IP asal tetap berada dalam daftar yang tersedia, dan permintaan akses berikutnya masih dikirim ke server asal ini berdasarkan bobotnya. Artinya, jika koneksi Layer 4 normal, pengecualian Layer 7 tidak secara otomatis memblokir alamat IP asal. Untuk secara aktif memblokir alamat IP asal, Anda harus mengonfigurasi fitur pemantauan asal Layer 7 dan pemeriksaan kesehatan.
Contoh konfigurasi:
{ "Functions":[{ "functionArgs":[{ "argName":"source_group_name", "argValue":"test_yidong" },{ "argName":"source_info", "argValue":"192.168.0.1_10_33_80,192.0.2.1_10_67_80" },{ "argName":"retry_times", "argValue":"3" },{ "argName":"retry_status_rule", "argValue":"404,502" },{ "argName":"failback_source", "argValue":"on" }], "functionName":"source_group" }], "DomainNames":"example.com" }
ipv6_origin
Deskripsi fitur: Mengonfigurasi pengambilan asal melalui IPv6. Untuk informasi selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Konfigurasi pengambilan asal melalui IPv6. Fitur ini hanya tersedia untuk pengguna yang ditambahkan ke daftar putih. Untuk menggunakan fitur ini, kirim tiket.
ID Fitur (FunctionID/FuncId): 265
Deskripsi parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
enable
String
Ya
Menentukan apakah akan mengaktifkan pengambilan asal melalui IPv6.
on: Mengaktifkan fitur.
off: Menonaktifkan fitur.
CatatanJika fitur ini diaktifkan, DCDN menyediakan layanan IPv6 untuk pengambilan asal.
Jika titik kehadiran (PoP) DCDN dan server asal memiliki alamat IPv6 aktif, DCDN membuat koneksi melalui IPv6.
DCDN membuat koneksi melalui IPv4 dalam skenario berikut:
PoP DCDN tidak memiliki alamat IPv6 aktif.
Server asal tidak memiliki alamat IPv6 aktif.
Baik PoP DCDN maupun server asal tidak memiliki alamat IPv6 aktif.
on
follow
String
Ya
Menentukan apakah permintaan kembali-ke-asal mengikuti versi protokol IP dari permintaan klien.
on: Fitur diaktifkan.
off: Fitur dinonaktifkan.
CatatanSaat fitur ini diaktifkan, permintaan kembali-ke-asal DCDN mengikuti versi protokol IP dari permintaan klien.
Jika permintaan klien menggunakan IPv6, DCDN memprioritaskan server asal IPv6 untuk permintaan kembali-ke-asal. Jika tidak ada server asal IPv6 yang tersedia, DCDN menggunakan server asal IPv4.
Jika permintaan klien menggunakan IPv4, DCDN memprioritaskan server asal IPv4 untuk permintaan kembali-ke-asal. Jika tidak ada server asal IPv4 yang tersedia, DCDN menggunakan server asal IPv6.
on
ipv6_v4_mix_used
String
Tidak
Menentukan apakah akan mengaktifkan fitur Polling Alamat Asal IPv4/IPv6.
on: Diaktifkan.
off: Dinonaktifkan.
CatatanFitur Polling Alamat Asal IPv4/IPv6 saling eksklusif dengan fitur Pengambilan Asal melalui IPv6 dan fitur Ikuti Protokol IP Klien untuk Pengambilan Asal. Jika Polling Alamat Asal IPv4/IPv6 diaktifkan, kedua fitur lainnya dinonaktifkan.
Fitur ini menggunakan metode polling untuk mengirim permintaan pengambilan asal ke semua alamat server asal IPv4 dan IPv6 yang dikonfigurasi. Proses ini berlaku untuk semua permintaan klien, terlepas dari apakah klien menggunakan IPv4 atau IPv6.
Jika bobot dikonfigurasi untuk alamat IPv4 dan IPv6, permintaan pengambilan asal didistribusikan sesuai dengan bobot tersebut.
Off
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "enable", "argValue": "on" },{ "argName": "follow", "argValue": "on" }], "functionName": "ipv6_origin" }], "DomainNames": "example.com" }
cos_auth
Deskripsi: Mengonfigurasi bucket autentikasi untuk Tencent Cloud Object Storage (COS). Fitur ini hanya tersedia untuk pengguna yang masuk daftar putih. Untuk meminta akses, kirim tiket.
ID Fungsi (FunctionID/FuncId): 288.
Parameter:
Parameter
Tipe
Wajib
Deskripsi
Nilai contoh
enable
String
Ya
Menentukan apakah akan mengaktifkan bucket autentikasi untuk Tencent Cloud COS.
on: Aktifkan.
off: Nonaktifkan.
on
cos_valid_period
String
Tidak
Periode validitas tanda tangan autentikasi dalam detik. Nilai default adalah 3600 detik.
/
cos_secret_id
String
Ya
ID autentikasi dari Tencent Cloud.
123456789
cos_secret_key
String
Ya
Kunci autentikasi dari Tencent Cloud.
12345678
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "enable", "argValue": "on" }, { "argName": "cos_secret_id", "argValue": "123456789" }, { "argName": "cos_secret_key", "argValue": "123456789" }], "functionName": "cos_auth" }], "DomainNames": "example.com" }
oss_auth
Deskripsi fitur: Mengonfigurasi informasi autentikasi untuk bucket Layanan Penyimpanan Objek (OSS) yang digunakan untuk pengambilan asal DCDN.
ID Fungsi (FunctionID/FuncId): 10.
Catatan: Platform secara otomatis menambahkan konfigurasi `oss_auth` saat Anda mengatur bucket OSS sebagai asal untuk nama domain yang dipercepat. Jangan menambahkan atau menghapus konfigurasi ini secara manual. Jika konfigurasi ini dihapus, pembebasan tagihan untuk lalu lintas asal DCDN tidak dapat diterapkan. Selain itu, jika autentikasi bucket pribadi diaktifkan, pengambilan asal dari DCDN ke bucket OSS pribadi gagal.
Parameter:
Parameter
Tipe
Wajib
Deskripsi
Nilai contoh
oss_bucket_id
String
Ya
Nama domain publik bucket OSS.
dcdn-test.oss-cn-hongkong.aliyuncs.com
oss_pri_buckets
String
Ya
Nama domain publik bucket OSS dan nama bucket yang sesuai.
dcdn-test.oss-cn-hongkong.aliyuncs.com|dcdn-test
Contoh konfigurasi:
{ "Functions": [ { "ArgValue": "dcdn-test.oss-cn-hongkong.aliyuncs.com", "ArgName": "oss_bucket_id" }, { "ArgValue": "dcdn-test.oss-cn-hongkong.aliyuncs.com|dcdn-test", "ArgName": "oss_pri_buckets" } ], "functionName": "oss_auth" }], "DomainNames": "example.com" }
Konfigurasi cache
filetype_based_ttl_set
Menentukan waktu kedaluwarsa cache untuk file berdasarkan ekstensi file. Untuk informasi selengkapnya, lihat Konfigurasi waktu-ke-hidup cache.
ID Fungsi (FunctionID/FuncId): 6.
Deskripsi parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
ttl
Integer
Ya
Durasi cache dalam detik. Nilainya harus bilangan bulat dari 1 hingga 99999999, yaitu sedikit lebih dari 3 tahun.
500000
file_type
String
Ya
Jenis file. Parameter ini peka huruf besar/kecil. Pisahkan beberapa jenis file dengan koma (,). Contoh: jpg,txt.
jpg
weight
Integer
Tidak
Bobot. Nilai yang valid: 1 hingga 99.
CatatanNilai default adalah 1. Nilai yang lebih besar menunjukkan prioritas yang lebih tinggi.
1
swift_origin_cache_high
String
Tidak
Memprioritaskan kebijakan cache server asal. Jika Anda mengatur parameter ini ke `on`, kebijakan cache server asal didahulukan saat server asal mengembalikan header terkait cache, seperti `Cache-Control` dan `Pragma`. Nilai yang valid:
`on`: diaktifkan
`off` (default): dinonaktifkan
off
swift_no_cache_low
String
Tidak
Abaikan header respons `no-cache` dari server asal. Jika Anda mengatur parameter ini ke `on`, header respons `no-cache` berikut dari server asal diabaikan.
Cache-Control: no-store
Cache-Control: no-cache
Cache-Control: max-age=0
Pragma: no-cache
Nilai yang valid:
`on`: diaktifkan
`off` (default): dinonaktifkan
off
swift_follow_cachetime
String
Tidak
Izinkan klien mengikuti kebijakan cache DCDN. Jika Anda mengatur parameter ini ke `on`, kebijakan cache DCDN akhir dikembalikan ke klien. Nilai yang valid:
`on`: diaktifkan
`off` (default): dinonaktifkan
off
force_revalidate
String
Tidak
Paksa validasi konten saat TTL adalah 0. Nilai yang valid:
`on`: diaktifkan. Saat TTL adalah 0, konten di-cache pada titik kehadiran (POPs), dan setiap permintaan memerlukan pengambilan asal untuk memvalidasi konten yang di-cache.
`off` (default): dinonaktifkan. Saat TTL adalah 0, konten tidak di-cache pada POPs, dan setiap permintaan memerlukan pengambilan asal untuk mengambil konten.
off
Contoh konfigurasi:
{ "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" },{ "argName": "force_revalidate", "argValue": "off" }], "functionName": "filetype_based_ttl_set" }], "DomainNames": "example.com" }
path_based_ttl_set
Deskripsi: Mengonfigurasi waktu kedaluwarsa cache untuk folder. Untuk informasi selengkapnya, lihat Konfigurasi waktu kedaluwarsa cache.
ID Fungsi (FunctionID/FuncId): 7.
Deskripsi parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
ttl
Integer
Ya
Durasi cache dalam detik. Nilainya harus bilangan bulat dari 1 hingga 99999999, yaitu sedikit lebih dari 3 tahun.
500000
path
String
Ya
Jalur folder. Jalur harus dimulai dengan garis miring (/).
/example/demo
weight
Integer
Tidak
Bobot. Nilai yang valid: 1 hingga 99.
CatatanNilai default adalah 1. Nilai yang lebih besar menunjukkan prioritas yang lebih tinggi.
1
swift_origin_cache_high
String
Tidak
Memprioritaskan kebijakan cache server asal. Jika Anda mengatur parameter ini ke `on`, kebijakan cache server asal didahulukan saat server asal mengembalikan header terkait cache, seperti `Cache-Control` dan `Pragma`. Nilai yang valid:
`on`: diaktifkan
`off` (default): dinonaktifkan
off
swift_no_cache_low
String
Tidak
Abaikan header respons `no-cache` dari server asal. Jika Anda mengatur parameter ini ke `on`, header respons `no-cache` berikut dari server asal diabaikan.
Cache-Control: no-store
Cache-Control: no-cache
Cache-Control: max-age=0
Pragma: no-cache
Nilai yang valid:
`on`: diaktifkan
`off` (default): dinonaktifkan
off
swift_follow_cachetime
String
Tidak
Izinkan klien mengikuti kebijakan cache DCDN. Jika Anda mengatur parameter ini ke `on`, kebijakan cache DCDN akhir dikembalikan ke klien. Nilai yang valid:
`on`: diaktifkan
`off` (default): dinonaktifkan
off
force_revalidate
String
Tidak
Paksa validasi konten saat TTL adalah 0. Nilai yang valid:
`on`: diaktifkan. Saat TTL adalah 0, konten di-cache pada POPs, dan setiap permintaan memerlukan pengambilan asal untuk memvalidasi konten yang di-cache.
`off` (default): dinonaktifkan. Saat TTL adalah 0, konten tidak di-cache pada POPs, dan setiap permintaan memerlukan pengambilan asal untuk mengambil konten.
off
Contoh konfigurasi:
{ "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" }, { "argName": "force_revalidate", "argValue": "off" }], "functionName": "path_based_ttl_set" }], "DomainNames": "example.com" }
filetype_force_ttl_code
Mengonfigurasi waktu kedaluwarsa cache kode status. Untuk informasi selengkapnya, lihat Konfigurasi waktu kedaluwarsa kode status.
ID Fungsi (FunctionID/FuncId): 63.
Deskripsi parameter:
Parameter
Type
Wajib
Deskripsi
Contoh
file_type
String
Ya
Jenis file. Parameter ini peka huruf besar/kecil. Pisahkan beberapa jenis file dengan koma (,). Contoh: jpg,txt.
jpg
code_string
String
Ya
Kode status dan durasi cache-nya dalam detik. Durasi maksimum adalah 3 tahun. Pisahkan beberapa entri dengan koma (,). Contoh: 302=0,301=0,4xx=2.
403=10
swift_code_origin_cache_high
String
Tidak
Memprioritaskan kebijakan cache server asal. Jika Anda mengatur parameter ini ke `on`, kebijakan cache server asal didahulukan saat server asal mengembalikan header terkait cache, seperti `Cache-Control` dan `Pragma`. Nilai yang valid:
`on`: diaktifkan
`off` (default): dinonaktifkan
off
swift_code_no_cache_low
String
Tidak
Abaikan header respons `no-cache` dari server asal. Jika Anda mengatur parameter ini ke `on`, header respons `no-cache` berikut dari server asal diabaikan.
Cache-Control: no-store
Cache-Control: no-cache
Cache-Control: max-age=0
Pragma: no-cache
Nilai yang valid:
`on`: diaktifkan
`off` (default): dinonaktifkan
off
swift_code_follow_cachetime
String
Tidak
Izinkan klien mengikuti kebijakan cache DCDN. Jika Anda mengatur parameter ini ke `on`, kebijakan cache DCDN akhir dikembalikan ke klien. Nilai yang valid:
`on`: diaktifkan
`off` (default): dinonaktifkan
off
force_revalidate
String
Tidak
Paksa validasi konten saat TTL adalah 0. Nilai yang valid:
`on`: diaktifkan. Saat TTL adalah 0, konten di-cache pada POPs, dan setiap permintaan memerlukan pengambilan asal untuk memvalidasi konten yang di-cache.
`off` (default): dinonaktifkan. Saat TTL adalah 0, konten tidak di-cache pada POPs, dan setiap permintaan memerlukan pengambilan asal untuk mengambil konten.
off
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "file_type", "argValue": "jpg" }, { "argName": "code_string", "argValue": "403=10" }, { "argName": "swift_code_origin_cache_high", "argValue": "off" }, { "argName": "swift_code_no_cache_low", "argValue": "off" }, { "argName": "swift_code_follow_cachetime", "argValue": "off" }, { "argName": "force_revalidate", "argValue": "off" }], "functionName": "filetype_force_ttl_code" }], "DomainNames": "example.com" }
path_force_ttl_code
Mengonfigurasi waktu kedaluwarsa cache kode status untuk jalur tertentu. Untuk informasi selengkapnya, lihat Konfigurasi waktu kedaluwarsa kode status.
ID Fungsi (FunctionID/FuncId): 65.
Deskripsi parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
path
String
Ya
Jalur folder. Jalur harus dimulai dengan garis miring (/). Contoh: /image.
/example/demo
code_string
String
Ya
Kode status dan durasi cache-nya dalam detik. Nilainya harus bilangan bulat dari 1 hingga 99999999, yaitu sedikit lebih dari 3 tahun. Pisahkan beberapa entri dengan koma (,). Contoh: 302=0,301=0,4xx=2.
403=10,404=15
swift_code_origin_cache_high
String
Tidak
Memprioritaskan kebijakan cache server asal. Jika Anda mengatur parameter ini ke `on`, kebijakan cache server asal didahulukan saat server asal mengembalikan header terkait cache, seperti `Cache-Control` dan `Pragma`. Nilai yang valid:
`on`: diaktifkan
`off` (default): dinonaktifkan
off
swift_code_no_cache_low
String
Tidak
Abaikan header respons `no-cache` dari server asal. Jika Anda mengatur parameter ini ke `on`, header respons `no-cache` berikut dari server asal diabaikan.
Cache-Control: no-store
Cache-Control: no-cache
Cache-Control: max-age=0
Pragma: no-cache
Nilai yang valid:
`on`: diaktifkan
`off` (default): dinonaktifkan
off
swift_code_follow_cachetime
String
Tidak
Izinkan klien mengikuti kebijakan cache DCDN. Jika Anda mengatur parameter ini ke `on`, kebijakan cache DCDN akhir dikembalikan ke klien. Nilai yang valid:
`on`: diaktifkan
`off` (default): dinonaktifkan
off
force_revalidate
String
Tidak
Paksa validasi konten saat TTL adalah 0. Nilai yang valid:
`on`: diaktifkan. Saat TTL adalah 0, konten di-cache pada POPs, dan setiap permintaan memerlukan pengambilan asal untuk memvalidasi konten yang di-cache.
`off` (default): dinonaktifkan. Saat TTL adalah 0, konten tidak di-cache pada POPs, dan setiap permintaan memerlukan pengambilan asal untuk mengambil konten.
off
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "path", "argValue": "/example/demo" }, { "argName": "code_string", "argValue": "403=10,404=15" }, { "argName": "swift_code_origin_cache_high", "argValue": "off" }, { "argName": "swift_code_no_cache_low", "argValue": "off" }, { "argName": "swift_code_follow_cachetime", "argValue": "off" }, { "argName": "force_revalidate", "argValue": "off" }], "functionName": "path_force_ttl_code" }], "DomainNames": "example.com" }
default_ttl_code
Deskripsi: Mengatur waktu kedaluwarsa cache kode status (prioritas asal).
ID Fungsi (FunctionID/FuncId): 207.
Deskripsi parameter:
Parameter
Type
Wajib
Deskripsi
Contoh
default_ttl_code
String
Ya
Kode status dan durasi cache-nya dalam detik. Nilainya harus bilangan bulat dari 1 hingga 99999999, yaitu sedikit lebih dari 3 tahun. Pisahkan beberapa kode status dengan koma (,).
4xx=3,200=3600,5xx=1
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "default_ttl_code", "argValue": "4xx=3,200=3600,5xx=1" }], "functionName": "default_ttl_code" }], "DomainNames": "example.com" }
set_resp_header
Deskripsi: Mengonfigurasi header respons HTTP kustom. Untuk informasi selengkapnya, lihat Ubah header respons outbound.
ID Fungsi (FunctionID/FuncId): 27.
Deskripsi parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
key
String
Ya
Header respons.
Cache-Control
value
String
Ya
Nilai header respons. Pisahkan beberapa nilai dengan koma (,).
CatatanUntuk menghapus header respons, atur nilainya ke null.
no-cache
header_operation_type
String
Tidak
Operasi yang dilakukan pada header permintaan. Nilainya adalah:
add: Menambahkan entri.
Delete: hapus.
Modify: Untuk mengubah.
`rewrite`: mengganti header.
add
duplicate
String
Tidak
Menentukan apakah akan mengizinkan penambahan header respons dengan nama yang sama. Parameter ini wajib saat Anda mengatur `header_operation_type` ke `add`. Nilai yang valid:
on: Duplikat diizinkan.
`off`: tidak diizinkan.
off
header_source
String
Tidak
Nilai yang akan diganti. Parameter ini wajib saat Anda mengatur `header_operation_type` ke `rewrite`. Nilainya bisa berupa ekspresi reguler.
value1
header_destination
String
Tidak
Nilai baru. Parameter ini wajib saat Anda mengatur `header_operation_type` ke `rewrite`.
value123
match_all
String
Tidak
Pola pencocokan. Parameter ini wajib saat Anda mengatur `header_operation_type` ke `rewrite`. Nilai yang valid:
`on`: cocokkan semua. Semua nilai yang cocok diganti.
`off`: cocokkan yang pertama. Hanya nilai pertama yang cocok yang diganti.
/
access_origin_control
String
Tidak
Menentukan apakah akan mengaktifkan autentikasi lintas domain. Nilai yang valid:
`on`: POP DCDN mengautentikasi permintaan pengguna lintas domain.
`off`: nonaktifkan fitur ini.
/
Contoh konfigurasi:
{ "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: Mengonfigurasi halaman kesalahan kustom. Untuk informasi selengkapnya, lihat Konfigurasi halaman kustom.
ID Fungsi (FunctionID/FuncId): 15.
Deskripsi parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
error_code
Integer
Ya
Kode kesalahan.
404
rewrite_page
String
Ya
Halaman pengalihan.
http://example.aliyundoc.com/error404.htmlContoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "error_code", "argValue": "404" }, { "argName": "rewrite_page", "argValue": "http://example.aliyundoc.com/error404.html" }], "functionName": "error_page" }], "DomainNames": "example.com" }
host_redirect
Deskripsi fitur: Mengonfigurasi aturan penulisan ulang URI. Untuk instruksi konfigurasi konsol terperinci, lihat Konfigurasi aturan penulisan ulang URI.
ID Fungsi (FunctionID/FuncId): 43.
Deskripsi parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
regex
String
Ya
URL yang akan ditulis ulang. Harus berupa URI yang dimulai dengan garis miring (/) dan tidak boleh mengandung protokol `http://` atau nama domain. Ekspresi reguler PCRE didukung. Contoh: ^/hello$.
^/hello$
replacement
String
Ya
URL tujuan. Harus berupa URI yang dimulai dengan garis miring (/) dan tidak boleh mengandung protokol `http://` atau nama domain.
/hello/test
flag
String
Tidak
Tindakan yang dilakukan POP DCDN setelah URI ditulis ulang. Nilai yang valid:
Kosong: Nilai default. Artinya parameter flag tidak dilewatkan. Jika beberapa aturan dikonfigurasi dan URL permintaan cocok dengan suatu aturan, POP melanjutkan pencocokan aturan berikutnya setelah aturan saat ini dieksekusi.
break: Jika URL permintaan cocok dengan suatu aturan, permintaan ditulis ulang ke URL tujuan. Parameter dalam URL asli tidak dimodifikasi. Setelah aturan saat ini dieksekusi, tidak ada aturan lain yang dicocokkan.
redirect: Jika URL permintaan cocok dengan suatu aturan, permintaan dialihkan ke URL tujuan dengan kode status 302. POP DCDN mengembalikan URL tujuan sebagai header `Location` ke klien. Parameter dalam URL asli tidak dimodifikasi. Setelah aturan saat ini dieksekusi, aturan berikutnya masih dicocokkan.
enhance_break: Mirip dengan break, tetapi menulis ulang selang URL lengkap, termasuk parameternya.
enhance_redirect: Mirip dengan redirect, tetapi menulis ulang seluruh URL, termasuk parameternya.
CatatanMetode penulisan ulang dan dukungan untuk nama domain serta protokol lainnya bervariasi berdasarkan tindakan:
Kosong, break, dan enhance_break langsung menulis ulang URL permintaan pengguna. Tidak mendukung penulisan ulang ke nama domain atau protokol lain, seperti menulis ulang dari HTTP ke HTTPS.
redirect dan enhance_redirect menggunakan pengalihan 302 untuk menulis ulang URL. Mendukung penulisan ulang ke nama domain atau protokol lain:
Alamat `Location` 302 dapat diatur ke nama domain yang dipercepat saat ini atau nama domain lain. Misalnya, Anda dapat menulis ulang URL dari `example.com` ke `aliyundoc.com`.
Alamat `Location` 302 mendukung protokol lain. Misalnya, Anda dapat menulis ulang URL dari HTTP ke HTTPS.
redirect
rewrite_method
String
Tidak
Metode pengalihan. Kode status 302, 303, dan 307 didukung:
302: Metode pengalihan default. Metode permintaan GET tidak berubah. Metode permintaan lain mungkin berubah menjadi GET.
303: Metode permintaan GET tidak berubah. Metode permintaan lain berubah menjadi GET, dan isi pesan hilang.
307: Metode permintaan dan isi pesan tidak berubah.
302
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "flag", "argValue": "redirect" }, { "argName": "regex", "argValue": "^/hello$" }, { "argName": "replacement", "argValue": "/hello/test" }, { "argName": "rewrite_method", "argValue": "302" }], "functionName": "host_redirect" }], "DomainNames": "example.com" }
self_defined_cachekey
Deskripsi: Mengonfigurasi CacheKey kustom. Untuk informasi selengkapnya, lihat CacheKey Kustom.
ID Fungsi (FunctionID/FuncId): 227.
Deskripsi parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
uri
Array of String
Tidak
Menulis ulang URI sumber dalam permintaan ke URI tujuan dan menyimpan hasilnya sebagai kunci cache.
`uri_to_rewrite` menentukan URI sumber.
`ai_uri_regex` menentukan URI tujuan.
[{"uri_to_rewrite":"/hello","ai_uri_regex":"/hello/test"}]args
Array of String
Tidak
Menjalankan operasi tambah, hapus, ubah, atau pertahankan pada parameter permintaan dan menyimpan hasilnya sebagai kunci cache. Nilai yang valid:
`args_operation_type`: menentukan jenis operasi parameter. Nilai yang didukung adalah `add`, `delete`, `modify`, dan `keep`.
`args`: menentukan nilai parameter untuk operasi.
[{"args":"test=123","args_operation_type":"add"}]headers
String
Tidak
Menambahkan beberapa header HTTP dan menambahkannya ke kunci cache. Pisahkan beberapa header HTTP dengan spasi.
example
variable
Array of String
Tidak
Variabel kustom. Anda dapat menggunakan ekspresi reguler untuk mengekstrak bidang apa pun dari parameter permintaan, header HTTP, cookie, atau URI dalam URL permintaan, lalu menambahkan bidang tersebut ke kunci cache.
[]
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "uri", "argValue": [{ "uri_to_rewrite": "/hello", "ai_uri_regex": "/hello/test" }] }, { "argName": "args", "argValue": [{ "args": "test=123", "args_operation_type": "add" }] }, { "argName": "headers", "argValue": "" }, { "argName": "variable", "argValue": [] }], "functionName": "self_defined_cachekey" }], "DomainNames": "example.com" }
rewrite_host
Deskripsi: Mengonfigurasi cache bersama.
ID Fungsi (FunctionID/FuncId): 54.
Deskripsi parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
share_host
String
Ya
Nama domain tujuan yang dapat berbagi cache dengan nama domain saat ini. Konfigurasi ini tidak memodifikasi header `Host` untuk pengambilan asal. Ini hanya menggunakan nilai `share_host` untuk menghasilkan kunci cache guna mencari resource yang di-cache.
example.com
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "share_host", "argValue": "example.com" }], "functionName": "rewrite_host" }], "DomainNames": "example.com" }
serving_stale_content
Deskripsi: Menyajikan konten kedaluwarsa saat server asal tidak tersedia.
ID Fungsi (FunctionID/FuncId): 260.
Deskripsi parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
origin_error_status_code
String
Tidak
Kode status abnormal kustom dari server asal.
Deskripsi: Menentukan kode status asal tempat fitur ini berlaku.
Nilai default: Parameter ini tidak ditentukan secara default. Secara default, kesalahan asal didefinisikan sebagai waktu habis atau kode status 5xx apa pun.
Konfigurasi: Anda dapat memasukkan `4xx` atau `5xx` untuk pencocokan kabur, atau memasukkan kode status tertentu seperti `502` atau `504` untuk pencocokan eksak. Untuk menentukan beberapa kode status, pisahkan dengan koma (,).
502
extend_expiration_time
Integer
Tidak
Waktu kedaluwarsa diperpanjang.
Deskripsi: Waktu maksimum untuk menyimpan cache kedaluwarsa setelah masa berlakunya habis.
Nilai default: Parameter ini tidak ditentukan secara default. Waktu kedaluwarsa diperpanjang default adalah 1 jam.
Konfigurasi: Masukkan bilangan bulat positif yang lebih besar dari atau sama dengan 1. Satuan: detik.
60
origin_first
String
Tidak
Kebijakan memprioritaskan asal.
Deskripsi: Jika Anda mengatur parameter ini ke on, kebijakan asal diprioritaskan. Jika server asal mengembalikan file dengan kebijakan cache
Cache-Control: stale-if-error=xx, waktu yang ditentukan oleh parameter `stale-if-error` digunakan sebagai waktu kedaluwarsa diperpanjang.Nilai default: Parameter ini tidak ditentukan secara default. Ini setara dengan `off`. Dalam hal ini, waktu kedaluwarsa diperpanjang ditentukan oleh parameter `extend_expiration_time`.
Konfigurasi: Nilai yang didukung adalah on (diaktifkan) dan off (dinonaktifkan).
on
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "origin_error_status_code", "argValue": "502" }, { "argName": "extend_expiration_time", "argValue": "60" }, { "argName": "origin_first", "argValue": "off" }], "functionName": "serving_stale_content" }], "DomainNames": "example.com" }
Konfigurasi HTTPS
https_option
Deskripsi fitur: Mengonfigurasi parameter HTTPS dasar. Untuk informasi selengkapnya, lihat Konfigurasi sertifikat HTTPS, Konfigurasi HTTP/2, dan Konfigurasi OCSP Stapling.
ID Fungsi (FunctionID/FuncId): 78.
Deskripsi parameter:
Parameter
Tipe
Wajib
Deskripsi
Nilai contoh
http2
String
Tidak
Menentukan apakah akan mengaktifkan HTTP/2:
on: Mengaktifkan fitur.
off: Menonaktifkan fitur.
on
ocsp_stapling
String
Tidak
Menentukan apakah akan mengaktifkan fitur Online Certificate Status Protocol (OCSP) Stapling:
on: Mengaktifkan fitur.
off: Menonaktifkan fitur.
on
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "http2", "argValue": "on" }, { "argName": "ocsp_stapling", "argValue": "on" }], "functionName": "https_option" }], "DomainNames": "example.com" }
http_force
Deskripsi: Mengonfigurasi pengalihan paksa ke HTTP. Untuk informasi selengkapnya, lihat Konfigurasi pengalihan paksa.
Konflik fitur: Fitur pengalihan paksa HTTP bertentangan dengan fitur pengalihan paksa HTTPS (fungsi: https_force, ID fungsi: 44). Anda hanya dapat mengaktifkan salah satunya. Jika salah satu fitur ini sudah dikonfigurasi, Anda harus menghapus konfigurasinya sebelum dapat mengonfigurasi yang lain. Fitur dianggap telah dikonfigurasi meskipun parameter switch-nya diatur ke `off`. Untuk menghapus konfigurasi fitur untuk nama domain, Anda dapat memanggil operasi DeleteDcdnSpecificConfig.
ID Fungsi (FunctionID/FuncId): 45.
Parameter:
Parameter
Tipe
Wajib
Deskripsi
Nilai contoh
enable
String
Ya
Menentukan apakah akan mengaktifkan pengalihan paksa HTTP.
on: Mengaktifkan fitur.
off: Menonaktifkan fitur.
on
http_rewrite
String
Tidak
Metode pengalihan. Kode status yang didukung adalah 301 dan 308.
301: Metode permintaan GET tidak berubah. Metode permintaan lain mungkin berubah menjadi metode GET.
308: Metode permintaan dan entitas pesan tidak berubah.
301
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "enable", "argValue": "on" }, { "argName": "http_rewrite", "argValue": "301" }], "functionName": "http_force" }], "DomainNames": "example.com" }
https_force
Deskripsi fitur: Mengonfigurasi pengalihan paksa ke HTTPS. Untuk informasi selengkapnya, lihat Konfigurasi pengalihan paksa.
Konflik fitur: Fitur pengalihan paksa HTTPS bertentangan dengan fitur pengalihan paksa HTTP (fungsi: http_force, ID Fungsi: 45). Anda hanya dapat mengaktifkan salah satunya. Jika salah satu fitur sudah dikonfigurasi, Anda harus menghapus konfigurasinya sebelum dapat mengonfigurasi yang lain. Fitur dianggap telah dikonfigurasi meskipun parameter switch-nya diatur ke `off`. Untuk menghapus konfigurasi, Anda dapat memanggil operasi DeleteDcdnSpecificConfig. Setelah konfigurasi dihapus, Anda dapat mengonfigurasi fitur lainnya.
ID Fungsi (FunctionID/FuncId): 44.
Deskripsi parameter:
Parameter
Type
Wajib
Deskripsi
Contoh
enable
String
Ya
Menentukan apakah akan mengaktifkan pengalihan paksa ke HTTPS:
on: Mengaktifkan fitur.
off: Menonaktifkan fitur.
on
https_rewrite
String
Tidak
Metode pengalihan. Nilai yang valid adalah 301 dan 308.
301: Metode permintaan GET tetap tidak berubah. Metode permintaan lain mungkin berubah menjadi GET.
308: Metode permintaan dan entitas pesan tetap tidak berubah.
301
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "enable", "argValue": "on" }, { "argName": "https_rewrite", "argValue": "301" }], "functionName": "https_force" }], "DomainNames": "example.com" }
https_tls_version
Deskripsi fitur: Mengonfigurasi versi TLS. Untuk informasi selengkapnya, lihat Konfigurasi versi TLS dan paket sandi.
ID Fungsi (FuncId): 110.
Parameter:
Parameter
Tipe
Wajib
Deskripsi
Nilai contoh
tls10
String
Tidak
Menentukan apakah akan mengaktifkan TLSv1.0:
on (default): Mengaktifkan pengaturan.
Mati: Instans dimatikan.
on
tls11
String
Tidak
Menentukan apakah akan mengaktifkan TLSv1.1:
on (default): Diaktifkan.
off: Menunjukkan pemadaman.
on
tls12
String
Tidak
Menentukan apakah akan mengaktifkan TLSv1.2:
On (default): Pengaturan diaktifkan.
Off: Dimatikan.
on
tls13
String
Tidak
Menentukan apakah akan mengaktifkan TLSv1.3:
on (default): Mengaktifkan pengaturan.
off: Pemadaman.
on
ciphersuitegroup
String
Tidak
Grup paket sandi:
all (default): Semua paket sandi.
strict: Paket sandi kuat.
custom: Paket sandi kustom.
all
ciphersuite
String
Tidak
Paket sandi kustom. Parameter ini hanya valid ketika ciphersuitegroup diatur ke custom. Tentukan beberapa paket sandi yang dipisahkan 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 konfigurasi:
Konfigurasi default: Aktifkan TLS 1.0, TLS 1.1, dan TLS 1.2, dan gunakan semua paket sandi.
{ "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" }Aktifkan TLS 1.2 dan TLS 1.3, dan gunakan paket sandi kuat.
{ "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" }Aktifkan TLS 1.2 dan TLS 1.3, dan gunakan paket sandi kustom.
{ "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" }
HSTS
Deskripsi: Mengonfigurasi HTTP Strict Transport Security (HSTS). Untuk informasi selengkapnya, lihat Konfigurasi HSTS.
ID Fungsi (FunctionID/FuncId) adalah 112.
Deskripsi parameter:
Parameter
Tipe
Wajib
Deskripsi
Nilai contoh
enabled
String
Ya
Aktifkan HSTS:
Diaktifkan.
off: Mematikan sistem.
on
https_hsts_max_age
Integer
Ya
Waktu kedaluwarsa dalam detik.
CatatanNilai yang direkomendasikan adalah 5.184.000 detik (60 hari).
5184000
https_hsts_include_subdomains
String
Tidak
Menentukan apakah akan menyertakan parameter subdomain dalam header HTTP Strict Transport Security (HSTS). Nilai yang valid adalah on atau off.
CatatanSebelum mengaktifkan opsi ini, pastikan HTTPS diaktifkan untuk semua subdomain dari nama domain yang dipercepat. Jika tidak, subdomain menjadi tidak dapat diakses setelah secara otomatis dialihkan ke HTTPS.
off
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "enabled", "argValue": "on" }, { "argName": "https_hsts_max_age", "argValue": "5184000" }, { "argName": "https_hsts_include_subdomains", "argValue": "off" }], "functionName": "HSTS" }], "DomainNames": "example.com" }
Kontrol akses
referer_white_list_set
Deskripsi: Mengonfigurasi daftar putih Referer. Untuk informasi selengkapnya tentang cara mengonfigurasi fitur ini di konsol, lihat Konfigurasi perlindungan hotlink Referer.
Konflik: Fitur daftar putih Referer saling eksklusif dengan fitur daftar hitam Referer (fungsi: referer_black_list_set, ID fungsi: 5). Anda hanya dapat mengaktifkan salah satunya. Jika salah satu fitur sudah dikonfigurasi, Anda harus menghapus konfigurasinya sebelum dapat mengonfigurasi yang lain. Fitur dianggap telah dikonfigurasi meskipun parameter switch-nya diatur ke `off`. Untuk menghapus konfigurasi tertentu untuk nama domain, Anda dapat memanggil operasi DeleteDcdnSpecificConfig.
ID Fungsi (FunctionID/FuncId): 1.
Parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
refer_domain_allow_list
String
Ya
Daftar putih. Pisahkan beberapa nama domain dengan koma (,).
example.aliyundoc.com,demo.aliyundoc.comallow_empty
String
Tidak
Menentukan apakah akan mengizinkan akses ke resource DCDN jika bidang Referer kosong. Nilai yang valid:
on: Mengizinkan akses.
off (default): Menolak akses.
off
redirect_url
String
Tidak
URL pengalihan. Jika Referer dalam permintaan pengguna tidak cocok dengan nama domain mana pun dalam daftar putih, permintaan diblokir. Alih-alih mengembalikan kesalahan 403, DCDN mengembalikan kode status 302 dan header Location. Parameter ini menentukan nilai header Location. URL harus dimulai dengan http:// atau https://.
http://www.example.comdisable_ast
String
Tidak
Mengaktifkan mode pencocokan eksak. Ini mengontrol apakah nama domain dalam daftar putih dicocokkan secara eksak. Jika Anda mengatur parameter ini ke on, pencocokan eksak digunakan.
Jika diatur ke on:
Pencocokan eksak didukung.
Jika daftar putih berisi
example.com, ini cocok denganexample.com.Jika daftar putih berisi
a*b.example.com, ini cocok dengana<string apa saja>b.example.com.
Pencocokan akhiran tidak didukung.
Jika diatur ke off (default):
Pencocokan eksak tidak didukung.
Pencocokan akhiran didukung.
Jika daftar putih berisi
example.com, ini cocok denganexample.comdan<string apa saja>.example.com.Jika daftar putih berisi
a*b.example.com, ini cocok dengana<string apa saja>b.example.comdan<string apa saja>.a<string apa saja>b.example.com.
off
ignore_scheme
String
Tidak
Menentukan apakah akan mengabaikan skema. Jika diaktifkan, Referer dalam permintaan pengguna dianggap valid bahkan jika tidak menyertakan header protokol HTTP atau HTTPS. Contoh:
Jika diatur ke on, format Referer adalah:
referer: www.example.comJika diatur ke off (default), format Referer adalah:
referer: https://www.example.com
off
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "allow_empty", "argValue": "off" }, { "argName": "refer_domain_allow_list", "argValue": "example.aliyundoc.com,demo.aliyundoc.com" }], "functionName": "referer_white_list_set" }], "DomainNames": "example.com" }
referer_black_list_set
Deskripsi: Mengonfigurasi daftar hitam Referer. Untuk informasi selengkapnya tentang cara mengonfigurasi fitur ini di konsol, lihat Konfigurasi perlindungan hotlink Referer.
Konflik: Fitur daftar hitam Referer saling eksklusif dengan fitur daftar putih Referer (fungsi: referer_white_list_set, ID fungsi: 1). Anda hanya dapat mengaktifkan salah satunya. Jika salah satu fitur sudah dikonfigurasi, Anda harus menghapus konfigurasinya sebelum dapat mengonfigurasi yang lain. Fitur dianggap telah dikonfigurasi meskipun parameter switch-nya diatur ke `off`. Untuk menghapus konfigurasi tertentu untuk nama domain, Anda dapat memanggil operasi DeleteDcdnSpecificConfig.
ID Fungsi (FunctionID/FuncId): 5.
Parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
refer_domain_deny_list
String
Ya
Daftar hitam. Pisahkan beberapa nama domain dengan koma (,).
example.aliyundoc.com,demo.aliyundoc.comallow_empty
String
Tidak
Menentukan apakah akan mengizinkan akses ke resource DCDN jika bidang Referer kosong:
on: Mengizinkan akses.
off: Menolak akses.
off
redirect_url
String
Tidak
URL pengalihan. Jika Referer dalam permintaan pengguna cocok dengan nama domain dalam daftar hitam, permintaan diblokir. Alih-alih mengembalikan kesalahan 403, DCDN mengembalikan kode status 302 dan header Location. Parameter ini menentukan nilai header Location. URL harus dimulai dengan http:// atau https://.
http://www.example.comdisable_ast
String
Tidak
Mengaktifkan mode pencocokan eksak. Ini mengontrol apakah nama domain dalam daftar hitam dicocokkan secara eksak. Jika Anda mengatur parameter ini ke on, pencocokan eksak digunakan.
Jika diatur ke on:
Pencocokan eksak didukung.
Jika daftar hitam berisi
example.com, ini cocok denganexample.com.Jika daftar hitam berisi
a*b.example.com, ini cocok dengana<string apa saja>b.example.com.
Pencocokan akhiran tidak didukung.
Jika diatur ke off (default):
Pencocokan eksak tidak didukung.
Pencocokan akhiran didukung.
Jika daftar hitam berisi
example.com, ini cocok denganexample.comdan<string apa saja>.example.com.Jika daftar hitam berisi
a*b.example.com, ini cocok dengana<string apa saja>b.example.comdan<string apa saja>.a<string apa saja>b.example.com.
off
ignore_scheme
String
Tidak
Menentukan apakah akan mengabaikan skema. Jika diaktifkan, Referer dalam permintaan pengguna dianggap valid bahkan jika tidak menyertakan header protokol HTTP atau HTTPS. Contoh:
Jika diatur ke on, format Referer adalah:
referer: www.example.comJika diatur ke off (default), format Referer adalah:
referer: https://www.example.com
off
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "allow_empty", "argValue": "off" }, { "argName": "refer_domain_deny_list", "argValue": "example.aliyundoc.com,demo.aliyundoc.com" }], "functionName": "referer_black_list_set" }], "DomainNames": "example.com" }
aliauth
Deskripsi: Mengonfigurasi penandatanganan URL. Untuk informasi selengkapnya tentang cara mengonfigurasi fitur ini di konsol, lihat Konfigurasi penandatanganan URL.
ID Fungsi (FunctionID/FuncId): 25.
Parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
auth_m3u8
String
Tidak
Mengaktifkan penulisan ulang konten M3U8. Ini menambahkan parameter penandatanganan yang diperlukan ke file TS dalam file M3U8 untuk mencegah kegagalan akses. Nilai yang valid adalah on (default) dan off.
on
auth_type
String
Ya
Metode penandatanganan. Nilai yang valid:
no_auth: Tanpa penandatanganan.
type_a: penandatanganan tipe A.
type_b: penandatanganan tipe B.
type_c: signing tipe c.
type_f: Tipe penandatanganan F.
type_a
auth_key1
String
Ya
Kunci enkripsi 1. Kunci harus terdiri dari 16 hingga 128 karakter dan dapat berisi huruf besar, huruf kecil, dan angka.
1234567890123456789
auth_key2
String
Tidak
Kunci enkripsi 2. Kunci harus terdiri dari 16 hingga 128 karakter dan dapat berisi huruf besar, huruf kecil, dan angka.
1234567890123456789
ali_auth_delta
Integer
Tidak
Periode validitas URL yang ditandatangani. Nilai default: 1800. Satuan: detik.
1800
req_auth_ip_white
String
Tidak
Daftar putih IP. Alamat IP dalam daftar ini dibebaskan dari verifikasi penandatanganan.
Anda dapat memasukkan beberapa alamat IP. Pisahkan dengan koma (,).
192.168.0.1
req_auth_ip_acl_xfwd
String
Tidak
Metode untuk mengambil alamat IP klien untuk daftar putih. Nilai yang valid:
on: Ini adalah mode default. DCDN memverifikasi alamat IP pertama di sebelah kiri dalam header X-Forwarded-For permintaan pengguna. Alamat IP ini adalah alamat IP asal klien.
off: DCDN memverifikasi alamat IP yang digunakan untuk membuat koneksi antara klien dan titik kehadiran DCDN.
all: DCDN memverifikasi kedua alamat IP berikut:
Alamat IP pertama di sebelah kiri dalam header X-Forwarded-For permintaan pengguna, yaitu alamat IP asal klien.
Alamat IP yang digunakan untuk membuat koneksi antara klien dan titik kehadiran DCDN.
all
sign_param
String
Tidak
Nama parameter penandatanganan. Parameter ini hanya valid ketika `auth_type` diatur ke `type_f`.
sign
time_param
String
Tidak
Nama parameter timestamp. Parameter ini hanya valid ketika `auth_type` diatur ke `type_f`.
time
time_format
String
Tidak
Format timestamp. Parameter ini hanya valid ketika `auth_type` diatur ke `type_f`.
dec: desimal
hex: heksadesimal
hec
path_encoding
String
Tidak
Menentukan apakah akan mengaktifkan pengkodean URL. Nilai yang valid: on dan off. Parameter ini hanya valid ketika `auth_type` diatur ke `type_f`.
on
Contoh konfigurasi:
{ "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" }
cdn_remote_auth
Deskripsi: Mengonfigurasi autentikasi jarak jauh.
ID Fungsi (FunctionID/FuncId): 258.
Parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
enable
String
Ya
Menentukan apakah akan mengaktifkan autentikasi jarak jauh. Nilai yang valid:
Diaktifkan.
Off: Pemadaman.
on
remote_auth_addr
String
Ya
Alamat server otentikasi. Format:
https://dcdn.aliyun.com/authatauhttp://10.10.10.10/auth.https://example.aliyundoc.com/auth
remote_auth_method
String
Ya
Metode permintaan. Nilai yang valid: get, post, dan head.
get
remote_auth_type
String
Ya
Jenis file yang memerlukan autentikasi. `all` menunjukkan semua jenis file. Untuk menentukan beberapa jenis file, pisahkan dengan tanda pipa vertikal (|). Jenis file peka huruf besar/kecil. Misalnya, jpg tidak sama dengan JPG.
all
remote_auth_reserve_args
String
Ya
Parameter yang dipertahankan dalam permintaan. Untuk menentukan beberapa parameter, pisahkan dengan tanda pipa vertikal (|). Parameter tidak peka huruf besar/kecil. Misalnya, key sama dengan KEY.
all: Mempertahankan semua parameter.
ali_delete_all_args: Menghapus semua parameter URL.
all
remote_auth_custom_args
String
Tidak
Parameter kustom yang ditambahkan. Untuk menentukan beberapa parameter, pisahkan dengan tanda pipa vertikal (|). Parameter peka huruf besar/kecil. Misalnya, key tidak sama dengan KEY.
empty
remote_auth_reserve_header
String
Ya
Header permintaan yang dipertahankan. Untuk menentukan beberapa header, pisahkan dengan tanda pipa vertikal (|). Header tidak peka huruf besar/kecil. Misalnya, http_remote_addr sama 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 kustom yang ditambahkan. Untuk menentukan beberapa header, pisahkan dengan tanda pipa vertikal (|). Header tidak peka huruf besar/kecil. Misalnya, http_remote_addr sama dengan HTTP_Remote_Addr.
empty
remote_auth_success_code
Integer
Ya
Kode status untuk autentikasi berhasil. Ini adalah hasil yang dikembalikan server otentikasi ke DCDN setelah autentikasi berhasil. Contoh: 200. Anda dapat menentukan beberapa kode status. Pisahkan dengan koma (,).
200
remote_auth_fail_code
Integer
Ya
Kode status untuk autentikasi gagal. Ini adalah hasil yang dikembalikan server otentikasi ke DCDN setelah autentikasi gagal. Contoh: 403. Anda dapat menentukan beberapa kode status. Pisahkan dengan koma (,).
403,404
remote_auth_other_code_act
String
Tidak
Tindakan yang diambil DCDN pada permintaan pengguna jika kode status yang dikembalikan oleh server otentikasi bukan kode keberhasilan atau kegagalan. Nilai yang valid:
pass (default): Mengizinkan permintaan.
reject: Menolak permintaan.
pass
remote_auth_fail_resp_code
Integer
Ya
Kode status respons yang dikembalikan DCDN kepada pengguna setelah autentikasi gagal. Contoh: 403.
403
remote_auth_timeout
Integer
Ya
Periode waktu habis autentikasi. Satuan: ms. Nilai maksimum adalah 3000.
500
remote_auth_timeout_action
String
Ya
Tindakan yang diambil saat autentikasi habis waktu. Nilai yang valid:
pass: DCDN mengizinkan permintaan pengguna.
reject: DCDN mengembalikan `remote_auth_fail_resp_code` yang ditentukan kepada pengguna.
pass
Contoh konfigurasi:
{ "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: Mengonfigurasi daftar putih IP. Untuk informasi selengkapnya tentang cara mengonfigurasi fitur ini di konsol, lihat Konfigurasi daftar hitam dan daftar putih IP.
Konflik: Fitur daftar putih IP saling eksklusif dengan fitur daftar hitam IP (fungsi: ip_black_list_set, ID fungsi: 13). Anda hanya dapat mengaktifkan salah satunya. Jika salah satu fitur sudah dikonfigurasi, Anda harus menghapus konfigurasinya sebelum dapat mengonfigurasi yang lain. Fitur dianggap telah dikonfigurasi meskipun parameter switch-nya diatur ke `off`. Untuk menghapus konfigurasi tertentu untuk nama domain, Anda dapat memanggil operasi DeleteDcdnSpecificConfig.
ID Fungsi (FunctionID/FuncId): 69.
Parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
ip_list
String
Ya
Daftar IP. Pisahkan beberapa alamat IP atau blok CIDR dengan koma (,).
192.168.0.1/24
customize_response_status_code
String
Tidak
Kode status respons kustom. Nilai default kosong, yang menunjukkan bahwa kode status respons adalah 403. Anda dapat memasukkan angka 3 digit untuk mengatur kode status respons kustom.
429
ip_acl_xfwd
String
Tidak
Menentukan apakah akan menggunakan alamat IP dalam header X-Forwarded-For. Nilai yang valid:
on: Ini adalah nilai default. DCDN menggunakan alamat IP pertama di sebelah kiri dalam header
x-forwarded-forpermintaan pengguna untuk verifikasi.off: Menggunakan alamat
real client IP.all: DCDN menggunakan header
x-forwarded-fordanalamat IP koneksiuntuk verifikasi.
all
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "ip_list", "argValue": "192.168.0.1/24" }], "functionName": "ip_allow_list_set" }], "DomainNames": "example.com" }
ip_black_list_set
Deskripsi: Mengonfigurasi daftar hitam IP. Untuk informasi selengkapnya tentang cara mengonfigurasi fitur ini di konsol, lihat Konfigurasi daftar hitam dan daftar putih IP.
Konflik: Fitur daftar hitam IP saling eksklusif dengan fitur daftar putih IP (fungsi: ip_allow_list_set, ID fungsi: 69). Anda hanya dapat mengaktifkan salah satunya. Jika salah satu fitur sudah dikonfigurasi, Anda harus menghapus konfigurasinya sebelum dapat mengonfigurasi yang lain. Fitur dianggap telah dikonfigurasi meskipun parameter switch-nya diatur ke `off`. Untuk menghapus konfigurasi tertentu untuk nama domain, Anda dapat memanggil operasi DeleteDcdnSpecificConfig.
ID Fungsi (FunctionID/FuncId): 13.
Parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
ip_list
String
Ya
Daftar IP. Pisahkan beberapa alamat IP atau blok CIDR dengan koma (,).
192.168.0.1
customize_response_status_code
String
Tidak
Kode status respons kustom. Nilai default kosong, yang menunjukkan bahwa kode status respons adalah 403. Anda dapat memasukkan angka 3 digit untuk mengatur kode status respons kustom.
429
ip_acl_xfwd
String
Tidak
Menentukan apakah akan menggunakan alamat IP dalam header X-Forwarded-For. Nilai yang valid:
on: Ini adalah nilai default. DCDN menggunakan alamat IP pertama di sebelah kiri dalam header
x-forwarded-forpermintaan pengguna untuk verifikasi.Nonaktif: Menggunakan
alamat IP sumber yang sebenarnya.all: DCDN menggunakan header
x-forwarded-fordanalamat IP koneksiuntuk verifikasi.
all
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "ip_list", "argValue": "192.168.0.1" }], "functionName": "ip_black_list_set" }], "DomainNames": "example.com" }
ali_ua
Deskripsi: Mengonfigurasi kontrol akses berdasarkan header User-Agent. Untuk informasi selengkapnya tentang cara mengonfigurasi fitur ini di konsol, lihat Konfigurasi daftar hitam dan daftar putih User-Agent.
ID Fungsi (FunctionID/FuncId): 58.
Parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
ua
String
Ya
String User-Agent. Karakter wildcard (*) didukung untuk mencocokkan string apa pun. Untuk menentukan beberapa nilai, pisahkan dengan tanda pipa vertikal (|). Contoh:
*curl*|*IE*|*chrome*|*firefox*.*curl*|*IE*|*chrome*|*firefox*
type
String
Ya
Jenis daftar. Nilai yang valid:
black: daftar hitam.
white: daftar putih.
CatatanDaftar hitam dan daftar putih saling eksklusif. Hanya satu jenis yang dapat efektif pada satu waktu.
black
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "ua", "argValue": "*curl*|*IE*|*chrome*|*firefox*" }, { "argName": "type", "argValue": "black" }], "functionName": "ali_ua" }], "DomainNames": "example.com" }
Optimalisasi performa
tesla
Deskripsi fitur: Mengonfigurasi optimalisasi HTML untuk mempercepat pemuatan halaman. Untuk informasi selengkapnya, lihat Optimalisasi HTML.
ID Fungsi (FunctionID/FuncId): 16.
Parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
enable
String
Ya
Menentukan apakah akan mengaktifkan akselerasi untuk optimalisasi HTML.
on: Mengaktifkan fitur.
off: Menonaktifkan fitur.
on
trim_js
String
Tidak
Menentukan apakah akan mengoptimalkan kode JavaScript (JS) inline dalam HTML.
on: Mengaktifkan fitur.
off (default): Menonaktifkan optimalisasi.
off
trim_css
String
Tidak
Menentukan apakah akan mengoptimalkan kode Cascading Style Sheets (CSS) inline dalam HTML.
on: Mengaktifkan optimalisasi.
off (default): Status mati.
off
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "enable", "argValue": "on" }, { "argName": "trim_css", "argValue": "off" }, { "argName": "trim_js", "argValue": "off" }], "functionName": "tesla" }], "DomainNames": "example.com" }
gzip
Deskripsi fitur: Mengoptimalkan halaman menggunakan kompresi Gzip. Untuk informasi selengkapnya tentang fitur ini, lihat Kompresi gzip.
ID Fungsi (FunctionID/FuncId): 35.
Parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
enable
String
Ya
Menentukan apakah akan mengaktifkan optimalisasi Gzip untuk halaman.
on: Mengaktifkan fitur.
off: Menonaktifkan fitur.
on
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "enable", "argValue": "on" }], "functionName": "gzip" }], "DomainNames": "example.com" }
brotli
Deskripsi fitur: Mengonfigurasi kompresi Brotli untuk halaman. Untuk informasi selengkapnya tentang fitur ini, lihat Kompresi Brotli.
ID Fungsi (FunctionID/FuncId): 97.
Parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
enable
String
Ya
Menentukan apakah akan mengaktifkan kompresi Brotli untuk halaman.
on: Mengaktifkan fitur.
off: Menonaktifkan fitur.
on
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "enable", "argValue": "on" }], "functionName": "brotli" }], "DomainNames": "example.com" }
set_hashkey_args
Deskripsi fitur: Mengonfigurasi fitur untuk mengabaikan parameter URL dengan hanya mempertahankan parameter yang ditentukan. Untuk informasi selengkapnya tentang fitur ini, lihat Abaikan parameter.
Konflik fitur: Fitur Abaikan Parameter URL (Pertahankan) bertentangan dengan fitur Abaikan Parameter URL (Hapus) (fungsi: ali_remove_args, ID fungsi: 75). Anda hanya dapat mengaktifkan salah satu fitur ini pada satu waktu. Jika salah satu fitur sudah dikonfigurasi, Anda harus menghapus konfigurasinya sebelum dapat mengonfigurasi yang lain. Fitur dianggap telah dikonfigurasi meskipun parameter enable-nya diatur ke `off`. Untuk menghapus konfigurasi fitur untuk nama domain, Anda dapat memanggil operasi DeleteDcdnSpecificConfig.
ID Fungsi (FunctionID/FuncId): 19.
Parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
hashkey_args
String
Tidak
Daftar parameter yang dipertahankan. Pisahkan beberapa parameter dengan koma (,). Anda dapat menentukan hingga 10 parameter.
key1,key2
disable
String
Ya
Menentukan apakah akan mengabaikan semua parameter.
on: Mengabaikan semua parameter. Fitur menghapus, mempertahankan, dan mengubah parameter dinonaktifkan. Hanya fitur menambahkan parameter yang tetap efektif.
off (default): Menonaktifkan fitur. Fitur mempertahankan, menambahkan, dan menghapus parameter tetap efektif.
CatatanPrioritas mengabaikan semua parameter untuk kunci hash cache lebih rendah daripada prioritas mempertahankan daftar parameter cache.
on
keep_oss_args
String
Ya
Menentukan apakah akan mempertahankan parameter untuk permintaan pengambilan asal.
on: Mempertahankan semua parameter dalam permintaan pengambilan asal.
off: Parameter dalam permintaan pengambilan asal sama dengan parameter dalam kunci hash cache.
on
Contoh konfigurasi:
{ "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: Mengonfigurasi fitur untuk mengabaikan parameter URL dengan menghapus parameter yang ditentukan. Untuk informasi selengkapnya tentang fitur ini, lihat Abaikan parameter.
Konflik fitur: Fitur Abaikan Parameter URL (Hapus) bertentangan dengan fitur Abaikan Parameter URL (Pertahankan) (fungsi: set_hashkey_args, ID fungsi: 19). Anda hanya dapat mengaktifkan salah satu fitur ini pada satu waktu. Jika salah satu fitur sudah dikonfigurasi, Anda harus menghapus konfigurasinya sebelum dapat mengonfigurasi yang lain. Fitur dianggap telah dikonfigurasi meskipun parameter enable-nya diatur ke `off`. Untuk menghapus konfigurasi fitur untuk nama domain, Anda dapat memanggil operasi DeleteDcdnSpecificConfig.
ID Fungsi (FunctionID/FuncId): 75.
Parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
ali_remove_args
String
Ya
Parameter yang akan dihapus. Pisahkan beberapa parameter dengan spasi.
CatatanParameter yang tersisa digunakan sebagai argumen URL dalam kunci hash.
test
keep_oss_args
String
Ya
Menentukan apakah akan mempertahankan parameter untuk permintaan pengambilan asal.
on: Mempertahankan semua parameter dalam permintaan pengambilan asal.
off: Parameter dalam permintaan pengambilan asal sama dengan parameter dalam kunci hash cache.
off
Contoh konfigurasi:
{ "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 transformasi gambar DCDN. Untuk informasi selengkapnya tentang fitur ini, lihat Metode dan manfaat pengeditan gambar.
ID Fungsi (FunctionID/FuncId): 239.
Parameter:
Parameter
Type
Wajib
Deskripsi
Contoh
enable
String
Ya
Menentukan apakah akan mengaktifkan transformasi gambar.
on: Mengaktifkan fitur.
off: Menonaktifkan fitur.
on
filetype
String
Ya
Format gambar yang mendukung transkode. Pisahkan beberapa format dengan tanda pipa vertikal (|). Nilai berikut didukung:
JPEG: Format gambar JPEG.
JPG: Format gambar JPG.
PNG: Format gambar PNG.
WEBP: Format gambar WEBP.
BMP: Format gambar BMP.
GIF: Format gambar GIF.
TIFF: Format gambar TIFF.
JP2: Format gambar JPEG 2000.
jpg|jpeg|png
webp
String
Tidak
Menentukan apakah akan mengaktifkan konversi otomatis ke WebP.
on: Mengaktifkan konversi.
mati: Instans dimatikan.
on
orient
String
Tidak
Menentukan apakah akan mengaktifkan rotasi gambar otomatis.
on: Fitur diaktifkan.
off: Sumber daya dimatikan.
CatatanFitur ini hanya berfungsi untuk gambar yang memiliki properti rotasi.
on
slim
Integer
Tidak
Pelangsingan gambar. Atur persentase pelangsingan. Nilainya bisa dari 0 hingga 100. Fitur ini mengurangi kualitas gambar untuk menghemat lalu lintas tanpa mengubah resolusi, dimensi, atau format.
10
Contoh konfigurasi:
{ "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" }
Fitur video
range
Deskripsi fitur: Mengonfigurasi pengambilan asal range. Untuk informasi selengkapnya, lihat Konfigurasi Pengambilan Asal Range.
ID Fungsi: 31.
Parameter:
Parameter
Type
Wajib
Deskripsi
Contoh
enable
String
Ya
Menentukan apakah akan mengaktifkan pengambilan asal range.
on: Aktifkan.
off: Nonaktifkan.
force: Paksa aktifkan.
on
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "enable", "argValue": "on" }], "functionName": "range" }], "DomainNames": "example.com" }
video_seek
Deskripsi: Mengonfigurasi pencarian video. Untuk detail konfigurasi konsol, lihat Pencarian video.
ID Fungsi: 30.
Parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
enable
String
Ya
Menentukan apakah akan mengaktifkan pencarian video.
on: Aktifkan.
off: Nonaktifkan.
on
flv_seek_by_time
String
Tidak
Menentukan apakah akan mengaktifkan pencarian berdasarkan waktu untuk file FLV.
on: Aktifkan.
off: Nonaktifkan.
on
mp4_seek_start
String
Tidak
Parameter awal kustom untuk file MP4.
mp4starttime
mp4_seek_end
String
Tidak
Parameter akhir kustom untuk file MP4.
mp4endtime
flv_seek_start
String
Tidak
Parameter awal kustom untuk file FLV.
flvstarttime
flv_seek_end
String
Tidak
Parameter akhir kustom untuk file FLV.
flvendtime
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "enable", "argValue": "on" }], "functionName": "video_seek" }], "DomainNames": "example.com" }
ali_video_split
Deskripsi: Mengonfigurasi pemutaran audio saja.
ID Fungsi: 204.
Parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
enable
String
Ya
Menentukan apakah akan mengaktifkan pemutaran audio saja.
on: Aktifkan.
off: Nonaktifkan.
on
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "enable", "argValue": "on" }], "functionName": "ali_video_split" }], "DomainNames": "example.com" }
ali_video_preview
Deskripsi: Mengonfigurasi pratinjau video.
ID Fungsi: 205.
Parameter:
Parameter
Type
Wajib
Deskripsi
Contoh
enable
String
Ya
Menentukan apakah akan mengaktifkan pratinjau video.
on: Aktifkan.
off: Nonaktifkan.
CatatanAnda dapat menggunakan file TS dan MP3, serta menyeret dan melepas file FLV dan MP4.
on
ali_video_preview_argument
String
Ya
Nama parameter kustom untuk pratinjau video. Nilai parameter ini harus dalam satuan detik.
fds
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "enable", "argValue": "on" }, { "argName": "ali_video_preview_argument", "argValue": "fds" }], "functionName": "ali_video_preview" }], "DomainNames": "example.com" }
hls_token_rewrite
Deskripsi: Mengonfigurasi enkripsi dan penulisan ulang M3U8.
ID Fungsi: 253.
Parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
enable
String
Ya
Menentukan apakah akan mengaktifkan enkripsi dan penulisan ulang M3U8.
on: Aktifkan.
off: Nonaktifkan.
on
hls_token_arg_name
String
Tidak
Nama parameter kustom untuk token HLS. Jika Anda tidak mengatur parameter ini, MtsHlsUriToken digunakan sebagai nama parameter default.
example
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "enable", "argValue": "on" }], "functionName": "hls_token_rewrite" }], "DomainNames": "example.com", }
Konfigurasi keamanan
ddos_domain
Deskripsi fitur: Mengonfigurasi penjadwalan Anti-DDoS. Untuk informasi selengkapnya, lihat Pengaturan Mitigasi.
ID Fungsi (FuncId): 209.
Deskripsi parameter:
Parameter
Type
Wajib
Deskripsi
Contoh
enable
String
Ya
Menentukan apakah akan mengaktifkan perlindungan Anti-DDoS:
on: Aktifkan
off: Nonaktifkan
on
dispatch_qps
String
Tidak
Ambang batas permintaan per detik (QPS).
Rentang nilai: 2000 hingga 50000.
Nilai default: 20000.
20000
auto_dispatch
String
Tidak
Mengaktifkan pembersihan lalu lintas cerdas. Jika Anda mengaktifkan fitur ini, Anda tidak perlu menentukan ambang batas QPS. Sistem DCDN secara otomatis menentukan apakah akan mengaktifkan pola pembersihan lalu lintas.
on: Aktifkan
off: Nonaktifkan
on
checkurl
String
Ya
Jalur untuk pemeriksaan kesehatan di bawah nama domain.
Nilai default:
/(direktori root nama domain)./*/examplefile.txt
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "enable", "argValue": "on" }, { "argName": "dispatch_qps", "argValue": "20000" }, { "argName": "checkurl", "argValue": "/*/examplefile.txt" }], "functionName": "ddos_domain" }], "DomainNames": "example.com" }
ali_location
Fitur: Daftar hitam berdasarkan lokasi. Untuk informasi selengkapnya, lihat Konfigurasi daftar hitam berdasarkan wilayah.
ID Fungsi (FuncId): 57.
Parameter:
Parameter
Type
Wajib
Deskripsi
Nilai contoh
location
String
Ya
Menentukan wilayah tempat kebijakan pemblokiran berlaku. Nilainya dapat dalam salah satu format berikut:
Kode negara dua huruf kapital yang sesuai dengan standar ISO 3166. Untuk menentukan beberapa negara, pisahkan kode dengan spasi.
Anda dapat mengatur wilayah ke global.
global
type
String
Ya
Menentukan jenis kebijakan pemblokiran. Nilai yang valid:
black: Daftar hitam. Memblokir alamat IP klien dari wilayah yang ditentukan.
white: Daftar putih. Memblokir alamat IP klien dari semua wilayah kecuali yang ditentukan.
black
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "location", "argValue": "global" }, { "argName": "type", "argValue": "white" }], "functionName": "ali_location" }], "DomainNames": "example.com" }
Pembatasan laju
limit_rate
Deskripsi fitur: Mengonfigurasi batas laju untuk satu permintaan.
ID Fungsi: 72.
Deskripsi parameter:
Anda dapat mengonfigurasi batas laju tetap dengan `ali_limit_rate`, batas laju dinamis berdasarkan parameter dalam URL permintaan, atau batas laju berbasis waktu.
Untuk membatasi laju berdasarkan parameter dalam URL permintaan, gunakan parameter `traffic_limit_arg` dan `traffic_limit_unit` bersama-sama.
Untuk mengatur waktu mulai dan akhir pembatasan laju, gunakan parameter `ali_limit_start_hour` dan `ali_limit_end_hour` bersama-sama.
Parameter
Type
Wajib
Deskripsi
Nilai contoh
ali_limit_rate
String
Ya
Menentukan batas laju untuk satu permintaan. Nilainya adalah angka diikuti satuan. Satuan yang didukung adalah `k` untuk KByte/s dan `m` untuk MByte/s.
Nilai minimum adalah `100k`. Nilai kurang dari `100k` diproses sebagai `100k`.
`1m`: Mengatur batas laju untuk satu permintaan menjadi 1 MByte/s.
`100k`: Mengatur batas laju untuk satu permintaan menjadi 100 KByte/s.
ali_limit_rate_after
String
Tidak
Jumlah data yang dikirim sebelum pembatasan laju dimulai. Nilainya adalah angka diikuti satuan. Satuan yang didukung adalah `k` untuk KByte dan `m` untuk MByte.
1000
traffic_limit_arg
String
Tidak
Nama parameter pembatasan laju. Laju dibatasi berdasarkan argumen yang diambil dari URL. Misalnya, `rate`.
Jika permintaan tidak berisi parameter ini, batas laju default yang ditentukan oleh `ali_limit_rate` digunakan. Untuk menonaktifkan pembatasan laju saat parameter ini tidak ada dalam permintaan, atur `ali_limit_rate` ke `0k`.
rate
traffic_limit_unit
String
Tidak
Satuan untuk parameter `traffic_limit_arg`. Satuan yang didukung adalah `m` (MByte/s) dan `k` (KByte/s). Misalnya, jika parameter ini diatur ke `m` dan URL permintaan berisi `rate=1`, batas laju aktualnya adalah 1 MByte/s.
Nilai minimum adalah `100k`. Nilai kurang dari `100k` diproses sebagai `100k`.
m
ali_limit_start_hour
Integer
Tidak
Waktu mulai pembatasan laju. Nilainya harus bilangan bulat dari 0 hingga 24 dan harus kurang dari waktu akhir. Nilai default adalah 0.
CatatanIni merepresentasikan jam dalam format 24 jam. Misalnya, `0` merepresentasikan 00:00:00 dan `24` merepresentasikan 24:00:00.
20
ali_limit_end_hour
Integer
Tidak
Waktu akhir pembatasan laju. Nilainya harus bilangan bulat dari 0 hingga 24 dan harus lebih besar dari waktu mulai. Nilai default adalah 24.
23
Contoh konfigurasi 1: Mengatur batas laju untuk satu permintaan menjadi 1 MB/s.
{ "Functions": [{ "functionArgs": [{ "argName": "ali_limit_rate", "argValue": "1m" }], "functionName": "limit_rate" }], "DomainNames": "example.com" }Contoh konfigurasi 2: Batas laju default untuk satu permintaan adalah 1 MB/s. Jika URL permintaan berisi parameter `rate`, laju dibatasi berdasarkan nilai parameter tersebut. Misalnya, jika permintaan berisi `rate=200`, batas laju aktual menjadi 200 KB/s.
{ "Functions": [{ "functionArgs": [{ "argName": "ali_limit_rate", "argValue": "1m" },{ "argName": "traffic_limit_arg", "argValue": "rate" },{ "argName": "traffic_limit_unit", "argValue": "k" }], "functionName": "limit_rate" }], "DomainNames": "example.com" }
WebSocket
websocket
Deskripsi: Mengonfigurasi WebSocket. Untuk informasi selengkapnya, lihat Konfigurasi WebSocket.
ID Fungsi (FunctionID/FuncId): 144.
Deskripsi parameter:
Parameter
Tipe
Wajib
Deskripsi
Nilai contoh
enabled
String
Ya
Menentukan apakah akan mengaktifkan WebSocket.
on: Mengaktifkan fitur.
off: Menonaktifkan fitur.
on
origin_scheme
String
Tidak
Protokol untuk permintaan pengambilan asal WebSocket. Nilai yang valid:
http: WebSocket menggunakan HTTP untuk pengambilan asal.
https: WebSocket menggunakan HTTPS untuk pengambilan asal. Server asal harus mendukung port 443.
follow: WebSocket menggunakan protokol yang sama dengan permintaan klien. Server asal harus mendukung port 443 atau port 80.
CatatanJika Anda tidak mengatur parameter ini, nilai default adalah follow.
http
heartbeat
String
Tidak
Waktu habis koneksi.
Rentang nilai: 1 hingga 300
Satuan: detik
Nilai default: 60
60
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "enabled", "argValue": "on" }, { "argName": "origin_scheme", "argValue": "http" }, { "argName": "heartbeat", "argValue": "60" }], "functionName": "websocket" }], "DomainNames": "example.com" }
Akselerasi aplikasi IP
protogw
Deskripsi fitur: Mengonfigurasi akselerasi aplikasi IP. Untuk informasi selengkapnya, lihat Apa itu akselerasi aplikasi IP?.
ID Fungsi (FunctionID/FuncId): 163.
Parameter:
Parameter
Tipe
Wajib
Deskripsi
Contoh
realip
String
Ya
Menentukan protokol yang digunakan untuk meneruskan alamat IP asal klien. Nilai yang valid:
off: Status mati.
toa: Meneruskan alamat IP asal klien. Anda harus menginstal modul kernel TOA pada server asal. Tidak diperlukan modifikasi pada program layanan.
pp: Meneruskan alamat IP asal klien. Protokol ini didukung oleh Nginx open source secara default. Anda harus memastikan perangkat lunak server asal lainnya kompatibel.
toa
port
String
Ya
Port akselerasi.
CatatanAkselerasi tidak didukung pada port berikut: 22, 123, 161 hingga 162, 179, 830, 2049, 2601, 2605, 3389, 5049, 7547, 8082, 8087, 8182, 8888, 9998, 15772, 15776, 15778 hingga 15779, 18053, 18098 hingga 18099, 18888, 19313, 19777, dan 56667.
Untuk menambahkan port 80 atau 443, kirim tiket.
8443
mux
String
Tidak
Menentukan apakah akan mengaktifkan multiplexing untuk port. Nilai yang valid:
on: Aktif.
off: Mati.
off
Contoh konfigurasi:
{ "Functions": [{ "functionArgs": [{ "argName": "realip", "argValue": "toa" }, { "argName": "port", "argValue": "8443" }, { "argName": "mux", "argValue": "off" }], "functionName": "protogw" }], "DomainNames": "example.com" }
EdgeScript/Fungsi tepi
edge_function
Deskripsi: Mengonfigurasi EdgeScript. Untuk informasi selengkapnya, lihat Ikhtisar EdgeScript.
ID Fungsi (FunctionID atau FuncId): 180.
Deskripsi parameter:
Parameter
Type
Wajib
Deskripsi
Contoh
rule
String
Ya
Aturan DSL.
if eq($uri, '/') {\n rewrite('https://example.com/index.html', 'redirect')\n}
pri
Integer
Ya
Prioritas. Nilai yang valid: [0, 999]. Nilai yang lebih kecil menunjukkan prioritas yang lebih tinggi.
CatatanPrioritas untuk eksekusi header dan eksekusi footer bersifat independen satu sama lain.
0
enable
String
Ya
Menentukan apakah akan mengaktifkan aturan. Nilai yang valid:
on: Aturan diaktifkan.
off: Aturan dinonaktifkan.
on
name
String
Ya
Nama aturan. Hanya huruf dan garis bawah (_) yang didukung.
test
pos
String
Tidak
Posisi tempat aturan dieksekusi. Nilai yang valid:
head (default): Aturan dieksekusi di awal alur pemrosesan permintaan.
foot: Aturan dieksekusi di akhir alur pemrosesan permintaan.
head
brk
String
Tidak
Menentukan apakah akan memutus eksekusi. Nilai yang valid:
on: Jika aturan ini terkena, aturan yang tersisa pada posisi eksekusi saat ini dilewati.
off (default): Jika aturan ini terkena, aturan yang tersisa masih dieksekusi.
off
option
String
Tidak
Bidang ekstensi.
empty
grammar
String
Tidak
Sintaks aturan. Nilai yang valid: es2 (default) dan js.
/
jsmode
String
Tidak
Mode eksekusi JavaScript (JS). Nilai yang valid:
redirect: Mode Blok.
bypass (default): Mode bypass.
/
Contoh konfigurasi:
{ "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" }
EdgeRoutine
edgeroutine
Deskripsi: Mengonfigurasi EdgeRoutine. Untuk informasi selengkapnya, lihat Apa itu fungsi tepi?.
ID Fitur (FunctionID/FuncId): 275.
Fitur ini hanya tersedia berdasarkan permintaan. Untuk menggunakan fitur ini, Anda harus atau kirim tiket.
Mesin aturan
condition
Deskripsi fitur: Mesin aturan memungkinkan Anda mengonfigurasi berbagai aturan bersyarat. Aturan bersyarat mendeteksi parameter dalam permintaan pengguna untuk menentukan apakah konfigurasi berlaku untuk permintaan tertentu. Anda dapat menggunakan aturan ini untuk kontrol yang lebih fleksibel dan tepat atas cara kebijakan konfigurasi DCDN dieksekusi.
ID Fitur (FunctionID/FuncId): 250.
Deskripsi parameter:
Parameter
Tipe
Wajib
Deskripsi
Nilai contoh
rule
Array
Ya
Isi aturan bersyarat, termasuk namanya, status, operator logika, dan ekspresi bersyarat.
Isi aturan:
{\"match\":{\"logic\":\"and\",\"criteria\":[{\"matchType\":\"clientipVer\",\"matchObject\":\"CONNECTING_IP\",\"matchOperator\":\"equals\",\"matchValue\":\"v6\",\"negate\":false}]},\"name\":\"example\",\"status\":\"enable\"}Hasil:
Nama aturan: example
Status: enable
Operator logika: and
Ekspresi bersyarat: Versi protokol alamat IP klien yang terhubung adalah v6.
Tabel berikut menjelaskan format ekspresi bersyarat, yaitu format untuk `argValue`:
Parameter
Deskripsi
"match":
`match` menentukan ekspresi pencocokan bersyarat.
"logic":"and"
`logic` menentukan operator logika untuk ekspresi pencocokan bersyarat. Nilai yang valid adalah `and` dan `or`.
"criteria"
`criteria` menentukan isi ekspresi bersyarat.
"matchType":"clientipVer"
`matchType` menentukan jenis informasi dalam permintaan pengguna untuk dicocokkan.
"matchObject":"CONNECTING_IP"
`matchObject` lebih lanjut menentukan jenis pencocokan. Misalnya, alamat IP klien dapat ditentukan sebagai alamat IP yang terhubung atau alamat IP X-Forwarded-For (XFF).
"matchOperator":"equals"
`matchOperator` menentukan tindakan untuk operasi pencocokan.
"matchValue":"v6"
`matchValue` menentukan nilai preset untuk dicocokkan terhadap informasi dalam permintaan pengguna.
"negate":false
`negate` menentukan apakah akan meniadakan hasil ekspresi bersyarat. Nilai yang valid adalah `true` dan `false`.
"name":"example"
`name` menentukan nama aturan bersyarat.
"status":"enable"
`status` menentukan status aturan bersyarat.
Contoh konfigurasi:
Contoh berikut menunjukkan cara menggunakan OpenAPI untuk menambahkan konfigurasi mesin aturan untuk nama domain yang dipercepat
example.com. Konfigurasi ini mencocokkan dan memfilter permintaan berdasarkan apakah versi protokol IP klien adalah IPv6.{ "Functions": [{ "functionArgs": [{ "argName": "rule", "argValue": "{\"match\":{\"logic\":\"and\",\"criteria\":[{\"matchType\":\"clientipVer\",\"matchObject\":\"CONNECTING_IP\",\"matchOperator\":\"equals\",\"matchValue\":\"v6\",\"negate\":false}]},\"name\":\"example\",\"status\":\"enable\"}" }], "functionName": "condition" }], "DomainNames": "example.com" }Setelah Anda membuat konfigurasi mesin aturan, Anda dapat mengaitkannya dengan konfigurasi fitur lain. Hal ini memberikan kontrol yang lebih fleksibel dan tepat atas cara kebijakan konfigurasi DCDN dieksekusi.
Catatan:
Untuk merujuk konfigurasi mesin aturan dari fitur lain, atur parameter `parentid` ke `configid` aturan bersyarat. `configid` dihasilkan saat Anda menambahkan konfigurasi mesin aturan.
Parameter `parentid` tidak didukung saat fungsinya adalah `condition` (mesin aturan).
QUIC
iquic
Deskripsi: Mengonfigurasi protokol QUIC. Untuk informasi selengkapnya, lihat Apa itu QUIC?.
ID Fungsi: 281.
Parameter:
Parameter
Type
Wajib
Deskripsi
Nilai contoh
iquic_enable
String
Ya
Menentukan apakah akan mengaktifkan protokol QUIC:
on: Aktifkan
off: Nonaktifkan
onContoh konfigurasi
{ "Functions": [{ "functionArgs": [{ "argName": "iquic_enable", "argValue": "on" }], "functionName": "iquic" }], "DomainNames": "example.com" }