Todos os produtos
Search
Central de documentação

EventBridge:QueryTracedEvents

Última atualização: Oct 28, 2026

Consulta o rastreamento de eventos dentro de um intervalo de tempo especificado.

Descrição da operação

Consulta o rastreamento de eventos dentro de um intervalo de tempo especificado.

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

get

*EventBus.

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

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

EventBusName

string

Sim

O nome do barramento de eventos.

MyEventBus

StartTime

integer

Sim

A hora de início do intervalo de tempo para recuperar eventos. Unidade: milissegundos.

1661773509000

EndTime

integer

Sim

A hora de término do intervalo de tempo para recuperar eventos. Unidade: milissegundos.

1661773509000

Limit

integer

Não

O número máximo de entradas a serem retornadas por página. Você pode usar este parâmetro junto com NextToken para paginar os resultados da consulta.

Importante O número máximo de entradas retornadas por página não pode exceder 100.

50

NextToken

string

Não

O token de paginação. Se você especificar Limit e houver mais resultados disponíveis, este token será retornado.

1000

EventSource

string

Não

O nome da origem do evento.

mse

Subject

string

Não

O assunto do evento.

order-1001

EventType

string

Não

O tipo de evento.

eventbridge:Events:HTTPEvent

MatchedRule

string

Não

O nome da regra correspondente.

test-mnsrule

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Message

string

A mensagem de erro.

EventBusNotExist

RequestId

string

O identificador exclusivo gerado pelo Alibaba Cloud para a solicitação.

d9e4628b-8b34-4f33-82be-5aac50aac0ba

Data

object

Os dados retornados.

NextToken

string

O token de paginação. Se houver mais resultados disponíveis, este token será retornado.

1000

Events

array<object>

A lista de eventos.

object

As informações do evento.

EventId

string

O ID do evento.

07E-1OCckaVzNB92BIFFh4xgydOF1wd

EventBusName

string

O nome do barramento de eventos.

test-custom-bus

EventReceivedTime

integer

A hora de entrega do evento no barramento de eventos. O valor é um timestamp UNIX em milissegundos.

1661773573100

EventSource

string

O nome da origem do evento.

acs.resourcemanager

EventType

string

O tipo de evento.

eventbridge:Events:HTTPEvent

Total

integer

O número total de entradas.

6

Code

string

O código de resposta:

  • Success: A solicitação foi bem-sucedida.

  • Outros valores: Um código de erro. Para mais informações, consulte Códigos de erro.

200

Success

boolean

Indica se a operação foi bem-sucedida.

true

Exemplos

Resposta de sucesso

JSON formato

{
  "Message": "EventBusNotExist",
  "RequestId": "d9e4628b-8b34-4f33-82be-5aac50aac0ba",
  "Data": {
    "NextToken": "1000",
    "Events": [
      {
        "EventId": "07E-1OCckaVzNB92BIFFh4xgydOF1wd",
        "EventBusName": "test-custom-bus",
        "EventReceivedTime": 1661773573100,
        "EventSource": "acs.resourcemanager",
        "EventType": "eventbridge:Events:HTTPEvent"
      }
    ],
    "Total": 6
  },
  "Code": "200",
  "Success": true
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

403 ServiceNotEnable Service not enable

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.