Todos os produtos
Search
Central de documentação

Edge Security Acceleration:BatchCreateDcdnWafRules

Última atualização: Oct 12, 2026

Configura regras de proteção do WAF.

Descrição da operação

Nota

Limite de taxa por usuário: 20 chamadas por segundo.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

  • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

  • API: A API que você pode chamar para executar a ação.

  • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

  • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

    • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

    • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

  • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

  • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

dcdn:BatchCreateDcdnWafRules

create

*All resources.

*

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

PolicyId

integer

Sim

O ID da política.

1000001

RuleConfigs

string

Sim

A configuração das regras de proteção.

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

Descrição do valor de RuleConfigs

  • RuleConfigs é uma lista (list slice), onde cada struct representa uma regra.

  • O formato de RuleConfigs varia de acordo com o tipo da política de proteção especificada por PolicyId.

Cenário de proteção 1: Proteção por regex web (waf_group)

ParâmetroTipoObrigatórioExemploDescrição
statusStringNãoonA chave da regra de proteção. Valores válidos: on (ativar) e off (desativar). Valor padrão: on.
actionStringSimblockA ação da regra. Valores válidos: block (bloquear solicitações) e monitor (monitorar solicitações).
wafGroupIdsStringNão1012O ID do grupo de regras do WAF. Valor padrão: 1012. Separe vários IDs com vírgulas (,).

Exemplo de configuração de waf_group:

// A proteção por regex web atualmente suporta apenas uma regra por política.
[
  {
    "status": "on",
    "action": "block"
  }
]

Cenário de proteção 2: Regras personalizadas (custom_acl)

ParâmetroTipoObrigatórioExemploDescrição
namestringSimacl_1O nome da regra de proteção. O nome pode conter letras, dígitos e sublinhados (_), e pode ter até 64 caracteres.
statusstringNãoonA chave da regra de proteção. Valores válidos: on (ativar) e off (desativar). Valor padrão: on.
conditionsConditionSim[ {"key": "URI", "subKey": "","opValue": "contain", "values": "/login.php" }]As condições que acionam a regra. Para mais informações sobre os parâmetros, consulte a Tabela 1 Descrição da métrica Condition.
ccStatusstringSimoffA chave para controle de frequência. Valores válidos: on (ativar) e off (desativar).
rateLimitRateLimitNão{ "target": "Header", "subKey": "User-Agent", "interval": 5, "threshold": 2, "ttl": 1800}A regra de controle de frequência. Este parâmetro é obrigatório quando ccStatus é definido como on. Para mais informações sobre os parâmetros, consulte a Tabela 2 Descrição da métrica RateLimit.
effectstringNãoserviceO escopo efetivo da lista negra de controle de frequência. Este parâmetro é obrigatório quando ccStatus é definido como on. Valores válidos: rule (efetivo para a regra atual) e service (efetivo globalmente).
actionstringSimdenyA ação da regra. Valores válidos: deny (bloquear), js (verificação JavaScript) e monitor (monitorar).

Tabela 1 Descrição da métrica Condition

ParâmetroTipoObrigatórioExemploDescrição
KeystringSimQuery String ParameterO campo de correspondência. Para mais informações, consulte DescribeDcdnWafFilterInfo.
subKeystringNãoactionO subcampo de correspondência. Para mais informações, consulte DescribeDcdnWafFilterInfo.
opValueStringSimeqO operador lógico. Para mais informações, consulte DescribeDcdnWafFilterInfo.
valuesStringNãojsO conteúdo de correspondência. Separe vários valores com vírgulas (,). Para mais informações, consulte DescribeDcdnWafFilterInfo.

Tabela 2 Descrição da métrica RateLimit

ParâmetroTipoObrigatórioExemploDescrição
targetstringSimHeaderO campo estatístico para controle de frequência. Valores válidos: IP (conta a frequência de solicitações do mesmo endereço IP), Header (conta a frequência de solicitações que contêm o cabeçalho especificado), Query String Parameter (conta a frequência de solicitações que contêm o parâmetro especificado), Cookie Name (conta a frequência de solicitações que contêm o cookie especificado) e Session (conta a frequência de solicitações da mesma sessão).
subKeystringNãoUser-AgentO subcampo do campo unificado. Este parâmetro é obrigatório quando target é definido como Header, Query String Parameter ou Cookie Name.
IntervalIntegerSim5O período estatístico. Valores válidos: 5 a 1800. Unidade: segundos.
thresholdIntegerSim2O limite estatístico. Valores válidos: 2 a 500000. Unidade: vezes.
ttlIntegerSim1800O período de tempo limite da lista negra. Valores válidos: 60 a 86400. Unidade: segundos.
statusRateLimitStatusNão{"code": "404", "ratio": 10}As estatísticas de códigos de resposta. Para mais informações sobre os parâmetros, consulte a Tabela 3 Descrição da métrica RateLimitStatus.

Tabela 3 Descrição da métrica RateLimitStatus

ParâmetroTipoObrigatórioExemploDescrição
codetstringSim404O código de status HTTP.
ratioIntegerNão10A porcentagem estatística (%). Valores válidos: 1 a 100. Este parâmetro e o parâmetro count são mutuamente exclusivos.
countIntegerNão10A contagem estatística. Valores válidos: 2 a 50000. Este parâmetro e o parâmetro ratio são mutuamente exclusivos.

Exemplo de configuração de custom_acl:

[
  // Controle de acesso
  {
    "name": "acl_1",
    "status": "off",
    "conditions":
    [
      {
        "key": "Query String Parameter",
        "subKey": "action",
        "opValue": "eq",
        "values": "js"
      }
    ],
    "ccStatus": "off",
    "action": "js"
  },
  // Controle de frequência
  {
    "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"
  }
]

Cenário de proteção 3: Lista de permissões (whitelist)

ParâmetroTipoObrigatórioExemploDescrição
namestringSimonO nome da regra de proteção. O nome pode conter letras, dígitos e sublinhados (_), e pode ter até 64 caracteres.
statusstringNãoonA chave da regra de proteção. Valores válidos: on (padrão, ativar) e off (desativar).
conditionsConditionSim[{ "key": "Http-Method","subKey": "","opValue": "match-one", "values": "GET,POST,DELETE" }]As condições que acionam a regra. Para mais informações sobre os parâmetros, consulte a Tabela 1 Descrição da métrica Condition.
tagsStringSim[ "waf_group", "custom_acl"]A lista de tipos de políticas de proteção.
regularTypesStringNão[ [ "sqli", "xss","code_exec", "crlf", "lfilei", "rfilei", "webshell","vvip", "other"]O tipo da regra de expressão regular. Este parâmetro pode ser especificado quando waf_group está incluído em tags. Valores válidos: sqli, xss, code_exec, crlf, lfilei, rfilei, webshell, vvip e other.
regularRulesStringNão[ "100001", "100002", "100003"]A regra de expressão regular. Este parâmetro pode ser especificado quando waf_group está incluído em tags. Este parâmetro e regularTypes são mutuamente exclusivos. O valor é uma lista de strings de seis dígitos.

Exemplo de configuração de whitelist:

[
  // Ignorar todos os cenários
  {
    "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"
    ]
  },
  // Ignorar IDs de regras especificados em 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"
    ]
  },
  {
  // Ignorar tipos de regras especificados em 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"
    ]
  },
  // Ignorar regras personalizadas
  {
    "name": "wl_custom_acl",
    "status": "on",
    "conditions":
    [
      {
        "key": "Http-Method",
        "subKey": "",
        "opValue": "match-one",
        "values": "GET,POST,DELETE"
      }
    ],
    "tags":
    [
      "custom_acl"
    ]
  },
  // Ignorar lista negra de IPs
  {
    "name": "wl_ip_blacklist",
    "status": "on",
    "conditions":
    [
      {
        "key": "Http-Method",
        "subKey": "",
        "opValue": "match-one",
        "values": "GET,POST,DELETE"
      }
    ],
    "tags":
    [
      "ip_blacklist"
    ]
  },
  // Ignorar bloqueio de região
  {
    "name": "wl_region_block",
    "status": "on",
    "conditions":
    [
      {
        "key": "Http-Method",
        "subKey": "",
        "opValue": "match-one",
        "values": "GET,POST,DELETE"
      }
    ],
    "tags":
    [
      "region_block"
    ]
  }
]

Cenário de proteção 4: Lista negra de IPs (ip_blacklist)

ParâmetroTipoObrigatórioExemploDescrição
namestringSimipblacklistO nome da regra de proteção. O nome pode conter letras, dígitos e sublinhados (_), e pode ter até 64 caracteres.
statusstringNãoonA chave da regra de proteção. Valores válidos: on (ativar) e off (desativar). Valor padrão: on.
remoteAddr[]StringSim["192.168.0.1","10.10.10.10/24","::1","abcd::abcd","BCDE::BCDE"]Filtra por endereço IP. Para mais informações, consulte DescribeDcdnWafFilterInfo.
actionstringSimdenyA ação da regra. Valores válidos: deny (bloquear) e monitor (monitorar).

