ListPlaybackConfigurations - AWS Elemental MediaTailor

ListPlaybackConfigurations

Retrieves existing playback configurations. For information about MediaTailor configurations, see Working with Configurations in AWS Elemental MediaTailor.

Request Syntax

GET /playbackConfigurations?MaxResults=MaxResults&NextToken=NextToken HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.

MaxResults

The maximum number of playback configurations that you want MediaTailor to return in response to the current request. If there are more than MaxResults playback configurations, 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.

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 ListPlaybackConfigurations 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.

Request Body

The request does not have a request body.

Response Syntax

HTTP/1.1 200 Content-type: application/json { "Items": [ { "AdConditioningConfiguration": { "StreamingMediaFileConditioning": "string" }, "AdDecisionServerUrl": "string", "AvailSuppression": { "FillPolicy": "string", "Mode": "string", "Value": "string" }, "Bumper": { "EndUrl": "string", "StartUrl": "string" }, "CdnConfiguration": { "AdSegmentUrlPrefix": "string", "ContentSegmentUrlPrefix": "string" }, "ConfigurationAliases": { "string" : { "string" : "string" } }, "DashConfiguration": { "ManifestEndpointPrefix": "string", "MpdLocation": "string", "OriginManifestType": "string" }, "HlsConfiguration": { "ManifestEndpointPrefix": "string" }, "InsertionMode": "string", "LivePreRollConfiguration": { "AdDecisionServerUrl": "string", "MaxDurationSeconds": number }, "LogConfiguration": { "AdsInteractionLog": { "ExcludeEventTypes": [ "string" ], "PublishOptInEventTypes": [ "string" ] }, "EnabledLoggingStrategies": [ "string" ], "ManifestServiceInteractionLog": { "ExcludeEventTypes": [ "string" ] }, "PercentEnabled": number }, "ManifestProcessingRules": { "AdMarkerPassthrough": { "Enabled": boolean } }, "Name": "string", "PersonalizationThresholdSeconds": number, "PlaybackConfigurationArn": "string", "PlaybackEndpointPrefix": "string", "SessionInitializationEndpointPrefix": "string", "SlateAdUrl": "string", "tags": { "string" : "string" }, "TranscodeProfileName": "string", "VideoContentSourceUrl": "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

Array of playback configurations. This might be all the available configurations or a subset, depending on the settings that you provide and the total number of configurations stored.

Type: Array of PlaybackConfiguration objects

NextToken

Pagination token returned by the GET 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: