Konfigurasi fungsi dan parameter domain - CDN - Alibaba Cloud Documentation Center

Topik ini menjelaskan fitur dan parameter yang dapat Anda konfigurasikan saat memanggil operasi BatchSetCdnDomainConfig atau SetCdnDomainStagingConfig untuk mengonfigurasi fitur nama domain. Setiap fitur diidentifikasi oleh nama fungsi dan ID fungsi numerik, serta diteruskan sebagai elemen dalam array Functions pada badan permintaan.

Struktur permintaan

Saat memanggil BatchSetCdnDomainConfig (lingkungan produksi) atau SetCdnDomainStagingConfig (lingkungan staging) untuk mengonfigurasi fitur nama domain, badan permintaan berisi array Functions. Setiap elemen dalam array menentukan functionName serta satu atau beberapa functionArgs dalam bentuk pasangan kunci-nilai (argName dan argValue).

{
    "Functions": [{
        "functionArgs": [{
            "argName": "<parameter-name>",
            "argValue": "<parameter-value>"
        }],
        "functionName": "<feature-name>"
    }],
    "DomainNames": "example.com"
}

Catatan

Fitur yang dijelaskan dalam topik ini dapat dirujuk melalui operasi berikut: - Lingkungan produksi: BatchSetCdnDomainConfig, DescribeCdnDomainConfigs, BatchDeleteCdnDomainConfig, dan DescribeCdnUserDomainsByFunc.

Lingkungan staging: SetCdnDomainStagingConfig, DescribeCdnDomainStagingConfig, RollbackStagingConfig, dan PublishStagingConfigToProduction.

Pemanggilan BatchSetCdnDomainConfig atau SetCdnDomainStagingConfig menghasilkan ConfigId unik untuk konfigurasi tersebut. Anda dapat menggunakan ConfigId ini untuk memperbarui atau menghapus konfigurasi. Untuk informasi selengkapnya, lihat Catatan Penggunaan ConfigId.Beberapa fitur saling bertentangan. Hanya satu fitur dari pasangan yang bertentangan yang dapat dikonfigurasi dalam satu waktu. Pasangan yang bertentangan tercantum di bagian fitur terkait di bawah ini.

Konfigurasi jaringan

ipv6

Description: Mengonfigurasi akses IPv6.
Function ID: 194
Parameters:

Parameter	Type	Required	Description	Example
switch	String	Yes	Menentukan apakah akan mengaktifkan akses IPv6. Nilai yang valid: `on`, `off`.	on
region	String	Yes	Wilayah tempat IPv6 diaktifkan. Gunakan tanda bintang (`*`) untuk semua wilayah.	*

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "switch",
            "argValue": "on"
        }, {
            "argName": "region",
            "argValue": "*"
        }],
        "functionName": "ipv6"
    }],
    "DomainNames": "example.com"
}

Konfigurasi origin

set_req_host_header

Description: Mengonfigurasi host origin default.
Function ID: 18
Parameters:

Parameter	Type	Required	Description	Example
domain_name	String	Yes	Konten header host origin.	example.com

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "domain_name",
            "argValue": "example.com"
        }],
        "functionName": "set_req_host_header"
    }],
    "DomainNames": "example.com"
}

forward_scheme

Description: Mengonfigurasi protokol origin.
Function ID: 47
Parameters:

Parameter	Type	Required	Description	Example
enable	String	Yes	Menentukan apakah akan mengaktifkan fitur protokol origin. Nilai yang valid: `on`, `off`.	on
scheme_origin	String	No	Skema protokol untuk pengambilan asal. Nilai yang valid: `http`, `https`, `follow`. Nilai default: `follow`.	follow
scheme_origin_port	String	No	Port origin kustom. Diperlukan saat `scheme_origin` diatur ke `follow` (format: `httpPort:httpsPort`, contohnya, `80:443`).	80:443

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "enable",
            "argValue": "on"
        }, {
            "argName": "scheme_origin",
            "argValue": "follow"
        }, {
            "argName": "scheme_origin_port",
            "argValue": "80:443"
        }],
        "functionName": "forward_scheme"
    }],
    "DomainNames": "example.com"
}

l2_oss_key

Description: Mengonfigurasi pengambilan asal bucket OSS privat. Saat menggunakan fitur ini untuk pertama kalinya, Anda harus mengaktifkan kebijakan izin default yang memberikan CDN akses read-only ke semua bucket OSS di bawah Akun Alibaba Cloud yang sama.
Function ID: 85
Parameters:

Parameter	Type	Required	Description	Example
private_oss_auth	String	Yes	Menentukan apakah akan mengaktifkan pengambilan asal bucket OSS privat. Nilai yang valid: `on`, `off`. Saat diaktifkan, sistem secara otomatis mengonfigurasi token keamanan STS. Ini hanya mendukung pengambilan asal domain CDN ke bucket OSS privat di bawah Akun Alibaba Cloud yang sama.	on
perm_private_oss_tbl	String	No	Konfigurasi token keamanan permanen. Format: access_id=123 access_secret=123abc (dipisahkan dengan spasi). Saat dikonfigurasi, pengambilan asal domain CDN ke bucket OSS privat di bawah akun Alibaba Cloud lain juga didukung.	access_id=123 access_secret=123abc

Example:

{
    "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

Description: Mengonfigurasi daftar kunci privat origin OSS. Anda dapat mengonfigurasi satu atau beberapa aturan yang merepresentasikan bucket OSS privat berbeda beserta token keamanannya masing-masing.
Function ID: 183
Parameters:

Parameter	Type	Required	Description	Example
host	String	Yes	Alamat lengkap bucket OSS.	example.oss-cn-hangzhou.aliyuncs.com
key	String	Yes	Konfigurasi token keamanan permanen. Format: access_id=123 access_secret=123abc (dipisahkan dengan spasi).	access_id=123 access_secret=123abc

Example:

{
    "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

Description: Mengonfigurasi origin SNI (Server Name Indication).
Function ID: 114
Parameters:

Parameter	Type	Required	Description	Example
enabled	String	Yes	Menentukan apakah akan mengaktifkan origin SNI. Nilai yang valid: `on`, `off`.	on
https_origin_sni	String	Yes	Informasi SNI yang dibawa dalam permintaan origin (alamat server origin yang perlu diakses oleh permintaan).	origin.example.com

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "https_origin_sni",
            "argValue": "origin.example.com"
        }, {
            "argName": "enabled",
            "argValue": "on"
        }],
        "functionName": "https_origin_sni"
    }],
    "DomainNames": "example.com"
}

forward_timeout

Description: Mengonfigurasi timeout permintaan origin.
Function ID: 124
Parameters:

Parameter	Type	Required	Description	Example
forward_timeout	Integer	Yes	Timeout permintaan dalam detik. Kami merekomendasikan mengatur nilai kurang dari 100 detik.	30

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "forward_timeout",
            "argValue": "30"
        }],
        "functionName": "forward_timeout"
    }],
    "DomainNames": "example.com"
}

advanced_origin

Description: Mengonfigurasi pengambilan asal lanjutan, yang mengarahkan permintaan ke server origin berbeda berdasarkan variabel dalam permintaan pengguna (seperti URI, header, parameter kueri, atau cookie).
Function ID: 235
Conflict: Bertentangan dengan origin_dns_host (Function ID: 212). Hanya satu yang dapat dikonfigurasi. Jika salah satu fitur sudah dikonfigurasi (termasuk saat parameter switch-nya diatur ke off), Anda harus menghapus konfigurasi yang ada sebelum mengonfigurasi yang lain.
Parameters:

Parameter	Type	Required	Description	Example
variable_type	String	Yes	Jenis variabel. Nilai yang valid: `header` (header permintaan), `arg` (parameter string kueri), `uri` (path permintaan), `cookie` (cookie permintaan).	uri
variable	String	Yes	Nama variabel. Saat variable_type diatur ke uri, variabel harus diatur ke uri.	uri
conditions	String	Yes	Operator kondisi. Nilai yang valid: == (sama dengan), != (tidak sama dengan).	==
value	String	Yes	Nilai variabel yang akan dicocokkan.	/image
origin	String	Yes	Nama domain server origin yang digunakan saat variabel cocok dengan nilai yang ditentukan.	origin.example.com

Example:

{
    "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

Description: Mengonfigurasi pengikutan redirect 302 origin.
Function ID: 219
Parameters:

Parameter	Type	Required	Description	Example
enable	String	Yes	Menentukan apakah akan mengaktifkan pengikutan redirect 302 origin. Nilai yang valid: `on`, `off`.	on
max_tries	Integer	No	Jumlah maksimum redirect 302 yang diikuti. Nilai default: 2. Nilai yang valid: 1-5. Jumlah maksimum permintaan origin aktual adalah max_tries + 1.	2
retain_args	String	No	Menentukan apakah akan mempertahankan parameter permintaan asli saat mengikuti redirect 302. Nilai yang valid: `on`, `off` (default).	off
retain_header	String	No	Menentukan apakah akan mempertahankan header permintaan asli saat mengikuti redirect 302. Nilai yang valid: `on`, `off` (default).	off
response_header	String	No	Nama header respons untuk redirect 302. Nilai default: Location.	X-Alicdn-Redirect
retain_host	String	No	Menentukan apakah akan mempertahankan host origin saat mengikuti redirect 302. Nilai yang valid: `on`, `off` (default).	off
modify_host	String	No	Memodifikasi host origin saat mengikuti redirect 302. Secara default, host origin tidak dimodifikasi.	example.com
cache	String	No	Menentukan apakah akan menyimpan hasil redirect 302 untuk URL yang sama guna meningkatkan performa respons CDN. Nilai yang valid: `on`, `off` (default).	off
expired_time	Integer	No	Waktu kedaluwarsa cache untuk hasil redirect 302, dalam detik. Harus digunakan bersama parameter cache. Nilai default: 3600.	7200
follow_origin_host	String	No	Menentukan apakah akan menggunakan nama domain server origin sebagai host origin (menggunakan domain origin terbaru bahkan setelah switching primary/standby). Nilai yang valid: `on`, `off` (default).	off
follow_5xx_retry_origin	String	No	Menentukan apakah akan beralih ke server origin berikutnya yang tersedia saat server origin saat ini merespons dengan kode status 5xx. Nilai yang valid: `on`, `off` (default).	off

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "enable",
            "argValue": "on"
        }, {
            "argName": "max_tries",
            "argValue": "2"
        }, {
            "argName": "retain_args",
            "argValue": "off"
        }, {
            "argName": "retain_header",
            "argValue": "off"
        }],
        "functionName": "follow_302"
    }],
    "DomainNames": "example.com"
}