Exemplo de configuração de ipblacklist:

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

Cenário de proteção 5: Bloqueio de região (region_block)

ParâmetroTipoObrigatórioExemploDescrição
statusstringNãoonA chave da regra de proteção. Valores válidos: on (ativar) e off (desativar). Valor padrão: on.
cnRegionListstringNão110000,TW,MOAs regiões bloqueadas na parte continental da China, separadas por vírgulas (,). Para mais informações sobre as regiões suportadas, consulte DescribeDcdnWafGeoInfo.
otherRegionListstringNãoJP,GBAs regiões bloqueadas fora da parte continental da China, separadas por vírgulas (,). Para mais informações sobre as regiões suportadas, consulte DescribeDcdnWafGeoInfo.
actionstringSimdenyA ação da regra. Valores válidos: deny (bloquear) e monitor (monitorar).
Nota

Você deve especificar pelo menos um entre cnRegionList e otherRegionList.

Exemplo de configuração de region_block:

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

Cenário de proteção 6: Gerenciamento de bots (bot)

Modelo de regra

Todos os parâmetros da regra incluem os quatro campos a seguir. Para valores específicos, consulte a categoria de regra correspondente.

ParâmetroTipoObrigatórioDescrição
typeStringSimO tipo da regra. Para mais informações, consulte a categoria de regra específica.
statusStringSimO status da regra. Valores válidos: on (ativado) e off (desativado).
configTargetTypeNãoA configuração da regra. Para mais informações, consulte a categoria de regra específica.
actionStringNãoA ação da regra. Para mais informações, consulte a categoria de regra específica.

Categoria de regra 1: Tipo de objeto protegido

ParâmetroTipoObrigatórioExemploDescrição
typeStringSimtarget_typeO tipo da regra. Defina o valor como target_type.
statusStringSimonA chave da regra. Valor válido: on (ativado).
configTargetTypeNão{"target":"app"}A configuração da regra. Formato:
target: o tipo de objeto protegido. Obrigatório. Valores válidos: web (páginas da web/navegadores) e app (aplicativos).

actionStringNãoVazioA ação da regra. Não aplicável aqui. Defina como um valor vazio.

Exemplo de configuração de tipo de objeto protegido:

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

Categoria de regra 2: Integração do Web SDK

ParâmetroTipoObrigatórioExemploDescrição
typeStringSimweb_sdkO tipo da regra. Defina o valor como web_sdk.
statusStringSimonA chave da regra. Valor válido: on (ativado).
configWebSdkNão{"mode":"automatic","crossDomain":"example.com"}A configuração da regra. Formato:
mode: o método de integração do Web SDK. Obrigatório. Valores válidos: automatic (integração automática) e manual (integração manual).
crossDomain: a chamada de nome de domínio entre domínios. Opcional. Este parâmetro só entra em vigor quando mode é definido como automatic.




actionStringNãoVazioA ação da regra. Não aplicável aqui. Defina como um valor vazio.

Exemplo de configuração de integração do Web SDK:

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

Categoria de regra 3: Recursos de tráfego

ParâmetroTipoObrigatórioExemploDescrição
typeStringSimtraffic_featureO tipo da regra. Defina o valor como traffic_feature.
statusStringSimonA chave da regra. Valor válido: on (ativado).
configTrafficFeatureSim{"conditions":[{"key":"Header","subKey":"User-Agent","opValue":"contain","values":"Chrome"},{"key":"IP","subKey":"","opValue":"ip-contain","values":"192.168.0.1/24"}]}A configuração da regra. Para mais informações, consulte condition.
actionStringNãoVazioA ação da regra. Não aplicável aqui. Defina como um valor vazio.

condition (Condições de correspondência)

ParâmetroTipoObrigatórioExemploDescrição
keyStringSimHeaderO campo de correspondência. Para valores específicos, consulte DescribeDcdnWafFilterInfo.
subKeyStringNãoUser-AgentO subcampo de correspondência. Para valores específicos, consulte DescribeDcdnWafFilterInfo.
opValueStringSimcontainO operador. Para valores específicos, consulte DescribeDcdnWafFilterInfo.
valuesStringNãoChromeO conteúdo de correspondência. Separe vários valores com vírgulas (,). Para valores específicos, consulte DescribeDcdnWafFilterInfo.

Exemplo de configuração de recursos de tráfego:

[
  {
    "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":""
  }
]

Categoria de regra 4: Gerenciamento de bots legítimos

