OutputDestination

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

Bases: object

(experimental) A general URL-based output destination — an S3 bucket or an HTTP(S) endpoint.

Used by HLS, MS Smooth, and CMAF Ingest output groups. Each output group’s destinations prop is typed to the destination valid for its protocol, so an invalid pairing (e.g. a UDP destination on an HLS group) is a compile-time error rather than a deploy-time failure.

Stability:: experimental
ExampleMetadata:: infused

Example:

# stack: Stack
# input: medialive.IInput
# bucket: s3.IBucket
# video: medialive.EncodeConfiguration


medialive.Channel(stack, "Channel",
    inputs=[medialive.InputAttachment(input=input)],
    avail_blanking=medialive.AvailBlanking(
        state=medialive.AvailBlankingState.ENABLED,
        image=medialive.FileLocation.from_bucket(bucket, "slates/avail.png")
    ),
    blackout_slate=medialive.BlackoutSlate(
        state=medialive.BlackoutSlateState.ENABLED,
        image=medialive.FileLocation.from_bucket(bucket, "slates/blackout.png")
    ),
    output_groups=[
        medialive.OutputGroupConfiguration.hls(
            name="hls",
            destinations=[medialive.OutputDestination.to_bucket(bucket, "live/stream")],
            outputs=[medialive.HlsOutputDefinition(encodes=[video], output_name="hls_out")]
        )
    ]
)

Static Methods

classmethod to_bucket(bucket, prefix=None)

(experimental) Deliver to an S3 bucket (auto-grants write to the channel role).

Parameters:

bucket (IBucket)
prefix (Optional[str])

Stability:

experimental

Return type:

OutputDestination

classmethod url(url, *, password=None, username=None)

(experimental) Deliver to a raw URL — typically an https:// origin (or an s3ssl:// path).

Parameters:

url (str)
password (Optional[IStringParameter]) – (experimental) An SSM String Parameter holding the password for accessing the downstream system. MediaLive reads it from Parameter Store at channel runtime, so the channel role is granted read access. Default: - no credentials
username (Optional[str]) – (experimental) The username for accessing the downstream system. Default: - no credentials

Stability:

experimental

Return type:

OutputDestination