Todos os produtos
Search

Este produto

    Web Application Firewall:DescribeDefenseRule

    Central de documentação

    Web Application Firewall:DescribeDefenseRule

    Última atualização: Jul 13, 2026

    Consulta uma única regra de proteção.

    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:DescribeDefenseRule

    get

    *All Resource

    *
    • 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 a operação DescribeInstance para consultar o ID da sua instância WAF atual.

    waf_cdnsdf3****
    TemplateId

    integer

    Não

    O ID do modelo de proteção a ser consultado.

    Nota

    Este parâmetro é obrigatório apenas quando DefenseType está definido como template.

    10318
    RuleId

    integer

    Sim

    O ID da regra de proteção a ser consultada.

    20026192
    DefenseType

    string

    Não

    O tipo da regra de proteção.

    Valores válidos:

    • template :

      (Padrão) Regra de proteção de modelo.

    • resource :

      Regra no nível do objeto de proteção.

    • global :

      Regra no nível global.

    template
    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
    ResourceManagerResourceGroupId

    string

    Não

    O ID do grupo de recursos do Alibaba Cloud.

    rg-acfm***q
    Resource

    string

    Não

    O objeto protegido associado à regra a ser consultada.

    Nota

    Este parâmetro é obrigatório apenas quando DefenseType está definido como resource.

    rencs***-waf

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    Os parâmetros de resposta.

    RequestId

    string

    O ID da solicitação.

    D7861F61-5B61-46CE-A47C-6B19160D5EB0
    Rule

    object

    A configuração da regra, que é uma string convertida de um objeto JSON construído com uma série de parâmetros.

    Status

    integer

    O status da regra de proteção. Valores válidos:

    • 0: Desativado.

    • 1: Ativado.

    1
    DefenseOrigin

    string

    A origem da regra de proteção. Valores válidos:

    • custom: Definido pelo usuário.

    • system: Gerado automaticamente pelo sistema.

    custom
    Config

    string

    Os detalhes da regra de proteção, que é uma string convertida de um objeto JSON construído com uma série de parâmetros. Para mais informações, consulte a descrição dos parâmetros da regra de proteção em CreateDefenseRule.

    {\"status\":1,\"policyId\":1012,\"action\":\"block\"}
    RuleId

    integer

    O ID da regra de proteção.

    2732975
    DefenseScene

    string

    O cenário de proteção.

    Quando o parâmetro DefenseType está definido como template, valores válidos:

    • waf_group: Regras regex para proteção básica.

    • waf_base: Nova proteção central da Web.

    • waf_base_compliance: Regras de conformidade de protocolo para proteção básica.

    • waf_base_sema: Regras semânticas para proteção básica.

    • cc: Proteção contra flood HTTP.

    • antiscan_dirscan: Bloqueio de travessia de diretórios na proteção contra varredura.

    • antiscan_highfreq: Bloqueio de varredura de alta frequência na proteção contra varredura.

    • antiscan_scantools: Bloqueio de ferramentas de varredura na proteção contra varredura.

    • ip_blacklist: Lista negra de IPs.

    • custom_acl: Regras personalizadas.

    • region_block: Lista negra de localização.

    • tamperproof: Prova de adulteração da Web.

    • dlp: Prevenção contra vazamento de informações.

    • custom_response_block: Resposta personalizada.

    • spike_throttle: Limitação de tráfego de pico.

    Quando o parâmetro DefenseType está definido como resource, valores válidos:

    • account_identifier: Extração de conta.

    • custom_response: Nova resposta personalizada.

    • waf_codec: Decodificação.

    Quando o parâmetro DefenseType está definido como global, valores válidos:

    • regular_custom: Regex personalizado.

    • address_book: Catálogo de endereços.

    • custom_response: Nova resposta personalizada.

    waf_group
    GmtModified

    integer

    A hora da última modificação da regra de proteção.

    1665196746000
    RuleName

    string

    O nome da regra de proteção.

    test1
    TemplateId

    integer

    O ID do modelo da regra de proteção.

    Nota

    Este parâmetro é retornado apenas quando DefenseType está definido como template.

    9114
    Resource

    string

    O objeto protegido ao qual a regra pertence.

    Nota

    Este parâmetro é retornado apenas quando DefenseType está definido como resource.

    rencs***-waf
    DefenseType

    string

    O tipo da regra de proteção. Valores válidos:

    • template (padrão): Regra de proteção de modelo.

    • resource: Regra no nível do objeto de proteção.

    • global: Regra no nível global.

    template

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "RequestId": "D7861F61-5B61-46CE-A47C-6B19160D5EB0",
  "Rule": {
    "Status": 1,
    "DefenseOrigin": "custom",
    "Config": "{\\\"status\\\":1,\\\"policyId\\\":1012,\\\"action\\\":\\\"block\\\"}",
    "RuleId": 2732975,
    "DefenseScene": "waf_group",
    "GmtModified": 1665196746000,
    "RuleName": "test1",
    "TemplateId": 9114,
    "Resource": "rencs***-waf",
    "DefenseType": "template"
  }
}

    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.