ParâmetroTipoObrigatórioExemploDescrição
typeStringSimintelligence_crawlerO tipo da regra. Defina o valor como intelligence_crawler.
statusStringSimonA chave da regra. Valor válido: on (ativado).
configIntelligenceCrawlerNão{"name":"intelligence_crawler_baidu"}A configuração da regra. Para valores válidos, consulte name (Lista de permissões de bots de mecanismos de busca).
actionStringSimbypassA ação da regra. Valor válido: bypass (permitir).

name (Lista de permissões de bots de mecanismos de busca)

ValorDescrição
intelligence_crawler_allLista de permissões de mecanismos de busca legítimos (Google, Bing, Baidu, Sogou, 360, Yandex)
intelligence_crawler_baiduLista de permissões de bots do Baidu
intelligence_crawler_sogouLista de permissões de bots do Sogou
intelligence_crawler_360Lista de permissões de bots do 360
intelligence_crawler_googleLista de permissões de bots do Google
intelligence_crawler_bingLista de permissões de bots do Bing
intelligence_crawler_yandexLista de permissões de bots do Yandex

Exemplo de configuração de gerenciamento de bots legítimos:

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

Categoria de regra 5: Filtragem de script simples (desafio JavaScript)

ParâmetroTipoObrigatórioExemploDescrição
typeStringSimjsO tipo da regra. Defina o valor como js.
statusStringSimonA chave da regra. Valores válidos: on (ativado) e off (desativado).
configJsNãoVazioA configuração da regra. Não aplicável aqui. Defina como um valor vazio.
actionStringSimjsA ação da regra. Valor válido: js (verificação JavaScript).

Exemplo de configuração de filtragem de script simples (desafio JavaScript):

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

Categoria de regra 6: Proteção avançada contra bots (desafio de token dinâmico)

ParâmetroTipoObrigatórioExemploDescrição
typeStringSimsigchlO tipo da regra. Defina o valor como sigchl.
statusStringSimonA chave da regra. Valores válidos: on (ativado) e off (desativado).
configSigchlNão{"sigchl":["sig","replay","driver"]}A configuração da regra. Formato:
sigchl: a verificação de assinatura de dados da solicitação. Obrigatório. Valores válidos: sig (exceção de verificação de assinatura), replay (exceção de carimbo de data/hora da assinatura) e driver (ataque WebDriver).

actionStringSimsigchlA ação da regra. Valor válido: sigchl (bloquear).

Exemplo de configuração de proteção avançada contra bots (desafio de token dinâmico):

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

Categoria de regra 7: Proteção inteligente baseada em IA

ParâmetroTipoObrigatórioExemploDescrição
typeStringSimalgorithmO tipo da regra. Defina o valor como algorithm.
statusStringSimonA chave da regra. Valores válidos: on (ativado) e off (desativado).
configAlgorithmNãoVazioA configuração da regra. Não aplicável aqui. Defina como um valor vazio.
actionStringSimcaptchaA ação da regra. Valores válidos: monitor (monitorar) e captcha (CAPTCHA de controle deslizante).

Exemplo de configuração de proteção inteligente baseada em IA:

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

Categoria de regra 8: Limitação de taxa de IP

ParâmetroTipoObrigatórioExemploDescrição
typeStringSimcustom_cc_ipO tipo da regra. Defina o valor como custom_cc_ip.
statusStringSimonA chave da regra. Valores válidos: on (ativado) e off (desativado).
configCustomCcIpSim{"interval":20,"target":"IP","threshold":50,"ttl":2800}A configuração da regra. Para mais informações, consulte Descrição do parâmetro de configuração de limitação de taxa de IP.
actionStringSimmonitorA ação da regra. Valores válidos: deny (bloquear), monitor (monitorar) e captcha (CAPTCHA de controle deslizante, aplicável apenas à web).

Descrição do parâmetro de configuração de limitação de taxa de IP

ParâmetroTipoObrigatórioExemploDescrição
targetStringSimIPO campo estatístico para controle de frequência. Valor válido: IP.
subKeyStringNãoVazioO subcampo do campo estatístico. Não aplicável aqui. Defina como um valor vazio.
IntervalIntegerSim20O período estatístico. Valores válidos: 5 a 1800. Unidade: segundos.
thresholdIntegerSim50O limite estatístico. Valores válidos: 2 a 50000. Unidade: vezes.
ttlIntegerSim2800O período de tempo limite da lista negra. Valores válidos: 60 a 86400. Unidade: segundos.