set_req_header

Description: Mengonfigurasi header permintaan HTTP origin kustom (v1). Kami merekomendasikan menggunakan versi v2: origin_request_header, yang mendukung lebih banyak fitur.
Function ID: 39
Parameters:

Parameter	Type	Required	Description	Example
key	String	Yes	Nama header permintaan origin.	Accept-Encoding
value	String	Yes	Nilai header permintaan origin. Untuk menghapus header, atur nilainya ke null.	gzip

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "value",
            "argValue": "gzip"
        }, {
            "argName": "key",
            "argValue": "Accept-Encoding"
        }],
        "functionName": "set_req_header"
    }],
    "DomainNames": "example.com"
}

origin_request_header

Description: Mengonfigurasi header permintaan HTTP origin kustom (v2). Mendukung operasi tambah, hapus, modifikasi, dan tulis ulang.
Function ID: 228
Parameters:

Parameter	Type	Required	Description	Example
header_operation_type	String	Yes	Jenis operasi header. Nilai yang valid: `add`, `delete`, `modify`, `rewrite`.	add
header_name	String	Yes	Nama header permintaan.	Accept-Encoding
header_value	String	No	Nilai header permintaan. Beberapa nilai dapat dipisahkan dengan koma (,).	gzip
duplicate	String	No	Menentukan apakah akan mengizinkan header duplikat dengan nama yang sama (saat menggunakan operasi add). Nilai yang valid: `on`, `off`.	off
header_source	String	No	Nilai yang akan dicari untuk penggantian (saat menggunakan operasi rewrite). Mendukung ekspresi reguler.	value1
header_destination	String	No	Nilai pengganti (saat menggunakan operasi rewrite).	value123
match_all	String	No	Mode pencocokan (saat menggunakan operasi rewrite). Nilai yang valid: `on` (mengganti semua kecocokan), `off` (mengganti hanya kecocokan pertama).	off

Example:

{
    "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

Description: Mengonfigurasi header respons HTTP origin. Mendukung operasi tambah, hapus, modifikasi, dan tulis ulang.
Function ID: 229
Parameters:

Parameter	Type	Required	Description	Example
header_operation_type	String	Yes	Jenis operasi header respons. Nilai yang valid: `add`, `delete`, `modify`, `rewrite`.	add
header_name	String	Yes	Nama header respons.	Cache-Control
header_value	String	No	Nilai header respons. Beberapa nilai dapat dipisahkan dengan koma (,).	no-cache
duplicate	String	No	Menentukan apakah akan mengizinkan header duplikat dengan nama yang sama (saat menggunakan operasi add). Nilai yang valid: `on`, `off`.	off
header_source	String	No	Nilai yang akan dicari untuk penggantian (saat menggunakan operasi rewrite). Mendukung ekspresi reguler.	value1
header_destination	String	No	Nilai pengganti (saat menggunakan operasi rewrite).	value123
match_all	String	No	Mode pencocokan (saat menggunakan operasi rewrite). Nilai yang valid: `on` (mengganti semua kecocokan), `off` (mengganti hanya kecocokan pertama).	off

Example:

{
    "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

Description: Mengonfigurasi penulisan ulang URI origin.
Function ID: 225
Parameters:

Parameter	Type	Required	Description	Example
source_url	String	Yes	URI yang akan ditulis ulang.	^/hello$
target_url	String	Yes	URI target setelah penulisan ulang.	/hello/test
flag	String	No	Aturan eksekusi untuk operasi penulisan ulang. Nilai yang valid: (kosong, default) melanjutkan pencocokan aturan penulisan ulang berikutnya setelah eksekusi; break: menghentikan pencocokan aturan berikutnya setelah eksekusi; enhance_break: mirip dengan break tetapi memproses parameter bersama dan juga berfungsi untuk streaming langsung FLV.	break
sequence	Integer	No	Mengatur prioritas eksekusi konfigurasi. Nilai yang valid: 1 hingga 99. Nilai yang lebih kecil menunjukkan prioritas yang lebih tinggi. Jika parameter ini tidak ditentukan, prioritas ditetapkan secara otomatis secara berurutan mulai dari 1.	1

Example:

{
    "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

Description: Mengonfigurasi penulisan ulang argumen origin. Menulis ulang parameter kueri dalam URL permintaan origin. Mendukung konfigurasi beberapa aturan penulisan ulang. Prioritas operasi: add > delete > keep > modify.
Function ID: 224
Parameters:

Parameter	Type	Required	Description	Example
delete_argument	String	No	Argumen yang akan dihapus, dipisahkan dengan spasi.	code1
save_argument	String	No	Argumen yang akan dipertahankan, dipisahkan dengan spasi. Hanya argumen yang tercantum yang dipertahankan. Operasi add dan delete tetap berlaku.	(empty)
ignore_all_argument	String	No	Menentukan apakah akan mengabaikan semua argumen. Nilai yang valid: `on` (mengabaikan semua argumen; hanya operasi add yang tetap efektif), `off` (default).	on
add_argument	String	No	Argumen yang akan ditambahkan (prioritas tertinggi), dipisahkan dengan spasi.	value=123
modify_argument	String	No	Argumen yang akan dimodifikasi (prioritas terendah), dipisahkan dengan spasi. Jika suatu argumen dihapus, argumen tersebut tidak akan dipertahankan.	value=321
enable	String	Yes	Menentukan apakah akan mengaktifkan penulisan ulang argumen origin. Nilai yang valid: `on`, `off`.	on

Example:

{
    "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

Description: Mengonfigurasi pengambilan asal bucket Amazon S3 terotentikasi.
Function ID: 186
Parameters:

Parameter	Type	Required	Description	Example
enabled	String	Yes	Menentukan apakah akan mengaktifkan bucket Amazon S3 terotentikasi. Nilai yang valid: `l2` (aktifkan), `off` (nonaktifkan).	l2
bucketname	String	No	Nama bucket Amazon S3.	/
accesskey	String	Yes	AWS AccessKey.	123456789
secretkey	String	Yes	AWS SecretKey.	12345678
region	String	Yes	Wilayah penyimpanan Amazon S3.	us-east-2

Example:

{
    "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

Description: Mengonfigurasi verifikasi sertifikat origin (daftar putih SNI).
Function ID: 223
Parameters:

Parameter	Type	Required	Description	Example
enabled	String	Yes	Menentukan apakah akan mengaktifkan verifikasi sertifikat origin. Nilai yang valid: `on`, `off`.	on
common_name_whitelist	String	No	Nama domain daftar putih sertifikat, dipisahkan dengan koma (,). Sertifikat yang cocok dengan domain dalam daftar putih ini lolos verifikasi.	example.com

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "enable",
            "argValue": "on"
        }, {
            "argName": "common_name_whitelist",
            "argValue": "example.com"
        }],
        "functionName": "origin_certificate_verification"
    }],
    "DomainNames": "example.com"
}

origin_dns_host

Description: Mengonfigurasi server origin bersyarat. Bekerja dengan fitur mesin aturan (condition, Function ID: 250) untuk mengarahkan permintaan ke server origin tertentu berdasarkan path, parameter URL, header permintaan, dan informasi lainnya. Sebelum mengonfigurasi, Anda harus terlebih dahulu membuat minimal satu kondisi mesin aturan.
Function ID: 212
Conflict: Bertentangan dengan advanced_origin (Function ID: 235). Hanya satu yang dapat dikonfigurasi. Jika salah satu fitur sudah dikonfigurasi (termasuk saat parameter switch-nya diatur ke off), Anda harus menghapus konfigurasi yang ada sebelum mengonfigurasi yang lain.
Parameters:

Parameter	Type	Required	Description	Example
ali_origin_dns_host	String	Yes	Nama domain yang digunakan untuk resolusi DNS origin.	example.com

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "ali_origin_dns_host",
            "argValue": "example.com"
        }],
        "functionName": "origin_dns_host",
        "parentId": 30119730104
    }],
    "DomainNames": "example.com"
}

origin_host

Description: Mengonfigurasi host origin untuk server origin tertentu.
Function ID: 242
Parameters:

