Copyright | (c) 2013-2018 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay <brendan.g.hay+amazonka@gmail.com> |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | None |
Language | Haskell2010 |
Lists your Kinesis data streams.
The number of streams may be too large to return from a single call to ListStreams
. You can limit the number of returned streams using the Limit
parameter. If you do not specify a value for the Limit
parameter, Kinesis Data Streams uses the default limit, which is currently 10.
You can detect if there are more streams available to list by using the HasMoreStreams
flag from the returned output. If there are more streams available, you can request more streams by using the name of the last stream returned by the ListStreams
request in the ExclusiveStartStreamName
parameter in a subsequent request to ListStreams
. The group of stream names returned by the subsequent request is then added to the list. You can continue this process until all the stream names have been collected in the list.
ListStreams
has a limit of five transactions per second per account.
This operation returns paginated results.
- listStreams :: ListStreams
- data ListStreams
- lsLimit :: Lens' ListStreams (Maybe Natural)
- lsExclusiveStartStreamName :: Lens' ListStreams (Maybe Text)
- listStreamsResponse :: Int -> Bool -> ListStreamsResponse
- data ListStreamsResponse
- lsrsResponseStatus :: Lens' ListStreamsResponse Int
- lsrsStreamNames :: Lens' ListStreamsResponse [Text]
- lsrsHasMoreStreams :: Lens' ListStreamsResponse Bool
Creating a Request
listStreams :: ListStreams Source #
Creates a value of ListStreams
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
lsLimit
- The maximum number of streams to list.lsExclusiveStartStreamName
- The name of the stream to start the list with.
data ListStreams Source #
Represents the input for ListStreams
.
See: listStreams
smart constructor.
Request Lenses
lsExclusiveStartStreamName :: Lens' ListStreams (Maybe Text) Source #
The name of the stream to start the list with.
Destructuring the Response
Creates a value of ListStreamsResponse
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
lsrsResponseStatus
- -- | The response status code.lsrsStreamNames
- The names of the streams that are associated with the AWS account making theListStreams
request.lsrsHasMoreStreams
- If set totrue
, there are more streams available to list.
data ListStreamsResponse Source #
Represents the output for ListStreams
.
See: listStreamsResponse
smart constructor.
Response Lenses
lsrsResponseStatus :: Lens' ListStreamsResponse Int Source #
- - | The response status code.
lsrsStreamNames :: Lens' ListStreamsResponse [Text] Source #
The names of the streams that are associated with the AWS account making the ListStreams
request.
lsrsHasMoreStreams :: Lens' ListStreamsResponse Bool Source #
If set to true
, there are more streams available to list.