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

StreamDescription

Represents the output for DescribeStream.

Contents

EnhancedMonitoring

Represents the current enhanced monitoring settings of the stream.

Type: Array of EnhancedMetrics objects

Required: Yes

HasMoreShards

If set to true, more shards in the stream are available to describe.

Type: Boolean

Required: Yes

RetentionPeriodHours

The current retention period, in hours.

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 100000.

Required: Yes

Shards

The shards that comprise the stream.

Type: Array of Shard objects

Required: Yes

StreamARN

The Amazon Resource Name (ARN) for the stream being described.

Type: String

Required: Yes

StreamCreationTimestamp

The approximate time that the stream was created.

Type: Timestamp

Required: Yes

StreamName

The name of the stream being described.

Type: String

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

Pattern: [a-zA-Z0-9_.-]+

Required: Yes

StreamStatus

The current status of the stream being described. The stream status is one of the following states:

  • CREATING - The stream is being created. Amazon Kinesis immediately returns and sets StreamStatus to CREATING.

  • DELETING - The stream is being deleted. The specified stream is in the DELETING state until Amazon Kinesis completes the deletion.

  • ACTIVE - The stream exists and is ready for read and write operations or deletion. You should perform read and write operations only on an ACTIVE stream.

  • UPDATING - Shards in the stream are being merged or split. Read and write operations continue to work while the stream is in the UPDATING state.

Type: String

Valid Values: CREATING | DELETING | ACTIVE | UPDATING

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: