Todos os produtos
Search

Este produto

    Web Application Firewall:DescribeBotRuleLabels

    Central de documentação

    Web Application Firewall:DescribeBotRuleLabels

    Última atualização: Oct 14, 2026

    Consulta as informações de rótulos de regras de gerenciamento de bots.

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

    list

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

    waf_v3prepaid_public_cn-53y4******
    SubScene

    string

    Não

    O tipo do cenário de proteção de gerenciamento de bots.

    Valores válidos:

    • app :

      O cenário de proteção de aplicativo.

    • web :

      O cenário de proteção web.

    app
    ResourceManagerResourceGroupId

    string

    Não

    O ID do grupo de recursos do Alibaba Cloud.

    rg-acfm***q
    RegionId

    string

    Não

    A região onde a instância WAF está localizada. Valores válidos:

    • cn-hangzhou: a China continental.

    • ap-southeast-1: fora da China continental.

    cn-hangzhou
    LabelType

    string

    Não

    O tipo de rótulo de regra de bot a ser consultado.

    human_machine_challenge
    NextToken

    string

    Não

    O token de paginação para a próxima página. Este parâmetro é retornado apenas se existir uma próxima página.

    Nota

    Se este parâmetro for retornado, indica que há uma próxima página. Você pode usar o NextToken retornado como um parâmetro de solicitação para obter os dados da próxima página até que nenhum valor seja retornado, o que indica que todos os dados foram obtidos.

    AAAAAGBgV9tolsLfijC4wam2htS*****D/46H3X2wIS
    MaxResults

    integer

    Não

    O número de entradas a serem retornadas por paginação em uma consulta paginada. Valores válidos: 1 a 200. Valor padrão: 20.

    20

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    MaxResults

    integer

    O número de entradas a serem retornadas por paginação em uma consulta paginada. Valores válidos: 1 a 200. Valor padrão: 20.

    20
    NextToken

    string

    O token de paginação para a próxima página. Este parâmetro é retornado apenas se existir uma próxima página.

    Nota

    Se este parâmetro for retornado, indica que há uma próxima página. Você pode usar o NextToken retornado como um parâmetro de solicitação para obter os dados da próxima página até que nenhum valor seja retornado, o que indica que todos os dados foram obtidos.

    AAAAAGBgV9tolsLfijC4wam2htS*****D/46H3X2wIS
    RequestId

    string

    O ID da solicitação.

    D7861F61-5B61-46CE-A47C-6B19****5EB0
    RuleLabels

    array<object>

    A lista de rótulos de regras de gerenciamento de bots.

    object

    BotBehavior

    string

    O comportamento do bot correspondente ao rótulo da regra.

    • malicious: bots maliciosos.

    • suspicious: bots suspeitos.

    • normal: bots normais.

    malicious
    DefaultAction

    string

    A ação padrão.

    • block: bloquear.

    • monitor: monitorar.

    • js: verificação JavaScript.

    • captcha: CAPTCHA deslizante.

    • captcha_strict: CAPTCHA deslizante rigoroso.

    • bypass: permitir.

    block
    DefaultConfig

    string

    As configurações padrão correspondentes ao rótulo.

    {"crawlerStatusMap":{"360":1,"bytedance":1}}
    DefaultStatus

    integer

    O status padrão da regra do rótulo.

    • 1: A regra está ativada.

    • 0: A regra está desativada.

    1
    LabelKey

    string

    O rótulo da regra de gerenciamento de bots.

    malicious_crawler_python
    LabelStatus

    string

    O status do rótulo.

    • online: online.

    • wait_offline: pendente de offline.

    online
    LabelType

    string

    O tipo do rótulo da regra de bots.

    human_machine_challenge
    SubScene

    string

    Os cenários de proteção de gerenciamento de bots aos quais a regra pertence. Vários cenários são separados por vírgulas (,). Valores válidos:

    • web: o cenário de proteção web.

    • app: o cenário de proteção de aplicativo.

    • agentic_web: o cenário de proteção Agentic Web.

    • agentic_app: o cenário de proteção Agentic App.

    web,app
    TotalCount

    integer

    O número total de resultados retornados.

    8

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "MaxResults": 20,
  "NextToken": "AAAAAGBgV9tolsLfijC4wam2htS*****D/46H3X2wIS",
  "RequestId": "D7861F61-5B61-46CE-A47C-6B19****5EB0",
  "RuleLabels": [
    {
      "BotBehavior": "malicious",
      "DefaultAction": "block",
      "DefaultConfig": "{\"crawlerStatusMap\":{\"360\":1,\"bytedance\":1}}",
      "DefaultStatus": 1,
      "LabelKey": "malicious_crawler_python",
      "LabelStatus": "online",
      "LabelType": "human_machine_challenge",
      "SubScene": "web,app"
    }
  ],
  "TotalCount": 8
}

    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.