Struct aws_sdk_kinesis::types::StreamDescriptionSummary
source · #[non_exhaustive]pub struct StreamDescriptionSummary {
pub stream_name: String,
pub stream_arn: String,
pub stream_status: StreamStatus,
pub stream_mode_details: Option<StreamModeDetails>,
pub retention_period_hours: i32,
pub stream_creation_timestamp: DateTime,
pub enhanced_monitoring: Vec<EnhancedMetrics>,
pub encryption_type: Option<EncryptionType>,
pub key_id: Option<String>,
pub open_shard_count: i32,
pub consumer_count: Option<i32>,
}Expand description
Represents the output for DescribeStreamSummary
Fields (Non-exhaustive)§
This struct is marked as non-exhaustive
Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.stream_name: StringThe name of the stream being described.
stream_arn: StringThe Amazon Resource Name (ARN) for the stream being described.
stream_status: StreamStatusThe current status of the stream being described. The stream status is one of the following states:
-
CREATING- The stream is being created. Kinesis Data Streams immediately returns and setsStreamStatustoCREATING. -
DELETING- The stream is being deleted. The specified stream is in theDELETINGstate until Kinesis Data Streams 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 anACTIVEstream. -
UPDATING- Shards in the stream are being merged or split. Read and write operations continue to work while the stream is in theUPDATINGstate.
stream_mode_details: Option<StreamModeDetails>Specifies the capacity mode to which you want to set your data stream. Currently, in Kinesis Data Streams, you can choose between an on-demand ycapacity mode and a provisioned capacity mode for your data streams.
retention_period_hours: i32The current retention period, in hours.
stream_creation_timestamp: DateTimeThe approximate time that the stream was created.
enhanced_monitoring: Vec<EnhancedMetrics>Represents the current enhanced monitoring settings of the stream.
encryption_type: Option<EncryptionType>The encryption type used. This value is one of the following:
-
KMS -
NONE
key_id: Option<String>The GUID for the customer-managed Amazon Web Services KMS key to use for encryption. This value can be a globally unique identifier, a fully specified ARN to either an alias or a key, or an alias name prefixed by "alias/".You can also use a master key owned by Kinesis Data Streams by specifying the alias aws/kinesis.
-
Key ARN example:
arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012 -
Alias ARN example:
arn:aws:kms:us-east-1:123456789012:alias/MyAliasName -
Globally unique key ID example:
12345678-1234-1234-1234-123456789012 -
Alias name example:
alias/MyAliasName -
Master key owned by Kinesis Data Streams:
alias/aws/kinesis
open_shard_count: i32The number of open shards in the stream.
consumer_count: Option<i32>The number of enhanced fan-out consumers registered with the stream.
Implementations§
source§impl StreamDescriptionSummary
impl StreamDescriptionSummary
sourcepub fn stream_name(&self) -> &str
pub fn stream_name(&self) -> &str
The name of the stream being described.
sourcepub fn stream_arn(&self) -> &str
pub fn stream_arn(&self) -> &str
The Amazon Resource Name (ARN) for the stream being described.
sourcepub fn stream_status(&self) -> &StreamStatus
pub fn stream_status(&self) -> &StreamStatus
The current status of the stream being described. The stream status is one of the following states:
-
CREATING- The stream is being created. Kinesis Data Streams immediately returns and setsStreamStatustoCREATING. -
DELETING- The stream is being deleted. The specified stream is in theDELETINGstate until Kinesis Data Streams 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 anACTIVEstream. -
UPDATING- Shards in the stream are being merged or split. Read and write operations continue to work while the stream is in theUPDATINGstate.
sourcepub fn stream_mode_details(&self) -> Option<&StreamModeDetails>
pub fn stream_mode_details(&self) -> Option<&StreamModeDetails>
Specifies the capacity mode to which you want to set your data stream. Currently, in Kinesis Data Streams, you can choose between an on-demand ycapacity mode and a provisioned capacity mode for your data streams.
sourcepub fn retention_period_hours(&self) -> i32
pub fn retention_period_hours(&self) -> i32
The current retention period, in hours.
sourcepub fn stream_creation_timestamp(&self) -> &DateTime
pub fn stream_creation_timestamp(&self) -> &DateTime
The approximate time that the stream was created.
sourcepub fn enhanced_monitoring(&self) -> &[EnhancedMetrics]
pub fn enhanced_monitoring(&self) -> &[EnhancedMetrics]
Represents the current enhanced monitoring settings of the stream.
sourcepub fn encryption_type(&self) -> Option<&EncryptionType>
pub fn encryption_type(&self) -> Option<&EncryptionType>
The encryption type used. This value is one of the following:
-
KMS -
NONE
sourcepub fn key_id(&self) -> Option<&str>
pub fn key_id(&self) -> Option<&str>
The GUID for the customer-managed Amazon Web Services KMS key to use for encryption. This value can be a globally unique identifier, a fully specified ARN to either an alias or a key, or an alias name prefixed by "alias/".You can also use a master key owned by Kinesis Data Streams by specifying the alias aws/kinesis.
-
Key ARN example:
arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012 -
Alias ARN example:
arn:aws:kms:us-east-1:123456789012:alias/MyAliasName -
Globally unique key ID example:
12345678-1234-1234-1234-123456789012 -
Alias name example:
alias/MyAliasName -
Master key owned by Kinesis Data Streams:
alias/aws/kinesis
sourcepub fn open_shard_count(&self) -> i32
pub fn open_shard_count(&self) -> i32
The number of open shards in the stream.
sourcepub fn consumer_count(&self) -> Option<i32>
pub fn consumer_count(&self) -> Option<i32>
The number of enhanced fan-out consumers registered with the stream.
source§impl StreamDescriptionSummary
impl StreamDescriptionSummary
sourcepub fn builder() -> StreamDescriptionSummaryBuilder
pub fn builder() -> StreamDescriptionSummaryBuilder
Creates a new builder-style object to manufacture StreamDescriptionSummary.
Trait Implementations§
source§impl Clone for StreamDescriptionSummary
impl Clone for StreamDescriptionSummary
source§fn clone(&self) -> StreamDescriptionSummary
fn clone(&self) -> StreamDescriptionSummary
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source. Read moresource§impl Debug for StreamDescriptionSummary
impl Debug for StreamDescriptionSummary
source§impl PartialEq for StreamDescriptionSummary
impl PartialEq for StreamDescriptionSummary
source§fn eq(&self, other: &StreamDescriptionSummary) -> bool
fn eq(&self, other: &StreamDescriptionSummary) -> bool
self and other values to be equal, and is used
by ==.