Menu
Amazon Kinesis Streams Service API Reference
API Reference (API Version 2013-12-02)

Record

The unit of data of the Kinesis stream, which is composed of a sequence number, a partition key, and a data blob.

Contents

ApproximateArrivalTimestamp

The approximate time that the record was inserted into the stream.

Type: Timestamp

Required: No

Data

The data blob. The data in the blob is both opaque and immutable to Kinesis Streams, which does not inspect, interpret, or change the data in the blob in any way. When the data blob (the payload before base64-encoding) is added to the partition key size, the total size must not exceed the maximum record size (1 MB).

Type: Base64-encoded binary data object

Length Constraints: Minimum length of 0. Maximum length of 1048576.

Required: Yes

EncryptionType

The encryption type used on the record. This parameter can be one of the following values:

  • NONE: Do not encrypt the records in the stream.

  • KMS: Use server-side encryption on the records in the stream using a customer-managed KMS key.

Type: String

Valid Values: NONE | KMS

Required: No

PartitionKey

Identifies which shard in the stream the data record is assigned to.

Type: String

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

Required: Yes

SequenceNumber

The unique identifier of the record within its shard.

Type: String

Pattern: 0|([1-9]\d{0,128})

Required: Yes

See Also

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

On this page: