> **Experimental**
>
> `@aws-cdk/aws-medialive-alpha` is an [**experimental**](https://docs.aws.amazon.com/cdk/api/stability.html) (alpha) package: its API may change in any release, without a major version bump.
# S3OutputDestination

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

Obtainable from: S3OutputDestination.toBucket, S3OutputDestination.url

- Stability: [Experimental](https://docs.aws.amazon.com/cdk/api/stability.html)
- Source: [`lib/destinations.ts`](https://github.com/aws/aws-cdk/blob/v2.278.0/packages/@aws-cdk/aws-medialive-alpha/lib/destinations.ts#L87)

## Example

TypeScript:

```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:

```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:

```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());
```

C# / .NET:

```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" } }
});
```

Golang:

```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` (static) — Deliver to an S3 bucket (auto-grants write to the channel role).

- `url(url: string): S3OutputDestination // chainable` (static) — Deliver to a raw `s3ssl://` path (escape hatch when you don't have a bucket construct).
