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 tersebut 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 diakses melalui operasi berikut di 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 setiap pasangan yang bertentangan yang dapat dikonfigurasi dalam satu waktu. Pasangan fitur yang saling 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 ketika `scheme_origin` diatur ke `follow` (format: `httpPort:httpsPort`, contoh: `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 pertama kali menggunakan fitur ini, Anda harus mengaktifkan kebijakan izin default yang memberikan akses CDN 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 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 pribadi origin OSS. Anda dapat mengonfigurasi satu atau beberapa aturan yang merepresentasikan bucket OSS pribadi berbeda dengan 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 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 asal (alamat server asal 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 asal.
Function ID: 124
Parameters:

Parameter	Type	Required	Description	Example
forward_timeout	Integer	Yes	Timeout permintaan dalam detik. Kami menyarankan 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 asal 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 asal 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 asal.
Function ID: 219
Parameters:

Parameter	Type	Required	Description	Example
enable	String	Yes	Menentukan apakah akan mengaktifkan pengikutan redirect 302 asal. 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 asal sebenarnya 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 asal saat mengikuti redirect 302. Nilai yang valid: `on`, `off` (default).	off
modify_host	String	No	Memodifikasi host asal saat mengikuti redirect 302. Secara default, host asal 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 asal sebagai host asal (menggunakan domain asal 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 asal berikutnya yang tersedia saat server asal 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 asal kustom (v1). Disarankan 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 asal.	Accept-Encoding
value	String	Yes	Nilai header permintaan asal. 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 asal kustom (v2). Mendukung operasi add, delete, modify, dan rewrite.
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 kecocokan pertama saja).	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 asal. Mendukung operasi add, delete, modify, dan rewrite.
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 kecocokan pertama saja).	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 asal.
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 bersamaan dan juga berfungsi untuk streaming live FLV.	break

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 asal. Menulis ulang parameter kueri dalam URL permintaan asal. 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 spasi.	code1
save_argument	String	No	Argumen yang akan dipertahankan, dipisahkan 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 spasi.	value=123
modify_argument	String	No	Argumen yang akan dimodifikasi (prioritas terendah), dipisahkan spasi. Jika suatu argumen dihapus, argumen tersebut tidak akan dipertahankan.	value=321
enable	String	Yes	Menentukan apakah akan mengaktifkan penulisan ulang argumen asal. 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 asal (daftar putih SNI).
Function ID: 223
Parameters:

Parameter	Type	Required	Description	Example
enabled	String	Yes	Menentukan apakah akan mengaktifkan verifikasi sertifikat asal. Nilai yang valid: `on`, `off`.	on
common_name_whitelist	String	No	Nama domain daftar putih sertifikat, dipisahkan 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 asal bersyarat. Bekerja dengan fitur mesin aturan (condition, Function ID: 250) untuk mengarahkan permintaan ke server asal tertentu berdasarkan path, parameter URL, header permintaan, dan informasi lainnya. Sebelum mengonfigurasi, Anda harus terlebih dahulu membuat setidaknya 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 asal.	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 asal untuk server asal tertentu.
Function ID: 242
Parameters:

Parameter	Type	Required	Description	Example
origin	String	Yes	Alamat server asal. Atur ke all untuk menerapkan ke semua server asal.	example.com
host	String	Yes	Nilai header host. Atur ke ali_follow_origin untuk menggunakan alamat server asal 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 asal.
Function ID: 276
Parameters:

Parameter	Type	Required	Description	Example
port	String	Yes	Port asal. Saat scheme diatur ke follow, gunakan format http:80\|https:443.	80
scheme	String	Yes	Protokol asal. 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 asal tertentu.
Function ID: 262
Parameters:

Parameter	Type	Required	Description	Example
origin	String	Yes	Alamat server asal. Atur ke all untuk menerapkan ke semua server asal.	example.com
sni_host	String	Yes	Nilai host SNI. Dapat berupa nilai tetap, ali_follow_origin (mengikuti alamat server asal), atau ali_follow_host (mengikuti host asal).	example.org
keepalive_sni	String	No	Menentukan apakah akan mengaktifkan pencocokan keepalive SNI. Nilai yang valid: `on`, `off`. Saat diaktifkan, nilai origin SNI 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 asal.
Function ID: 294
Parameters:

Parameter	Type	Required	Description	Example
source_group_name	String	Yes	Nama grup server asal. Mendukung huruf kecil, angka, dan garis bawah. Panjang maksimum: 128 byte.	example_origin
source_info	String	Yes	Informasi server asal dalam format: address_priority_weight_port. Pisahkan beberapa server asal 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 asal ulang.	3
retry_status_rule	Integer	No	Kode status untuk mencoba ulang. 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 asal 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 asal saat node CDN dan server asal 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 asal IPv6; permintaan klien IPv4 lebih memilih server asal IPv4.	on
ipv6_v4_mix_used	String	No	Menentukan apakah akan mengaktifkan pengambilan asal round-robin IPv4/IPv6. Nilai yang valid: `on`, `off`. Saat diaktifkan, fitur IPv6 asal dan follow menjadi tidak efektif. Semua permintaan menggunakan round-robin di semua alamat asal 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 asal tipe OSS untuk nama domain yang dipercepat. Jangan menghapus konfigurasi ini secara manual karena dapat menyebabkan masalah penagihan untuk lalu lintas asal 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 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 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 akhiran, 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 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 akhiran, 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 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 (malicious IP)

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 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 (malicious IP)

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 tiap 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 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 ditambahkan, dipisahkan tanda pipa (\|), case-sensitive.	(empty)
remote_auth_reserve_header	String	Yes	Header permintaan yang disimpan, dipisahkan 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 ditambahkan, dipisahkan tanda pipa (\|), case-insensitive.	(empty)
remote_auth_success_code	Integer	Yes	Kode status keberhasilan otentikasi yang dikembalikan oleh server otentikasi. Beberapa kode dipisahkan koma.	200
remote_auth_fail_code	Integer	Yes	Kode status kegagalan otentikasi yang dikembalikan oleh server otentikasi. Beberapa kode dipisahkan 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 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 sekaligus.	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 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 asal. Saat diaktifkan, kebijakan cache dari header respons asal (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 no-cache asal. Saat diaktifkan, header respons asal 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 0, konten di-cache di node CDN dan divalidasi ulang dengan asal pada setiap permintaan), `off` (default, saat TTL 0, konten tidak di-cache dan diambil dari asal 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 sebelum asal (exit_after_return_code diatur ke on): CDN tidak mengambil dari asal. Permintaan dicegat langsung dan mengembalikan kode status respons serta badan respons (jika dikonfigurasi) ke klien.

Mode respons setelah asal (exit_after_return_code diatur ke return_code_phase atau kosong): CDN terlebih dahulu mengambil konten dari asal, lalu mengembalikan kode status respons dan konten respons asal ke klien. Pengaturan ini tidak berlaku secara default dalam mode setelah asal; badan respons selalu merupakan konten yang dikembalikan oleh asal. Untuk mengganti badan respons asal, 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 sebelum asal. CDN tidak mengambil dari asal. Permintaan dicegat langsung dan mengembalikan kode status respons dan badan respons (jika dikonfigurasi) ke klien. `return_code_phase`: Respons setelah asal. CDN terlebih dahulu mengambil konten dari asal, lalu mengembalikan kode status respons dan konten respons asal 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 sebelum asal: jika ditentukan, konten ini dikembalikan sebagai badan respons; jika tidak ditentukan, hanya kode status yang dikembalikan. Dalam mode respons setelah asal: pengaturan ini tidak berlaku secara default; badan respons selalu merupakan konten yang dikembalikan oleh asal.	example
ali_body_filter_switch	String	No	Saklar untuk memodifikasi konten respons asal. Pengaturan ini hanya berlaku dalam mode respons setelah asal. Saat diaktifkan, CDN mengganti badan respons asal 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 asal. Pengaturan ini hanya berlaku dalam mode respons setelah asal dan saat modifikasi konten respons asal diaktifkan. Saat ditentukan, CDN hanya memicu logika penggantian konten respons saat asal 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 asal. Nilai yang valid: `on`, `off` (default).	off
swift_no_cache_low	String	No	Menentukan apakah akan mengabaikan header respons no-cache asal. 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 dan kode status.
Function ID: 63
Parameters:

Parameter	Type	Required	Description	Example
file_type	String	Yes	Jenis file, case-sensitive, dipisahkan koma (,).	jpg
code_string	String	Yes	Kode status dan durasi cache-nya dalam detik (1-99999999), dipisahkan koma. Format: code=ttl.	403=10
swift_code_origin_cache_high	String	No	Menentukan apakah akan memprioritaskan kebijakan cache asal. Nilai yang valid: `on`, `off` (default).	off
swift_code_no_cache_low	String	No	Menentukan apakah akan mengabaikan header respons no-cache asal. 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 dan 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 koma. Format: code=ttl.	403=10,404=15
swift_code_origin_cache_high	String	No	Menentukan apakah akan memprioritaskan kebijakan cache asal. Nilai yang valid: `on`, `off` (default).	off
swift_code_no_cache_low	String	No	Menentukan apakah akan mengabaikan header respons no-cache asal. 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 berbasis kode status (prioritas asal).
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 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 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 yang pertama saja).	off
access_origin_control	String	No	Menentukan apakah akan mengaktifkan validasi cross-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

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 asal 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 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 asal 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 asal tidak tersedia.
Function ID: 260
Parameters:

Parameter	Type	Required	Description	Example
origin_error_status_code	String	No	Kode status error asal kustom yang memicu penyajian konten kedaluwarsa. Secara default (saat tidak ditentukan), error asal didefinisikan sebagai timeout ditambah semua kode status 5xx. Mendukung pencocokan kabur (4xx, 5xx) dan pencocokan eksak (502, 504). Beberapa kode dipisahkan 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 stale-if-error asal. Saat diaktifkan (on), jika respons asal 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 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 mengaktifkan, 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 dipertahankan, dipisahkan 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 asal. Nilai yang valid: `on` (pertahankan semua parameter), `off` (parameter asal 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 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 asal. Nilai yang valid: `on` (pertahankan semua parameter), `off` (parameter asal 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 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 berlaku. 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, intersepsi di awal pemrosesan permintaan), `foot` (intersepsi 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	Sintaksis aturan. Nilai yang valid: `es2` (default), `js`.	es2
jsmode	String	No	Mode eksekusi JS. Nilai yang valid: `redirect` (mode intersepsi), `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"}

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 spasi. Juga mendukung global untuk pemblokiran 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"
}