DescribeDefenseRuleStatistics - Web Application Firewall: Central de Documentação do Alibaba Cloud

Descrição da operação

Esta operação suporta a consulta de estatísticas de regras para modelos de proteção nos cenários de novo Gerenciamento de Bots (bot_manager) e nova Proteção Central da Web (waf_base).

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

yundun-waf:DescribeDefenseRuleStatistics

get

*Todos os recursos.

*

acs:ResourceGroupId

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
InstanceId	string	Sim	O ID da instância WAF. Nota Você pode chamar DescribeInstance para consultar o ID da instância WAF atual.	waf_elasticity-cn-0xldbqt****
RegionId	string	Não	A região onde a instância WAF está implantada. Valores válidos: cn-hangzhou: China continental. ap-southeast-1: fora da China continental.	cn-hangzhou
TemplateId	integer	Sim	O ID do modelo de proteção a ser consultado. Nota Esta operação suporta a consulta de modelos de proteção nos cenários de novo Gerenciamento de Bots (bot_manager) e nova Proteção Central da Web (waf_base). Você pode chamar DescribeDefenseTemplates para consultar o cenário de proteção (DefenseScene) de um modelo de proteção.	239136
PrimaryKey	string	Sim	A condição de consulta primária. Valores válidos: riskLevel : Nível de risco. detectType : Tipo de detecção. action : Ação da regra. type : Tipo de regra. scene : Cenário de proteção. status : Status da regra.	scene
SecondaryKey	string	Não	A condição de consulta secundária. O valor não pode ser igual à condição de consulta primária. Valores válidos: riskLevel : Nível de risco. detectType : Tipo de detecção. action : Ação da regra. scene : Cenário de proteção. status : Status da regra.	action
ThirdKey	string	Não	A condição de consulta terciária. O valor não pode ser igual à condição de consulta primária ou secundária. Valores válidos: riskLevel : Nível de risco. detectType : Tipo de detecção. action : Ação da regra. scene : Cenário de proteção. status : Status da regra.	status
FourthKey	string	Não	A condição de consulta quaternária. O valor não pode ser igual à condição de consulta primária, secundária ou terciária. Valores válidos: riskLevel : Nível de risco. detectType : Tipo de detecção. action : Ação da regra. scene : Cenário de proteção. status : Status da regra.	riskLevel
ResourceManagerResourceGroupId	string	Não	O ID do grupo de recursos do Alibaba Cloud.	rg-acfm***q

Detalhes das condições de consulta

Os cenários de proteção (scene) suportados por esta operação de consulta são o novo Gerenciamento de Bots (bot_manager) e a nova Proteção Central da Web (waf_base).

Novo Gerenciamento de Bots (bot_manager)

Os parâmetros suportados para estatísticas em cada nível de consulta são os seguintes.

Descrição dos parâmetros

Nome	Tipo	Descrição
scene	String	Conta regras por cenário de proteção.
status	Integer	Conta regras por status da regra.
action	String	Conta regras por ação da regra.

Nova Proteção Central da Web (waf_base)

Os parâmetros suportados para estatísticas em cada nível de consulta são os seguintes.

Descrição dos parâmetros

Nome	Tipo	Descrição
type	String	Conta regras por tipo de regra.
detectType	String	Conta regras por tipo de detecção.
riskLevel	String	Conta regras por nível de risco.
status	Integer	Conta regras por status da regra.
action	String	Conta regras por ação da regra.

Nota

type só pode ser usado como parâmetro da condição de consulta primária, que conta separadamente o número de regras de proteção do sistema (system) e regras de expressão regular personalizadas (custom).

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	D7861F61-5B61-46CE-A47C-6B19160D5EB0
StatisticsInfos	array<object>	Os resultados das estatísticas.
	object	Os resultados das estatísticas.
PrimaryValue	string	O valor correspondente à condição de consulta primária.	sytem
SecondaryValue	string	O valor correspondente à condição de consulta secundária.	block
ThirdValue	string	O valor correspondente à condição de consulta terciária.	1
FourthValue	string	O valor correspondente à condição de consulta quaternária.	action
Count	integer	O número de regras que atendem a todas as condições de consulta.	27

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "D7861F61-5B61-46CE-A47C-6B19160D5EB0",
  "StatisticsInfos": [
    {
      "PrimaryValue": "sytem",
      "SecondaryValue": "block",
      "ThirdValue": "1",
      "FourthValue": "action",
      "Count": 27
    }
  ]
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.