Exemplo de configuração de limitação de taxa de 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"
  }
]

Categoria de regra 9: Limitação de taxa de dispositivo

ParâmetroTipoObrigatórioExemploDescrição
typeStringSimcustom_cc_devO tipo da regra. Defina o valor como custom_cc_dev.
statusStringSimonA chave da regra. Valores válidos: on (ativado) e off (desativado).
configCustomCcDevSim{"interval":20,"target":"Header","subKey":"aliwaf_wxbb_umid","threshold":50,"ttl":2800}A configuração da regra. Para mais informações, consulte Descrição do parâmetro de configuração de limitação de taxa de dispositivo.
actionStringSimmonitorA ação da regra. Valores válidos: deny (bloquear) e monitor (monitorar).

Descrição do parâmetro de configuração de limitação de taxa de dispositivo

ParâmetroTipoObrigatórioExemploDescrição
targetStringSimHeaderO campo estatístico para controle de frequência. Valor válido: Header.
subKeyStringNãoaliwaf_wxbb_umidO subcampo do campo estatístico. Valor válido: aliwaf_wxbb_umid.
IntervalIntegerSim20O período estatístico. Valores válidos: 5 a 1800. Unidade: segundos.
thresholdIntegerSim50O limite estatístico. Valores válidos: 2 a 50000. Unidade: vezes.
ttlIntegerSim2800O período de tempo limite da lista negra. Valores válidos: 60 a 86400. Unidade: segundos.

Exemplo de configuração de limitação de taxa de dispositivo:

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

Categoria de regra 10: Limitação de taxa de sessão personalizada

ParâmetroTipoObrigatórioExemploDescrição
typeStringSimcustom_ccO tipo da regra. Defina o valor como custom_cc.
statusStringSimonA chave da regra. Valores válidos: on (ativado) e off (desativado).
configCustomCcIpSim{"interval":10,"target":"Query String Parameter","subKey":"arg","threshold":30,"ttl":1800}A configuração da regra. Para mais informações, consulte Descrição do parâmetro de configuração de limitação de taxa de sessão personalizada.
actionStringSimmonitorA ação da regra. Valores válidos: deny (bloquear), monitor (monitorar) e captcha (CAPTCHA de controle deslizante, aplicável apenas à web).

Descrição do parâmetro de configuração de limitação de taxa de sessão personalizada

ParâmetroTipoObrigatórioExemploDescrição
targetStringSimQuery String ParameterO campo estatístico para controle de frequência. Valores válidos: Header (conta a frequência de solicitações que contêm o cabeçalho especificado), Query String Parameter (conta a frequência de solicitações que contêm o parâmetro especificado), Cookie Name (conta a frequência de solicitações que contêm o cookie especificado) e Session (conta a frequência de solicitações da mesma sessão).
subKeyStringNãoargO subcampo do campo estatístico. Valor personalizado.
IntervalIntegerSim10O período estatístico. Valores válidos: 5 a 1800. Unidade: segundos.
thresholdIntegerSim30O limite estatístico. Valores válidos: 2 a 50000. Unidade: vezes.
ttlIntegerSim2800O período de tempo limite da lista negra. Valores válidos: 60 a 86400. Unidade: segundos.

Exemplo de configuração de limitação de taxa de sessão personalizada:

[
  {
    "type":"custom_cc",
    "status":"on",
    "config":{"

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

RequestId

string

O ID da solicitação.

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

RuleIds

object

RuleId

array

A lista de IDs de regras de proteção.

string

A lista de IDs das regras criadas.

100001,200002

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 InvalidParameter The specified parameter is invalid. O parâmetro é inválido.
400 Policy.NotExist The specified policy does not exist. A política de proteção especificada não existe.
400 RuleConfigs.Malformed The specified RuleConfigs format is invalid. O parâmetro RuleConfigs especificado está malformado.
400 RuleName.AlreadyExists Rule name already exists in specified policy. O nome da regra já existe na política especificada.
400 Rule.QuantityOverflow Rules are overflowed quantity in specified policy. O número de regras na política especificada excedeu a cota.
500 InternalError An internal error occurred; please try again later. Ocorreu um erro interno. Tente novamente. Se o erro persistir após várias tentativas, abra um ticket.
403 %s.NotSupport The specified resource type %s is not supported. O tipo de recurso especificado não é suportado. Para usar este tipo de recurso, entre em contato conosco.
403 %s.OverQuota The quantity of %s exceeds the quota. A quantidade deste recurso excede o limite de cota. Para solicitar uma cota maior, entre em contato conosco.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.