Parameter	Type	Required	Description	Example
origin	String	Yes	Alamat server origin. Atur ke all untuk menerapkan ke semua server origin.	example.com
host	String	Yes	Nilai header host. Atur ke ali_follow_origin untuk menggunakan alamat server origin sebagai nilai host.	host.example.com

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "origin",
            "argValue": "example.com"
        }, {
            "argName": "host",
            "argValue": "host.example.com"
        }],
        "functionName": "origin_host"
    }],
    "DomainNames": "example.com"
}

ali_origin_port_scheme

Description: Mengonfigurasi port dan protokol origin.
Function ID: 276
Parameters:

Parameter	Type	Required	Description	Example
port	String	Yes	Port origin. Saat scheme diatur ke follow, gunakan format http:80\|https:443.	80
scheme	String	Yes	Protokol origin. Nilai yang valid: `http`, `https`, `follow` (mengikuti protokol klien), `https_sm` (HTTPS dengan algoritma kriptografi nasional Tiongkok), `follow_sm` (mengikuti protokol klien, mendukung algoritma kriptografi internasional dan nasional).	http

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "port",
            "argValue": "80"
        }, {
            "argName": "scheme",
            "argValue": "http"
        }],
        "functionName": "ali_origin_port_scheme"
    }],
    "DomainNames": "example.com"
}

origin_sni

Description: Mengonfigurasi origin SNI untuk server origin tertentu.
Function ID: 262
Parameters:

Parameter	Type	Required	Description	Example
origin	String	Yes	Alamat server origin. Atur ke all untuk menerapkan ke semua server origin.	example.com
sni_host	String	Yes	Nilai host SNI. Dapat berupa nilai tetap, ali_follow_origin (mengikuti alamat server origin), atau ali_follow_host (mengikuti host origin).	example.org
keepalive_sni	String	No	Menentukan apakah akan mengaktifkan pencocokan keepalive SNI. Nilai yang valid: `on`, `off`. Saat diaktifkan, nilai origin SNI yang berbeda menggunakan koneksi keepalive terpisah.	off

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "origin",
            "argValue": "origin.example.com"
        }, {
            "argName": "sni_host",
            "argValue": "host.example.com"
        }],
        "functionName": "origin_sni"
    }],
    "DomainNames": "example.com"
}

source_group

Description: Mengonfigurasi grup server origin.
Function ID: 294
Parameters:

Parameter	Type	Required	Description	Example
source_group_name	String	Yes	Nama grup server origin. Mendukung huruf kecil, angka, dan garis bawah. Panjang maksimum: 128 byte.	example_origin
source_info	String	Yes	Informasi server origin dalam format: address_priority_weight_port. Pisahkan beberapa server origin dengan koma (,). Prioritas: 1-65535 (nilai lebih rendah = prioritas lebih tinggi). Bobot: 1-100. Port: 1-65535.	192.168.0.1_10_33_80,192.0.2.1_10_67_80
retry_times	Integer	No	Jumlah upaya pengambilan origin ulang.	3
retry_status_rule	Integer	No	Kode status pengulangan. Nilai yang didukung: 4xx, 5xx, 404, 404-or-5xx, 4xx-or-5xx.	404-or-5xx
failback_source	String	No	Menentukan apakah akan kembali ke konfigurasi server origin dasar saat semua server dalam grup tidak tersedia. Nilai yang valid: `on`, `off`.	on

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "source_group_name",
            "argValue": "test_origin"
        }, {
            "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-or-5xx"
        }, {
            "argName": "failback_source",
            "argValue": "on"
        }],
        "functionName": "source_group"
    }],
    "DomainNames": "example.com"
}

ipv6_origin

Description: Mengonfigurasi pengambilan asal IPv6.
Function ID: 265
Parameters:

Parameter	Type	Required	Description	Example
enable	String	Yes	Menentukan apakah akan mengaktifkan pengambilan asal IPv6. Nilai yang valid: `on`, `off`. Saat diaktifkan, CDN menggunakan IPv6 untuk koneksi origin saat node CDN dan server origin memiliki alamat IPv6 yang tersedia.	on
follow	String	Yes	Menentukan apakah akan mengikuti versi protokol IP klien untuk pengambilan asal. Nilai yang valid: `on`, `off`. Saat diaktifkan, CDN mengikuti protokol permintaan klien: permintaan klien IPv6 lebih memilih server origin IPv6; permintaan klien IPv4 lebih memilih server origin IPv4.	on
ipv6_v4_mix_used	String	No	Menentukan apakah akan mengaktifkan pengambilan asal IPv4/IPv6 round-robin. Nilai yang valid: `on`, `off`. Saat diaktifkan, fitur origin IPv6 dan follow menjadi tidak efektif. Semua permintaan menggunakan round-robin di semua alamat origin terlepas dari protokol klien.	off

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "enable",
            "argValue": "on"
        }, {
            "argName": "follow",
            "argValue": "on"
        }],
        "functionName": "ipv6_origin"
    }],
    "DomainNames": "example.com"
}

cos_auth

Description: Mengonfigurasi pengambilan asal bucket Tencent Cloud COS terotentikasi.
Function ID: 288
Parameters:

Parameter	Type	Required	Description	Example
enable	String	Yes	Menentukan apakah akan mengaktifkan bucket Tencent Cloud COS terotentikasi. Nilai yang valid: `on`, `off`.	on
cos_valid_period	String	No	Periode validitas tanda tangan otentikasi dalam detik. Nilai default: 3600.	3600
cos_secret_id	String	Yes	ID otentikasi Tencent Cloud.	123456789
cos_secret_key	String	Yes	Kunci otentikasi Tencent Cloud.	12345678

Example:

{
    "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

Description: Mengonfigurasi informasi bucket otentikasi OSS yang digunakan CDN untuk pengambilan asal. Konfigurasi ini ditambahkan secara otomatis saat Anda mengonfigurasi server origin tipe OSS untuk nama domain yang dipercepat. Jangan menghapus konfigurasi ini secara manual karena dapat menyebabkan masalah penagihan untuk traffic origin CDN dan kegagalan otentikasi untuk akses bucket privat.
Function ID: 10
Parameters:

Parameter	Type	Required	Description	Example
oss_bucket_id	String	Yes	Titik akhir publik bucket OSS.	cdn-test.oss-cn-hongkong.aliyuncs.com
oss_pri_buckets	String	Yes	Titik akhir publik bucket OSS dan nama bucket-nya yang sesuai, dipisahkan dengan tanda pipa (\|).	cdn-test.oss-cn-hongkong.aliyuncs.com\|cdn-test

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "oss_bucket_id",
            "argValue": "cdn-test.oss-cn-hongkong.aliyuncs.com"
        }, {
            "argName": "oss_pri_buckets",
            "argValue": "cdn-test.oss-cn-hongkong.aliyuncs.com|cdn-test"
        }],
        "functionName": "oss_auth"
    }],
    "DomainNames": "example.com"
}

Kontrol akses

referer_white_list_set

Description: Mengonfigurasi daftar putih Referer.
Function ID: 1
Conflict: Bertentangan dengan referer_black_list_set (Function ID: 5). Hanya satu yang dapat dikonfigurasi.
Parameters:

Parameter	Type	Required	Description	Example
refer_domain_allow_list	String	Yes	Daftar domain Referer yang diizinkan, dipisahkan dengan koma (`,`).	example.aliyundoc.com,demo.aliyundoc.com
allow_empty	String	No	Menentukan apakah akan mengizinkan field Referer kosong. Nilai yang valid: `on`, `off` (default).	off
redirect_url	String	No	URL pengalihan untuk permintaan yang tidak cocok (harus dimulai dengan `http://` atau `https://`).	http://www.example.com
disable_ast	String	No	Mode pencocokan eksak. Nilai yang valid: `on` (pencocokan eksak), `off` (pencocokan sufiks, default).	off
ignore_scheme	String	No	Menentukan apakah akan mengabaikan skema HTTP atau HTTPS dalam Referer. Nilai yang valid: `on`, `off` (default).	off

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "refer_domain_allow_list",
            "argValue": "example.aliyundoc.com,demo.aliyundoc.com"
        }],
        "functionName": "referer_white_list_set"
    }],
    "DomainNames": "example.com"
}

referer_black_list_set

Description: Mengonfigurasi daftar hitam Referer.
Function ID: 5
Conflict: Bertentangan dengan referer_white_list_set (Function ID: 1). Hanya satu yang dapat dikonfigurasi.
Parameters:

Parameter	Type	Required	Description	Example
refer_domain_deny_list	String	Yes	Daftar domain Referer yang diblokir, dipisahkan dengan koma (`,`).	example.aliyundoc.com,demo.aliyundoc.com
allow_empty	String	No	Menentukan apakah akan mengizinkan field Referer kosong. Nilai yang valid: `on`, `off`.	off
redirect_url	String	No	URL pengalihan untuk permintaan yang cocok.	http://www.example.com
disable_ast	String	No	Mode pencocokan eksak. Nilai yang valid: `on` (pencocokan eksak), `off` (pencocokan sufiks, default).	off
ignore_scheme	String	No	Menentukan apakah akan mengabaikan skema HTTP atau HTTPS dalam Referer. Nilai yang valid: `on`, `off` (default).	off

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "refer_domain_deny_list",
            "argValue": "example.aliyundoc.com,demo.aliyundoc.com"
        }],
        "functionName": "referer_black_list_set"
    }],
    "DomainNames": "example.com"
}

ip_allow_list_set

Description: Mengonfigurasi daftar putih IP.
Function ID: 69
Conflict: Bertentangan dengan ip_black_list_set (Function ID: 13). Hanya satu yang dapat dikonfigurasi.
Parameters:

Parameter	Type	Required	Description	Example
ip_list	String	Yes	Daftar alamat IP atau blok CIDR, dipisahkan dengan koma (`,`). Anda dapat mengonfigurasi hingga 700 alamat IPv6 atau 2.000 alamat IPv4. Panjang total string alamat IP tidak boleh melebihi 30 KB. Blok CIDR didukung (misalnya, `127.0.0.0/24`). Huruf besar/kecil tidak signifikan dalam alamat IPv6. Singkatan `::` tidak didukung.	192.168.0.1/24
customize_response_status_code	String	No	Kode status respons kustom. Nilai default: `403`.	429
ip_acl_xfwd	String	No	Mode pencocokan IP. Nilai yang valid: `on` (gunakan header X-Forwarded-For, default), `off` (gunakan IP koneksi TCP), `all` (gunakan keduanya).	all
ip_list_notes	String	No	Catatan untuk daftar IP.	192.x.x.1 (IP berbahaya)

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "ip_list",
            "argValue": "192.168.0.1/24"
        }],
        "functionName": "ip_allow_list_set"
    }],
    "DomainNames": "example.com"
}

ip_black_list_set

Description: Mengonfigurasi daftar hitam IP.
Function ID: 13
Conflict: Bertentangan dengan ip_allow_list_set (Function ID: 69). Hanya satu yang dapat dikonfigurasi.
Parameters:

Parameter	Type	Required	Description	Example
ip_list	String	Yes	Daftar alamat IP atau blok CIDR, dipisahkan dengan koma (`,`). Anda dapat mengonfigurasi hingga 700 alamat IPv6 atau 2.000 alamat IPv4. Panjang total string alamat IP tidak boleh melebihi 30 KB. Blok CIDR didukung (misalnya, `127.0.0.0/24`). Huruf besar/kecil tidak signifikan dalam alamat IPv6. Singkatan `::` tidak didukung.	192.168.0.1
customize_response_status_code	String	No	Kode status respons kustom. Nilai default: `403`.	429
ip_acl_xfwd	String	No	Mode pencocokan IP. Nilai yang valid: `on` (gunakan header X-Forwarded-For, default), `off` (gunakan IP koneksi TCP), `all` (gunakan keduanya).	all
ip_list_notes	String	No	Catatan untuk daftar IP.	192.x.x.1 (IP berbahaya)

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "ip_list",
            "argValue": "192.168.0.1"
        }],
        "functionName": "ip_black_list_set"
    }],
    "DomainNames": "example.com"
}

aliauth

Description: Mengonfigurasi otentikasi URL.
Function ID: 25
Parameters:

Parameter	Type	Required	Description	Example
auth_m3u8	String	No	Mengaktifkan penulisan ulang konten m3u8. Saat diaktifkan, parameter otentikasi ditambahkan ke segmen TS dalam file m3u8 untuk mencegah kegagalan otentikasi akses TS. Nilai yang valid: `on` (default), `off`.	on
auth_type	String	Yes	Jenis otentikasi. Nilai yang valid: `no_auth`, `type_a`, `type_b`, `type_c`, `type_d`, `type_e`, `type_f`. Untuk detail tentang setiap jenis, lihat dokumentasi otentikasi URL.	type_a
auth_key1	String	Yes	Kunci otentikasi 1 (16-128 karakter, hanya huruf dan angka).	1234567890123456789
auth_key2	String	No	Kunci otentikasi 2 (16-128 karakter, hanya huruf dan angka).	1234567890123456789
ali_auth_delta	Integer	No	Durasi valid URL terotentikasi, dalam detik. Nilai default: `1800`.	1800
req_auth_ip_white	String	No	Alamat IP daftar putih yang dikecualikan dari otentikasi. Pisahkan beberapa alamat IP dengan koma (,).	192.168.0.1
req_auth_ip_acl_xfwd	String	No	Metode untuk mengekstrak IP klien untuk pengecualian daftar putih. Nilai yang valid: `on` (default, menggunakan IP pertama dari header X-Forwarded-For), `off` (menggunakan IP koneksi TCP), `all` (menggunakan keduanya).	all
sign_param	String	No	Nama parameter sign. Hanya valid saat auth_type diatur ke type_f.	sign
time_param	String	No	Nama parameter timestamp. Hanya valid saat auth_type diatur ke type_f.	time
time_format	String	No	Format timestamp. Hanya valid saat auth_type diatur ke type_f. Nilai yang valid: `dec` (desimal), `hex` (heksadesimal).	hex
path_encoding	String	No	Menentukan apakah akan mengaktifkan encoding URL. Hanya valid saat auth_type diatur ke type_f. Nilai yang valid: `on`, `off`.	on

Example 1 (Jenis otentikasi A):

{
    "Functions": [{
        "functionArgs": [{
            "argName": "auth_type",
            "argValue": "type_a"
        }, {
            "argName": "auth_key1",
            "argValue": "1234567890123456789"
        }, {
            "argName": "auth_key2",
            "argValue": "1234567890123456789"
        }, {
            "argName": "ali_auth_delta",
            "argValue": 1800
        }, {
            "argName": "req_auth_ip_white",
            "argValue": "192.168.0.1"
        }, {
            "argName": "req_auth_ip_acl_xfwd",
            "argValue": "all"
        }],
        "functionName": "aliauth"
    }],
    "DomainNames": "example.com"
}

Example 2 (Jenis otentikasi F):

{
    "Functions": [{
        "functionArgs": [{
            "argName": "auth_type",
            "argValue": "type_f"
        }, {
            "argName": "auth_key1",
            "argValue": "1234567890123456789"
        }, {
            "argName": "auth_key2",
            "argValue": "1234567890123456789"
        }, {
            "argName": "ali_auth_delta",
            "argValue": 1800
        }, {
            "argName": "sign_param",
            "argValue": "sign"
        }, {
            "argName": "time_param",
            "argValue": "time"
        }, {
            "argName": "time_format",
            "argValue": "hex"
        }, {
            "argName": "path_encoding",
            "argValue": "on"
        }],
        "functionName": "aliauth"
    }],
    "DomainNames": "example.com"
}

cdn_remote_auth

Description: Mengonfigurasi otentikasi jarak jauh.
Function ID: 258
Parameters:

Parameter	Type	Required	Description	Example
enable	String	Yes	Menentukan apakah akan mengaktifkan otentikasi jarak jauh. Nilai yang valid: `on`, `off`.	on
remote_auth_addr	String	Yes	Alamat server otentikasi. Format: https://cdn.aliyun.com/auth atau http://10.10.10.10/auth.	https://example.aliyundoc.com/auth
remote_auth_method	String	Yes	Metode permintaan. Nilai yang valid: GET, POST, HEAD.	get
remote_auth_type	String	Yes	Jenis file yang diautentikasi. Atur ke all untuk semua jenis. Beberapa jenis dipisahkan dengan tanda pipa (\|), case-sensitive.	all
remote_auth_reserve_args	String	Yes	Parameter permintaan yang disimpan, dipisahkan dengan tanda pipa (\|), case-insensitive. Atur ke all untuk menyimpan semua parameter, atau ali_delete_all_args untuk menghapus semua parameter URL.	all
remote_auth_custom_args	String	No	Parameter kustom yang akan ditambahkan, dipisahkan dengan tanda pipa (\|), case-sensitive.	(empty)
remote_auth_reserve_header	String	Yes	Header permintaan yang disimpan, dipisahkan dengan tanda pipa (\|), case-insensitive. Atur ke all untuk menyimpan semua header, atau ali_delete_all_headers untuk menghapus semua header.	all
remote_auth_custom_header	String	No	Header permintaan kustom yang akan ditambahkan, dipisahkan dengan tanda pipa (\|), case-insensitive.	(empty)
remote_auth_success_code	Integer	Yes	Kode status keberhasilan otentikasi yang dikembalikan oleh server otentikasi. Beberapa kode dipisahkan dengan koma.	200
remote_auth_fail_code	Integer	Yes	Kode status kegagalan otentikasi yang dikembalikan oleh server otentikasi. Beberapa kode dipisahkan dengan koma.	403,404
remote_auth_other_code_act	String	No	Tindakan untuk kode status lain (bukan keberhasilan maupun kegagalan). Nilai yang valid: `pass` (default, izinkan permintaan), `reject` (tolak permintaan).	pass
remote_auth_fail_resp_code	Integer	Yes	Kode status yang dikembalikan CDN ke klien saat otentikasi gagal.	403
remote_auth_timeout	Integer	Yes	Timeout otentikasi dalam milidetik. Nilai maksimum: 3000.	500
remote_auth_timeout_action	String	Yes	Tindakan saat otentikasi timeout. Nilai yang valid: `pass` (izinkan permintaan), `reject` (kembalikan kode respons kegagalan).	pass

Example:

{
    "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_reserve_header",
            "argValue": "all"
        }, {
            "argName": "remote_auth_success_code",
            "argValue": "200"
        }, {
            "argName": "remote_auth_fail_code",
            "argValue": "403"
        }, {
            "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"
}

ali_ua

Description: Mengonfigurasi pembatasan akses User-Agent.
Function ID: 58
Parameters:

Parameter	Type	Required	Description	Example
ua	String	Yes	Nilai User-Agent. Mendukung wildcard * (mencocokkan string apa pun) dan beberapa nilai dipisahkan dengan tanda pipa (\|).	curl\|IE\|chrome\|firefox
type	String	Yes	Jenis daftar. Nilai yang valid: `black` (daftar hitam), `white` (daftar putih). Daftar hitam dan daftar putih saling eksklusif; hanya satu yang dapat aktif dalam satu waktu.	black

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "ua",
            "argValue": "*curl*|*IE*|*chrome*|*firefox*"
        }, {
            "argName": "type",
            "argValue": "black"
        }],
        "functionName": "ali_ua"
    }],
    "DomainNames": "example.com"
}

Konfigurasi cache

filetype_based_ttl_set

Description: Mengonfigurasi waktu kedaluwarsa file.
Function ID: 6
Parameters:

Parameter	Type	Required	Description	Example
ttl	Integer	Yes	Durasi cache dalam detik. Nilai yang valid: 1-99999999.	500000
file_type	String	Yes	Jenis file, dipisahkan dengan koma (`,`). Case-sensitive. Misalnya, jpg,txt.	jpg
weight	Integer	No	Prioritas. Nilai yang valid: 1-99. Nilai default: `1` (nilai lebih tinggi = prioritas lebih tinggi).	1
swift_origin_cache_high	String	No	Menentukan apakah akan memprioritaskan kebijakan cache origin. Saat diaktifkan, kebijakan cache dari header respons origin (seperti Cache-Control dan Pragma) memiliki prioritas. Nilai yang valid: `on`, `off` (default).	off
swift_no_cache_low	String	No	Menentukan apakah akan mengabaikan header respons origin no-cache. Saat diaktifkan, header respons origin berikut diabaikan: Cache-Control: no-store, Cache-Control: no-cache, Cache-Control: max-age=0, Pragma: no-cache. Nilai yang valid: `on`, `off` (default).	off
swift_follow_cachetime	String	No	Menentukan apakah klien mengikuti kebijakan cache CDN. Saat diaktifkan, kebijakan cache CDN yang efektif dikirim dalam respons ke klien. Nilai yang valid: `on`, `off` (default).	off
force_revalidate	String	No	Menentukan apakah akan memaksa validasi konten saat TTL adalah 0. Nilai yang valid: `on` (saat TTL adalah 0, konten di-cache pada node CDN dan divalidasi ulang dengan origin pada setiap permintaan), `off` (default, saat TTL adalah 0, konten tidak di-cache dan diambil dari origin pada setiap permintaan).	off

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "ttl",
            "argValue": "500000"
        }, {
            "argName": "file_type",
            "argValue": "jpg"
        }],
        "functionName": "filetype_based_ttl_set"
    }],
    "DomainNames": "example.com"
}

ali_return_code

Description: Respons HTTP kustom. Membuat respons HTTP dengan kode status HTTP kustom dan badan HTTP. Respons yang dibuat dikembalikan langsung ke klien.
Function ID: 56
Parameters:

Catatan

Mode respons pre-origin (exit_after_return_code diatur ke on): CDN tidak mengambil data dari origin. Permintaan dicegat langsung dan mengembalikan kode status respons serta badan respons (jika dikonfigurasi) ke klien.

Mode respons post-origin (exit_after_return_code diatur ke return_code_phase atau kosong): CDN terlebih dahulu mengambil konten dari origin, lalu mengembalikan kode status respons dan badan respons origin ke klien. Secara default, dalam mode post-origin, badan respons selalu berupa konten yang dikembalikan oleh origin. Untuk mengganti badan respons origin, Anda juga harus mengaktifkan ali_body_filter_switch.

Parameter	Type	Required	Description	Example
return_code	Integer	Yes	Kode status respons. Mengatur kode status HTTP yang akhirnya dikembalikan node CDN ke klien.	302
exit_after_return_code	String	No	Mode respons, yang mengontrol kapan CDN mengembalikan respons ke klien. Nilai yang valid: `on`: Respons pre-origin. CDN tidak mengambil dari origin. Permintaan dicegat langsung dan mengembalikan kode status respons dan badan respons (jika dikonfigurasi) ke klien. `return_code_phase`: Respons post-origin. CDN terlebih dahulu mengambil konten dari origin, lalu mengembalikan kode status respons dan konten respons origin ke klien (mode default, digunakan saat parameter ini kosong).	on
resp_body_ct	String	No	Konten badan respons (HTTP Body) untuk menyesuaikan apa yang dikembalikan ke klien. Dalam mode respons pre-origin: jika ditentukan, konten ini dikembalikan sebagai badan respons; jika tidak ditentukan, hanya kode status yang dikembalikan. Dalam mode respons post-origin: pengaturan ini tidak berlaku secara default; badan respons selalu merupakan konten yang dikembalikan oleh origin.	example
ali_body_filter_switch	String	No	Sakelar untuk memodifikasi konten respons origin. Pengaturan ini hanya berlaku dalam mode respons post-origin. Saat diaktifkan, CDN mengganti badan respons origin dengan konten respons yang ditentukan dan mengembalikan kode status respons plus konten respons ke klien. Nilai yang valid: `on`: Aktifkan. `off`: Nonaktifkan.	on
ali_body_filter_code	Integer	No	Mencocokkan kode status respons origin. Pengaturan ini hanya berlaku dalam mode respons post-origin dan saat memodifikasi konten respons origin diaktifkan. Saat ditentukan, CDN hanya memicu logika penggantian konten respons saat origin mengembalikan kode status yang ditentukan. Jika kode status tidak cocok, tidak ada penggantian yang dilakukan.	404

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "return_code",
            "argValue": "403"
        }, {
            "argName": "exit_after_return_code",
            "argValue": "on"
        }, {
            "argName": "resp_body_ct",
            "argValue": "null"
        }, {
            "argName": "ali_body_filter_switch",
            "argValue": "on"
        }, {
            "argName": "ali_body_filter_code",
            "argValue": "333"
        }],
        "functionName": "ali_return_code"
    }],
    "DomainNames": "example.com"
}

path_based_ttl_set

Description: Mengonfigurasi waktu kedaluwarsa cache berbasis direktori.
Function ID: 7
Parameters:

Parameter	Type	Required	Description	Example
ttl	Integer	Yes	Durasi cache dalam detik. Nilai yang valid: 1-99999999.	500000
path	String	Yes	Path direktori, yang harus dimulai dengan garis miring (/).	/example/demo
weight	Integer	No	Prioritas. Nilai yang valid: 1-99. Nilai default: 1 (nilai lebih tinggi = prioritas lebih tinggi).	1
swift_origin_cache_high	String	No	Menentukan apakah akan memprioritaskan kebijakan cache origin. Nilai yang valid: `on`, `off` (default).	off
swift_no_cache_low	String	No	Menentukan apakah akan mengabaikan header respons origin no-cache. Nilai yang valid: `on`, `off` (default).	off
swift_follow_cachetime	String	No	Menentukan apakah klien mengikuti kebijakan cache CDN. Nilai yang valid: `on`, `off` (default).	off
force_revalidate	String	No	Menentukan apakah akan memaksa validasi konten saat TTL adalah 0. Nilai yang valid: `on`, `off` (default).	off

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "path",
            "argValue": "/example/demo"
        }, {
            "argName": "weight",
            "argValue": "1"
        }, {
            "argName": "ttl",
            "argValue": "500000"
        }],
        "functionName": "path_based_ttl_set"
    }],
    "DomainNames": "example.com"
}

filetype_force_ttl_code

Description: Mengonfigurasi waktu kedaluwarsa cache berbasis jenis file untuk kode status.
Function ID: 63
Parameters:

Parameter	Type	Required	Description	Example
file_type	String	Yes	Jenis file, case-sensitive, dipisahkan dengan koma (,).	jpg
code_string	String	Yes	Kode status dan durasi cache-nya dalam detik (1-99999999), dipisahkan dengan koma. Format: code=ttl.	403=10
swift_code_origin_cache_high	String	No	Menentukan apakah akan memprioritaskan kebijakan cache origin. Nilai yang valid: `on`, `off` (default).	off
swift_code_no_cache_low	String	No	Menentukan apakah akan mengabaikan header respons origin no-cache. Nilai yang valid: `on`, `off` (default).	off
swift_code_follow_cachetime	String	No	Menentukan apakah klien mengikuti kebijakan cache CDN. Nilai yang valid: `on`, `off` (default).	off
force_revalidate	String	No	Menentukan apakah akan memaksa validasi konten saat TTL adalah 0. Nilai yang valid: `on`, `off` (default).	off

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "file_type",
            "argValue": "jpg"
        }, {
            "argName": "code_string",
            "argValue": "403=10"
        }],
        "functionName": "filetype_force_ttl_code"
    }],
    "DomainNames": "example.com"
}

path_force_ttl_code

Description: Mengonfigurasi waktu kedaluwarsa cache berbasis path untuk kode status.
Function ID: 65
Parameters:

Parameter	Type	Required	Description	Example
path	String	Yes	Path direktori, yang harus dimulai dengan garis miring (/).	/example/demo
code_string	String	Yes	Kode status dan durasi cache-nya dalam detik (1-99999999), dipisahkan dengan koma. Format: code=ttl.	403=10,404=15
swift_code_origin_cache_high	String	No	Menentukan apakah akan memprioritaskan kebijakan cache origin. Nilai yang valid: `on`, `off` (default).	off
swift_code_no_cache_low	String	No	Menentukan apakah akan mengabaikan header respons origin no-cache. Nilai yang valid: `on`, `off` (default).	off
swift_code_follow_cachetime	String	No	Menentukan apakah klien mengikuti kebijakan cache CDN. Nilai yang valid: `on`, `off` (default).	off
force_revalidate	String	No	Menentukan apakah akan memaksa validasi konten saat TTL adalah 0. Nilai yang valid: `on`, `off` (default).	off

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "path",
            "argValue": "/example/demo"
        }, {
            "argName": "code_string",
            "argValue": "403=10,404=15"
        }],
        "functionName": "path_force_ttl_code"
    }],
    "DomainNames": "example.com"
}

