Dual-stack (IPv6) endpoints for AWS Elemental MediaTailor

AWS Elemental MediaTailor supports dual-stack endpoints that you can use to connect over either IPv4 or IPv6. These endpoints are functionally equivalent to the standard IPv4-only endpoints. The service behavior is identical, and only the network transport layer differs.

What are dual-stack endpoints?

Dual-stack endpoints advertise both IPv4 and IPv6 addresses. When you use a dual-stack endpoint, DNS resolves to either an IPv4 or IPv6 address based on your network configuration and client preferences. You don't need to change your MediaTailor resources, playback configurations, or ad insertion behavior.

Supported features

The following table lists MediaTailor feature support for dual-stack endpoints.

Dual-stack endpoint format

MediaTailor dual-stack endpoints use the .api.aws domain:

Your existing applications continue to work with the original IPv4-only endpoints (api.mediatailor.region.amazonaws.com for control plane, unique-id.mediatailor.region.amazonaws.com for data plane). For a complete list of available endpoints, see MediaTailor endpoints and quotas in the AWS General Reference.

Using dual-stack endpoints

AWS Management Console

Dual-stack endpoints appear in the Playback configuration details page under the Dualstack endpoints section. You can copy these URLs directly for use in your player or CDN configuration.

AWS Command Line Interface

Specify the dual-stack endpoint URL when you make API calls:

aws mediatailor get-playback-configuration \
    --name my-config \
    --endpoint-url https://mediatailor.us-east-1.api.aws

Replace my-config with the name of your playback configuration and us-east-1 with your AWS Region.

AWS SDK

Enable dual-stack in your SDK configuration.

Python (boto3):

import boto3

client = boto3.client(
    'mediatailor',
    endpoint_url='https://mediatailor.us-east-1.api.aws'
)

JavaScript (AWS SDK v3):

import { MediaTailorClient } from "@aws-sdk/client-mediatailor";

const client = new MediaTailorClient({
    useDualstackEndpoint: true
});

Considerations

Keep the following in mind when you use dual-stack endpoints: