HlsCdnSettings

class aws_cdk.aws_medialive_alpha.HlsCdnSettings(*args: Any, **kwargs)

Bases: object

(experimental) CDN settings for HLS output groups.

Stability:

experimental

ExampleMetadata:

infused

Example:

# bucket: s3.IBucket
# video: medialive.EncodeConfiguration
# audio: medialive.EncodeConfiguration


# HLS to S3
medialive.OutputGroupConfiguration.hls(
    name="hls_s3",
    destinations=[medialive.OutputDestination.to_bucket(bucket, "live/stream")],
    outputs=[medialive.HlsOutputDefinition(encodes=[video, audio], output_name="hls_out")]
)

# HLS to an HTTPS CDN origin.
medialive.OutputGroupConfiguration.hls(
    name="hls-http",
    destinations=[medialive.OutputDestination.url("https://203.0.113.10/ingest/stream")],
    hls_cdn_settings=medialive.HlsCdnSettings.basic_put(),
    outputs=[medialive.HlsOutputDefinition(encodes=[video, audio], output_name="hls_out")]
)

Static Methods

classmethod akamai(*, connection_retry_interval=None, filecache_duration=None, http_transfer_mode=None, num_retries=None, restart_delay=None, salt=None, token=None)

(experimental) Use Akamai as the CDN for HLS output.

Parameters:
  • connection_retry_interval (Union[int, float, None]) – (experimental) The number of seconds to wait before retrying a connection to the CDN. Default: 1

  • filecache_duration (Optional[Duration]) – (experimental) The size of the file cache for streaming outputs. Default: Duration.seconds(300)

  • http_transfer_mode (Optional[HttpTransferMode]) – (experimental) Specifies whether to use chunked transfer encoding. Default: HttpTransferMode.NON_CHUNKED

  • num_retries (Union[int, float, None]) – (experimental) The number of retry attempts. Default: 10

  • restart_delay (Union[int, float, None]) – (experimental) The number of seconds to wait before restarting after a failure. Default: 1

  • salt (Optional[str]) – (experimental) The salt for Akamai authentication. Default: - no salt

  • token (Optional[str]) – (experimental) The token for Akamai authentication. Default: - no token

Stability:

experimental

Return type:

HlsCdnSettings

classmethod basic_put(*, connection_retry_interval=None, filecache_duration=None, num_retries=None, restart_delay=None)

(experimental) Use a basic HTTP PUT for HLS output.

Parameters:
  • connection_retry_interval (Union[int, float, None]) – (experimental) The number of seconds to wait before retrying a connection to the CDN. Default: 1

  • filecache_duration (Optional[Duration]) – (experimental) The size of the file cache for streaming outputs. Default: Duration.seconds(300)

  • num_retries (Union[int, float, None]) – (experimental) The number of retry attempts. Default: 10

  • restart_delay (Union[int, float, None]) – (experimental) The number of seconds to wait before restarting after a failure. Default: 1

Stability:

experimental

Return type:

HlsCdnSettings

classmethod s3(*, canned_acl=None)

(experimental) Use Amazon S3 as the CDN for HLS output.

Parameters:

canned_acl (Optional[S3CannedAcl]) – (experimental) The S3 canned ACL to apply to each output. Default: - no canned ACL

Stability:

experimental

Return type:

HlsCdnSettings

classmethod webdav(*, connection_retry_interval=None, filecache_duration=None, http_transfer_mode=None, num_retries=None, restart_delay=None)

(experimental) Use WebDAV as the CDN for HLS output.

Parameters:
  • connection_retry_interval (Union[int, float, None]) – (experimental) The number of seconds to wait before retrying a connection to the CDN. Default: 1

  • filecache_duration (Optional[Duration]) – (experimental) The size of the file cache for streaming outputs. Default: Duration.seconds(300)

  • http_transfer_mode (Optional[HttpTransferMode]) – (experimental) Specifies whether to use chunked transfer encoding. Default: HttpTransferMode.NON_CHUNKED

  • num_retries (Union[int, float, None]) – (experimental) The number of retry attempts. Default: 10

  • restart_delay (Union[int, float, None]) – (experimental) The number of seconds to wait before restarting after a failure. Default: 1

Stability:

experimental

Return type:

HlsCdnSettings