Copyright | (c) 2013-2016 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay <brendan.g.hay@gmail.com> |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | None |
Language | Haskell2010 |
Describes the specified Amazon Kinesis stream.
The information about the stream includes its current status, its Amazon Resource Name (ARN), and an array of shard objects. For each shard object, there is information about the hash key and sequence number ranges that the shard spans, and the IDs of any earlier shards that played in a role in creating the shard. A sequence number is the identifier associated with every record ingested in the stream. The sequence number is assigned when a record is put into the stream.
You can limit the number of returned shards using the Limit
parameter.
The number of shards in a stream may be too large to return from a
single call to DescribeStream
. You can detect this by using the
HasMoreShards
flag in the returned output. HasMoreShards
is set to
true
when there is more data available.
DescribeStream
is a paginated operation. If there are more shards
available, you can request them using the shard ID of the last shard
returned. Specify this ID in the ExclusiveStartShardId
parameter in a
subsequent request to DescribeStream
.
There are no guarantees about the chronological order shards returned in
DescribeStream
results. If you want to process shards in chronological
order, use ParentShardId
to track lineage to the oldest shard.
DescribeStream has a limit of 10 transactions per second per account.
This operation returns paginated results.
- describeStream :: Text -> DescribeStream
- data DescribeStream
- dExclusiveStartShardId :: Lens' DescribeStream (Maybe Text)
- dLimit :: Lens' DescribeStream (Maybe Natural)
- dStreamName :: Lens' DescribeStream Text
- describeStreamResponse :: Int -> StreamDescription -> DescribeStreamResponse
- data DescribeStreamResponse
- dsrsResponseStatus :: Lens' DescribeStreamResponse Int
- dsrsStreamDescription :: Lens' DescribeStreamResponse StreamDescription
Creating a Request
Creates a value of DescribeStream
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
data DescribeStream Source #
Represents the input for DescribeStream
.
See: describeStream
smart constructor.
Request Lenses
dExclusiveStartShardId :: Lens' DescribeStream (Maybe Text) Source #
The shard ID of the shard to start with.
dStreamName :: Lens' DescribeStream Text Source #
The name of the stream to describe.
Destructuring the Response
describeStreamResponse Source #
Creates a value of DescribeStreamResponse
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
data DescribeStreamResponse Source #
Represents the output for DescribeStream
.
See: describeStreamResponse
smart constructor.
Response Lenses
dsrsResponseStatus :: Lens' DescribeStreamResponse Int Source #
The response status code.
dsrsStreamDescription :: Lens' DescribeStreamResponse StreamDescription Source #
The current status of the stream, the stream ARN, an array of shard objects that comprise the stream, and states whether there are more shards available.