Todos os produtos
Search

Este produto

    Web Application Firewall:DescribeApisecEvents

    Central de documentação

    Web Application Firewall:DescribeApisecEvents

    Última atualização: Jul 13, 2026

    Consulta a lista de eventos de segurança de API.

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

    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 DescribeInstance para obter o ID da instância WAF atual.

    waf_v2_public_cn-5y***d31
    EventId

    string

    Não

    O ID do evento de segurança de API.

    18ba94fea9***e66ba0557b7b91
    ApiFormat

    string

    Não

    A operação de API.

    /apisec/v1/***.php
    MatchedHost

    string

    Não

    O nome de domínio ou endereço IP ao qual a operação de API pertence.

    a.***.com
    EventTag

    string

    Não

    O tipo de evento.

    Nota

    Você pode chamar DescribeApisecRules para obter os tipos de evento suportados.

    ObtainSensitiveUnauthorized
    StartTs

    integer

    Não

    A hora inicial da consulta, no formato de timestamp UNIX (UTC). Unidade: segundos.

    1683648000
    EndTs

    integer

    Não

    A hora final da consulta, no formato de timestamp UNIX (UTC). Unidade: segundos.

    1683703260
    OrderKey

    string

    Não

    O nome do campo usado para ordenação. Valores válidos:

    • allCnt: Contagem de ataques.

    • startTs: Hora de início do evento.

    • endTs: Hora de término do evento.

    startTs
    OrderWay

    string

    Não

    A ordem de classificação. Valores válidos:

    • desc: Ordem decrescente (padrão).

    • asc: Ordem crescente.

    desc
    PageNumber

    integer

    Não

    O número da página a ser retornado em uma consulta paginada. Valor padrão: 1, que indica a primeira página.

    1
    PageSize

    integer

    Não

    O número de entradas por página em uma consulta paginada. Valor padrão: 10, que indica 10 entradas por página.

    10
    ApiTag

    string

    Não

    A finalidade comercial da API.

    Nota

    Você pode chamar DescribeApisecRules para obter as finalidades comerciais suportadas.

    SendMail
    Origin

    string

    Não

    A origem do tipo de evento. Valores válidos:

    • custom: Personalizado.

    • default: Integrado.

    default
    EventLevel

    string

    Não

    O nível do evento. Valores válidos:

    • high: Alto risco.

    • medium: Médio risco.

    • low: Baixo risco.

    low
    UserStatus

    string

    Não

    O status do evento. Valores válidos:

    • toBeConfirmed: A ser confirmado.

    • confirmed: Confirmado.

    • actioned: Tratado.

    • ignored: Ignorado.

    ignored
    AttackIp

    string

    Não

    O endereço IP do ataque.

    42.224.*.*
    ApiId

    string

    Não

    O ID da API.

    820b860***6205da93b935b28
    ClusterId

    string

    Não

    O ID do cluster de nuvem híbrida.

    Nota

    Este parâmetro se aplica apenas a cenários de nuvem híbrida. Você pode chamar DescribeHybridCloudClusters para obter informações sobre clusters de nuvem híbrida.

    428
    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
    EventScope

    string

    Não

    A dimensão do evento de segurança.

    Valores válidos:

    • ip :

      (Padrão) Evento de segurança de IP.

    • account :

      Evento de segurança de conta.

    ip
    Account

    string

    Não

    As informações da conta.

    1818743389962696

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    A resposta.

    TotalCount

    integer

    O número total de entradas retornadas.

    3
    RequestId

    string

    O ID da solicitação.

    12F4CC8F-7E9F-5E4D-BF7C-BD1EDDE0C282
    Data

    array<object>

    A lista de eventos de segurança.

    object

    As informações do evento de segurança.

    Origin

    string

    A origem do tipo de evento. Valores válidos:

    • custom: Personalizado.

    • default: Integrado.

    custom
    EventLevel

    string

    O nível do evento. Valores válidos:

    • high: Alto risco.

    • medium: Médio risco.

    • low: Baixo risco.

    medium
    StartTs

    integer

    A hora inicial da consulta, no formato de timestamp UNIX (UTC). Unidade: segundos.

    1683648000
    EventInfo deprecated

    string

    Os detalhes do evento, que é uma string convertida de um objeto JSON construído com os seguintes parâmetros:

    • ip_info: as informações do IP de ataque. Consulte o parâmetro de resposta AttackIpInfo desta operação.

    • rule_id: o ID da regra associada ao evento.

    • rule_tag: as informações da regra associada ao evento.

    { "ip_info": [ { "ip": "112.224.143.**", "country_id": "CN", "region_id": "-", "cnt": "4" } ], "rule_id": "837**", "rule_tag": "interface returns a large amount of sensitive information" }

    ApiFormat

    string

    A operação de API.

    /apisec/v1/register.php
    ApiTag

    string

    A finalidade comercial da API.

    Nota

    Você pode chamar DescribeApisecRules para obter as finalidades comerciais suportadas.

    SendMail
    UserStatus

    string

    O status do evento. Valores válidos:

    • toBeConfirmed: A ser confirmado.

    • confirmed: Confirmado.

    • actioned: Tratado.

    • ignored: Ignorado.

    toBeConfirmed
    Follow

    integer

    Indica se o evento é seguido. Valores válidos:

    • 1: Seguido.

    • 0: Não seguido.

    0
    RequestData deprecated

    string

    Uma amostra de dados de solicitação de API, que é uma string convertida de um objeto JSON construído com uma série de parâmetros.

    {}
    EventId

    string

    O ID do evento.

    c82cb276847e9c96f9597d9f4b0cdcff
    AttackIp deprecated

    string

    O endereço IP do ataque.

    Importante Este parâmetro está obsoleto. Use o parâmetro AttackIps em vez disso.

    104.234.140.**
    AttackIpInfo deprecated

    string

    As informações do IP de ataque, que é uma string convertida de um objeto JSON construído com os seguintes parâmetros:

    • ip: o endereço IP.

    • country_id: o país ao qual o endereço IP pertence.

    • region_id: a região à qual o endereço IP pertence.

    • cnt: o número de ataques.

    [ { "ip": "72.*.*.119", "country_id": "US", "region_id": "", "cnt": "2100" } ]
    EndTs

    integer

    A hora final da consulta, no formato de timestamp UNIX (UTC). Unidade: segundos.

    1683703260
    AttackCntInfo deprecated

    string

    As informações de contagem de ataques, que é uma string convertida de um objeto JSON. A chave é um timestamp em segundos e o valor é o número de ataques.

    { "1717498320": 500, "1717498380": 529, "1717498440": 20 }
    AllCnt

    integer

    O número de ataques.

    10
    RemoteRegion

    string

    A região à qual o endereço IP de ataque pertence.

    110000
    ResponseData deprecated

    string

    Uma amostra de dados de resposta de API, que é uma string convertida de um objeto JSON construído com uma série de parâmetros.

    {}
    AttackClient

    string

    O cliente de ataque.

    Chrome
    EventTag

    string

    O tipo de evento.

    Nota

    Você pode chamar DescribeApisecRules para obter os tipos de evento suportados.

    ObtainSensitiveUnauthorized
    MatchedHost

    string

    O nome de domínio ou endereço IP ao qual a operação de API pertence.

    a.***.com
    Note

    string

    As observações.

    Notify
    ApiId

    string

    O ID da API associada ao evento de segurança.

    2ecc1cf67b91853bc55545052ccf06a8
    RemoteCountry

    string

    O país ao qual o endereço IP de ataque pertence.

    US
    AttackIps deprecated

    array

    A lista de endereços IP de ataque.

    string

    O endereço IP do ataque.

    104.234.140.**

    AttackerList

    array

    A lista de atacantes associada ao evento.

    string

    O atacante associado ao evento.

    Nota

    Quando EventScope está definido como ip, este valor é o endereço IP do atacante. Quando EventScope está definido como account, este valor é a conta do atacante.

    1.1.1.1

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "TotalCount": 3,
  "RequestId": "12F4CC8F-7E9F-5E4D-BF7C-BD1EDDE0C282",
  "Data": [
    {
      "Origin": "custom",
      "EventLevel": "medium",
      "StartTs": 1683648000,
      "EventInfo": "{\n    \"ip_info\": [\n        {\n            \"ip\": \"112.224.143.**\",\n            \"country_id\": \"CN\",\n            \"region_id\": \"-\",\n            \"cnt\": \"4\"\n        }\n    ],\n    \"rule_id\": \"837**\",\n    \"rule_tag\": \"interface returns a large amount of sensitive information\"\n}\n",
      "ApiFormat": "/apisec/v1/register.php",
      "ApiTag": "SendMail",
      "UserStatus": "toBeConfirmed",
      "Follow": 0,
      "RequestData": "{}",
      "EventId": "c82cb276847e9c96f9597d9f4b0cdcff",
      "AttackIp": "104.234.140.**",
      "AttackIpInfo": "[\n    {\n        \"ip\": \"72.*.*.119\",\n        \"country_id\": \"US\",\n        \"region_id\": \"\",\n        \"cnt\": \"2100\"\n    }\n]",
      "EndTs": 1683703260,
      "AttackCntInfo": "{\n    \"1717498320\": 500,\n    \"1717498380\": 529,\n    \"1717498440\": 20\n}",
      "AllCnt": 10,
      "RemoteRegion": "110000",
      "ResponseData": "{}",
      "AttackClient": "Chrome",
      "EventTag": "ObtainSensitiveUnauthorized",
      "MatchedHost": "a.***.com",
      "Note": "Notify",
      "ApiId": "2ecc1cf67b91853bc55545052ccf06a8",
      "RemoteCountry": "US",
      "AttackIps": [
        "104.234.140.**\n"
      ],
      "AttackerList": [
        "1.1.1.1"
      ]
    }
  ]
}

    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.