All Products
Search
Document Center

EventBridge:QueryTracedEvents

Last Updated:Jan 06, 2026

This operation queries event traces within a time range.

Operation description

This operation queries event traces within a time range.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

EventBusName

string

Yes

The name of the event bus.

MyEventBus

StartTime

integer

Yes

The start time to retrieve events. Unit: ms.

1661773509000

EndTime

integer

Yes

The end time to retrieve events. Unit: ms.

1661773509000

Limit

integer

No

The maximum number of entries to return on each page. You can use this parameter with NextToken to implement pagination.

Important The maximum number of entries that can be returned on each page is 100.

50

NextToken

string

No

The token that is used to retrieve the next page of results. If more results exist, this parameter is returned.

1000

EventSource

string

No

The name of the event source.

mse

EventType

string

No

eventbridge:Events:HTTPEvent

MatchedRule

string

No

The event type.

test-mnsrule

Response elements

Element

Type

Description

Example

object

Message

string

The error message.

EventBusNotExist

RequestId

string

The ID of the request.

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

Data

object

The returned data.

NextToken

string

The token that is used to retrieve the next page of results. This parameter is returned only if more results are available.

1000

Events

array<object>

The list of events.

object

The event information.

EventId

string

The event ID.

07E-1OCckaVzNB92BIFFh4xgydOF1wd

EventBusName

string

The name of the event bus.

test-custom-bus

EventReceivedTime

integer

The time when the event was delivered to the event bus.

1661773573100

EventSource

string

The name of the event source.

acs.resourcemanager

EventType

string

The event type.

eventbridge:Events:HTTPEvent

Total

integer

The total number of entries.

6

Code

string

The response code.

  • Success: The request was successful.

  • Other codes: The request failed. For more information, see the Error codes section of this topic.

200

Success

boolean

A value of true is returned if the operation is successful.

true

Examples

Success response

JSON format

{
  "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
}

Error codes

HTTP status code

Error code

Error message

Description

403 ServiceNotEnable Service not enable

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.