All Products
Search
Document Center

EventBridge:QueryTracedEvents

Last Updated:Mar 15, 2024

Queries event traces by time range.

Operation description

You can call this API operation to query event traces by time range.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
EventBusNamestringYes

The name of the event bus.

MyEventBus
StartTimelongYes

The beginning of the time range to query event traces. Unit: milliseconds.

1661773509000
EndTimelongYes

The end of the time range when event traces are queried. Unit: milliseconds.

1661773509000
LimitintegerNo

The maximum number of entries to be returned in a call. You can use this parameter and NextToken to implement paging. Up to 100 entries can be returned in a call.

50
NextTokenstringNo

If you configure Limit and excess return values exist, this parameter is returned.

1000
EventSourcestringNo

The name of the event source.

mse
EventTypestringNo

The event type.

eventbridge:Events:HTTPEvent
MatchedRulestringNo

The name of the event rule that is matched.

test-mnsrule

Response parameters

ParameterTypeDescriptionExample
object
Messagestring

The returned error message.

EventBusNotExist
RequestIdstring

The request ID.

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

The data returned.

NextTokenstring

If excess return values exist, this parameter is returned.

1000
Eventsobject []

The event type.

EventIdstring

The event ID.

07E-1OCckaVzNB92BIFFh4xgydOF1wd
EventBusNamestring

The name of the event bus.

test-custom-bus
EventReceivedTimelong

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

1661773573100
EventSourcestring

The name of the event source.

acs.resourcemanager
EventTypestring

The event type.

eventbridge:Events:HTTPEvent
Totalinteger

The total number of entries.

6
Codestring

The returned HTTP status code. The HTTP status code 200 indicates that the request is successful.

200
Successboolean

Indicates whether the request is successful. Valid values: true and false.

true

Examples

Sample success responses

JSONformat

{
  "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 codeError codeError message
403ServiceNotEnableService not enable

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
No change history