default_ttl_code

Description: Mengonfigurasi waktu kedaluwarsa cache untuk kode status (prioritas origin).
Function ID: 207
Parameters:

Parameter	Type	Required	Description	Example
default_ttl_code	String	Yes	Kode status dan durasi cache-nya dalam detik (1-99999999), dipisahkan dengan koma. Format: code=ttl.	4xx=3,200=3600,5xx=1

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "default_ttl_code",
            "argValue": "4xx=3,200=3600,5xx=1"
        }],
        "functionName": "default_ttl_code"
    }],
    "DomainNames": "example.com"
}

set_resp_header

Description: Mengonfigurasi header respons HTTP kustom.
Function ID: 27
Parameters:

Parameter	Type	Required	Description	Example
key	String	Yes	Nama header respons.	Cache-Control
value	String	Yes	Nilai header respons. Beberapa nilai dipisahkan dengan koma (,). Untuk menghapus header, atur nilainya ke null.	no-cache
header_operation_type	String	No	Jenis operasi header. Nilai yang valid: `add`, `delete`, `modify`, `rewrite`.	add
duplicate	String	No	Menentukan apakah akan mengizinkan header duplikat (saat menggunakan operasi add). Nilai yang valid: `on`, `off`.	off
header_source	String	No	Nilai yang akan dicari untuk penggantian (saat menggunakan rewrite). Mendukung ekspresi reguler.	value1
header_destination	String	No	Nilai pengganti (saat menggunakan rewrite).	value123
match_all	String	No	Mode pencocokan (saat menggunakan rewrite). Nilai yang valid: `on` (mengganti semua), `off` (mengganti hanya yang pertama).	off
access_origin_control	String	No	Menentukan apakah akan mengaktifkan validasi lintas-origin. Nilai yang valid: `on`, `off`.	off

Example:

{
    "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

Description: Mengonfigurasi halaman error kustom.
Function ID: 15
Parameters:

Parameter	Type	Required	Description	Example
error_code	Integer	Yes	Kode status error.	404
rewrite_page	String	Yes	URL halaman pengalihan.	http://example.aliyundoc.com/error404.html

Example:

{
    "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

Description: Mengonfigurasi aturan penulisan ulang URI.
Function ID: 43
Parameters:

Parameter	Type	Required	Description	Example
regex	String	Yes	URI yang akan ditulis ulang. Harus dimulai dengan /. Mendukung ekspresi reguler PCRE.	^/hello$
replacement	String	Yes	URI target. Saat flag diatur ke break, hanya mendukung path yang dimulai dengan /. Saat flag diatur ke redirect, dapat mencakup protokol dan nama domain. Mendukung ekspresi reguler PCRE ($1, $2 untuk grup tangkapan).	/hello/test
flag	String	No	Aturan eksekusi. Nilai yang valid: (kosong, default) melanjutkan pencocokan aturan berikutnya; break: menghentikan pencocokan aturan berikutnya, menulis ulang URI tanpa memodifikasi parameter; redirect: mengembalikan pengalihan 302 ke klien, melanjutkan pencocokan aturan berikutnya; enhance_break: mirip dengan break tetapi memodifikasi seluruh URL termasuk parameter; enhance_redirect: mirip dengan redirect tetapi memodifikasi seluruh URL termasuk parameter.	redirect
rewrite_method	String	No	Metode pengalihan. Nilai yang valid: 302 (default, metode permintaan dapat berubah menjadi GET), 303 (metode permintaan berubah menjadi GET, body hilang), 307 (metode permintaan dan body dipertahankan).	302
sequence	Integer	No	Mengatur prioritas eksekusi konfigurasi. Nilai yang valid: 1 hingga 99. Nilai yang lebih kecil menunjukkan prioritas yang lebih tinggi. Jika parameter ini tidak ditentukan, prioritas ditetapkan secara otomatis secara berurutan mulai dari 1.	1

Example:

{
    "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

Description: Mengonfigurasi kunci cache kustom.
Function ID: 227
Parameters:

Parameter	Type	Required	Description	Example
uri	Array of String	No	Menulis ulang URI sumber ke URI target untuk kunci cache. Gunakan uri_to_rewrite untuk sumber dan ai_uri_regex untuk target.	[{"uri_to_rewrite":"/hello","ai_uri_regex":"/hello/test"}]
args	Array of String	No	Menjalankan operasi add, delete, modify, atau keep pada parameter permintaan untuk kunci cache.	[{"args":"test=123","args_operation_type":"add"}]
headers	String	No	Header HTTP yang disertakan dalam kunci cache, dipisahkan dengan spasi.	example
variable	Array of String	No	Variabel kustom yang diekstraksi dari parameter URL permintaan, header HTTP, cookie, atau URI menggunakan ekspresi reguler untuk ditambahkan ke kunci cache.	[]

Example:

{
    "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

Description: Mengonfigurasi cache bersama (penulisan ulang kunci cache).
Function ID: 54
Parameters:

Parameter	Type	Required	Description	Example
share_host	String	Yes	Nama domain target yang dapat berbagi cache dengan domain saat ini. Ini tidak memodifikasi host origin dalam permintaan pengguna. Ini hanya menggunakan nilai share_host untuk menghasilkan kunci cache untuk pencarian cache.	example.com

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "share_host",
            "argValue": "example.com"
        }],
        "functionName": "rewrite_host"
    }],
    "DomainNames": "example.com"
}

serving_stale_content

Description: Mengonfigurasi penyajian konten kedaluwarsa. Menyajikan konten cache yang telah kedaluwarsa saat server origin tidak tersedia.
Function ID: 260
Parameters:

Parameter	Type	Required	Description	Example
origin_error_status_code	String	No	Kode status error origin kustom yang memicu penyajian konten kedaluwarsa. Secara default (saat tidak ditentukan), error origin didefinisikan sebagai timeout ditambah semua kode status 5xx. Mendukung pencocokan kabur (4xx, 5xx) dan pencocokan eksak (502, 504). Beberapa kode dipisahkan dengan koma.	502
extend_expiration_time	Integer	No	Waktu maksimum (dalam detik) untuk menyimpan konten cache kedaluwarsa setelah kedaluwarsa. Nilai default: 3600 (1 jam).	60
origin_first	String	No	Menentukan apakah akan memprioritaskan kebijakan origin stale-if-error. Saat diaktifkan (on), jika respons origin menyertakan Cache-Control: stale-if-error=xx, waktu stale-if-error memiliki prioritas atas extend_expiration_time. Nilai yang valid: `on`, `off` (default).	on

Example:

{
    "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

Description: Mengonfigurasi parameter dasar HTTPS.
Function ID: 78
Parameters:

Parameter	Type	Required	Description	Example
http2	String	No	Menentukan apakah akan mengaktifkan HTTP/2. Nilai yang valid: `on`, `off`.	on
ocsp_stapling	String	No	Menentukan apakah akan mengaktifkan OCSP Stapling. Nilai yang valid: `on`, `off`.	on

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "http2",
            "argValue": "on"
        }],
        "functionName": "https_option"
    }],
    "DomainNames": "example.com"
}

https_force

Description: Mengonfigurasi pengalihan HTTPS.
Function ID: 44
Conflict: Bertentangan dengan http_force (Function ID: 45). Hanya satu yang dapat dikonfigurasi.
Parameters:

Parameter	Type	Required	Description	Example
enable	String	Yes	Menentukan apakah akan mengaktifkan pengalihan HTTPS. Nilai yang valid: `on`, `off`.	on
https_rewrite	String	No	Metode pengalihan. Nilai yang valid: `301`, `308`.	301

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "enable",
            "argValue": "on"
        }, {
            "argName": "https_rewrite",
            "argValue": "301"
        }],
        "functionName": "https_force"
    }],
    "DomainNames": "example.com"
}

http_force

Description: Mengonfigurasi pengalihan HTTP paksa.
Function ID: 45
Conflict: Bertentangan dengan https_force (Function ID: 44). Hanya satu yang dapat dikonfigurasi. Jika salah satu fitur sudah dikonfigurasi (termasuk saat parameter switch-nya diatur ke off), Anda harus menghapus konfigurasi yang ada sebelum mengonfigurasi yang lain.
Parameters:

Parameter	Type	Required	Description	Example
enable	String	Yes	Menentukan apakah akan mengaktifkan pengalihan HTTP paksa. Nilai yang valid: `on`, `off`.	on
http_rewrite	String	No	Metode pengalihan. Nilai yang valid: 301 (metode permintaan GET tidak berubah, metode lain dapat berubah menjadi GET), 308 (metode permintaan dan body dipertahankan).	301

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "enable",
            "argValue": "on"
        }, {
            "argName": "http_rewrite",
            "argValue": "301"
        }],
        "functionName": "http_force"
    }],
    "DomainNames": "example.com"
}

https_tls_version

Description: Mengonfigurasi versi protokol TLS.
Function ID: 110
Parameters:

Parameter	Type	Required	Description	Example
tls10	String	No	Menentukan apakah akan mengaktifkan TLS 1.0. Nilai yang valid: `on` (default), `off`.	on
tls11	String	No	Menentukan apakah akan mengaktifkan TLS 1.1. Nilai yang valid: `on` (default), `off`.	on
tls12	String	No	Menentukan apakah akan mengaktifkan TLS 1.2. Nilai yang valid: `on` (default), `off`.	on
tls13	String	No	Menentukan apakah akan mengaktifkan TLS 1.3. Nilai yang valid: `on` (default), `off`.	on
ciphersuitegroup	String	No	Grup paket sandi. Nilai yang valid: `all` (default, semua paket sandi), `strict` (hanya paket sandi kuat), `custom` (paket sandi kustom).	all
ciphersuite	String	No	Paket sandi kustom. Digunakan dengan ciphersuitegroup diatur ke custom. Beberapa paket sandi dipisahkan dengan koma.	TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "tls10",
            "argValue": "on"
        }, {
            "argName": "tls11",
            "argValue": "on"
        }, {
            "argName": "tls12",
            "argValue": "on"
        }, {
            "argName": "tls13",
            "argValue": "off"
        }, {
            "argName": "ciphersuitegroup",
            "argValue": "all"
        }],
        "functionName": "https_tls_version"
    }],
    "DomainNames": "example.com"
}

HSTS

Description: Mengonfigurasi HTTP Strict Transport Security (HSTS).
Function ID: 112
Parameters:

Parameter	Type	Required	Description	Example
enabled	String	Yes	Menentukan apakah akan mengaktifkan HSTS. Nilai yang valid: `on`, `off`.	on
https_hsts_max_age	Integer	Yes	Waktu kedaluwarsa dalam detik. Nilai yang direkomendasikan: 5184000 (60 hari).	5184000
https_hsts_include_subdomains	String	No	Menentukan apakah akan menyertakan subdomain dalam header HSTS. Nilai yang valid: `on`, `off`. Sebelum diaktifkan, pastikan semua subdomain telah mengaktifkan HTTPS; jika tidak, akses subdomain mungkin gagal.	off

Example:

{
    "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"
}

https_client_cert

Description: Mengonfigurasi otentikasi sertifikat klien.
Function ID: 111
Parameters:

Parameter	Type	Required	Description	Example
client_certificate_verify	String	Yes	Menentukan apakah akan mengaktifkan otentikasi sertifikat klien. Nilai yang valid: `on`, `off`.	on
client_certificate	String	Yes	Sertifikat klien (kunci publik) yang digunakan untuk otentikasi. Sertifikat CA harus dimulai dengan -----BEGIN CERTIFICATE----- dan diakhiri dengan -----END CERTIFICATE-----.	-----BEGIN PUBLIC KEY-----***-----END PUBLIC KEY-----
client_verify_depth	String	No	Kedalaman verifikasi rantai sertifikat (jumlah level sertifikat dari sertifikat klien ke CA root). Nilai default: 1.	1

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "client_certificate_verify",
            "argValue": "on"
        }, {
            "argName": "client_certificate",
            "argValue": "-----BEGIN PUBLIC KEY-----***-----END PUBLIC KEY-----"
        }],
        "functionName": "https_client_cert"
    }],
    "DomainNames": "example.com"
}

Optimisasi performa

gzip

Description: Mengaktifkan kompresi Gzip halaman.
Function ID: 35
Parameters:

Parameter	Type	Required	Description	Example
enable	String	Yes	Menentukan apakah akan mengaktifkan kompresi Gzip. Nilai yang valid: `on`, `off`.	on

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "enable",
            "argValue": "on"
        }],
        "functionName": "gzip"
    }],
    "DomainNames": "example.com"
}

tesla

Description: Mengonfigurasi optimisasi halaman HTML.
Function ID: 16
Parameters:

Parameter	Type	Required	Description	Example
enable	String	Yes	Menentukan apakah akan mengaktifkan optimisasi halaman. Nilai yang valid: `on`, `off`.	on
trim_js	String	No	Menentukan apakah akan mengoptimalkan kode JS inline dalam HTML. Nilai yang valid: `on`, `off` (default).	off
trim_css	String	No	Menentukan apakah akan mengoptimalkan kode CSS inline dalam HTML. Nilai yang valid: `on`, `off` (default).	off

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "enable",
            "argValue": "on"
        }, {
            "argName": "trim_css",
            "argValue": "off"
        }, {
            "argName": "trim_js",
            "argValue": "off"
        }],
        "functionName": "tesla"
    }],
    "DomainNames": "example.com"
}

brotli

Description: Mengonfigurasi kompresi Brotli.
Function ID: 97
Parameters:

Parameter	Type	Required	Description	Example
enable	String	Yes	Menentukan apakah akan mengaktifkan kompresi Brotli. Nilai yang valid: `on`, `off`.	on

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "enable",
            "argValue": "on"
        }],
        "functionName": "brotli"
    }],
    "DomainNames": "example.com"
}

set_hashkey_args

Description: Mengonfigurasi penyaringan parameter URL (mode pertahankan).
Function ID: 19
Conflict: Bertentangan dengan ali_remove_args (Function ID: 75). Hanya satu yang dapat dikonfigurasi.
Parameters:

Parameter	Type	Required	Description	Example
hashkey_args	String	No	Daftar parameter yang akan dipertahankan, dipisahkan dengan koma (,). Maksimum: 10 parameter.	key1,key2
disable	String	Yes	Menentukan apakah akan mengabaikan semua parameter. Nilai yang valid: `on` (abaikan semua, hanya operasi add yang tetap efektif), `off` (default). Mengabaikan semua parameter memiliki prioritas lebih rendah daripada daftar parameter yang dipertahankan.	on
keep_oss_args	String	Yes	Menentukan apakah akan mempertahankan parameter untuk permintaan origin. Nilai yang valid: `on` (pertahankan semua parameter), `off` (parameter origin sesuai dengan parameter kunci cache).	on

Example:

{
    "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

Description: Mengonfigurasi penyaringan parameter URL (mode hapus).
Function ID: 75
Conflict: Bertentangan dengan set_hashkey_args (Function ID: 19). Hanya satu yang dapat dikonfigurasi.
Parameters:

Parameter	Type	Required	Description	Example
ali_remove_args	String	Yes	Parameter yang akan dihapus, dipisahkan dengan spasi. Parameter yang tersisa digunakan sebagai bagian args URL dari kunci cache.	test
keep_oss_args	String	Yes	Menentukan apakah akan mempertahankan parameter untuk permintaan origin. Nilai yang valid: `on` (pertahankan semua parameter), `off` (parameter origin sesuai dengan parameter kunci cache).	off

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "ali_remove_args",
            "argValue": "test"
        }, {
            "argName": "keep_oss_args",
            "argValue": "off"
        }],
        "functionName": "ali_remove_args"
    }],
    "DomainNames": "example.com"
}

image_transform

Description: Mengonfigurasi transformasi gambar CDN.
Function ID: 239
Parameters:

Parameter	Type	Required	Description	Example
enable	String	Yes	Menentukan apakah akan mengaktifkan transformasi gambar. Nilai yang valid: `on`, `off`.	on
filetype	String	Yes	Format gambar yang didukung untuk transkoding, dipisahkan dengan tanda pipa (\|). Nilai yang valid: JPEG, JPG, PNG, WEBP, BMP, GIF, TIFF, JP2.	jpg\|jpeg\|png
webp	String	No	Menentukan apakah akan mengaktifkan konversi WebP adaptif. Nilai yang valid: `on`, `off`.	on
orient	String	No	Menentukan apakah akan mengaktifkan rotasi gambar otomatis. Nilai yang valid: `on`, `off`. Hanya berlaku untuk gambar dengan atribut rotasi.	on
slim	Integer	No	Persentase pelangsingan gambar. Nilai yang valid: 0-100. Mengurangi kualitas gambar tanpa mengubah resolusi, ukuran, atau format untuk menghemat bandwidth.	10

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "filetype",
            "argValue": "jpg|jpeg|png"
        }, {
            "argName": "webp",
            "argValue": "on"
        }, {
            "argName": "orient",
            "argValue": "on"
        }, {
            "argName": "enable",
            "argValue": "on"
        }],
        "functionName": "image_transform"
    }],
    "DomainNames": "example.com"
}

Video

range

Description: Mengonfigurasi pengambilan asal berbasis Range.
Function ID: 31
Parameters:

Parameter	Type	Required	Description	Example
enable	String	Yes	Menentukan apakah akan mengaktifkan pengambilan asal berbasis Range. Nilai yang valid: `on`, `off`, `force` (paksa aktifkan).	on

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "enable",
            "argValue": "on"
        }],
        "functionName": "range"
    }],
    "DomainNames": "example.com"
}

video_seek

Description: Mengonfigurasi pencarian video (drag and play).
Function ID: 30
Parameters:

Parameter	Type	Required	Description	Example
enable	String	Yes	Menentukan apakah akan mengaktifkan pencarian video. Nilai yang valid: `on`, `off`.	on
flv_seek_by_time	String	No	Menentukan apakah akan mengaktifkan pencarian berbasis waktu FLV. Nilai yang valid: `on`, `off`.	on
mp4_seek_start	String	No	Nama parameter awal MP4 kustom.	mp4starttime
mp4_seek_end	String	No	Nama parameter akhir MP4 kustom.	mp4endtime
flv_seek_start	String	No	Nama parameter awal FLV kustom.	flvstarttime
flv_seek_end	String	No	Nama parameter akhir FLV kustom.	flvendtime

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "enable",
            "argValue": "on"
        }],
        "functionName": "video_seek"
    }],
    "DomainNames": "example.com"
}

