ListStreams
Returns an array of StreamInfo
objects. Each object describes a
stream. To retrieve only streams that satisfy a specific condition, you can specify a
StreamNameCondition
.
Request Syntax
POST /listStreams HTTP/1.1
Content-type: application/json
{
"MaxResults": number
,
"NextToken": "string
",
"StreamNameCondition": {
"ComparisonOperator": "string
",
"ComparisonValue": "string
"
}
}
URI Request Parameters
The request does not use any URI parameters.
Request Body
The request accepts the following data in JSON format.
- MaxResults
-
The maximum number of streams to return in the response. The default is 10,000.
Type: Integer
Valid Range: Minimum value of 1. Maximum value of 10000.
Required: No
- NextToken
-
If you specify this parameter, when the result of a
ListStreams
operation is truncated, the call returns theNextToken
in the response. To get another batch of streams, provide this token in your next request.Type: String
Length Constraints: Minimum length of 0. Maximum length of 512.
Pattern:
[a-zA-Z0-9+/=]*
Required: No
- StreamNameCondition
-
Optional: Returns only streams that satisfy a specific condition. Currently, you can specify only the prefix of a stream name as a condition.
Type: StreamNameCondition object
Required: No
Response Syntax
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "string",
"StreamInfoList": [
{
"CreationTime": number,
"DataRetentionInHours": number,
"DeviceName": "string",
"KmsKeyId": "string",
"MediaType": "string",
"Status": "string",
"StreamARN": "string",
"StreamName": "string",
"Version": "string"
}
]
}
Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
- NextToken
-
If the response is truncated, the call returns this element with a token. To get the next batch of streams, use this token in your next request.
Type: String
Length Constraints: Minimum length of 0. Maximum length of 512.
Pattern:
[a-zA-Z0-9+/=]*
- StreamInfoList
-
An array of
StreamInfo
objects.Type: Array of StreamInfo objects
Errors
For information about the errors that are common to all actions, see Common Errors.
- ClientLimitExceededException
-
Kinesis Video Streams has throttled the request because you have exceeded the limit of allowed client calls. Try making the call later.
HTTP Status Code: 400
- InvalidArgumentException
-
The value for this input parameter is invalid.
HTTP Status Code: 400
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: