Paramètres de configuration des fonctionnalités pour les noms de domaine - CDN

Cette rubrique décrit les fonctionnalités et les paramètres que vous pouvez configurer lors de l'appel des opérations BatchSetCdnDomainConfig ou SetCdnDomainStagingConfig pour configurer des fonctionnalités pour les noms de domaine. Chaque fonctionnalité est identifiée par un nom de fonction et un ID de fonction numérique, et est transmise en tant qu'élément du tableau Functions du corps de la requête.

Structure de la requête

Lorsque vous appelez BatchSetCdnDomainConfig (environnement de production) ou SetCdnDomainStagingConfig (environnement de préproduction) pour configurer les fonctionnalités d'un nom de domaine, le corps de la requête contient un tableau Functions. Chaque élément du tableau spécifie un functionName et un ou plusieurs functionArgs sous forme de paires clé-valeur (argName et argValue).

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

Remarque

Les fonctionnalités décrites dans cette rubrique peuvent être référencées par les opérations suivantes : - Environnement de production : BatchSetCdnDomainConfig, DescribeCdnDomainConfigs, BatchDeleteCdnDomainConfig et DescribeCdnUserDomainsByFunc.

Environnement de préproduction : SetCdnDomainStagingConfig, DescribeCdnDomainStagingConfig, RollbackStagingConfig et PublishStagingConfigToProduction.

L'appel de BatchSetCdnDomainConfig ou de SetCdnDomainStagingConfig génère un ConfigId unique pour la configuration. Vous pouvez utiliser le ConfigId pour mettre à jour ou supprimer la configuration. Pour plus d'informations, consultez la rubrique Remarques sur l'utilisation de ConfigId. - Certaines fonctionnalités entrent en conflit entre elles. Une seule fonctionnalité d'une paire conflictuelle peut être configurée à la fois. Les paires de conflits sont indiquées dans les sections correspondantes ci-dessous.

Configurations réseau

ipv6

Description : Configure l'accès IPv6.
ID de fonction : 194
Paramètres :

Paramètre

Type

Obligatoire

Description

Exemple

switch

String

Oui

Indique s'il faut activer l'accès IPv6. Valeurs valides : on, off.

region

String

Oui

Région où IPv6 est activé. Utilisez un astérisque (*) pour toutes les régions.

Exemple :

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

Configurations d'origine

set_req_host_header

Description : Configure l'hôte d'origine par défaut.
ID de fonction : 18
Paramètres :

Paramètre

Type

Obligatoire

Description

Exemple

domain_name

String

Oui

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 :

Paramètre

Type

Obligatoire

Description

Exemple

enable

String

Oui

Indique s'il faut activer la fonctionnalité de protocole d'origine. Valeurs valides : on, off.

scheme_origin

String

Non

Schéma de protocole pour la récupération depuis l'origine. Valeurs valides : http, https, follow. Valeur par défaut : follow.

scheme_origin_port

String

Non

Ports d'origine personnalisés. Obligatoire lorsque scheme_origin est défini sur follow (format : httpPort:httpsPort, par exemple, 80:443).

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 à CDN un accès en lecture seule à tous les buckets OSS du même compte Alibaba Cloud.
ID de fonction : 85
Paramètres :

Paramètre

Type

Obligatoire

Description

Exemple

private_oss_auth

String

Oui

Indique s'il faut activer la récupération depuis un bucket OSS privé. Valeurs valides : on, off. Lorsqu'elle est activée, le système configure automatiquement les jetons de sécurité STS. Cette option prend uniquement en charge la récupération depuis l'origine pour les domaines CDN vers des buckets OSS privés appartenant au même compte Alibaba Cloud.

perm_private_oss_tbl

String

Non

Configuration du jeton de sécurité permanent. Format : access_id=123 access_secret=123abc (séparés par un espace). Lorsqu'elle est configurée, la récupération depuis l'origine pour les domaines CDN vers des buckets OSS privés appartenant à 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"
}

oss_key_list

Description : Configure la liste des clés privées d'origine OSS. Vous pouvez configurer une ou plusieurs règles représentant différents buckets OSS privés avec leurs jetons de sécurité correspondants.
ID de fonction : 183
Paramètres :

Paramètre

Type

Obligatoire

Description

Exemple

host

String

Oui

Adresse complète du bucket OSS.

example.oss-cn-hangzhou.aliyuncs.com

key

String

Oui

Configuration du jeton de sécurité permanent. Format : access_id=123 access_secret=123abc (séparés par un espace).

access_id=123 access_secret=123abc

Exemple :

{
    "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 : Configure le SNI d'origine (Server Name Indication).
ID de fonction : 114
Paramètres :

Paramètre

Type

Obligatoire

Description

Exemple

enabled

String

Oui

Indique s'il faut activer le SNI d'origine. Valeurs valides : on, off.

https_origin_sni

String

Oui

Informations SNI transmises 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 :

Paramètre

Type

Obligatoire

Description

Exemple

forward_timeout

Integer

Oui

Délai d'expiration de la requête en secondes. Nous vous recommandons de définir une valeur inférieure à 100 secondes.

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 fonctionnalités peut être configurée. Si l'une des fonctionnalités est déjà configurée (y compris lorsque son paramètre switch est défini sur off), vous devez supprimer la configuration existante avant de configurer l'autre.
Paramètres :

Paramètre

Type

Obligatoire

Description

Exemple

variable_type

String

Oui

Type de variable. Valeurs valides : header (en-tête de requête), arg (paramètre de chaîne de requête), uri (chemin de requête), cookie (cookie de requête).

uri

variable

String

Oui

Nom de la variable. Lorsque variable_type est défini sur uri, la variable doit être définie sur uri.

uri

conditions

String

Oui

Opérateur de condition. Valeurs valides : == (égal), != (différent).

value

String

Oui

Valeur de la variable à faire correspondre.

/image

origin

String

Oui

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 : configurez le suivi des redirections 302 depuis l'origine.
Function ID : 219
Parameters :

Parameter

Type

Required

Description

Example

enable

String

Yes

Indique si le suivi des redirections 302 depuis l'origine est activé. Valeurs valides : on, off.

max_tries

Integer

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 correspond à max_tries + 1.

retain_args

String

Indique si les paramètres de la requête d'origine sont conservés lors du suivi des redirections 302. Valeurs valides : on, off (par défaut).

off

retain_header

String

Indique si les en-têtes de la requête d'origine sont conservés lors du suivi des redirections 302. Valeurs valides : on, off (par défaut).

off

response_header

String

Nom de l'en-tête de réponse pour la redirection 302. Valeur par défaut : Location.

X-Alicdn-Redirect

retain_host

String

Indique si l'hôte d'origine est conservé lors du suivi des redirections 302. Valeurs valides : on, off (par défaut).

off

modify_host

String

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

Indique si les résultats des redirections 302 pour la même URL sont mis en cache afin d'améliorer les performances de réponse du CDN. Valeurs valides : on, off (par défaut).

off

expired_time

Integer

Durée d'expiration du cache pour les résultats des redirections 302, en secondes. Ce paramètre doit être utilisé conjointement avec le paramètre cache. Valeur par défaut : 3600.

7200

follow_origin_host

String

Indique si le nom de domaine du serveur d'origine est utilisé comme hôte d'origine (utilise le dernier domaine d'origine, même après un basculement primaire/secondaire). Valeurs valides : on, off (par défaut).

off

follow_5xx_retry_origin

String

Indique si le système bascule vers le serveur d'origine disponible suivant lorsque le serveur d'origine actuel renvoie un code d'état 5xx. Valeurs valides : on, off (par défaut).

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 : configurez des en-têtes de requête HTTP personnalisés vers l'origine (v1). Nous vous recommandons d'utiliser la version v2 : origin_request_header, qui prend en charge davantage de fonctionnalités.
Function ID : 39
Parameters :

Parameter

Type

Required

Description

Example

key

String

Yes

Nom de l'en-tête de requête vers l'origine.

Accept-Encoding

value

String

Yes

Valeur de l'en-tête de requête vers l'origine. Pour supprimer un en-tête, définissez la valeur sur 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 : configurez des en-têtes de requête HTTP personnalisés vers l'origine (v2). Prend en charge les opérations d'ajout, de suppression, de modification et de réécriture.
Function ID : 228
Parameters :

Parameter

Type

Required

Description

Example

header_operation_type

String

Yes

Type d'opération sur l'en-tête. Valeurs valides : add, delete, modify, rewrite.

add

header_name

String

Yes

Nom de l'en-tête de requête.

Accept-Encoding

header_value

String

Valeur de l'en-tête de requête. Plusieurs valeurs peuvent être séparées par des virgules (,).

gzip

duplicate

String

Indique si les en-têtes dupliqués portant le même nom sont autorisés (lors de l'utilisation de l'opération add). Valeurs valides : on, off.

off

header_source

String

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

Valeur de remplacement (lors de l'utilisation de l'opération rewrite).

value123

match_all

String

Mode de correspondance (lors de l'utilisation de l'opération rewrite). Valeurs valides : on (remplace toutes les correspondances), off (remplace uniquement la première correspondance).

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 : configurez des en-têtes de réponse HTTP depuis l'origine. Prend en charge les opérations d'ajout, de suppression, de modification et de réécriture.
Function ID : 229
Parameters :

Parameter

Type

Required

Description

Example

header_operation_type

String

Yes

Type d'opération sur l'en-tête de réponse. Valeurs valides : add, delete, modify, rewrite.

add

header_name

String

Yes

Nom de l'en-tête de réponse.

Cache-Control

header_value

String

Valeur de l'en-tête de réponse. Plusieurs valeurs peuvent être séparées par des virgules (,).

no-cache

duplicate

String

Indique si les en-têtes dupliqués portant le même nom sont autorisés (lors de l'utilisation de l'opération add). Valeurs valides : on, off.

off

header_source

String

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

Valeur de remplacement (lors de l'utilisation de l'opération rewrite).

value123

match_all

String

Mode de correspondance (lors de l'utilisation de l'opération rewrite). Valeurs valides : on (remplace toutes les correspondances), off (remplace uniquement la première correspondance).

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 : configurez la réécriture d'URI vers l'origine.
Function ID : 225
Parameters :

Parameter

Type

Required

Description

Example

source_url

String

Yes

URI à réécrire.

^/hello$

target_url

String

Yes

URI cible après réécriture.

/hello/test

flag

String

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 la diffusion en direct FLV.

break

sequence

Integer

Définit la priorité d'exécution de la configuration. Valeurs valides : 1 à 99. Une valeur plus faible 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.

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 : configurez la réécriture des arguments vers l'origine. Réécrit les paramètres de requête dans l'URL de la requête vers l'origine. Permet de configurer plusieurs règles de réécriture. Priorité des opérations : add > delete > keep > modify.
Function ID : 224
Parameters :

Parameter

Type

Required

Description

Example

delete_argument

String

Arguments à supprimer, séparés par des espaces.

code1

save_argument

String

Arguments à conserver, séparés par des espaces. Seuls les arguments répertoriés sont conservés. Les opérations d'ajout et de suppression restent effectives.

(empty)

ignore_all_argument

String

Indique si tous les arguments doivent être ignorés. Valeurs valides : on (ignore tous les arguments ; seule l'opération add reste effective), off (par défaut).

add_argument

String

Arguments à ajouter (priorité la plus élevée), séparés par des espaces.

value=123

modify_argument

String

Arguments à modifier (priorité la plus faible), séparés par des espaces. Si un argument est supprimé, il ne sera pas conservé.

value=321

enable

String

Yes

Indique si la réécriture des arguments vers l'origine est activée. Valeurs valides : on, off.

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 : Configure la récupération d'origine authentifiée pour un bucket Amazon S3.
ID de fonction : 186
Paramètres :

Paramètre

Type

Obligatoire

Description

Exemple

enabled

String

Oui

Indique si l'authentification du bucket Amazon S3 est activée. Valeurs valides : l2 (activé), off (désactivé).

bucketname

String

Non

Nom du bucket Amazon S3.

accesskey

String

Oui

AccessKey AWS.

123456789

secretkey

String

Oui

SecretKey AWS.

12345678

region

String

Oui

Région de stockage Amazon S3.

us-east-2

Exemple :

{
    "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 : Configure la vérification du certificat d'origine (liste blanche SNI).
ID de fonction : 223
Paramètres :

Paramètre

Type

Obligatoire

Description

Exemple

enabled

String

Oui

Indique si la vérification du certificat d'origine est activée. Valeurs valides : on, off.

common_name_whitelist

String

Non

Noms de domaine de la liste blanche des certificats, séparés par des virgules (,). Les certificats correspondant à ces domaines autorisés passent la vérification.

example.com

Exemple :

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

origin_dns_host

Description : Configure un serveur d'origine conditionnel. Cette fonctionnalité s'utilise conjointement avec le moteur de règles (condition, ID de fonction : 250) pour acheminer les requêtes vers des serveurs d'origine spécifiques en fonction du chemin, des paramètres d'URL, des en-têtes de requête et d'autres informations. Avant la configuration, vous devez créer au moins une condition dans le moteur de règles.
ID de fonction : 212
Conflit : Entre en conflit avec advanced_origin (ID de fonction : 235). Une seule de ces configurations peut être active. Si l'une des fonctionnalités est déjà configurée (y compris lorsque son paramètre d'activation est défini sur off), vous devez supprimer la configuration existante avant de configurer l'autre.
Paramètres :

Paramètre

Type

Obligatoire

Description

Exemple

ali_origin_dns_host

String

Oui

Nom de domaine utilisé pour la résolution DNS d'origine.

example.com

Exemple :

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

origin_host

Description : Configure l'hôte d'origine pour un serveur d'origine spécifique.
ID de fonction : 242
Paramètres :

Paramètre

Type

Obligatoire

Description

Exemple

origin

String

Oui

Adresse du serveur d'origine. Définissez la valeur sur all pour appliquer la configuration à tous les serveurs d'origine.

example.com

host

String

Oui

Valeur de l'en-tête Host. Définissez la valeur sur ali_follow_origin pour utiliser l'adresse du serveur d'origine comme valeur d'hôte.

host.example.com

Exemple :

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

ali_origin_port_scheme

Description : Configure le port et le protocole d'origine.
ID de fonction : 276
Paramètres :

Paramètre

Type

Obligatoire

Description

Exemple

port

String

Oui

Port d'origine. Lorsque le schéma est défini sur follow, utilisez le format http:80\

https:443.

scheme

String

Oui

Protocole d'origine. Valeurs valides : http, https, follow (suit le protocole client), https_sm (HTTPS avec algorithmes cryptographiques nationaux chinois), follow_sm (suit le protocole client, prenant en charge les algorithmes cryptographiques internationaux et nationaux).

http

Exemple :

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

origin_sni

Description : Configure le SNI d'origine pour un serveur d'origine spécifique.
ID de fonction : 262
Paramètres :

Paramètre

Type

Obligatoire

Description

Exemple

origin

String

Oui

Adresse du serveur d'origine. Définissez la valeur sur all pour appliquer la configuration à tous les serveurs d'origine.

example.com

sni_host

String

Oui

Valeur de l'hôte SNI. Peut être une valeur fixe, ali_follow_origin (suit l'adresse du serveur d'origine) ou ali_follow_host (suit l'hôte d'origine).

example.org

keepalive_sni

String

Non

Indique si la correspondance SNI keepalive est activée. Valeurs valides : on, off. Lorsqu'elle est activée, différentes valeurs SNI d'origine utilisent des connexions keepalive distinctes.

off

Exemple :

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

source_group

Description : Configure les groupes de serveurs d'origine.
ID de fonction : 294
Paramètres :

Paramètre

Type

Obligatoire

Description

Exemple

source_group_name

String

Oui

Nom du groupe de serveurs d'origine. Accepte les lettres minuscules, les chiffres et les traits de soulignement. Longueur maximale : 128 octets.

example_origin

source_info

String

Oui

Informations sur le serveur d'origine au format : adresse_priorité_poids_port. Séparez plusieurs serveurs d'origine par des virgules (,). Priorité : 1-65535 (une valeur plus faible indique une priorité plus élevée). Poids : 1-100. Port : 1-65535.

192.168.0.1_10_33_80,192.0.2.1_10_67_80

retry_times

Integer

Non

Nombre de tentatives de nouvelle connexion au serveur d'origine.

retry_status_rule

Integer

Non

Codes d'état pour lesquels une nouvelle tentative est effectuée. Valeurs prises en charge : 4xx, 5xx, 404, 404-or-5xx, 4xx-or-5xx.

404-or-5xx

failback_source

String

Non

Indique si le système doit revenir à la configuration de base du serveur d'origine lorsque tous les serveurs du groupe sont indisponibles. Valeurs valides : on, off.

Exemple :

{
    "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 : Configure la récupération d'origine via IPv6.
ID de fonction : 265
Paramètres :

Paramètre

Type

Obligatoire

Description

Exemple

enable

String

Oui

Indique si la récupération d'origine via IPv6 est activée. Valeurs valides : on, off. Lorsqu'elle est activée, le CDN utilise IPv6 pour les connexions d'origine si le nœud CDN et le serveur d'origine disposent tous deux d'adresses IPv6 disponibles.

String

Oui

Indique si la version du protocole IP du client doit être suivie pour la récupération d'origine. Valeurs valides : on, off. Lorsqu'elle est activée, le CDN suit le protocole de la requête client : les requêtes clientes IPv6 privilégient les serveurs d'origine IPv6 ; les requêtes clientes IPv4 privilégient les serveurs d'origine IPv4.

ipv6_v4_mix_used

String

Non

Indique si la récupération d'origine par rotation (round-robin) IPv4/IPv6 est activée. Valeurs valides : on, off. Lorsqu'elle est activée, les fonctionnalités IPv6 origin et follow deviennent inefficaces. Toutes les requêtes utilisent la rotation entre toutes les adresses d'origine, indépendamment du protocole client.

off

Exemple :

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

cos_auth

Description : Configure la récupération d'origine authentifiée pour un bucket Tencent Cloud COS.
ID de fonction : 288
Paramètres :

Paramètre

Type

Obligatoire

Description

Exemple

enable

String

Oui

Indique si l'authentification du bucket Tencent Cloud COS est activée. Valeurs valides : on, off.

cos_valid_period

String

Non

Durée de validité de la signature d'authentification en secondes. Valeur par défaut : 3600.

3600

cos_secret_id

String

Oui

ID d'authentification Tencent Cloud.

123456789

cos_secret_key

String

Oui

Clé d'authentification Tencent Cloud.

12345678

Exemple :

{
    "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 : Configure les informations du bucket d'authentification OSS utilisées par le CDN pour la récupération d'origine. Cette configuration est ajoutée automatiquement lorsque vous configurez un serveur d'origine de type OSS pour un nom de domaine accéléré. Ne supprimez pas cette configuration manuellement, car cela pourrait entraîner des problèmes de facturation pour le trafic d'origine du CDN et des échecs d'authentification pour l'accès aux buckets privés.
ID de fonction : 10
Paramètres :

Paramètre

Type

Obligatoire

Description

Exemple

oss_bucket_id

String

Oui

Point de terminaison public du bucket OSS.

cdn-test.oss-cn-hongkong.aliyuncs.com

oss_pri_buckets

String

Oui

Point de terminaison public du bucket OSS et nom du bucket correspondant, séparés par une barre verticale (\

cdn-test.oss-cn-hongkong.aliyuncs.com\

cdn-test

Exemple :

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

Contrôle d'accès

referer_white_list_set

Description : configurez 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 définie.
Paramètres :

Parameter

Type

Required

Description

Example

refer_domain_allow_list

String

Yes

Liste blanche des domaines Referer, séparés par des virgules (,).

example.aliyundoc.com,demo.aliyundoc.com

allow_empty

String

Indique si les champs Referer vides sont autorisés. Valeurs valides : on, off (par défaut).

off

redirect_url

String

URL de redirection pour les requêtes non correspondantes (doit commencer par http:// ou https://).

http://www.example.com

disable_ast

String

Mode de correspondance exacte. Valeurs valides : on (correspondance exacte), off (correspondance par suffixe, par défaut).

off

ignore_scheme

String

Indique si le schéma HTTP ou HTTPS du Referer doit être ignoré. Valeurs valides : on, off (par défaut).

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 : configurez 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 définie.
Paramètres :

Parameter

Type

Required

Description

Example

refer_domain_deny_list

String

Yes

Liste noire des domaines Referer, séparés par des virgules (,).

example.aliyundoc.com,demo.aliyundoc.com

allow_empty

String

Indique si les champs Referer vides sont autorisés. Valeurs valides : on, off.

off

redirect_url

String

URL de redirection pour les requêtes correspondantes.

http://www.example.com

disable_ast

String

Mode de correspondance exacte. Valeurs valides : on (correspondance exacte), off (correspondance par suffixe, par défaut).

off

ignore_scheme

String

Indique si le schéma HTTP ou HTTPS du Referer doit être ignoré. Valeurs valides : on, off (par défaut).

off

Exemple :

{
    "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 : configurez 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 définie.
Paramètres :

Parameter

Type

Required

Description

Example

ip_list

String

Yes

Liste d'adresses IP ou de blocs CIDR, séparés par des virgules (,). Vous pouvez configurer jusqu'à 700 adresses IPv6 ou 2 000 adresses IPv4. La longueur totale de la chaîne des adresses IP ne peut pas dépasser 30 Ko. Les blocs CIDR sont pris en charge (par exemple, 127.0.0.0/24). La casse n'est pas significative pour les adresses IPv6. La notation abrégée :: n'est pas prise en charge.

192.168.0.1/24

customize_response_status_code

String

Code d'état de réponse personnalisé. Valeur par défaut : 403.

429

ip_acl_xfwd

String

Mode de correspondance des adresses IP. Valeurs valides : on (utilise l'en-tête X-Forwarded-For, par défaut), off (utilise l'adresse IP de la connexion TCP), all (utilise les deux).

all

ip_list_notes

String

Notes associées à 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 : configurez 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 définie.
Paramètres :

Parameter

Type

Required

Description

Example

ip_list

String

Yes

192.168.0.1

customize_response_status_code

String

Code d'état de réponse personnalisé. Valeur par défaut : 403.

429

ip_acl_xfwd

String

Mode de correspondance des adresses IP. Valeurs valides : on (utilise l'en-tête X-Forwarded-For, par défaut), off (utilise l'adresse IP de la connexion TCP), all (utilise les deux).

all

ip_list_notes

String

Notes associées à 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"
}

aliauth

Description : configurez l'authentification par URL.
ID de fonction : 25
Paramètres :

Parameter

Type

Required

Description

Example

auth_m3u8

String

Active la réécriture du contenu m3u8. Lorsqu'elle est activée, les paramètres d'authentification sont ajoutés aux segments TS du fichier m3u8 pour éviter les échecs d'authentification d'accès aux fichiers TS. Valeurs valides : on (par défaut), off.

auth_type

String

Yes

Type d'authentification. Valeurs valides : no_auth, type_a, type_b, type_c, type_d, type_e, type_f. Pour plus de détails sur chaque type, consultez la documentation sur l'authentification par URL.

type_a

auth_key1

String

Yes

Clé d'authentification 1 (16 à 128 caractères, uniquement des lettres et des chiffres).

1234567890123456789

auth_key2

String

Clé d'authentification 2 (16 à 128 caractères, uniquement des lettres et des chiffres).

1234567890123456789

ali_auth_delta

Integer

Durée de validité de l'URL authentifiée, en secondes. Valeur par défaut : 1800.

1800

req_auth_ip_white

String

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

Méthode d'extraction de l'adresse IP du client pour l'exemption de la liste blanche. Valeurs valides : on (par défaut, utilise la première adresse IP de l'en-tête X-Forwarded-For), off (utilise l'adresse IP de la connexion TCP), all (utilise les deux).

all

sign_param

String

Nom du paramètre de signature. Valide uniquement lorsque auth_type est défini sur type_f.

sign

time_param

String

Nom du paramètre d'horodatage. Valide uniquement lorsque auth_type est défini sur type_f.

time

time_format

String

Format de l'horodatage. Valide uniquement lorsque auth_type est défini sur type_f. Valeurs valides : dec (décimal), hex (hexadécimal).

hex

path_encoding

String

Indique si l'encodage d'URL doit être activé. Valide uniquement lorsque auth_type est défini sur type_f. Valeurs valides : on, off.

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 : configurez l'authentification distante.
ID de fonction : 258
Paramètres :

Parameter

Type

Required

Description

Example

enable

String

Yes

Indique si l'authentification distante doit être activée. Valeurs valides : on, off.

remote_auth_addr

String

Yes

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

Yes

Méthode de requête. Valeurs valides : GET, POST, HEAD.

get

remote_auth_type

String

Yes

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

Yes

Paramètres de requête réservés, séparés par des barres verticales (

), non sensibles à la casse. Définissez sur all pour conserver tous les paramètres, ou sur ali_delete_all_args pour supprimer tous les paramètres d'URL.

all

remote_auth_custom_args

String

Paramètres personnalisés à ajouter, séparés par des barres verticales (

), sensibles à la casse.

(empty)

remote_auth_reserve_header

String

Yes

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 conserver tous les en-têtes, ou sur ali_delete_all_headers pour supprimer tous les en-têtes.

all

remote_auth_custom_header

String

En-têtes de requête personnalisés à ajouter, séparés par des barres verticales (

), non sensibles à la casse.

(empty)

remote_auth_success_code

Integer

Yes

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

Yes

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

Action pour les autres codes d'état (ni succès ni échec). Valeurs valides : pass (par défaut, autorise la requête), reject (refuse la requête).

pass

remote_auth_fail_resp_code

Integer

Yes

Code d'état que le CDN renvoie au client en cas d'échec de l'authentification.

403

remote_auth_timeout

Integer

Yes

Délai d'expiration de l'authentification en millisecondes. Valeur maximale : 3000.

500

remote_auth_timeout_action

String

Yes

Action en cas d'expiration du délai d'authentification. Valeurs valides : pass (autorise la requête), reject (renvoie le code de réponse d'échec).

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

ali_ua

Description : Configurez les restrictions d'accès basées sur l'en-tête User-Agent.
ID de fonction : 58
Paramètres :

Parameter

Type

Required

Description

Example

String

Yes

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

chrome

firefox

type

String

Yes

Type de liste. Valeurs valides : black (liste de blocage), white (liste d'autorisation). La liste de blocage et la liste d'autorisation s'excluent mutuellement ; une seule peut être active à la fois.

black

Exemple :

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

Cache configurations

filetype_based_ttl_set

Description : Configurez la durée d'expiration des fichiers.
ID de fonction : 6
Paramètres :

Parameter

Type

Required

Description

Example

ttl

Integer

Yes

Durée du cache en secondes. Valeurs valides : 1-99999999.

500000

file_type

String

Yes

Types de fichiers, séparés par des virgules (,). Sensible à la casse. Par exemple, jpg,txt.

jpg

weight

Integer

Priorité. Valeurs valides : 1-99. Valeur par défaut : 1 (une valeur plus élevée indique une priorité plus haute).

swift_origin_cache_high

String

Indique s'il faut prioriser 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 : on, off (par défaut).

off

swift_no_cache_low

String

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 : on, off (par défaut).

off

swift_follow_cachetime

String

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 : on, off (par défaut).

off

force_revalidate

String

Indique s'il faut forcer la validation du contenu lorsque le TTL est égal à 0. Valeurs valides : on (lorsque le TTL est égal à 0, le contenu est mis en cache sur le nœud CDN et revalidé auprès de l'origine à chaque requête), off (par défaut, lorsque le TTL est égal à 0, le contenu n'est pas mis en cache et est récupéré depuis l'origine à chaque requête).

off

Exemple :

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

ali_return_code

Description : Réponse HTTP personnalisée. Construit une réponse HTTP avec un code d'état HTTP personnalisé et un corps HTTP personnalisé. La réponse construite est renvoyée directement au client.
ID de fonction : 56
Paramètres :

Remarque

Mode de réponse avant l'origine (exit_after_return_code défini sur on) : le CDN ne récupère pas les données depuis l'origine. Il intercepte la requête directement et renvoie le code d'état de réponse et le corps de réponse (si configuré) au client.

Mode de réponse après l'origine (exit_after_return_code défini sur return_code_phase ou vide) : le CDN récupère d'abord le contenu depuis l'origine, puis renvoie à la fois le code d'état de réponse et le contenu de la réponse de l'origine au client. Ce paramètre n'est pas actif par défaut en mode post-origine ; le corps de la réponse correspond toujours au contenu renvoyé par l'origine. Pour remplacer le corps de la réponse de l'origine, vous devez également activer ali_body_filter_switch.

Parameter

Type

Required

Description

Example

return_code

Integer

Yes

Code d'état de la réponse. Définit le code d'état HTTP que le nœud CDN renvoie finalement au client.

302

exit_after_return_code

String

Mode de réponse, qui contrôle le moment où le CDN renvoie la réponse au client. Valeurs valides : on : Réponse avant l'origine. Le CDN ne récupère pas les données depuis l'origine. Il intercepte la requête directement et renvoie le code d'état de réponse et le corps de réponse (si configuré) au client. return_code_phase : Réponse après l'origine. Le CDN récupère d'abord le contenu depuis l'origine, puis renvoie à la fois le code d'état de réponse et le contenu de la réponse de l'origine au client (mode par défaut, utilisé lorsque ce paramètre est vide).

resp_body_ct

String

Contenu du corps de la réponse (HTTP Body) pour personnaliser ce qui est renvoyé au client. En mode de réponse avant l'origine : si spécifié, ce contenu est renvoyé comme corps de réponse ; sinon, seul le code d'état est renvoyé. En mode de réponse après l'origine : ce paramètre n'est pas actif par défaut ; le corps de la réponse correspond toujours au contenu renvoyé par l'origine.

example

ali_body_filter_switch

String

Commutateur pour modifier le contenu de la réponse de l'origine. Ce paramètre n'est actif qu'en mode de réponse après l'origine. Lorsqu'il est activé, le CDN remplace le corps de la réponse de l'origine par le contenu de réponse spécifié et renvoie le code d'état de réponse ainsi que le contenu de la réponse au client. Valeurs valides : on : Activer. off : Désactiver.

ali_body_filter_code

Integer

Fait correspondre le code d'état de la réponse de l'origine. Ce paramètre n'est actif qu'en mode de réponse après l'origine et lorsque la modification du contenu de la réponse de l'origine est activée. Lorsqu'il est spécifié, le CDN ne déclenche la logique de remplacement du contenu de réponse que lorsque l'origine renvoie le code d'état spécifié. Si le code d'état ne correspond pas, aucun remplacement n'est effectué.

404

Exemple :

{
    "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 : Configurez la durée d'expiration du cache basée sur le répertoire.
ID de fonction : 7
Paramètres :

Parameter

Type

Required

Description

Example

ttl

Integer

Yes

Durée du cache en secondes. Valeurs valides : 1-99999999.

500000

path

String

Yes

Chemin du répertoire, qui doit commencer par une barre oblique (/).

/example/demo

weight

Integer

Priorité. Valeurs valides : 1-99. Valeur par défaut : 1 (une valeur plus élevée indique une priorité plus haute).

swift_origin_cache_high

String

Indique s'il faut prioriser la politique de cache de l'origine. Valeurs valides : on, off (par défaut).

off

swift_no_cache_low

String

Indique s'il faut ignorer les en-têtes de réponse no-cache de l'origine. Valeurs valides : on, off (par défaut).

off

swift_follow_cachetime

String

Indique si le client suit la politique de cache du CDN. Valeurs valides : on, off (par défaut).

off

force_revalidate

String

Indique s'il faut forcer la validation du contenu lorsque le TTL est égal à 0. Valeurs valides : on, off (par défaut).

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 : Configurez la durée d'expiration du cache basée sur le type de fichier et le code d'état.
ID de fonction : 63
Paramètres :

Parameter

Type

Required

Description

Example

file_type

String

Yes

Types de fichiers, sensibles à la casse, séparés par des virgules (,).

jpg

code_string

String

Yes

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

Indique s'il faut prioriser la politique de cache de l'origine. Valeurs valides : on, off (par défaut).

off

swift_code_no_cache_low

String

Indique s'il faut ignorer les en-têtes de réponse no-cache de l'origine. Valeurs valides : on, off (par défaut).

off

swift_code_follow_cachetime

String

Indique si le client suit la politique de cache du CDN. Valeurs valides : on, off (par défaut).

off

force_revalidate

String

Indique s'il faut forcer la validation du contenu lorsque le TTL est égal à 0. Valeurs valides : on, off (par défaut).

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 : Configurez la durée d'expiration du cache basée sur le chemin et le code d'état.
ID de fonction : 65
Paramètres :

Parameter

Type

Required

Description

Example

path

String

Yes

Chemin du répertoire, qui doit commencer par une barre oblique (/).

/example/demo

code_string

String

Yes

Codes d'état et leurs durées de cache en secondes (1-99999999), séparés par des virgules. Format : code=ttl.

403=10 404=15

swift_code_origin_cache_high

String

Indique s'il faut prioriser la politique de cache de l'origine. Valeurs valides : on, off (par défaut).

off

swift_code_no_cache_low

String

Indique s'il faut ignorer les en-têtes de réponse no-cache de l'origine. Valeurs valides : on, off (par défaut).

off

swift_code_follow_cachetime

String

Indique si le client suit la politique de cache du CDN. Valeurs valides : on, off (par défaut).

off

force_revalidate

String

Indique s'il faut forcer la validation du contenu lorsque le TTL est égal à 0. Valeurs valides : on, off (par défaut).

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

default_ttl_code

Description : Configurez la durée d'expiration du cache basée sur le code d'état (priorité à l'origine).
ID de fonction : 207
Paramètres :

Parameter

Type

Required

Description

Example

default_ttl_code

String

Yes

Codes d'état et leurs durées de cache en secondes (1-99999999), séparés par des virgules. Format : code=ttl.

4xx=3 200=3600,5xx=1

Exemple :

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

set_resp_header

Description : configurez des en-têtes de réponse HTTP personnalisés.
ID de fonction : 27
Paramètres :

Parameter

Type

Required

Description

Example

key

String

Yes

Nom de l'en-tête de réponse.

Cache-Control

value

String

Yes

Valeur de l'en-tête de réponse. Séparez plusieurs valeurs par des virgules (,). Pour supprimer un en-tête, définissez la valeur sur null.

no-cache

header_operation_type

String

Type d'opération sur l'en-tête. Valeurs valides : add, delete, modify, rewrite.

add

duplicate

String

Indique s'il faut autoriser les en-têtes en double (lors de l'utilisation de l'opération add). Valeurs valides : on, off.

off

header_source

String

Valeur à rechercher pour le remplacement (lors de l'utilisation de rewrite). Prend en charge les expressions régulières.

value1

header_destination

String

Valeur de remplacement (lors de l'utilisation de rewrite).

value123

match_all

String

Mode de correspondance (lors de l'utilisation de rewrite). Valeurs valides : on (remplacer tout), off (remplacer uniquement la première occurrence).

off

access_origin_control

String

Indique s'il faut activer la validation cross-origin. Valeurs valides : on, off.

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 : configurez des pages d'erreur personnalisées.
ID de fonction : 15
Paramètres :

Parameter

Type

Required

Description

Example

error_code

Integer

Yes

Code d'état d'erreur.

404

rewrite_page

String

Yes

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

host_redirect

Description : configurez des règles de réécriture d'URI.
ID de fonction : 43
Paramètres :

Parameter

Type

Required

Description

Example

regex

String

Yes

URI à réécrire. Doit commencer par /. Prend en charge les expressions régulières PCRE.

^/hello$

replacement

String

Yes

URI cible. Lorsque flag est défini sur break, seuls les chemins commençant par / sont pris en charge. Lorsque flag est défini sur redirect, peut inclure le protocole et le nom de domaine. Prend en charge les expressions régulières PCRE ($1, $2 pour les groupes de capture).

/hello/test

flag

String

Règle d'exécution. Valeurs valides : (vide, par défaut) poursuit la correspondance avec les règles suivantes ; break : arrête la correspondance avec les règles suivantes, réécrit l'URI sans modifier les paramètres ; redirect : renvoie une redirection 302 au client, poursuit la correspondance avec les règles suivantes ; enhance_break : similaire à break mais modifie l'URL entière, y compris les paramètres ; enhance_redirect : similaire à redirect mais modifie l'URL entière, y compris les paramètres.

redirect

rewrite_method

String

Méthode de redirection. Valeurs valides : 302 (par défaut, la méthode de requête peut changer en GET), 303 (la méthode de requête change en GET, le corps est perdu), 307 (la méthode de requête et le corps sont conservés).

302

sequence

Integer

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.

Exemple :

{
    "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 : configurez des clés de cache personnalisées.
ID de fonction : 227
Paramètres :

Parameter

Type

Required

Description

Example

uri

Array of String

Réécrit l'URI source vers un URI cible pour la clé de cache. Utilisez uri_to_rewrite pour la source et ai_uri_regex pour la cible.

[{"uri_to_rewrite":"/hello","ai_uri_regex":"/hello/test"}]

args

Array of String

Effectue des opérations d'ajout, de suppression, de modification ou de conservation sur les paramètres de requête pour la clé de cache.

[{"args":"test=123","args_operation_type":"add"}]

headers

String

En-têtes HTTP à inclure dans la clé de cache, séparés par des espaces.

example

variable

Array of String

Variables personnalisées extraites des paramètres d'URL de requête, des en-têtes HTTP, des cookies ou de l'URI à l'aide d'expressions régulières pour les ajouter à la clé de cache.

[]

Exemple :

{
    "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 : configurez le cache partagé (réécriture de clé de cache).
ID de fonction : 54
Paramètres :

Parameter

Type

Required

Description

Example

share_host

String

Yes

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. Utilise uniquement la valeur share_host 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"
}

serving_stale_content

Description : configurez la diffusion de contenu obsolète. Diffuse le contenu mis en cache ayant expiré lorsque le serveur d'origine n'est pas disponible.
ID de fonction : 260
Paramètres :

Parameter

Type

Required

Description

Example

origin_error_status_code

String

Codes d'état d'erreur d'origine personnalisés qui déclenchent la diffusion de contenu obsolète. Par défaut (lorsqu'il n'est pas spécifié), les erreurs d'origine sont définies comme des délais d'attente plus tous les codes d'état 5xx. Prend en charge la correspondance floue (4xx, 5xx) et exacte (502, 504). Plusieurs codes sont séparés par des virgules.

502

extend_expiration_time

Integer

Durée maximale (en secondes) de conservation du contenu mis en cache obsolète après expiration. Valeur par défaut : 3600 (1 heure).

origin_first

String

Indique s'il faut prioriser la politique stale-if-error de l'origine. Lorsqu'elle est activée (on), si la réponse de l'origine inclut Cache-Control: stale-if-error=xx, le temps stale-if-error prend le pas sur extend_expiration_time. Valeurs valides : on, off (par défaut).

Exemple :

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

Configurations HTTPS

https_option

Description : configurez les paramètres de base HTTPS.
ID de fonction : 78
Paramètres :

Parameter

Type

Required

Description

Example

http2

String

Indique s'il faut activer HTTP/2. Valeurs valides : on, off.

ocsp_stapling

String

Indique s'il faut activer OCSP Stapling. Valeurs valides : on, off.

Exemple :

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

https_force

Description : configurez la redirection HTTPS.
ID de fonction : 44
Conflit : entre en conflit avec http_force (ID de fonction : 45). Une seule configuration est possible.
Paramètres :

Parameter

Type

Required

Description

Example

enable

String

Yes

Indique s'il faut activer la redirection HTTPS. Valeurs valides : on, off.

https_rewrite

String

Méthode de redirection. Valeurs valides : 301, 308.

301

Exemple :

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

http_force

Description : configurez la redirection HTTP forcée.
ID de fonction : 45
Conflit : entre en conflit avec https_force (ID de fonction : 44). Une seule configuration est possible. Si une fonctionnalité 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

enable

String

Yes

Indique s'il faut activer la redirection HTTP forcée. Valeurs valides : on, off.

http_rewrite

String

Méthode de redirection. Valeurs valides : 301 (méthode de requête GET inchangée, les autres méthodes peuvent changer 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_tls_version

Description : Définit les versions du protocole TLS.
Function ID : 110
Parameters :

Parameter

Type

Required

Description

Example

tls10

String

Indique si le protocole TLS 1.0 est activé. Valeurs valides : on (par défaut), off.

tls11

String

Indique si le protocole TLS 1.1 est activé. Valeurs valides : on (par défaut), off.

tls12

String

Indique si le protocole TLS 1.2 est activé. Valeurs valides : on (par défaut), off.

tls13

String

Indique si le protocole TLS 1.3 est activé. Valeurs valides : on (par défaut), off.

ciphersuitegroup

String

Groupe de suites de chiffrement. Valeurs valides : all (par défaut, toutes les suites de chiffrement), strict (suites de chiffrement fortes uniquement), custom (suites de chiffrement personnalisées).

all

ciphersuite

String

Suites de chiffrement personnalisées. À utiliser lorsque ciphersuitegroup est défini sur custom. Séparez plusieurs suites de chiffrement par des virgules.

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 : Définit la configuration HTTP Strict Transport Security (HSTS).
Function ID : 112
Parameters :

Parameter

Type

Required

Description

Example

enabled

String

Yes

Indique si le protocole HSTS est activé. Valeurs valides : on, off.

https_hsts_max_age

Integer

Yes

Durée d'expiration en secondes. Valeur recommandée : 5184000 (60 jours).

5184000

https_hsts_include_subdomains

String

Indique si les sous-domaines doivent être inclus dans l'en-tête HSTS. Valeurs valides : on, off. Avant d'activer cette option, assurez-vous que le protocole HTTPS est activé pour tous les sous-domaines ; sinon, l'accès aux sous-domaines risque d'échouer.

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 : Définit l'authentification par certificat client.
Function ID : 111
Parameters :

Parameter

Type

Required

Description

Example

client_certificate_verify

String

Yes

Indique si l'authentification par certificat client est activée. Valeurs valides : on, off.

client_certificate

String

Yes

Certificat client (clé publique) à utiliser pour l'authentification. Le certificat d'autorité de certification doit commencer par -----BEGIN CERTIFICATE----- et se terminer par -----END CERTIFICATE-----.

-----BEGIN PUBLIC KEY-----***-----END PUBLIC KEY-----

client_verify_depth

String

Profondeur de vérification de la chaîne de certificats (nombre de niveaux de certificats entre le certificat client et l'autorité de certification racine). Valeur par défaut : 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"
}

Performance optimization

gzip

Description : Active la compression Gzip des pages.
Function ID : 35
Parameters :

Parameter

Type

Required

Description

Example

enable

String

Yes

Indique si la compression Gzip est activée. Valeurs valides : on, off.

Example :

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

tesla

Description : Définit l'optimisation des pages HTML.
Function ID : 16
Parameters :

Parameter

Type

Required

Description

Example

enable

String

Yes

Indique si l'optimisation des pages est activée. Valeurs valides : on, off.

trim_js

String

Indique si le code JS intégré au HTML doit être optimisé. Valeurs valides : on, off (par défaut).

off

trim_css

String

Indique si le code CSS intégré au HTML doit être optimisé. Valeurs valides : on, off (par défaut).

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 : Définit la compression Brotli.
Function ID : 97
Parameters :

Parameter

Type

Required

Description

Example

enable

String

Yes

Indique si la compression Brotli est activée. Valeurs valides : on, off.

Example :

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

set_hashkey_args

Description : Définit le filtrage des paramètres d'URL (mode conservation).
Function ID : 19
Conflict : Entre en conflit avec ali_remove_args (Function ID : 75). Une seule de ces fonctions peut être configurée.
Parameters :

Parameter

Type

Required

Description

Example

hashkey_args

String

Liste des paramètres à conserver, séparés par des virgules (,). Maximum : 10 paramètres.

key1,key2

disable

String

Yes

Indique si tous les paramètres doivent être ignorés. Valeurs valides : on (ignorer tous les paramètres, seule l'opération d'ajout reste effective), off (par défaut). L'ignorance de tous les paramètres a une priorité inférieure à celle de la liste des paramètres à conserver.

keep_oss_args

String

Yes

Indique si les paramètres doivent être conservés pour les requêtes vers l'origine. Valeurs valides : on (conserver tous les paramètres), off (les paramètres d'origine correspondent aux paramètres de la clé de cache).

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 : Définit le filtrage des paramètres d'URL (mode suppression).
Function ID : 75
Conflict : Entre en conflit avec set_hashkey_args (Function ID : 19). Une seule de ces fonctions peut être configurée.
Parameters :

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 des arguments d'URL de la clé de cache.

test

keep_oss_args

String

Yes

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 : Définit la transformation d'image CDN.
Function ID : 239
Parameters :

Parameter

Type

Required

Description

Example

enable

String

Yes

Indique si la transformation d'image est activée. Valeurs valides : on, off.

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

Indique si la conversion WebP adaptative est activée. Valeurs valides : on, off.

orient

String

Indique si la rotation automatique des images est activée. Valeurs valides : on, off. S'applique uniquement aux images comportant des attributs de rotation.

slim

Integer

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.

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 : Définit la récupération de contenu à l'origine basée sur Range.
Function ID : 31
Parameters :

Parameter

Type

Required

Description

Example

enable

String

Yes

Indique si la récupération de contenu à l'origine basée sur Range est activée. Valeurs valides : on, off, force (activation forcée).

Example :

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

video_seek

Description : Configurez la recherche 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 recherche vidéo. Valeurs valides : on, off.

flv_seek_by_time

String

Indique s'il faut activer la recherche temporelle FLV. Valeurs valides : on, off.

mp4_seek_start

String

Nom personnalisé du paramètre de début MP4.

mp4starttime

mp4_seek_end

String

Nom personnalisé du paramètre de fin MP4.

mp4endtime

flv_seek_start

String

Nom personnalisé du paramètre de début FLV.

flvstarttime

flv_seek_end

String

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 : Configurez 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, off.

Exemple :

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

ali_video_preview

Description : Configurez 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, off. Prend en charge les formats de fichier TS et MP3. Pour les formats FLV et MP4, utilisez la fonctionnalité de recherche vidéo.

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 : Configurez 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, off.

hls_token_arg_name

String

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

Limitation du trafic

limit_rate

Description : Configurez la limitation du débit par requête.
ID de fonction : 72
Paramètres :

Parameter

Type

Required

Description

Example

ali_limit_rate

String

Yes

Valeur de la limite de débit pour une seule requête (par exemple, 200 KByte/s ou 1 MByte/s). La valeur doit respecter le format nombre + unité (k pour KByte/s, m pour MByte/s). Valeur minimale : 100k. Les valeurs inférieures à 100k sont traitées comme 100k.

ali_limit_rate_after

String

Seuil de volume de données avant le démarrage de la limitation du débit. La valeur doit respecter le format nombre + unité (k ou m), en octets.

1000

traffic_limit_arg

String

Nom du paramètre de limite de débit extrait de l'URL de la requête. Lorsqu'il est spécifié, la limite de débit est basée sur la valeur de ce paramètre dans l'URL. Lorsque la requête ne contient pas ce paramètre, la limite de débit par défaut (ali_limit_rate) est utilisée. Pour désactiver la limitation du débit en l'absence du paramètre, définissez ali_limit_rate sur 0k.

rate

traffic_limit_unit

String

Unité de la valeur du paramètre traffic_limit_arg. Valeurs valides : m (MByte/s), k (KByte/s). Par exemple, si l'unité est définie sur m et que l'URL de la requête contient rate=1, la limite de débit réelle est de 1 MByte/s. Valeur minimale : 100k. Les valeurs inférieures à 100k sont traitées comme 100k.

ali_limit_start_hour

Integer

Heure de début de la limitation du débit. Valeurs valides : 0-24 (format 24 heures). Valeur par défaut : 0.

ali_limit_end_hour

Integer

Heure de fin de la limitation du débit. Valeurs valides : 0-24 (doit être supérieure à l'heure de début). Valeur par défaut : 24.

Exemple 1 :

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

Exemple 2 : Définissez une limite de débit par défaut de 1 MByte/s. Si l'URL de la requête contient le paramètre rate, la limite de débit suit la valeur de ce paramètre. Par exemple, si l'URL contient rate=200, la limite de débit réelle est de 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 et fonctions edge

edge_function

Description : Configurez 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.

enable

String

Yes

Indique si la règle est effective. Valeurs valides : on, off.

name

String

Yes

Nom de la règle (lettres et traits de soulignement uniquement).

test

pos

String

Position d'exécution. Valeurs valides : head (par défaut, interception au début du traitement de la requête), foot (interception à la fin du traitement de la requête).

head

brk

String

Indique s'il faut interrompre l'exécution. Valeurs valides : on (ignorer les règles restantes à la position d'exécution actuelle après la correspondance de cette règle), off (par défaut, continuer l'exécution des règles restantes).

off

option

String

Champ d'extension.

(vide)

grammar

String

Syntaxe de la règle. Valeurs valides : es2 (par défaut), js.

es2

jsmode

String

Mode d'exécution JS. Valeurs valides : redirect (mode d'interception), bypass (par défaut, mode de contournement).

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

Fonctions edge

edgeroutine

Description : Configurez Edge Routine (fonctions edge).
ID de fonction : 275

Remarque

Cette fonctionnalité nécessite une demande d'activation. Vous devez postuler pour activer cette fonctionnalité avant de l'utiliser.

Moteur de règles

condition

Description : Configurez le moteur de règles. Permet une configuration graphique des règles de condition qui identifient divers paramètres dans les requêtes utilisateur (tels que l'adresse IP du client, l'URI, les en-têtes, les cookies) afin de déterminer si une configuration s'applique à une requête spécifique. Cela permet un contrôle plus flexible et précis des politiques de configuration CDN.
ID de fonction : 250
Paramètres :

Remarque

Cette fonctionnalité nécessite une demande d'activation. Vous devez postuler pour activer cette fonctionnalité avant de l'utiliser.

Parameter

Type

Required

Description

Example

rule

Array

Yes

Contenu de la condition de règle, incluant le nom, le statut, la logique et les critères. L'objet criteria contient : matchType (le type d'information de requête à faire correspondre), matchObject (affinement supplémentaire du type de correspondance), matchOperator (l'action de correspondance, telle que equals), matchValue (la valeur à laquelle comparer), negate (indique s'il faut inverser le résultat, true ou false).

{"match":{"logic":"and","criteria":[{"matchType":"clientipVer","matchObject":"CONNECTING_IP","matchOperator":"equals","matchValue":"v6","negate":false}]},"name":"example","status":"enable"}

sequence

Integer

Exemple :

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

Sécurité

ali_location

Description : Configurez le blocage d'accès basé sur la région.
ID de fonction : 57
Paramètres :

Parameter

Type

Required

Description

Example

location

String

Yes

Régions auxquelles appliquer la politique de blocage. Prend en charge les codes pays à deux lettres (norme ISO 3166), séparés par des espaces. Prend également en charge global pour un blocage mondial.

type

String

Yes

Type de politique de blocage. Valeurs valides : black (liste noire, bloquer les adresses IP clientes des régions spécifiées), white (liste blanche, bloquer les adresses IP clientes des régions non présentes dans la liste).

black

Exemple :

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

QUIC

iquic

Description : Configurez les paramètres de base du protocole QUIC.
ID de fonction : 281
Paramètres :

Parameter

Type

Required

Description

Example

iquic_enable

String

Yes

Indique s'il faut activer le protocole QUIC. Valeurs valides : on, off.

Exemple :

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