ali_video_split

Description: Mengonfigurasi ekstraksi audio dari video.
Function ID: 204
Parameters:

Parameter	Type	Required	Description	Example
enable	String	Yes	Menentukan apakah akan mengaktifkan ekstraksi audio. Nilai yang valid: `on`, `off`.	on

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "enable",
            "argValue": "on"
        }],
        "functionName": "ali_video_split"
    }],
    "DomainNames": "example.com"
}

ali_video_preview

Description: Mengonfigurasi pratinjau video (trial viewing).
Function ID: 205
Parameters:

Parameter	Type	Required	Description	Example
enable	String	Yes	Menentukan apakah akan mengaktifkan pratinjau video. Nilai yang valid: `on`, `off`. Mendukung format file TS dan MP3. Untuk FLV dan MP4, gunakan fitur pencarian video.	on
ali_video_preview_argument	String	Yes	Nama parameter pratinjau kustom. Satuan nilai parameter harus dalam detik.	fds

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "enable",
            "argValue": "on"
        }, {
            "argName": "ali_video_preview_argument",
            "argValue": "fds"
        }],
        "functionName": "ali_video_preview"
    }],
    "DomainNames": "example.com"
}

hls_token_rewrite

Description: Mengonfigurasi penulisan ulang enkripsi standar M3U8.
Function ID: 253
Parameters:

Parameter	Type	Required	Description	Example
enable	String	Yes	Menentukan apakah akan mengaktifkan penulisan ulang enkripsi standar M3U8. Nilai yang valid: `on`, `off`.	on
hls_token_arg_name	String	No	Nama parameter token HLS kustom. Nilai default: MtsHlsUriToken.	example

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "enable",
            "argValue": "on"
        }],
        "functionName": "hls_token_rewrite"
    }],
    "DomainNames": "example.com"
}

Pembatasan laju

limit_rate

Description: Mengonfigurasi pembatasan laju per permintaan.
Function ID: 72
Parameters:

Parameter	Type	Required	Description	Example
ali_limit_rate	String	Yes	Nilai batas laju untuk satu permintaan (misalnya, `200 KByte/s` atau `1 MByte/s`). Nilai harus dalam format angka + unit (k untuk KByte/s, m untuk MByte/s). Nilai minimum: `100k`. Nilai di bawah 100k diperlakukan sebagai 100k.	1m
ali_limit_rate_after	String	No	Ambang batas volume data sebelum pembatasan laju dimulai. Nilai harus dalam format angka + unit (k atau m), dalam byte.	1000
traffic_limit_arg	String	No	Nama parameter batas laju yang diekstraksi dari URL permintaan. Saat ditentukan, batas laju didasarkan pada nilai parameter ini dalam URL. Saat permintaan tidak mengandung parameter ini, batas laju default (ali_limit_rate) digunakan. Untuk menonaktifkan pembatasan laju saat parameter tidak ada, atur ali_limit_rate ke 0k.	rate
traffic_limit_unit	String	No	Unit untuk nilai parameter traffic_limit_arg. Nilai yang valid: `m` (MByte/s), `k` (KByte/s). Misalnya, jika unit diatur ke m dan URL permintaan berisi rate=1, batas laju aktual adalah 1 MByte/s. Nilai minimum: 100k. Nilai di bawah 100k diperlakukan sebagai 100k.	k
ali_limit_start_hour	Integer	No	Jam mulai pembatasan laju. Nilai yang valid: 0-24 (format 24 jam). Nilai default: `0`.	20
ali_limit_end_hour	Integer	No	Jam akhir pembatasan laju. Nilai yang valid: 0-24 (harus lebih besar dari jam mulai). Nilai default: `24`.	23

Example 1:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "ali_limit_rate",
            "argValue": "1m"
        }],
        "functionName": "limit_rate"
    }],
    "DomainNames": "example.com"
}

Example 2: Tetapkan batas laju default 1 MByte/s. Jika URL permintaan berisi parameter rate, batas laju mengikuti nilai parameter tersebut. Misalnya, jika URL berisi rate=200, batas laju aktual adalah 200 KByte/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"
}

EdgeScript dan fungsi edge

edge_function

Description: Mengonfigurasi aturan EdgeScript.
Function ID: 180
Parameters:

Parameter	Type	Required	Description	Example
rule	String	Yes	Aturan DSL.	if eq($uri, '/') { rewrite('https://example.com/index.html', 'redirect') }
pri	Integer	Yes	Prioritas. Nilai yang valid: 0-999 (nilai lebih rendah = prioritas lebih tinggi). Prioritas posisi eksekusi head dan foot bersifat independen.	0
enable	String	Yes	Menentukan apakah aturan efektif. Nilai yang valid: `on`, `off`.	on
name	String	Yes	Nama aturan (hanya huruf dan garis bawah).	test
pos	String	No	Posisi eksekusi. Nilai yang valid: `head` (default, intercept di awal pemrosesan permintaan), `foot` (intercept di akhir pemrosesan permintaan).	head
brk	String	No	Menentukan apakah akan menghentikan eksekusi. Nilai yang valid: `on` (lewati aturan yang tersisa di posisi eksekusi saat ini setelah aturan ini cocok), `off` (default, lanjutkan mengeksekusi aturan yang tersisa).	off
option	String	No	Bidang ekstensi.	(empty)
grammar	String	No	Sintaks aturan. Nilai yang valid: `es2` (default), `js`.	es2
jsmode	String	No	Mode eksekusi JS. Nilai yang valid: `redirect` (mode intercept), `bypass` (default, mode bypass).	bypass

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "rule",
            "argValue": "if eq($uri, '/') { rewrite('https://example.com/index.html', 'redirect') }"
        }, {
            "argName": "pri",
            "argValue": "0"
        }, {
            "argName": "enable",
            "argValue": "on"
        }, {
            "argName": "name",
            "argValue": "test"
        }],
        "functionName": "edge_function"
    }],
    "DomainNames": "example.com"
}

Fungsi edge

edgeroutine

Description: Mengonfigurasi Edge Routine (fungsi edge).
Function ID: 275

Catatan

Fitur ini memerlukan aplikasi untuk diaktifkan. Anda harus mengajukan permohonan untuk mengaktifkan fitur ini sebelum digunakan.

Mesin aturan

condition

Description: Mengonfigurasi mesin aturan. Memungkinkan konfigurasi grafis aturan kondisi yang mengidentifikasi berbagai parameter dalam permintaan pengguna (seperti IP klien, URI, header, cookie) untuk menentukan apakah konfigurasi berlaku untuk permintaan tertentu. Ini memungkinkan kontrol kebijakan konfigurasi CDN yang lebih fleksibel dan tepat.
Function ID: 250
Parameters:

Catatan

Fitur ini memerlukan aplikasi untuk diaktifkan. Anda harus mengajukan permohonan untuk mengaktifkan fitur ini sebelum digunakan.

Parameter	Type	Required	Description	Example
rule	Array	Yes	Konten aturan kondisi, termasuk name, status, logic, dan criteria. Objek criteria berisi: matchType (jenis informasi permintaan yang dicocokkan), matchObject (penyempurnaan lebih lanjut dari jenis pencocokan), matchOperator (tindakan pencocokan, seperti equals), matchValue (nilai yang dicocokkan), negate (apakah akan meniadakan hasil, true atau false).	{"match":{"logic":"and","criteria":[{"matchType":"clientipVer","matchObject":"CONNECTING_IP","matchOperator":"equals","matchValue":"v6","negate":false}]},"name":"example","status":"enable"}
sequence	Integer	No	Mengatur prioritas eksekusi konfigurasi. Nilai yang valid: 1 hingga 99. Nilai yang lebih kecil menunjukkan prioritas yang lebih tinggi. Jika parameter ini tidak ditentukan, prioritas ditetapkan secara otomatis secara berurutan mulai dari 1.	1

Example:

{
    "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"
}

Keamanan

ali_location

Description: Mengonfigurasi pemblokiran akses berbasis wilayah.
Function ID: 57
Parameters:

Parameter	Type	Required	Description	Example
location	String	Yes	Wilayah tempat kebijakan pemblokiran diterapkan. Mendukung kode negara dua huruf (standar ISO 3166), dipisahkan dengan spasi. Juga mendukung global untuk pemblokiran di seluruh dunia.	CN
type	String	Yes	Jenis kebijakan pemblokiran. Nilai yang valid: `black` (daftar hitam, blokir IP klien dari wilayah yang ditentukan), `white` (daftar putih, blokir IP klien dari wilayah yang tidak ada dalam daftar).	black

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "location",
            "argValue": "CN"
        }, {
            "argName": "type",
            "argValue": "black"
        }],
        "functionName": "ali_location"
    }],
    "DomainNames": "example.com"
}

QUIC

iquic

Description: Mengonfigurasi parameter dasar protokol QUIC.
Function ID: 281
Parameters:

Parameter	Type	Required	Description	Example
iquic_enable	String	Yes	Menentukan apakah akan mengaktifkan protokol QUIC. Nilai yang valid: `on`, `off`.	on

Example:

{
    "Functions": [{
        "functionArgs": [{
            "argName": "iquic_enable",
            "argValue": "on"
        }],
        "functionName": "iquic"
    }],
    "DomainNames": "example.com"
}