Tous les produits
Search
Centre de documentation

:BatchCreateDcdnWafRules

Dernière mise à jour :Oct 12, 2026

Configure les règles de protection WAF.

Description de l'opération

Remarque

Limite de fréquence par utilisateur : 20 appels par seconde.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

  • Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.

  • API : l'API que vous pouvez appeler pour exécuter l'action.

  • Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.

  • Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.

    • Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.

    • Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.

  • Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.

  • Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

dcdn:BatchCreateDcdnWafRules

create

*All resources.

*

Aucune Aucune

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

PolicyId

integer

Oui

L'identifiant de la stratégie.

1000001

RuleConfigs

string

Oui

La configuration des règles de protection.

[{"name":"example","action":"monitor","conditions":[{"key":"URL","opValue":"match-one","values":"1,2,3,4,5"},{"key":"Header","opValue":"contain-one","subKey":"example_subkey","values":"6,7,8,9,10"}],"ratelimit":{"target":"header","interval":10,"threshold":5,"ttl":1800,"subKey":"example_subkey","status":{"code":"502","count":5}},"ccStatus":"on","effect":"rule","status":"on"}]

Description des valeurs de RuleConfigs

  • RuleConfigs est une liste (slice), où chaque structure représente une règle.

  • Le format de RuleConfigs varie en fonction du type de stratégie de protection spécifié par PolicyId.

Scénario de protection 1 : Protection par expressions régulières Web (waf_group)

ParamètreTypeRequisExempleDescription
statusStringNononLe commutateur de la règle de protection. Valeurs valides : on (activer) et off (désactiver). Valeur par défaut : on.
actionStringOuiblockL'action de la règle. Valeurs valides : block (bloquer les requêtes) et monitor (surveiller les requêtes).
wafGroupIdsStringNon1012L'identifiant du groupe de règles WAF. Valeur par défaut : 1012. Séparez plusieurs identifiants par des virgules (,).

Exemple de configuration waf_group :

// La protection par expressions régulières Web ne prend actuellement en charge qu'une seule règle par stratégie.
[
  {
    "status": "on",
    "action": "block"
  }
]

Scénario de protection 2 : Règles personnalisées (custom_acl)

ParamètreTypeRequisExempleDescription
namestringOuiacl_1Le nom de la règle de protection. Le nom peut contenir des lettres, des chiffres et des traits de soulignement (_), et peut comporter jusqu'à 64 caractères.
statusstringNononLe commutateur de la règle de protection. Valeurs valides : on (activer) et off (désactiver). Valeur par défaut : on.
conditionsConditionOui[ {"key": "URI", "subKey": "","opValue": "contain", "values": "/login.php" }]Les conditions qui déclenchent la règle. Pour plus d'informations sur les paramètres, consultez le Tableau 1 Description des métriques de condition.
ccStatusstringOuioffLe commutateur de contrôle de fréquence. Valeurs valides : on (activer) et off (désactiver).
rateLimitRateLimitNon{ "target": "Header", "subKey": "User-Agent", "interval": 5, "threshold": 2, "ttl": 1800}La règle de contrôle de fréquence. Ce paramètre est requis lorsque ccStatus est défini sur on. Pour plus d'informations sur les paramètres, consultez le Tableau 2 Description des métriques de RateLimit.
effectstringNonserviceLa portée d'application de la liste noire de contrôle de fréquence. Ce paramètre est requis lorsque ccStatus est défini sur on. Valeurs valides : rule (effectif pour la règle actuelle) et service (effectif globalement).
actionstringOuidenyL'action de la règle. Valeurs valides : deny (bloquer), js (vérification JavaScript) et monitor (surveiller).

Tableau 1 Description des métriques de condition

ParamètreTypeRequisExempleDescription
KeystringOuiQuery String ParameterLe champ de correspondance. Pour plus d'informations, consultez DescribeDcdnWafFilterInfo.
subKeystringNonactionLe sous-champ de correspondance. Pour plus d'informations, consultez DescribeDcdnWafFilterInfo.
opValueStringOuieqL'opérateur logique. Pour plus d'informations, consultez DescribeDcdnWafFilterInfo.
valuesStringNonjsLe contenu de correspondance. Séparez plusieurs valeurs par des virgules (,). Pour plus d'informations, consultez DescribeDcdnWafFilterInfo.

Tableau 2 Description des métriques de RateLimit

ParamètreTypeRequisExempleDescription
targetstringOuiHeaderLe champ statistique pour le contrôle de fréquence. Valeurs valides : IP (compte la fréquence des requêtes provenant de la même adresse IP), Header (compte la fréquence des requêtes contenant l'en-tête spécifié), Query String Parameter (compte la fréquence des requêtes contenant le paramètre spécifié), Cookie Name (compte la fréquence des requêtes contenant le cookie spécifié) et Session (compte la fréquence des requêtes provenant de la même session).
subKeystringNonUser-AgentLe sous-champ du champ unifié. Ce paramètre est requis lorsque target est défini sur Header, Query String Parameter ou Cookie Name.
IntervalIntegerOui5La période statistique. Valeurs valides : 5 à 1800. Unité : secondes.
thresholdIntegerOui2Le seuil statistique. Valeurs valides : 2 à 500000. Unité : fois.
ttlIntegerOui1800Le délai d'expiration de la liste noire. Valeurs valides : 60 à 86400. Unité : secondes.
statusRateLimitStatusNon{"code": "404", "ratio": 10}Les statistiques des codes de réponse. Pour plus d'informations sur les paramètres, consultez le Tableau 3 Description des métriques de RateLimitStatus.

Tableau 3 Description des métriques de RateLimitStatus

ParamètreTypeRequisExempleDescription
codetstringOui404Le code d'état HTTP.
ratioIntegerNon10Le pourcentage statistique (%). Valeurs valides : 1 à 100. Ce paramètre et le paramètre count sont mutuellement exclusifs.
countIntegerNon10Le nombre statistique. Valeurs valides : 2 à 50000. Ce paramètre et le paramètre ratio sont mutuellement exclusifs.

Exemple de configuration custom_acl :

[
  // Contrôle d'accès
  {
    "name": "acl_1",
    "status": "off",
    "conditions":
    [
      {
        "key": "Query String Parameter",
        "subKey": "action",
        "opValue": "eq",
        "values": "js"
      }
    ],
    "ccStatus": "off",
    "action": "js"
  },
  // Contrôle de fréquence
  {
    "name": "cc_1",
    "status": "on",
  	"conditions": 
    [
      {
        "key": "URI",
        "subKey": "",
        "opValue": "contain",
        "values": "/login.php"
      },
      {
        "key": "IP",
        "subKey": "",
        "opValue": "ip-contain",
        "values": "192.168.0.1/24"
      }
    ],
    "ccStatus": "on",
    "ratelimit":
    {
      "target": "Header",
      "subKey": "User-Agent",
      "interval": 5,
      "threshold": 2,
      "ttl": 1800,
      "status":
      {
        "code": "404",
        "ratio": 10
      }
    },
    "effect": "service",
    "action": "deny"
  }
]

Scénario de protection 3 : Liste blanche (whitelist)

ParamètreTypeRequisExempleDescription
namestringOuionLe nom de la règle de protection. Le nom peut contenir des lettres, des chiffres et des traits de soulignement (_), et peut comporter jusqu'à 64 caractères.
statusstringNononLe commutateur de la règle de protection. Valeurs valides : on (par défaut, activer) et off (désactiver).
conditionsConditionOui[{ "key": "Http-Method","subKey": "","opValue": "match-one", "values": "GET,POST,DELETE" }]Les conditions qui déclenchent la règle. Pour plus d'informations sur les paramètres, consultez le Tableau 1 Description des métriques de condition.
tagsStringOui[ "waf_group", "custom_acl"]La liste des types de stratégies de protection.
regularTypesStringNon[ [ "sqli", "xss","code_exec", "crlf", "lfilei", "rfilei", "webshell","vvip", "other"]Le type de règle d'expression régulière. Ce paramètre peut être spécifié lorsque waf_group est inclus dans tags. Valeurs valides : sqli, xss, code_exec, crlf, lfilei, rfilei, webshell, vvip et other.
regularRulesStringNon[ "100001", "100002", "100003"]La règle d'expression régulière. Ce paramètre peut être spécifié lorsque waf_group est inclus dans tags. Ce paramètre et regularTypes sont mutuellement exclusifs. La valeur est une liste de chaînes de six chiffres.

Exemple de configuration whitelist :

[
  // Ignorer tous les scénarios
  {
    "name": "wl_all",
    "status": "on",
    "conditions":
    [
      {
        "key": "Http-Method",
        "subKey": "",
        "opValue": "match-one",
        "values": "GET,POST,DELETE"
      }
    ],
    "tags":
    [
      "waf_group",
      "custom_acl",
      "ip_blacklist",
      "region_block"
    ]
  },
  // Ignorer les identifiants de règle spécifiés dans waf_group
  {
    "name": "wl_waf_id",
    "status": "off",
    "conditions":
    [
      {
        "key": "Cookie Name",
        "subKey": "cdn-sec",
        "opValue": "prefix-match",
        "values": "a7sdsa9dsa8d8sa"
      },
      {
        "key": "Referer",
        "subKey": "",
        "opValue": "none",
        "values": ""
      }
    ],
    "tags":
    [
      "waf_group"
    ],
    "regularRules":
    [
      "100001",
      "100002",
      "100003"
    ]
  },
  {
  // Ignorer les types de règle spécifiés dans waf_group
    "name": "wl_waf_type",
    "status": "on",
    "conditions":
    [
      {
        "key": "Query String",
        "subKey": "",
        "opValue": "exists",
        "values": ""
      }
    ],
    "tags":
    [
      "waf_group"
    ],
    "regularTypes":
    [
      "sqli",
      "xss",
      "code_exec",
      "crlf",
      "lfilei",
      "rfilei",
      "webshell",
      "vvip",
      "other"
    ]
  },
  // Ignorer les règles personnalisées
  {
    "name": "wl_custom_acl",
    "status": "on",
    "conditions":
    [
      {
        "key": "Http-Method",
        "subKey": "",
        "opValue": "match-one",
        "values": "GET,POST,DELETE"
      }
    ],
    "tags":
    [
      "custom_acl"
    ]
  },
  // Ignorer la liste noire d'adresses IP
  {
    "name": "wl_ip_blacklist",
    "status": "on",
    "conditions":
    [
      {
        "key": "Http-Method",
        "subKey": "",
        "opValue": "match-one",
        "values": "GET,POST,DELETE"
      }
    ],
    "tags":
    [
      "ip_blacklist"
    ]
  },
  // Ignorer le blocage de région
  {
    "name": "wl_region_block",
    "status": "on",
    "conditions":
    [
      {
        "key": "Http-Method",
        "subKey": "",
        "opValue": "match-one",
        "values": "GET,POST,DELETE"
      }
    ],
    "tags":
    [
      "region_block"
    ]
  }
]

Scénario de protection 4 : Liste noire d'adresses IP (ip_blacklist)

ParamètreTypeRequisExempleDescription
namestringOuiipblacklistLe nom de la règle de protection. Le nom peut contenir des lettres, des chiffres et des traits de soulignement (_), et peut comporter jusqu'à 64 caractères.
statusstringNononLe commutateur de la règle de protection. Valeurs valides : on (activer) et off (désactiver). Valeur par défaut : on.
remoteAddr[]StringOui["192.168.0.1","10.10.10.10/24","::1","abcd::abcd","BCDE::BCDE"]Filtre par adresse IP. Pour plus d'informations, consultez DescribeDcdnWafFilterInfo.
actionstringOuidenyL'action de la règle. Valeurs valides : deny (bloquer) et monitor (surveiller).

Exemple de configuration ipblacklist :

[
    {
    "name": "ipblacklist",
    "status": "on",
    "remoteAddr": ["192.168.0.1","10.10.10.10/24","::1","abcd::abcd","BCDE::BCDE"],
    "action": "deny"
  }
]

Scénario de protection 5 : Blocage de région (region_block)

ParamètreTypeRequisExempleDescription
statusstringNononLe commutateur de la règle de protection. Valeurs valides : on (activer) et off (désactiver). Valeur par défaut : on.
cnRegionListstringNon110000,TW,MOLes régions bloquées en Chine continentale, séparées par des virgules (,). Pour plus d'informations sur les régions prises en charge, consultez DescribeDcdnWafGeoInfo.
otherRegionListstringNonJP,GBLes régions bloquées en dehors de la Chine continentale, séparées par des virgules (,). Pour plus d'informations sur les régions prises en charge, consultez DescribeDcdnWafGeoInfo.
actionstringOuidenyL'action de la règle. Valeurs valides : deny (bloquer) et monitor (surveiller).
Remarque

Vous devez spécifier au moins l'un des paramètres cnRegionList et otherRegionList.

Exemple de configuration region_block :

[
    {
    "status": "on",
    "cnRegionList": "110000,TW,MO",
    "otherRegionList": "JP,GB",
    "action": "deny"
  }
]

Scénario de protection 6 : Gestion des bots (bot)

Modèle de règle

Tous les paramètres de règle incluent les quatre champs suivants. Pour les valeurs spécifiques, reportez-vous à la catégorie de règle correspondante.

ParamètreTypeRequisDescription
typeStringOuiLe type de règle. Pour plus d'informations, consultez la catégorie de règle spécifique.
statusStringOuiL'état de la règle. Valeurs valides : on (activé) et off (désactivé).
configTargetTypeNonLa configuration de la règle. Pour plus d'informations, consultez la catégorie de règle spécifique.
actionStringNonL'action de la règle. Pour plus d'informations, consultez la catégorie de règle spécifique.

Catégorie de règle 1 : Type d'objet protégé

ParamètreTypeRequisExempleDescription
typeStringOuitarget_typeLe type de règle. Définissez la valeur sur target_type.
statusStringOuionLe commutateur de la règle. Valeur valide : on (activé).
configTargetTypeNon{"target":"app"}La configuration de la règle. Format :
target : le type d'objet protégé. Requis. Valeurs valides : web (pages Web/navigateurs) et app (applications).

actionStringNonEmptyL'action de la règle. Non applicable ici. Définissez-la sur une valeur vide.

Exemple de configuration de type d'objet protégé :

[
  {
    "type":"target_type",
    "status":"on",
    "config":{"target":"app"},
    "action":""
  }
]

Catégorie de règle 2 : Intégration du SDK Web

ParamètreTypeRequisExempleDescription
typeStringOuiweb_sdkLe type de règle. Définissez la valeur sur web_sdk.
statusStringOuionLe commutateur de la règle. Valeur valide : on (activé).
configWebSdkNon{"mode":"automatic","crossDomain":"example.com"}La configuration de la règle. Format :
mode : la méthode d'intégration du SDK Web. Requis. Valeurs valides : automatic (intégration automatique) et manual (intégration manuelle).
crossDomain : l'appel de nom de domaine inter-domaines. Facultatif. Ce paramètre prend effet uniquement lorsque mode est défini sur automatic.




actionStringNonEmptyL'action de la règle. Non applicable ici. Définissez-la sur une valeur vide.

Exemple de configuration d'intégration du SDK Web :

[
  {
    "type":"web_sdk",
    "status":"on",
    "config":{"mode":"automatic","crossDomain":"example.com"},
    "action":""
  }
]

Catégorie de règle 3 : Caractéristiques du trafic

ParamètreTypeRequisExempleDescription
typeStringOuitraffic_featureLe type de règle. Définissez la valeur sur traffic_feature.
statusStringOuionLe commutateur de la règle. Valeur valide : on (activé).
configTrafficFeatureOui{"conditions":[{"key":"Header","subKey":"User-Agent","opValue":"contain","values":"Chrome"},{"key":"IP","subKey":"","opValue":"ip-contain","values":"192.168.0.1/24"}]}La configuration de la règle. Pour plus d'informations, consultez condition.
actionStringNonEmptyL'action de la règle. Non applicable ici. Définissez-la sur une valeur vide.

condition (Conditions de correspondance)

ParamètreTypeRequisExempleDescription
keyStringOuiHeaderLe champ de correspondance. Pour les valeurs spécifiques, consultez DescribeDcdnWafFilterInfo.
subKeyStringNonUser-AgentLe sous-champ de correspondance. Pour les valeurs spécifiques, consultez DescribeDcdnWafFilterInfo.
opValueStringOuicontainL'opérateur. Pour les valeurs spécifiques, consultez DescribeDcdnWafFilterInfo.
valuesStringNonChromeLe contenu de correspondance. Séparez plusieurs valeurs par des virgules (,). Pour les valeurs spécifiques, consultez DescribeDcdnWafFilterInfo.

Exemple de configuration de caractéristiques du trafic :

[
  {
    "type":"traffic_feature",
    "status":"on",
    "config":{"conditions":[{"key":"Header","subKey":"User-Agent","opValue":"contain","values":"Chrome"},{"key":"IP","subKey":"","opValue":"ip-contain","values":"192.168.0.1/24"}]},
    "action":""
  }
]

Catégorie de règle 4 : Gestion des bots légitimes

ParamètreTypeRequisExempleDescription
typeStringOuiintelligence_crawlerLe type de règle. Définissez la valeur sur intelligence_crawler.
statusStringOuionLe commutateur de la règle. Valeur valide : on (activé).
configIntelligenceCrawlerNon{"name":"intelligence_crawler_baidu"}La configuration de la règle. Pour les valeurs valides, consultez name (Liste blanche des bots de moteurs de recherche).
actionStringOuibypassL'action de la règle. Valeur valide : bypass (autoriser).

name (Liste blanche des bots de moteurs de recherche)

ValeurDescription
intelligence_crawler_allListe blanche des moteurs de recherche légitimes (Google, Bing, Baidu, Sogou, 360, Yandex)
intelligence_crawler_baiduListe blanche des bots Baidu
intelligence_crawler_sogouListe blanche des bots Sogou
intelligence_crawler_360Liste blanche des bots 360
intelligence_crawler_googleListe blanche des bots Google
intelligence_crawler_bingListe blanche des bots Bing
intelligence_crawler_yandexListe blanche des bots Yandex

Exemple de configuration de gestion des bots légitimes :

[
  {
    "type":"intelligence_crawler",
    "status":"on",
    "config":{"name":"intelligence_crawler_baidu"},
    "action":"bypass"
  },
  {
    "type":"intelligence_crawler",
    "status":"on",
    "config":{"name":"intelligence_crawler_google"},
    "action":"bypass"
  }
]

Catégorie de règle 5 : Filtrage de scripts simples (défi JavaScript)

ParamètreTypeRequisExempleDescription
typeStringOuijsLe type de règle. Définissez la valeur sur js.
statusStringOuionLe commutateur de la règle. Valeurs valides : on (activé) et off (désactivé).
configJsNonEmptyLa configuration de la règle. Non applicable ici. Définissez-la sur une valeur vide.
actionStringOuijsL'action de la règle. Valeur valide : js (vérification JavaScript).

Exemple de configuration de filtrage de scripts simples (défi JavaScript) :

[
  {
    "type":"js",
    "status":"on",
    "config":{},
    "action":"js"
  }
]

Catégorie de règle 6 : Protection avancée contre les bots (défi de jeton dynamique)

ParamètreTypeRequisExempleDescription
typeStringOuisigchlLe type de règle. Définissez la valeur sur sigchl.
statusStringOuionLe commutateur de la règle. Valeurs valides : on (activé) et off (désactivé).
configSigchlNon{"sigchl":["sig","replay","driver"]}La configuration de la règle. Format :
sigchl : la vérification de signature des données de requête. Requis. Valeurs valides : sig (exception de vérification de signature), replay (exception d'horodatage de signature) et driver (attaque WebDriver).

actionStringOuisigchlL'action de la règle. Valeur valide : sigchl (bloquer).

Exemple de configuration de protection avancée contre les bots (défi de jeton dynamique) :

[
  {
    "type":"sigchl",
    "status":"on",
    "config":{"sigchl":["sig","replay","driver"]},
    "action":"sigchl"
  }
]

Catégorie de règle 7 : Protection intelligente basée sur l'IA

ParamètreTypeRequisExempleDescription
typeStringOuialgorithmLe type de règle. Définissez la valeur sur algorithm.
statusStringOuionLe commutateur de la règle. Valeurs valides : on (activé) et off (désactivé).
configAlgorithmNonEmptyLa configuration de la règle. Non applicable ici. Définissez-la sur une valeur vide.
actionStringOuicaptchaL'action de la règle. Valeurs valides : monitor (surveiller) et captcha (CAPTCHA à curseur).

Exemple de configuration de protection intelligente basée sur l'IA :

[
  {
    "type":"algorithm",
    "status":"on",
    "config":{},
    "action":"captcha"
  }
]

Catégorie de règle 8 : Limitation de fréquence par IP

ParamètreTypeRequisExempleDescription
typeStringOuicustom_cc_ipLe type de règle. Définissez la valeur sur custom_cc_ip.
statusStringOuionLe commutateur de la règle. Valeurs valides : on (activé) et off (désactivé).
configCustomCcIpOui{"interval":20,"target":"IP","threshold":50,"ttl":2800}La configuration de la règle. Pour plus d'informations, consultez Description des paramètres de configuration de la limitation de fréquence par IP.
actionStringOuimonitorL'action de la règle. Valeurs valides : deny (bloquer), monitor (surveiller) et captcha (CAPTCHA à curseur, applicable uniquement au Web).

Description des paramètres de configuration de la limitation de fréquence par IP

ParamètreTypeRequisExempleDescription
targetStringOuiIPLe champ statistique pour le contrôle de fréquence. Valeur valide : IP.
subKeyStringNonEmptyLe sous-champ du champ statistique. Non applicable ici. Définissez-le sur une valeur vide.
IntervalIntegerOui20La période statistique. Valeurs valides : 5 à 1800. Unité : secondes.
thresholdIntegerOui50Le seuil statistique. Valeurs valides : 2 à 50000. Unité : fois.
ttlIntegerOui2800Le délai d'expiration de la liste noire. Valeurs valides : 60 à 86400. Unité : secondes.

Exemple de configuration de limitation de fréquence par IP :

[
  {
    "type":"custom_cc_ip",
    "status":"on",
    "config":{"interval":20,"target":"IP","threshold":50,"ttl":2800},
    "action":"monitor"
  },
  {
    "type":"custom_cc_ip",
    "status":"on",
    "config":{"interval":10,"target":"IP","threshold":30,"ttl":1800},
    "action":"monitor"
  }
]

Catégorie de règle 9 : Limitation de fréquence par appareil

ParamètreTypeRequisExempleDescription
typeStringOuicustom_cc_devLe type de règle. Définissez la valeur sur custom_cc_dev.
statusStringOuionLe commutateur de la règle. Valeurs valides : on (activé) et off (désactivé).
configCustomCcDevOui{"interval":20,"target":"Header","subKey":"aliwaf_wxbb_umid","threshold":50,"ttl":2800}La configuration de la règle. Pour plus d'informations, consultez Description des paramètres de configuration de la limitation de fréquence par appareil.
actionStringOuimonitorL'action de la règle. Valeurs valides : deny (bloquer) et monitor (surveiller).

Description des paramètres de configuration de la limitation de fréquence par appareil

ParamètreTypeRequisExempleDescription
targetStringOuiHeaderLe champ statistique pour le contrôle de fréquence. Valeur valide : Header.
subKeyStringNonaliwaf_wxbb_umidLe sous-champ du champ statistique. Valeur valide : aliwaf_wxbb_umid.
IntervalIntegerOui20La période statistique. Valeurs valides : 5 à 1800. Unité : secondes.
thresholdIntegerOui50Le seuil statistique. Valeurs valides : 2 à 50000. Unité : fois.
ttlIntegerOui2800Le délai d'expiration de la liste noire. Valeurs valides : 60 à 86400. Unité : secondes.

Exemple de configuration de limitation de fréquence par appareil :

[
  {
    "type":"custom_cc_dev",
    "status":"on",
    "config":{"interval":20,"target":"Header","subKey":"aliwaf_wxbb_umid","threshold":50,"ttl":2800},
    "action":"monitor"
  },
  {
    "type":"custom_cc_dev",
    "status":"on",
    "config":{"interval":20,"target":"Header","subKey":"aliwaf_wxbb_umid","threshold":50,"ttl":2800},
    "action":"deny"
  }
]

Catégorie de règle 10 : Limitation de fréquence par session personnalisée

ParamètreTypeRequisExempleDescription
typeStringOuicustom_ccLe type de règle. Définissez la valeur sur custom_cc.
statusStringOuionLe commutateur de la règle. Valeurs valides : on (activé) et off (désactivé).
configCustomCcIpOui{"interval":10,"target":"Query String Parameter","subKey":"arg","threshold":30,"ttl":1800}La configuration de la règle. Pour plus d'informations, consultez Description des paramètres de configuration de la limitation de fréquence par session personnalisée.
actionStringOuimonitorL'action de la règle. Valeurs valides : deny (bloquer), monitor (surveiller) et captcha (CAPTCHA à curseur, applicable uniquement au Web).

Description des paramètres de configuration de la limitation de fréquence par session personnalisée

ParamètreTypeRequisExempleDescription
targetStringOuiQuery String ParameterLe champ statistique pour le contrôle de fréquence. Valeurs valides : Header (compte la fréquence des requêtes contenant l'en-tête spécifié), Query String Parameter (compte la fréquence des requêtes contenant le paramètre spécifié), Cookie Name (compte la fréquence des requêtes contenant le cookie spécifié) et Session (compte la fréquence des requêtes provenant de la même session).
subKeyStringNonargLe sous-ch

Éléments de réponse

Élément

Type

Description

Exemple

object

RequestId

string

L'identifiant de la requête.

CB1A380B-09F0-41BB-280B-72F8FD6DA2FE

RuleIds

object

RuleId

array

La liste des identifiants des règles de protection.

string

La liste des identifiants des règles créées.

100001,200002

Exemples

JSON format

{
  "RequestId": "CB1A380B-09F0-41BB-280B-72F8FD6DA2FE",
  "RuleIds": {
    "RuleId": [
      "100001,200002"
    ]
  }
}

Codes d'erreur

Code de statut HTTP

Code d'erreur

Message d'erreur

Description

400 InvalidParameter The specified parameter is invalid. Le paramètre n'est pas valide.
400 Policy.NotExist The specified policy does not exist. La stratégie de protection spécifiée n'existe pas.
400 RuleConfigs.Malformed The specified RuleConfigs format is invalid. Le paramètre RuleConfigs spécifié est malformé.
400 RuleName.AlreadyExists Rule name already exists in specified policy. Le nom de la règle existe déjà dans la stratégie spécifiée.
400 Rule.QuantityOverflow Rules are overflowed quantity in specified policy. Le nombre de règles dans la stratégie spécifiée a dépassé le quota.
500 InternalError An internal error occurred; please try again later. Une erreur interne s'est produite. Réessayez. Si l'erreur persiste après plusieurs tentatives, soumettez un ticket.
403 %s.NotSupport The specified resource type %s is not supported. Le type de ressource spécifié n'est pas pris en charge. Pour utiliser ce type de ressource, contactez-nous.
403 %s.OverQuota The quantity of %s exceeds the quota. Le nombre de cette ressource dépasse la limite du quota. Pour demander un quota supérieur, contactez-nous.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.