Todos os produtos
Search

Este produto

    EventBridge:EventCenterQueryEvents

    Central de documentação

    EventBridge:EventCenterQueryEvents

    Última atualização: Oct 28, 2026

    Consulta eventos no recurso de análise de eventos.

    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

    eventbridge:EventCenterQueryEvents

    get

    *EventBus.

    acs:eventbridge:{#regionId}:{#accountId}:eventbus/{#eventbus}

    		 Nenhuma Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    BusName

    string

    Não

    O nome do barramento de eventos.

    default
    NextToken

    string

    Não

    O token usado para recuperar a próxima página de resultados.

    100
    MaxResults

    integer

    Não

    O número máximo de resultados a serem retornados. Valores válidos: 0 a 10000. Valor padrão: 100.

    100
    Body

    object

    Sim

    O corpo da solicitação.

    SchemaId

    string

    Sim

    O ID do esquema.

    ecs:GeneralSchema
    QueryType

    string

    Sim

    O tipo de consulta. Valores válidos:

    • timeseries: dados de série temporal

    • table: dados tabulares

    • timeseries_and_table: dados de série temporal e tabulares

    Valores válidos:

    • timeseries :

      Dados de série temporal.

    • timeseries_and_table :

      Dados de série temporal e tabulares.

    • table :

      Dados tabulares.

    timeseries_and_table
    Parameters

    object

    Sim

    Os parâmetros de consulta.

    Breakdowns

    array

    Não

    Divide ainda mais o conjunto de dados por dimensões específicas (nomes de colunas).

    string

    Não

    O nome de uma coluna que pode ser usada como dimensão de divisão.

    source
    Calculations

    array<object>

    Não

    Realiza cálculos nas colunas especificadas usando operadores.

    object

    Não

    Op

    string

    Não

    O operador.

    Valores válidos:

    • P99 :

      O 99º percentil.

    • AVG :

      O valor médio.

    • COUNT_DISTINCT :

      A contagem distinta.

    • MIN :

      O valor mínimo.

    • MAX :

      O valor máximo.

    • P90 :

      O 90º percentil.

    • COUNT :

      A contagem.

    • SUM :

      A soma.

    • P50 :

      O 50º percentil.

    • P95 :

      O 95º percentil.

    COUNT_DISTINCT
    Column

    string

    Não

    O nome da coluna.

    source
    Filters

    array<object>

    Não

    A lista de condições de filtro.

    array<object>

    Não

    Column

    string

    Não

    O nome da coluna.

    source
    Op

    string

    Não

    O operador.

    Valores válidos:

    • <= :

      Menor ou igual a.

    • in :

      No conjunto especificado.

    • does-not-start-with :

      Não começa com.

    • contains :

      Contém.

    • does-not-exist :

      O campo não existe.

    • exists :

      O campo existe.

    • does-not-contain :

      Não contém.

    • not-in :

      Não está no conjunto especificado.

    • starts-with :

      Começa com.

    • text-match :

      Corresponde ao texto.

    • != :

      Diferente de.

    • < :

      Menor que.

    • = :

      Igual a.

    • > :

      Maior que.

    • >= :

      Maior ou igual a.

    =
    Values

    array

    Não

    Os valores usados com o operador.

    string

    Não

    O valor. Se o valor for uma string, coloque-o entre aspas simples.

    'acs.ecs'
    NestedFilterCombination

    string

    Não

    O método de combinação lógica para condições de filtro aninhadas.

    Valores válidos:

    • OR :

      OR (qualquer condição é atendida).

    • AND :

      AND (todas as condições são atendidas).

    AND
    NestedFilters

    array<object>

    Não

    A lista de condições de filtro aninhadas.

    object

    Não

    Column

    string

    Não

    O nome da coluna.

    source
    Op

    string

    Não

    O operador.

    Valores válidos:

    • <= :

      Menor ou igual a.

    • in :

      No conjunto especificado.

    • does-not-start-with :

      Não começa com.

    • contains :

      Contém.

    • does-not-exist :

      O campo não existe.

    • exists :

      O campo existe.

    • does-not-contain :

      Não contém.

    • not-in :

      Não está no conjunto especificado.

    • starts-with :

      Começa com.

    • text-match :

      Corresponde ao texto.

    • != :

      Diferente de.

    • < :

      Menor que.

    • = :

      Igual a.

    • > :

      Maior que.

    • >= :

      Maior ou igual a.

    =
    Values

    array

    Não

    A lista de valores usados com o operador.

    string

    Não

    O valor único usado com o operador.

    'acs.ecs'
    FilterCombination

    string

    Não

    A lógica para combinar condições de filtro.

    Valores válidos:

    • OR :

      OR (qualquer condição é atendida).

    • AND :

      AND (todas as condições são atendidas).

    AND
    Granularity

    integer

    Não

    A granularidade de tempo, que é a unidade de tempo mínima para consultar dados de séries temporais. Unidade: segundos. Valor mínimo: 1. Este parâmetro é um valor recomendado. A granularidade real está sujeita ao valor retornado.

    30
    Orders

    array<object>

    Não

    Ordena os resultados da consulta. Este parâmetro é válido apenas para consultas em que QueryType está definido como table.

    object

    Não

    Op

    string

    Não

    O operador.

    Valores válidos:

    • P99 :

      O 99º percentil.

    • AVG :

      O valor médio.

    • COUNT_DISTINCT :

      A contagem distinta.

    • MIN :

      O valor mínimo.

    • MAX :

      O valor máximo.

    • P90 :

      O 90º percentil.

    • COUNT :

      A contagem.

    • SUM :

      A soma.

    • P50 :

      O 50º percentil.

    • P95 :

      O 95º percentil.

    AVG
    Column

    string

    Não

    O nome da coluna.

    source
    Desc

    boolean

    Não

    Especifica se os resultados devem ser ordenados em ordem decrescente.

    true
    Offset

    integer

    Não

    A posição inicial da consulta atual. O valor começa em 0.

    0
    Limit

    integer

    Não

    O número máximo de eventos a serem consultados. Valores válidos: 1 a 10000.

    100
    TimeRange

    integer

    Não

    O intervalo de tempo. Unidade: milissegundos. Valor mínimo: 1000.

    1000000
    StartTime

    integer

    Não

    O timestamp de início para consultar eventos, em milissegundos.

    1687860901814
    EndTime

    integer

    Não

    O timestamp de fim para consultar eventos, em milissegundos.

    1687861201814

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    Esquema da resposta.

    Message

    string

    A mensagem de erro.

    Specified parameter Limit is not valid.
    RequestId

    string

    O ID da solicitação.

    5DAF96FB-A4B6-548C-B999-XXXXXXXX
    Data

    object

    O resultado retornado.

    NextToken

    string

    O token que indica a posição de leitura retornada pela chamada atual. Um valor vazio indica que todos os dados foram lidos.

    100
    MaxResults

    integer

    O número máximo de registros retornados para a solicitação atual.

    100
    TotalCount

    integer

    O número total de entradas de dados que atendem às condições da solicitação. Este parâmetro é opcional e não é retornado por padrão.

    76
    TimeSeries

    array<object>

    Os resultados da consulta para o tipo de consulta de séries temporais.

    array<object>

    RowData

    object

    As entradas nos resultados da consulta, representadas como pares chave-valor.

    { "id":"xxx", "source":"acs.ecs" }
    Time

    string

    O timestamp usado para exibição.

    1683561600000
    Table

    array<object>

    Os resultados da consulta para o tipo de consulta de tabela.

    array<object>

    RowData

    object

    As entradas nos resultados da consulta, representadas como pares chave-valor.

    { "id":"xxx", "source":"acs.ecs" }
    Code

    string

    O status da API ou o código de erro POP. Valores válidos: Success: Bem-sucedido.

    Success
    Success

    boolean

    Indica se a operação foi bem-sucedida. Valores válidos: true: Bem-sucedido. false: Falha.

    true

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "Message": "Specified parameter Limit is not valid.",
  "RequestId": "5DAF96FB-A4B6-548C-B999-XXXXXXXX",
  "Data": {
    "NextToken": "100",
    "MaxResults": 100,
    "TotalCount": 76,
    "TimeSeries": [
      {
        "RowData": {
          "id": "xxx",
          "source": "acs.ecs"
        },
        "Time": "1683561600000"
      }
    ],
    "Table": [
      {
        "RowData": {
          "id": "xxx",
          "source": "acs.ecs"
        }
      }
    ]
  },
  "Code": "Success",
  "Success": true
}

    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.