PutEventsRequestEntry - Amazon EventBridge
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).


Represents an event to be submitted.



A valid JSON object. There is no other schema imposed. The JSON object may contain fields and nested subobjects.

Type: String

Required: No


Free-form string, with a maximum of 128 characters, used to decide what fields to expect in the event detail.

Type: String

Required: No


The name or ARN of the event bus to receive the event. Only the rules that are associated with this event bus are used to match the event. If you omit this, the default event bus is used.


If you're using a global endpoint with a custom bus, you must enter the name, not the ARN, of the event bus in either the primary or secondary Region here and the corresponding event bus in the other Region will be determined based on the endpoint referenced by the EndpointId.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1600.

Pattern: (arn:aws[\w-]*:events:[a-z]{2}-[a-z]+-[\w-]+:[0-9]{12}:event-bus\/)?[\.\-_A-Za-z0-9]+

Required: No


Amazon resources, identified by Amazon Resource Name (ARN), which the event primarily concerns. Any number, including zero, may be present.

Type: Array of strings

Length Constraints: Maximum length of 2048.

Required: No


The source of the event.

Type: String

Required: No


The time stamp of the event, per RFC3339. If no time stamp is provided, the time stamp of the PutEvents call is used.

Type: Timestamp

Required: No


An Amazon X-Ray trace header, which is an http header (X-Amzn-Trace-Id) that contains the trace-id associated with the event.

To learn more about X-Ray trace headers, see Tracing header in the Amazon X-Ray Developer Guide.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 500.

Required: No

See Also

For more information about using this API in one of the language-specific Amazon SDKs, see the following: