MediaTailor / Client / list_live_sources

list_live_sources¶

MediaTailor.Client.list_live_sources(**kwargs)¶

Lists the live sources contained in a source location. A source represents a piece of content.

Request Syntax

response = client.list_live_sources(
    MaxResults=123,
    NextToken='string',
    SourceLocationName='string'
)

Parameters:

MaxResults (integer) –
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 of NextToken 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 the NextToken value from each response until the response no longer includes a NextToken value.
NextToken (string) –
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 of NextToken from the previous response and specify that value for NextToken in the request. Continue making requests until the response no longer includes a NextToken value, which indicates that all results have been retrieved.
SourceLocationName (string) –
[REQUIRED]

The name of the source location associated with this Live Sources list.

Return type:

dict

Returns:

Response Syntax

{
    'Items': [
        {
            'Arn': 'string',
            'CreationTime': datetime(2015, 1, 1),
            'HttpPackageConfigurations': [
                {
                    'Path': 'string',
                    'SourceGroup': 'string',
                    'Type': 'DASH'|'HLS'
                },
            ],
            'LastModifiedTime': datetime(2015, 1, 1),
            'LiveSourceName': 'string',
            'SourceLocationName': 'string',
            'Tags': {
                'string': 'string'
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

(dict) –
- Items (list) –
  
  Lists the live sources.
  - (dict) –
    
    Live source configuration parameters.
    - Arn (string) –
      
      The ARN for the live source.
    - CreationTime (datetime) –
      
      The timestamp that indicates when the live source was created.
    - HttpPackageConfigurations (list) –
      
      The HTTP package configurations for the live source.
      - (dict) –
        
        The HTTP package configuration properties for the requested VOD source.
        
        Path (string) –
        
        The relative path to the URL for this VOD source. This is combined with SourceLocation::HttpConfiguration::BaseUrl to form a valid URL.
        
        SourceGroup (string) –
        
        The name of the source group. This has to match one of the Channel::Outputs::SourceGroup.
        
        Type (string) –
        
        The streaming protocol for this package configuration. Supported values are HLS and DASH.
    - LastModifiedTime (datetime) –
      
      The timestamp that indicates when the live source was last modified.
    - LiveSourceName (string) –
      
      The name that’s used to refer to a live source.
    - SourceLocationName (string) –
      
      The name of the source location.
    - Tags (dict) –
      
      The tags assigned to the live source. Tags are key-value pairs that you can associate with Amazon resources to help with organization, access control, and cost tracking. For more information, see Tagging AWS Elemental MediaTailor Resources.
      - (string) –
        
        (string) –
- NextToken (string) –
  
  Pagination token returned by the list request when results exceed the maximum allowed. Use the token to fetch the next page of results.