Appelez l'opération BatchSetVodDomainConfigs pour configurer simultanément les fonctionnalités de plusieurs noms de domaine. Les sections suivantes répertorient les fonctionnalités disponibles ainsi que les paramètres associés à chacune d'elles.
Ces fonctionnalités peuvent être référencées lors de l'appel des opérations API suivantes : BatchSetVodDomainConfigs et DescribeVodDomainConfigs.
Paramètres de base
ipv6
Description : Configure l'accès IPv6.
ID de fonction : 194
Paramètres :
|
Parameter |
Type |
Required |
Description |
Example |
|
switch |
String |
Yes |
Indique s'il faut activer l'accès IPv6. Valeurs valides : |
on |
|
region |
String |
Yes |
Région où IPv6 est activé. Utilisez un astérisque ( |
* |
Exemple :
{
"Functions": [{
"functionArgs": [{
"argName": "switch",
"argValue": "on"
}, {
"argName": "region",
"argValue": "*"
}],
"functionName": "ipv6"
}],
"DomainNames": "example.com"
}
Paramètres de retour à l'origine
set_req_host_header
Description : Configure l'hôte d'origine par défaut.
ID de fonction : 18
Paramètres :
|
Parameter |
Type |
Required |
Description |
Example |
|
domain_name |
String |
Yes |
Contenu de l'en-tête d'hôte d'origine. |
example.com |
Exemple :
{
"Functions": [{
"functionArgs": [{
"argName": "domain_name",
"argValue": "example.com"
}],
"functionName": "set_req_host_header"
}],
"DomainNames": "example.com"
}
forward_scheme
Description : Configure le protocole d'origine.
ID de fonction : 47
Paramètres :
|
Parameter |
Type |
Required |
Description |
Example |
|
enable |
String |
Yes |
Indique s'il faut activer la fonctionnalité de protocole d'origine. Valeurs valides : |
on |
|
scheme_origin |
String |
No |
Schéma de protocole pour la récupération depuis l'origine. Valeurs valides : |
follow |
|
scheme_origin_port |
String |
No |
Ports d'origine personnalisés. Requis lorsque |
80:443 |
Exemple :
{
"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 : Configure la récupération depuis un bucket OSS privé. Lors de la première utilisation de cette fonctionnalité, vous devez activer la stratégie d'autorisation par défaut, qui accorde au CDN un accès en lecture seule à tous les buckets OSS sous le même compte Alibaba Cloud.
ID de fonction : 85
Paramètres :
|
Parameter |
Type |
Required |
Description |
Example |
|
private_oss_auth |
String |
Yes |
Indique s'il faut activer la récupération depuis un bucket OSS privé. Valeurs valides : |
on |
|
perm_private_oss_tbl |
String |
No |
Configuration du jeton de sécurité permanent. Format : access_id=123 access_secret=123abc (séparés par un espace). Une fois configuré, la récupération depuis l'origine du CDN vers des buckets OSS privés sous d'autres comptes Alibaba Cloud est également prise en charge. |
access_id=123 access_secret=123abc |
Exemple :
{
"Functions": [{
"functionArgs": [{
"argName": "private_oss_auth",
"argValue": "on"
}, {
"argName": "perm_private_oss_tbl",
"argValue": "access_id=123 access_secret=123abc"
}],
"functionName": "l2_oss_key"
}],
"DomainNames": "example.com"
}
https_origin_sni
Description : Configure le SNI (Server Name Indication) d'origine.
ID de fonction : 114
Paramètres :
|
Parameter |
Type |
Required |
Description |
Example |
|
enabled |
String |
Yes |
Indique s'il faut activer le SNI d'origine. Valeurs valides : |
on |
|
https_origin_sni |
String |
Yes |
Informations SNI incluses dans les requêtes vers l'origine (adresse du serveur d'origine que la requête doit atteindre). |
origin.example.com |
Exemple :
{
"Functions": [{
"functionArgs": [{
"argName": "https_origin_sni",
"argValue": "origin.example.com"
}, {
"argName": "enabled",
"argValue": "on"
}],
"functionName": "https_origin_sni"
}],
"DomainNames": "example.com"
}
forward_timeout
Description : Configure le délai d'expiration des requêtes vers l'origine.
ID de fonction : 124
Paramètres :
|
Parameter |
Type |
Required |
Description |
Example |
|
forward_timeout |
Integer |
Yes |
Délai d'expiration de la requête en secondes. Nous recommandons de définir une valeur inférieure à 100 secondes. |
30 |
Exemple :
{
"Functions": [{
"functionArgs": [{
"argName": "forward_timeout",
"argValue": "30"
}],
"functionName": "forward_timeout"
}],
"DomainNames": "example.com"
}
advanced_origin
Description : Configure la récupération avancée depuis l'origine, qui achemine les requêtes vers différents serveurs d'origine en fonction des variables contenues dans la requête utilisateur (telles que l'URI, les en-têtes, les paramètres de requête ou les cookies).
ID de fonction : 235
Conflit : Entre en conflit avec
origin_dns_host(ID de fonction : 212). Une seule de ces configurations peut être appliquée. Si l'une des fonctionnalités est déjà configurée (y compris lorsque son paramètre de commutation est défini sur off), vous devez supprimer la configuration existante avant de configurer l'autre.Paramètres :
|
Parameter |
Type |
Required |
Description |
Example |
|
variable_type |
String |
Yes |
Type de variable. Valeurs valides : |
uri |
|
variable |
String |
Yes |
Nom de la variable. Lorsque variable_type est défini sur uri, la variable doit être définie sur uri. |
uri |
|
conditions |
String |
Yes |
Opérateur de condition. Valeurs valides : == (égal à), != (différent de). |
== |
|
value |
String |
Yes |
Valeur de la variable à faire correspondre. |
/image |
|
origin |
String |
Yes |
Nom de domaine du serveur d'origine à utiliser lorsque la variable correspond à la valeur spécifiée. |
origin.example.com |
Exemple :
{
"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 : Configure le suivi des redirections 302 depuis l'origine.
ID de fonction : 219
Paramètres :
|
Parameter |
Type |
Required |
Description |
Example |
|
enable |
String |
Yes |
Indique s'il faut activer le suivi des redirections 302 depuis l'origine. Valeurs valides : |
on |
|
max_tries |
Integer |
No |
Nombre maximal de redirections 302 à suivre. Valeur par défaut : 2. Valeurs valides : 1-5. Le nombre maximal réel de requêtes vers l'origine est max_tries + 1. |
2 |
|
retain_args |
String |
No |
Indique s'il faut conserver les paramètres de la requête d'origine lors du suivi des redirections 302. Valeurs valides : |
off |
|
retain_header |
String |
No |
Indique s'il faut conserver les en-têtes de la requête d'origine lors du suivi des redirections 302. Valeurs valides : |
off |
|
response_header |
String |
No |
Nom de l'en-tête de réponse pour la redirection 302. Valeur par défaut : Location. |
X-Alicdn-Redirect |
|
retain_host |
String |
No |
Indique s'il faut conserver l'hôte d'origine lors du suivi des redirections 302. Valeurs valides : |
off |
|
modify_host |
String |
No |
Modifie l'hôte d'origine lors du suivi des redirections 302. Par défaut, l'hôte d'origine n'est pas modifié. |
example.com |
|
cache |
String |
No |
Indique s'il faut mettre en cache les résultats des redirections 302 pour la même URL afin d'améliorer les performances de réponse du CDN. Valeurs valides : |
off |
|
expired_time |
Integer |
No |
Durée d'expiration du cache pour les résultats des redirections 302, en secondes. Doit être utilisé avec le paramètre cache. Valeur par défaut : 3600. |
7200 |
|
follow_origin_host |
String |
No |
Indique s'il faut utiliser le nom de domaine du serveur d'origine comme hôte d'origine (utilise le dernier domaine d'origine même après un basculement principal/secondaire). Valeurs valides : |
off |
|
follow_5xx_retry_origin |
String |
No |
Indique s'il faut basculer vers le serveur d'origine disponible suivant lorsque le serveur d'origine actuel répond par un code d'état 5xx. Valeurs valides : |
off |
Exemple :
{
"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"
}
ipv6_origin
Description : Configure la récupération depuis l'origine via IPv6.
ID de fonction : 265
Paramètres :
|
Parameter |
Type |
Required |
Description |
Example |
|
enable |
String |
Yes |
Indique s'il faut activer la récupération depuis l'origine via IPv6. Valeurs valides : |
on |
|
follow |
String |
Yes |
Indique s'il faut suivre la version du protocole IP du client pour la récupération depuis l'origine. Valeurs valides : |
on |
|
ipv6_v4_mix_used |
String |
No |
Indique s'il faut activer la récupération depuis l'origine en alternance IPv4/IPv6 (round-robin). Valeurs valides : |
off |
Exemple :
{
"Functions": [{
"functionArgs": [{
"argName": "enable",
"argValue": "on"
}, {
"argName": "follow",
"argValue": "on"
}],
"functionName": "ipv6_origin"
}],
"DomainNames": "example.com"
}
origin_request_header
Description : Configure les en-têtes HTTP personnalisés des requêtes vers l'origine (v2). Prend en charge les opérations d'ajout, de suppression, de modification et de réécriture.
ID de fonction : 228
Paramètres :
|
Paramètre |
Type |
Obligatoire |
Description |
Exemple |
|
header_operation_type |
String |
Oui |
Type d'opération sur l'en-tête. Valeurs valides : |
add |
|
header_name |
String |
Oui |
Nom de l'en-tête de requête. |
Accept-Encoding |
|
header_value |
String |
Non |
Valeur de l'en-tête de requête. Plusieurs valeurs peuvent être séparées par des virgules (,). |
gzip |
|
duplicate |
String |
Non |
Indique s'il est autorisé d'avoir des en-têtes dupliqués portant le même nom (lors de l'utilisation de l'opération add). Valeurs valides : |
off |
|
header_source |
String |
Non |
Valeur à rechercher pour le remplacement (lors de l'utilisation de l'opération rewrite). Prend en charge les expressions régulières. |
value1 |
|
header_destination |
String |
Non |
Valeur de remplacement (lors de l'utilisation de l'opération rewrite). |
value123 |
|
match_all |
String |
Non |
Mode de correspondance (lors de l'utilisation de l'opération rewrite). Valeurs valides : |
off |
Exemple :
{
"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 : Configure les en-têtes HTTP des réponses provenant de l'origine. Prend en charge les opérations d'ajout, de suppression, de modification et de réécriture.
ID de fonction : 229
Paramètres :
|
Paramètre |
Type |
Obligatoire |
Description |
Exemple |
|
header_operation_type |
String |
Oui |
Type d'opération sur l'en-tête de réponse. Valeurs valides : |
add |
|
header_name |
String |
Oui |
Nom de l'en-tête de réponse. |
Cache-Control |
|
header_value |
String |
Non |
Valeur de l'en-tête de réponse. Plusieurs valeurs peuvent être séparées par des virgules (,). |
no-cache |
|
duplicate |
String |
Non |
Indique s'il est autorisé d'avoir des en-têtes dupliqués portant le même nom (lors de l'utilisation de l'opération add). Valeurs valides : |
off |
|
header_source |
String |
Non |
Valeur à rechercher pour le remplacement (lors de l'utilisation de l'opération rewrite). Prend en charge les expressions régulières. |
value1 |
|
header_destination |
String |
Non |
Valeur de remplacement (lors de l'utilisation de l'opération rewrite). |
value123 |
|
match_all |
String |
Non |
Mode de correspondance (lors de l'utilisation de l'opération rewrite). Valeurs valides : |
off |
Exemple :
{
"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 : Configure la réécriture des URI vers l'origine.
ID de fonction : 225
Paramètres :
|
Paramètre |
Type |
Obligatoire |
Description |
Exemple |
|
source_url |
String |
Oui |
URI à réécrire. |
^/hello$ |
|
target_url |
String |
Oui |
URI cible après réécriture. |
/hello/test |
|
flag |
String |
Non |
Règle d'exécution pour l'opération de réécriture. Valeurs valides : (vide, par défaut) continue à faire correspondre les règles de réécriture suivantes après l'exécution ; break : arrête la correspondance des règles suivantes après l'exécution ; enhance_break : similaire à break mais traite les paramètres ensemble et fonctionne également pour le streaming en direct FLV. |
break |
|
sequence |
Integer |
Non |
Définit la priorité d'exécution de la configuration. Valeurs valides : 1 à 99. Une valeur plus petite indique une priorité plus élevée. Si ce paramètre n'est pas spécifié, les priorités sont automatiquement attribuées par ordre croissant à partir de 1. |
1 |
Exemple :
{
"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"
}
Paramètres de cache
filetype_based_ttl_set
Description : Configure la durée d'expiration des fichiers.
ID de fonction : 6
Paramètres :
|
Paramètre |
Type |
Obligatoire |
Description |
Exemple |
|
ttl |
Integer |
Oui |
Durée du cache en secondes. Valeurs valides : 1-99999999. |
500000 |
|
file_type |
String |
Oui |
Types de fichiers, séparés par des virgules ( |
jpg |
|
weight |
Integer |
Non |
Priorité. Valeurs valides : 1-99. Valeur par défaut : |
1 |
|
swift_origin_cache_high |
String |
Non |
Indique s'il faut privilégier la politique de cache de l'origine. Lorsqu'elle est activée, la politique de cache issue des en-têtes de réponse de l'origine (tels que Cache-Control et Pragma) est prioritaire. Valeurs valides : |
off |
|
swift_no_cache_low |
String |
Non |
Indique s'il faut ignorer les en-têtes de réponse no-cache de l'origine. Lorsqu'elle est activée, les en-têtes de réponse suivants de l'origine sont ignorés : Cache-Control: no-store, Cache-Control: no-cache, Cache-Control: max-age=0, Pragma: no-cache. Valeurs valides : |
off |
|
swift_follow_cachetime |
String |
Non |
Indique si le client suit la politique de cache du CDN. Lorsqu'elle est activée, la politique de cache CDN finale effective est envoyée dans la réponse au client. Valeurs valides : |
off |
|
force_revalidate |
String |
Non |
Indique s'il faut forcer la validation du contenu lorsque le TTL est égal à 0. Valeurs valides : |
off |
Exemple :
{
"Functions": [{
"functionArgs": [{
"argName": "ttl",
"argValue": "500000"
}, {
"argName": "file_type",
"argValue": "jpg"
}],
"functionName": "filetype_based_ttl_set"
}],
"DomainNames": "example.com"
}
path_based_ttl_set
Description : Configure la durée d'expiration du cache basée sur le répertoire.
ID de fonction : 7
Paramètres :
|
Paramètre |
Type |
Obligatoire |
Description |
Exemple |
|
ttl |
Integer |
Oui |
Durée du cache en secondes. Valeurs valides : 1-99999999. |
500000 |
|
path |
String |
Oui |
Chemin du répertoire, qui doit commencer par une barre oblique (/). |
/example/demo |
|
weight |
Integer |
Non |
Priorité. Valeurs valides : 1-99. Valeur par défaut : 1 (une valeur plus élevée signifie une priorité plus élevée). |
1 |
|
swift_origin_cache_high |
String |
Non |
Indique s'il faut privilégier la politique de cache de l'origine. Valeurs valides : |
off |
|
swift_no_cache_low |
String |
Non |
Indique s'il faut ignorer les en-têtes de réponse no-cache de l'origine. Valeurs valides : |
off |
|
swift_follow_cachetime |
String |
Non |
Indique si le client suit la politique de cache du CDN. Valeurs valides : |
off |
|
force_revalidate |
String |
Non |
Indique s'il faut forcer la validation du contenu lorsque le TTL est égal à 0. Valeurs valides : |
off |
Exemple :
{
"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 : Configure la durée d'expiration du cache basée sur le code d'état et le type de fichier.
ID de fonction : 63
Paramètres :
|
Paramètre |
Type |
Obligatoire |
Description |
Exemple |
|
file_type |
String |
Oui |
Types de fichiers, sensibles à la casse, séparés par des virgules (,). |
jpg |
|
code_string |
String |
Oui |
Codes d'état et leurs durées de cache en secondes (1-99999999), séparés par des virgules. Format : code=ttl. |
403=10 |
|
swift_code_origin_cache_high |
String |
Non |
Indique s'il faut privilégier la politique de cache de l'origine. Valeurs valides : |
off |
|
swift_code_no_cache_low |
String |
Non |
Indique s'il faut ignorer les en-têtes de réponse no-cache de l'origine. Valeurs valides : |
off |
|
swift_code_follow_cachetime |
String |
Non |
Indique si le client suit la politique de cache du CDN. Valeurs valides : |
off |
|
force_revalidate |
String |
Non |
Indique s'il faut forcer la validation du contenu lorsque le TTL est égal à 0. Valeurs valides : |
off |
Exemple :
{
"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 : Définit la durée d'expiration du cache pour les codes d'état en fonction du chemin.
ID de fonction : 65
Paramètres :
|
Paramètre |
Type |
Obligatoire |
Description |
Exemple |
|
path |
String |
Oui |
Chemin du répertoire, qui doit commencer par une barre oblique (/). |
/example/demo |
|
code_string |
String |
Oui |
Codes d'état et leurs durées de mise en cache en secondes (1 à 99999999), séparés par des virgules. Format : code=ttl. |
403=10 404=15 |
|
swift_code_origin_cache_high |
String |
Non |
Indique s'il faut prioriser la politique de cache de l'origine. Valeurs valides : |
off |
|
swift_code_no_cache_low |
String |
Non |
Indique s'il faut ignorer les en-têtes de réponse no-cache de l'origine. Valeurs valides : |
off |
|
swift_code_follow_cachetime |
String |
Non |
Indique si le client suit la politique de cache du CDN. Valeurs valides : |
off |
|
force_revalidate |
String |
Non |
Indique s'il faut forcer la validation du contenu lorsque le TTL est égal à 0. Valeurs valides : |
off |
Exemple :
{
"Functions": [{
"functionArgs": [{
"argName": "path",
"argValue": "/example/demo"
}, {
"argName": "code_string",
"argValue": "403=10,404=15"
}],
"functionName": "path_force_ttl_code"
}],
"DomainNames": "example.com"
}
set_resp_header
Description : Définit des en-têtes de réponse HTTP personnalisés.
ID de fonction : 27
Paramètres :
|
Paramètre |
Type |
Obligatoire |
Description |
Exemple |
|
key |
String |
Oui |
Nom de l'en-tête de réponse. |
Cache-Control |
|
value |
String |
Oui |
Valeur de l'en-tête de réponse. Plusieurs valeurs sont séparées par des virgules (,). Pour supprimer un en-tête, définissez la valeur sur null. |
no-cache |
|
header_operation_type |
String |
Non |
Type d'opération sur l'en-tête. Valeurs valides : |
add |
|
duplicate |
String |
Non |
Indique s'il faut autoriser les en-têtes en double (lors de l'utilisation de l'opération add). Valeurs valides : |
off |
|
header_source |
String |
Non |
Valeur à rechercher pour le remplacement (lors de l'utilisation de rewrite). Prend en charge les expressions régulières. |
value1 |
|
header_destination |
String |
Non |
Valeur de remplacement (lors de l'utilisation de rewrite). |
value123 |
|
match_all |
String |
Non |
Mode de correspondance (lors de l'utilisation de rewrite). Valeurs valides : |
off |
|
access_origin_control |
String |
Non |
Indique s'il faut activer la validation cross-origin. Valeurs valides : |
off |
Exemple :
{
"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 : Définit des pages d'erreur personnalisées.
ID de fonction : 15
Paramètres :
|
Paramètre |
Type |
Obligatoire |
Description |
Exemple |
|
error_code |
Integer |
Oui |
Code d'état d'erreur. |
404 |
|
rewrite_page |
String |
Oui |
URL de la page de redirection. |
http://example.aliyundoc.com/error404.html |
Exemple :
{
"Functions": [{
"functionArgs": [{
"argName": "error_code",
"argValue": "404"
}, {
"argName": "rewrite_page",
"argValue": "http://example.aliyundoc.com/error404.html"
}],
"functionName": "error_page"
}],
"DomainNames": "example.com"
}
rewrite_host
Description : Définit le cache partagé (réécriture de la clé de cache).
ID de fonction : 54
Paramètres :
|
Paramètre |
Type |
Obligatoire |
Description |
Exemple |
|
share_host |
String |
Oui |
Nom de domaine cible pouvant partager le cache avec le domaine actuel. Cela ne modifie pas l'hôte d'origine dans les requêtes utilisateur. La valeur share_host est uniquement utilisée pour générer la clé de cache lors des recherches de cache. |
example.com |
Exemple :
{
"Functions": [{
"functionArgs": [{
"argName": "share_host",
"argValue": "example.com"
}],
"functionName": "rewrite_host"
}],
"DomainNames": "example.com"
}
Paramètres HTTPS
https_option
Description : Définit les paramètres de base HTTPS.
ID de fonction : 78
Paramètres :
|
Paramètre |
Type |
Obligatoire |
Description |
Exemple |
|
http2 |
String |
Non |
Indique s'il faut activer HTTP/2. Valeurs valides : |
on |
|
ocsp_stapling |
String |
Non |
Indique s'il faut activer OCSP Stapling. Valeurs valides : |
on |
Exemple :
{
"Functions": [{
"functionArgs": [{
"argName": "http2",
"argValue": "on"
}],
"functionName": "https_option"
}],
"DomainNames": "example.com"
}
http_force
Description : Définit la redirection HTTP forcée.
ID de fonction : 45
Conflit : Entre en conflit avec
https_force(ID de fonction : 44). Une seule de ces configurations peut être appliquée. Si l'une des fonctionnalités est déjà configurée (y compris lorsque son paramètre de commutation est défini sur off), vous devez supprimer la configuration existante avant de configurer l'autre.Paramètres :
|
Paramètre |
Type |
Obligatoire |
Description |
Exemple |
|
enable |
String |
Oui |
Indique s'il faut activer la redirection HTTP forcée. Valeurs valides : |
on |
|
http_rewrite |
String |
Non |
Méthode de redirection. Valeurs valides : 301 (la méthode de requête GET reste inchangée, les autres méthodes peuvent être converties en GET), 308 (la méthode de requête et le corps sont conservés). |
301 |
Exemple :
{
"Functions": [{
"functionArgs": [{
"argName": "enable",
"argValue": "on"
}, {
"argName": "http_rewrite",
"argValue": "301"
}],
"functionName": "http_force"
}],
"DomainNames": "example.com"
}
https_force
Description : Définit la redirection HTTPS.
ID de fonction : 44
Conflit : Entre en conflit avec
http_force(ID de fonction : 45). Une seule de ces configurations peut être appliquée.Paramètres :
|
Paramètre |
Type |
Obligatoire |
Description |
Exemple |
|
enable |
String |
Oui |
Indique s'il faut activer la redirection HTTPS. Valeurs valides : |
on |
|
https_rewrite |
String |
Non |
Méthode de redirection. Valeurs valides : |
301 |
Exemple :
{
"Functions": [{
"functionArgs": [{
"argName": "enable",
"argValue": "on"
}, {
"argName": "https_rewrite",
"argValue": "301"
}],
"functionName": "https_force"
}],
"DomainNames": "example.com"
}
https_tls_version
Description : Définit les versions du protocole TLS.
ID de fonction : 110
Paramètres :
|
Paramètre |
Type |
Obligatoire |
Description |
Exemple |
|
tls10 |
String |
Non |
Indique s'il faut activer TLS 1.0. Valeurs valides : |
on |
|
tls11 |
String |
Non |
Indique s'il faut activer TLS 1.1. Valeurs valides : |
on |
|
tls12 |
String |
Non |
Indique s'il faut activer TLS 1.2. Valeurs valides : |
on |
|
tls13 |
String |
Non |
Indique s'il faut activer TLS 1.3. Valeurs valides : |
on |
|
ciphersuitegroup |
String |
Non |
Groupe de suites de chiffrement. Valeurs valides : |
all |
|
ciphersuite |
String |
Non |
Suites de chiffrement personnalisées. Utilisé conjointement avec ciphersuitegroup défini sur custom. Plusieurs suites de chiffrement sont séparées par des virgules. |
TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 |
Exemple :
{
"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"
}
Paramètres de contrôle d'accès
referer_white_list_set
Description : Définit une liste blanche de Referer.
ID de fonction : 1
Conflit : Entre en conflit avec
referer_black_list_set(ID de fonction : 5). Une seule de ces configurations peut être appliquée.Paramètres :
|
Paramètre |
Type |
Obligatoire |
Description |
Exemple |
|
refer_domain_allow_list |
String |
Oui |
Liste blanche des domaines Referer, séparés par des virgules ( |
example.aliyundoc.com,demo.aliyundoc.com |
|
allow_empty |
String |
Non |
Indique s'il faut autoriser les champs Referer vides. Valeurs valides : |
off |
|
redirect_url |
String |
Non |
URL de redirection pour les requêtes non correspondantes (doit commencer par |
http://www.example.com |
|
disable_ast |
String |
Non |
Mode de correspondance exacte. Valeurs valides : |
off |
|
ignore_scheme |
String |
Non |
Indique s'il faut ignorer le schéma HTTP ou HTTPS dans le Referer. Valeurs valides : |
off |
Exemple :
{
"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 : Configure une liste noire de Referer.
ID de fonction : 5
Conflit : Entre en conflit avec
referer_white_list_set(ID de fonction : 1). Une seule de ces configurations peut être active à la fois.Paramètres :
|
Paramètre |
Type |
Obligatoire |
Description |
Exemple |
|
refer_domain_deny_list |
String |
Oui |
Liste noire des domaines Referer, séparés par des virgules ( |
example.aliyundoc.com,demo.aliyundoc.com |
|
allow_empty |
String |
Non |
Indique si les champs Referer vides sont autorisés. Valeurs valides : |
off |
|
redirect_url |
String |
Non |
URL de redirection pour les requêtes correspondantes. |
http://www.example.com |
|
disable_ast |
String |
Non |
Mode de correspondance exacte. Valeurs valides : |
off |
|
ignore_scheme |
String |
Non |
Indique si le schéma HTTP ou HTTPS du Referer doit être ignoré. Valeurs valides : |
off |
Exemple :
{
"Functions": [{
"functionArgs": [{
"argName": "refer_domain_deny_list",
"argValue": "example.aliyundoc.com,demo.aliyundoc.com"
}],
"functionName": "referer_black_list_set"
}],
"DomainNames": "example.com"
}
aliauth
Description : Configure l'authentification URL.
ID de fonction : 25
Paramètres :
|
Paramètre |
Type |
Obligatoire |
Description |
Exemple |
|
auth_m3u8 |
String |
Non |
Active la réécriture du contenu m3u8. Lorsqu'elle est activée, les paramètres d'authentification sont ajoutés aux segments TS dans le fichier m3u8 pour éviter les échecs d'authentification d'accès aux TS. Valeurs valides : |
on |
|
auth_type |
String |
Oui |
Type d'authentification. Valeurs valides : |
type_a |
|
auth_key1 |
String |
Oui |
Clé d'authentification 1 (16 à 128 caractères, uniquement lettres et chiffres). |
1234567890123456789 |
|
auth_key2 |
String |
Non |
Clé d'authentification 2 (16 à 128 caractères, uniquement lettres et chiffres). |
1234567890123456789 |
|
ali_auth_delta |
Integer |
Non |
Durée de validité de l'URL authentifiée, en secondes. Valeur par défaut : |
1800 |
|
req_auth_ip_white |
String |
Non |
Adresses IP de la liste blanche exemptées d'authentification. Séparez plusieurs adresses IP par des virgules (,). |
192.168.0.1 |
|
req_auth_ip_acl_xfwd |
String |
Non |
Méthode d'extraction de l'adresse IP du client pour l'exemption de la liste blanche. Valeurs valides : |
all |
|
sign_param |
String |
Non |
Nom du paramètre de signature. Valide uniquement lorsque auth_type est défini sur type_f. |
sign |
|
time_param |
String |
Non |
Nom du paramètre d'horodatage. Valide uniquement lorsque auth_type est défini sur type_f. |
time |
|
time_format |
String |
Non |
Format de l'horodatage. Valide uniquement lorsque auth_type est défini sur type_f. Valeurs valides : |
hex |
|
path_encoding |
String |
Non |
Indique si l'encodage URL doit être activé. Valide uniquement lorsque auth_type est défini sur type_f. Valeurs valides : |
on |
Exemple 1 (Type d'authentification 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"
}
Exemple 2 (Type d'authentification 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 : Configure l'authentification distante.
ID de fonction : 258
Paramètres :
|
Paramètre |
Type |
Obligatoire |
Description |
Exemple |
|
|
enable |
String |
Oui |
Indique si l'authentification distante doit être activée. Valeurs valides : |
on |
|
|
remote_auth_addr |
String |
Oui |
Adresse du serveur d'authentification. Format : https://cdn.aliyun.com/auth ou http://10.10.10.10/auth. |
https://example.aliyundoc.com/auth |
|
|
remote_auth_method |
String |
Oui |
Méthode de requête. Valeurs valides : GET, POST, HEAD. |
get |
|
|
remote_auth_type |
String |
Oui |
Type de fichier à authentifier. Définissez sur all pour tous les types. Plusieurs types sont séparés par des barres verticales ( |
), sensibles à la casse. |
all |
|
remote_auth_reserve_args |
String |
Oui |
Paramètres de requête réservés, séparés par des barres verticales ( |
), non sensibles à la casse. Définissez sur all pour réserver tous les paramètres, ou sur ali_delete_all_args pour supprimer tous les paramètres URL. |
all |
|
remote_auth_custom_args |
String |
Non |
Paramètres personnalisés à ajouter, séparés par des barres verticales ( |
), sensibles à la casse. |
(vide) |
|
remote_auth_reserve_header |
String |
Oui |
En-têtes de requête réservés, séparés par des barres verticales ( |
), non sensibles à la casse. Définissez sur all pour réserver tous les en-têtes, ou sur ali_delete_all_headers pour supprimer tous les en-têtes. |
all |
|
remote_auth_custom_header |
String |
Non |
En-têtes de requête personnalisés à ajouter, séparés par des barres verticales ( |
), non sensibles à la casse. |
(vide) |
|
remote_auth_success_code |
Integer |
Oui |
Code d'état de succès d'authentification renvoyé par le serveur d'authentification. Plusieurs codes sont séparés par des virgules. |
200 |
|
|
remote_auth_fail_code |
Integer |
Oui |
Code d'état d'échec d'authentification renvoyé par le serveur d'authentification. Plusieurs codes sont séparés par des virgules. |
403 404 |
|
|
remote_auth_other_code_act |
String |
Non |
Action pour les autres codes d'état (ni succès ni échec). Valeurs valides : |
pass |
|
|
remote_auth_fail_resp_code |
Integer |
Oui |
Code d'état que le CDN renvoie au client en cas d'échec de l'authentification. |
403 |
|
|
remote_auth_timeout |
Integer |
Oui |
Délai d'attente d'authentification en millisecondes. Valeur maximale : 3000. |
500 |
|
|
remote_auth_timeout_action |
String |
Oui |
Action en cas de délai d'attente d'authentification dépassé. Valeurs valides : |
pass |
Exemple :
{
"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"
}
ip_allow_list_set
Description : Configure une liste blanche d'adresses IP.
ID de fonction : 69
Conflit : Entre en conflit avec
ip_black_list_set(ID de fonction : 13). Une seule de ces configurations peut être active à la fois.Paramètres :
|
Paramètre |
Type |
Obligatoire |
Description |
Exemple |
|
ip_list |
String |
Oui |
Liste d'adresses IP ou de blocs CIDR, séparés par des virgules ( |
192.168.0.1/24 |
|
customize_response_status_code |
String |
Non |
Code d'état de réponse personnalisé. Valeur par défaut : |
429 |
|
ip_acl_xfwd |
String |
Non |
Mode de correspondance des adresses IP. Valeurs valides : |
all |
|
ip_list_notes |
String |
Non |
Notes pour la liste d'adresses IP. |
192.x.x.1 (adresse IP malveillante) |
Exemple :
{
"Functions": [{
"functionArgs": [{
"argName": "ip_list",
"argValue": "192.168.0.1/24"
}],
"functionName": "ip_allow_list_set"
}],
"DomainNames": "example.com"
}
ip_black_list_set
Description : Configure une liste noire d'adresses IP.
ID de fonction : 13
Conflit : Entre en conflit avec
ip_allow_list_set(ID de fonction : 69). Une seule de ces configurations peut être active à la fois.Paramètres :
|
Paramètre |
Type |
Obligatoire |
Description |
Exemple |
|
ip_list |
String |
Oui |
Liste d'adresses IP ou de blocs CIDR, séparés par des virgules ( |
192.168.0.1 |
|
customize_response_status_code |
String |
Non |
Code d'état de réponse personnalisé. Valeur par défaut : |
429 |
|
ip_acl_xfwd |
String |
Non |
Mode de correspondance des adresses IP. Valeurs valides : |
all |
|
ip_list_notes |
String |
Non |
Notes pour la liste d'adresses IP. |
192.x.x.1 (adresse IP malveillante) |
Exemple :
{
"Functions": [{
"functionArgs": [{
"argName": "ip_list",
"argValue": "192.168.0.1"
}],
"functionName": "ip_black_list_set"
}],
"DomainNames": "example.com"
}
ali_ua
Description : Configure les restrictions d'accès basées sur l'User-Agent.
ID de fonction : 58
Paramètres :
|
Paramètre |
Type |
Obligatoire |
Description |
Exemple |
||||
|
ua |
String |
Oui |
Valeurs User-Agent. Prend en charge le caractère générique * (correspond à n'importe quelle chaîne) et plusieurs valeurs séparées par des barres verticales ( |
). |
curl |
IE |
chrome |
firefox |
|
type |
String |
Oui |
Type de liste. Valeurs valides : |
black |
Exemple :
{
"Functions": [{
"functionArgs": [{
"argName": "ua",
"argValue": "*curl*|*IE*|*chrome*|*firefox*"
}, {
"argName": "type",
"argValue": "black"
}],
"functionName": "ali_ua"
}],
"DomainNames": "example.com"
}
Paramètres EdgeScript
edge_function
description : Configure les règles EdgeScript.
ID de fonction : 180
Paramètres :
|
Parameter |
Type |
Required |
Description |
Example |
|
rule |
String |
Yes |
Règle DSL. |
if eq($uri, '/') { rewrite('https://example.com/index.html', 'redirect') } |
|
pri |
Integer |
Yes |
Priorité. Valeurs valides : 0-999 (une valeur plus faible indique une priorité plus élevée). Les priorités des positions d'exécution head et foot sont indépendantes. |
0 |
|
enable |
String |
Yes |
Indique si la règle est effective. Valeurs valides : |
on |
|
name |
String |
Yes |
Nom de la règle (lettres et traits de soulignement uniquement). |
test |
|
pos |
String |
No |
Position d'exécution. Valeurs valides : |
head |
|
brk |
String |
No |
Indique s'il faut interrompre l'exécution. Valeurs valides : |
off |
|
option |
String |
No |
Champ d'extension. |
(empty) |
|
grammar |
String |
No |
Syntaxe de la règle. Valeurs valides : |
es2 |
|
jsmode |
String |
No |
Mode d'exécution JS. Valeurs valides : |
bypass |
Exemple :
{
"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"
}
Améliorations des performances
set_hashkey_args
description : Configure le filtrage des paramètres URL (mode de conservation).
ID de fonction : 19
Conflit : Entre en conflit avec
ali_remove_args(ID de fonction : 75). Une seule de ces configurations peut être appliquée.Paramètres :
|
Parameter |
Type |
Required |
Description |
Example |
|
hashkey_args |
String |
No |
Liste des paramètres à conserver, séparés par des virgules (,). Maximum : 10 paramètres. |
key1,key2 |
|
disable |
String |
Yes |
Indique s'il faut ignorer tous les paramètres. Valeurs valides : |
on |
|
keep_oss_args |
String |
Yes |
Indique s'il faut conserver les paramètres pour les requêtes vers l'origine. Valeurs valides : |
on |
Exemple :
{
"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 : Configure le filtrage des paramètres URL (mode de suppression).
ID de fonction : 75
Conflit : Entre en conflit avec
set_hashkey_args(ID de fonction : 19). Une seule de ces configurations peut être appliquée.Paramètres :
|
Parameter |
Type |
Required |
Description |
Example |
|
ali_remove_args |
String |
Yes |
Paramètres à supprimer, séparés par des espaces. Les paramètres restants sont utilisés comme partie args de l'URL de la clé de cache. |
test |
|
keep_oss_args |
String |
Yes |
Indique s'il faut conserver les paramètres pour les requêtes vers l'origine. Valeurs valides : |
off |
Exemple :
{
"Functions": [{
"functionArgs": [{
"argName": "ali_remove_args",
"argValue": "test"
}, {
"argName": "keep_oss_args",
"argValue": "off"
}],
"functionName": "ali_remove_args"
}],
"DomainNames": "example.com"
}
image_transform
description : Configure la transformation d'image CDN.
ID de fonction : 239
Paramètres :
|
Parameter |
Type |
Required |
Description |
Example |
|||
|
enable |
String |
Yes |
Indique s'il faut activer la transformation d'image. Valeurs valides : |
on |
|||
|
filetype |
String |
Yes |
Formats d'image pris en charge pour le transcodage, séparés par des barres verticales ( |
). Valeurs valides : JPEG, JPG, PNG, WEBP, BMP, GIF, TIFF, JP2. |
jpg |
jpeg |
png |
|
webp |
String |
No |
Indique s'il faut activer la conversion WebP adaptative. Valeurs valides : |
on |
|||
|
orient |
String |
No |
Indique s'il faut activer la rotation automatique des images. Valeurs valides : |
on |
|||
|
slim |
Integer |
No |
Pourcentage de réduction de la taille de l'image. Valeurs valides : 0-100. Réduit la qualité de l'image sans modifier la résolution, la taille ou le format afin d'économiser de la bande passante. |
10 |
Exemple :
{
"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"
}
Paramètres liés à la vidéo
range
description : Configure la récupération d'origine basée sur Range.
ID de fonction : 31
Paramètres :
|
Parameter |
Type |
Required |
Description |
Example |
|
enable |
String |
Yes |
Indique s'il faut activer la récupération d'origine basée sur Range. Valeurs valides : |
on |
Exemple :
{
"Functions": [{
"functionArgs": [{
"argName": "enable",
"argValue": "on"
}],
"functionName": "range"
}],
"DomainNames": "example.com"
}
video_seek
description : Configure la navigation vidéo (glisser-déposer et lecture).
ID de fonction : 30
Paramètres :
|
Parameter |
Type |
Required |
Description |
Example |
|
enable |
String |
Yes |
Indique s'il faut activer la navigation vidéo. Valeurs valides : |
on |
|
flv_seek_by_time |
String |
No |
Indique s'il faut activer la navigation temporelle FLV. Valeurs valides : |
on |
|
mp4_seek_start |
String |
No |
Nom personnalisé du paramètre de début MP4. |
mp4starttime |
|
mp4_seek_end |
String |
No |
Nom personnalisé du paramètre de fin MP4. |
mp4endtime |
|
flv_seek_start |
String |
No |
Nom personnalisé du paramètre de début FLV. |
flvstarttime |
|
flv_seek_end |
String |
No |
Nom personnalisé du paramètre de fin FLV. |
flvendtime |
Exemple :
{
"Functions": [{
"functionArgs": [{
"argName": "enable",
"argValue": "on"
}],
"functionName": "video_seek"
}],
"DomainNames": "example.com"
}
ali_video_split
description : Configure l'extraction audio à partir de la vidéo.
ID de fonction : 204
Paramètres :
|
Parameter |
Type |
Required |
Description |
Example |
|
enable |
String |
Yes |
Indique s'il faut activer l'extraction audio. Valeurs valides : |
on |
Exemple :
{
"Functions": [{
"functionArgs": [{
"argName": "enable",
"argValue": "on"
}],
"functionName": "ali_video_split"
}],
"DomainNames": "example.com"
}
ali_video_preview
description : Configure l'aperçu vidéo (visionnage d'essai).
ID de fonction : 205
Paramètres :
|
Parameter |
Type |
Required |
Description |
Example |
|
enable |
String |
Yes |
Indique s'il faut activer l'aperçu vidéo. Valeurs valides : |
on |
|
ali_video_preview_argument |
String |
Yes |
Nom personnalisé du paramètre d'aperçu. L'unité de la valeur du paramètre doit être exprimée en secondes. |
fds |
Exemple :
{
"Functions": [{
"functionArgs": [{
"argName": "enable",
"argValue": "on"
}, {
"argName": "ali_video_preview_argument",
"argValue": "fds"
}],
"functionName": "ali_video_preview"
}],
"DomainNames": "example.com"
}
hls_token_rewrite
description : Configure la réécriture du chiffrement standard M3U8.
ID de fonction : 253
Paramètres :
|
Parameter |
Type |
Required |
Description |
Example |
|
enable |
String |
Yes |
Indique s'il faut activer la réécriture du chiffrement standard M3U8. Valeurs valides : |
on |
|
hls_token_arg_name |
String |
No |
Nom personnalisé du paramètre de jeton HLS. Valeur par défaut : MtsHlsUriToken. |
example |
Exemple :
{
"Functions": [{
"functionArgs": [{
"argName": "enable",
"argValue": "on"
}],
"functionName": "hls_token_rewrite"
}],
"DomainNames": "example.com"
}