ListLiveSources
Lists the live sources contained in a source location. A source represents a piece of content.
Request Syntax
GET /sourceLocation/SourceLocationName
/liveSources?maxResults=MaxResults
&nextToken=NextToken
HTTP/1.1
URI Request Parameters
The request uses the following URI parameters.
- MaxResults
-
The maximum number of live sources that you want MediaTailor to return in response to the current request. If there are more than
MaxResults
live sources, use the value ofNextToken
in the response to get the next page of results.The default value is 100. MediaTailor uses DynamoDB-based pagination, which means that a response might contain fewer than
MaxResults
items, including 0 items, even when more results are available. To retrieve all results, you must continue making requests using theNextToken
value from each response until the response no longer includes aNextToken
value.Valid Range: Minimum value of 1. Maximum value of 100.
- NextToken
-
Pagination token returned by the list request when results exceed the maximum allowed. Use the token to fetch the next page of results.
For the first
ListLiveSources
request, omit this value. For subsequent requests, get the value ofNextToken
from the previous response and specify that value forNextToken
in the request. Continue making requests until the response no longer includes aNextToken
value, which indicates that all results have been retrieved. - SourceLocationName
-
The name of the source location associated with this Live Sources list.
Required: Yes
Request Body
The request does not have a request body.
Response Syntax
HTTP/1.1 200
Content-type: application/json
{
"Items": [
{
"Arn": "string",
"CreationTime": number,
"HttpPackageConfigurations": [
{
"Path": "string",
"SourceGroup": "string",
"Type": "string"
}
],
"LastModifiedTime": number,
"LiveSourceName": "string",
"SourceLocationName": "string",
"tags": {
"string" : "string"
}
}
],
"NextToken": "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.
- Items
-
Lists the live sources.
Type: Array of LiveSource objects
- NextToken
-
Pagination token returned by the list request when results exceed the maximum allowed. Use the token to fetch the next page of results.
Type: String
Errors
For information about the errors that are common to all actions, see Common Errors.
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: