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 the shards in a stream and provides information about each shard.
Important: This API is a new operation that is used by the Amazon Kinesis Client Library (KCL). If you have a fine-grained IAM policy that only allows specific operations, you must update your policy to allow calls to this API. For more information, see Controlling Access to Amazon Kinesis Data Streams Resources Using IAM .
- listShards :: ListShards
- data ListShards
- lsNextToken :: Lens' ListShards (Maybe Text)
- lsExclusiveStartShardId :: Lens' ListShards (Maybe Text)
- lsStreamCreationTimestamp :: Lens' ListShards (Maybe UTCTime)
- lsStreamName :: Lens' ListShards (Maybe Text)
- lsMaxResults :: Lens' ListShards (Maybe Natural)
- listShardsResponse :: Int -> ListShardsResponse
- data ListShardsResponse
- lrsNextToken :: Lens' ListShardsResponse (Maybe Text)
- lrsShards :: Lens' ListShardsResponse [Shard]
- lrsResponseStatus :: Lens' ListShardsResponse Int
Creating a Request
listShards :: ListShards Source #
Creates a value of ListShards
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
lsNextToken
- When the number of shards in the data stream is greater than the default value for theMaxResults
parameter, or if you explicitly specify a value forMaxResults
that is less than the number of shards in the data stream, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListShards
to list the next set of shards. Don't specifyStreamName
orStreamCreationTimestamp
if you specifyNextToken
because the latter unambiguously identifies the stream. You can optionally specify a value for theMaxResults
parameter when you specifyNextToken
. If you specify aMaxResults
value that is less than the number of shards that the operation returns if you don't specifyMaxResults
, the response will contain a newNextToken
value. You can use the newNextToken
value in a subsequent call to theListShards
operation. Important: Tokens expire after 300 seconds. When you obtain a value forNextToken
in the response to a call toListShards
, you have 300 seconds to use that value. If you specify an expired token in a call toListShards
, you getExpiredNextTokenException
.lsExclusiveStartShardId
- The ID of the shard to start the list with. If you don't specify this parameter, the default behavior is forListShards
to list the shards starting with the first one in the stream. You cannot specify this parameter if you specifyNextToken
.lsStreamCreationTimestamp
- Specify this input parameter to distinguish data streams that have the same name. For example, if you create a data stream and then delete it, and you later create another data stream with the same name, you can use this input parameter to specify which of the two streams you want to list the shards for. You cannot specify this parameter if you specify theNextToken
parameter.lsStreamName
- The name of the data stream whose shards you want to list. You cannot specify this parameter if you specify theNextToken
parameter.lsMaxResults
- The maximum number of shards to return in a single call toListShards
. The minimum value you can specify for this parameter is 1, and the maximum is 1,000, which is also the default. When the number of shards to be listed is greater than the value ofMaxResults
, the response contains aNextToken
value that you can use in a subsequent call toListShards
to list the next set of shards.
data ListShards Source #
See: listShards
smart constructor.
Request Lenses
lsNextToken :: Lens' ListShards (Maybe Text) Source #
When the number of shards in the data stream is greater than the default value for the MaxResults
parameter, or if you explicitly specify a value for MaxResults
that is less than the number of shards in the data stream, the response includes a pagination token named NextToken
. You can specify this NextToken
value in a subsequent call to ListShards
to list the next set of shards. Don't specify StreamName
or StreamCreationTimestamp
if you specify NextToken
because the latter unambiguously identifies the stream. You can optionally specify a value for the MaxResults
parameter when you specify NextToken
. If you specify a MaxResults
value that is less than the number of shards that the operation returns if you don't specify MaxResults
, the response will contain a new NextToken
value. You can use the new NextToken
value in a subsequent call to the ListShards
operation. Important: Tokens expire after 300 seconds. When you obtain a value for NextToken
in the response to a call to ListShards
, you have 300 seconds to use that value. If you specify an expired token in a call to ListShards
, you get ExpiredNextTokenException
.
lsExclusiveStartShardId :: Lens' ListShards (Maybe Text) Source #
The ID of the shard to start the list with. If you don't specify this parameter, the default behavior is for ListShards
to list the shards starting with the first one in the stream. You cannot specify this parameter if you specify NextToken
.
lsStreamCreationTimestamp :: Lens' ListShards (Maybe UTCTime) Source #
Specify this input parameter to distinguish data streams that have the same name. For example, if you create a data stream and then delete it, and you later create another data stream with the same name, you can use this input parameter to specify which of the two streams you want to list the shards for. You cannot specify this parameter if you specify the NextToken
parameter.
lsStreamName :: Lens' ListShards (Maybe Text) Source #
The name of the data stream whose shards you want to list. You cannot specify this parameter if you specify the NextToken
parameter.
lsMaxResults :: Lens' ListShards (Maybe Natural) Source #
The maximum number of shards to return in a single call to ListShards
. The minimum value you can specify for this parameter is 1, and the maximum is 1,000, which is also the default. When the number of shards to be listed is greater than the value of MaxResults
, the response contains a NextToken
value that you can use in a subsequent call to ListShards
to list the next set of shards.
Destructuring the Response
Creates a value of ListShardsResponse
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
lrsNextToken
- When the number of shards in the data stream is greater than the default value for theMaxResults
parameter, or if you explicitly specify a value forMaxResults
that is less than the number of shards in the data stream, the response includes a pagination token namedNextToken
. You can specify thisNextToken
value in a subsequent call toListShards
to list the next set of shards. For more information about the use of this pagination token when calling theListShards
operation, see 'ListShardsInput$NextToken' . Important: Tokens expire after 300 seconds. When you obtain a value forNextToken
in the response to a call toListShards
, you have 300 seconds to use that value. If you specify an expired token in a call toListShards
, you getExpiredNextTokenException
.lrsShards
- An array of JSON objects. Each object represents one shard and specifies the IDs of the shard, the shard's parent, and the shard that's adjacent to the shard's parent. Each object also contains the starting and ending hash keys and the starting and ending sequence numbers for the shard.lrsResponseStatus
- -- | The response status code.
data ListShardsResponse Source #
See: listShardsResponse
smart constructor.
Response Lenses
lrsNextToken :: Lens' ListShardsResponse (Maybe Text) Source #
When the number of shards in the data stream is greater than the default value for the MaxResults
parameter, or if you explicitly specify a value for MaxResults
that is less than the number of shards in the data stream, the response includes a pagination token named NextToken
. You can specify this NextToken
value in a subsequent call to ListShards
to list the next set of shards. For more information about the use of this pagination token when calling the ListShards
operation, see 'ListShardsInput$NextToken' . Important: Tokens expire after 300 seconds. When you obtain a value for NextToken
in the response to a call to ListShards
, you have 300 seconds to use that value. If you specify an expired token in a call to ListShards
, you get ExpiredNextTokenException
.
lrsShards :: Lens' ListShardsResponse [Shard] Source #
An array of JSON objects. Each object represents one shard and specifies the IDs of the shard, the shard's parent, and the shard that's adjacent to the shard's parent. Each object also contains the starting and ending hash keys and the starting and ending sequence numbers for the shard.
lrsResponseStatus :: Lens' ListShardsResponse Int Source #
- - | The response status code.