Skip to content
v2.277.0

Experimental

@aws-cdk/aws-medialive-alpha is an experimental (alpha) package: its API may change in any release, without a major version bump.

S3OutputDestination Class ​

A destination for an Archive or Frame Capture output group — always an S3 bucket.

Example ​

ts
declare const bucket: s3.IBucket;
declare const video: medialive.EncodeConfiguration;
declare const audio: medialive.EncodeConfiguration;

medialive.OutputGroupConfiguration.archive({
  name: 'archive',
  destinations: [medialive.S3OutputDestination.toBucket(bucket, 'archive/recording')],
  rolloverInterval: Duration.seconds(600),
  outputs: [{ encodes: [video, audio], outputName: 'archive_out' }],
});
python
# bucket: s3.IBucket
# video: medialive.EncodeConfiguration
# audio: medialive.EncodeConfiguration


medialive.OutputGroupConfiguration.archive(
    name="archive",
    destinations=[medialive.S3OutputDestination.to_bucket(bucket, "archive/recording")],
    rollover_interval=Duration.seconds(600),
    outputs=[medialive.ArchiveOutputDefinition(encodes=[video, audio], output_name="archive_out")]
)
java
IBucket bucket;
EncodeConfiguration video;
EncodeConfiguration audio;


OutputGroupConfiguration.archive(ArchiveOutputGroupProps.builder()
        .name("archive")
        .destinations(List.of(S3OutputDestination.toBucket(bucket, "archive/recording")))
        .rolloverInterval(Duration.seconds(600))
        .outputs(List.of(ArchiveOutputDefinition.builder().encodes(List.of(video, audio)).outputName("archive_out").build()))
        .build());
csharp
// Install: dotnet add package Amazon.CDK.AWS.MediaLive.Alpha
IBucket bucket;
EncodeConfiguration video;
EncodeConfiguration audio;


OutputGroupConfiguration.Archive(new ArchiveOutputGroupProps {
    Name = "archive",
    Destinations = new [] { S3OutputDestination.ToBucket(bucket, "archive/recording") },
    RolloverInterval = Duration.Seconds(600),
    Outputs = new [] { new ArchiveOutputDefinition { Encodes = new [] { video, audio }, OutputName = "archive_out" } }
});
go
// Install: go get github.com/aws/aws-cdk-go/awsmedialivealpha/v2
var bucket IBucket
var video EncodeConfiguration
var audio EncodeConfiguration


medialive.OutputGroupConfiguration_Archive(&ArchiveOutputGroupProps{
	Name: jsii.String("archive"),
	Destinations: []S3OutputDestination{
		medialive.S3OutputDestination_ToBucket(bucket, jsii.String("archive/recording")),
	},
	RolloverInterval: awscdk.Duration_Seconds(jsii.Number(600)),
	Outputs: []ArchiveOutputDefinition{
		&ArchiveOutputDefinition{
			Encodes: []EncodeConfiguration{
				video,
				audio,
			},
			OutputName: jsii.String("archive_out"),
		},
	},
})

Methods ​

toBucket(bucket: IBucket, prefix?: string): S3OutputDestination // chainable@staticmethod def to_bucket(bucket: IBucket, prefix: typing.Optional[str] = None) -> S3OutputDestinationpublic static S3OutputDestination toBucket(IBucket bucket, String prefix)public static S3OutputDestination ToBucket(IBucket bucket, string? prefix = null)func ToBucket(Bucket IBucket, Prefix *string) S3OutputDestination static #
Deliver to an S3 bucket (auto-grants write to the channel role).
url(url: string): S3OutputDestination // chainable@staticmethod def url(url: str) -> S3OutputDestinationpublic static S3OutputDestination url(String url)public static S3OutputDestination Url(string url)func Url(Url *string) S3OutputDestination static #
Deliver to a raw `s3ssl://` path (escape hatch when you don't have a bucket construct).