View a markdown version of this page

PutRawEvents - Amazon EventBridge Custom Event Bus

PutRawEvents

Publishes pre-shaped events to an event bus.

Request Parameters

DeduplicationConfiguration

Request-level deduplication settings, applied to every entry in the batch.

Type: DeduplicationConfiguration object

Required: No

Entries

List of event entries to publish. Must contain at least one entry.

Type: Array of PutRawEventsRequestEntry objects

Array Members: Minimum number of 1 item. Maximum number of 100 items.

Required: Yes

EventBusArn

The Amazon Resource Name (ARN) that uniquely identifies an event bus.

Type: String

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

Pattern: arn:aws(-[a-z0-9]+)*:events:[a-z][a-z0-9]*(-[a-z0-9]+)*:([0-9]{12}):event-busv2\/[A-Za-z0-9][\.\-_A-Za-z0-9]{0,255}\/[a-z0-9]{25}

Required: Yes

SchemaRegistryConfiguration

Schema-registry settings for encoding open-format (Avro/Protobuf) events. Required for open-format entries; ignored for JSON entries. The registry is read with the caller's credentials, so the caller needs read access to the registry it references.

Type: SchemaRegistryConfiguration object

Required: No

Response Elements

The following elements are returned by the service.

Entries

List of per-entry publish results, in the same order as the request entries.

Type: Array of PutRawEventsResultEntry objects

FailedEntryCount

The number of entries in the batch that failed to be published.

Type: Integer

Errors

For information about the errors that are common to all actions, see Common Error Types.

AccessDeniedException

The caller does not have the permissions required to perform the operation. This error is also returned when the operation cannot use the AWS KMS key for the event bus.

HTTP Status Code: 403

InternalException

The request failed because of an internal service error. Retry the request.

HTTP Status Code: 500

InvalidInputException

A request parameter is missing or not valid.

HTTP Status Code: 400

InvalidStateException

The resource is not in a state that allows the operation. For example, an event bus that is still being created cannot accept events.

HTTP Status Code: 409

ResourceNotFoundException

The resource does not exist.

HTTP Status Code: 404

SchemaRegistryUnavailableException

The configured schema registry could not be reached. Retry the request.

HTTP Status Code: 400

ThrottlingException

The request was throttled because it exceeds a request rate limit. Retry the request with backoff.

HTTP Status Code: 429

See Also

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