> **Experimental**
>
> `@aws-cdk/aws-ivs-alpha` is an [**experimental**](/stability) (alpha) package: its API may change in any release, without a major version bump.
# RecordingConfigurationProps

Properties of the IVS Recording configuration.

Used as props by: [RecordingConfiguration](/cdk/api/v2/docs/@aws-cdk_aws-ivs-alpha.RecordingConfiguration.html)

- Stability: [Experimental](/cdk/api/stability.html)
- Source: [`lib/recording-configuration.ts`](https://github.com/aws/aws-cdk/blob/v2.277.0/packages/@aws-cdk/aws-ivs-alpha/lib/recording-configuration.ts#L14)

## Example

TypeScript:

```ts
declare const recordingBucket: s3.Bucket;

const recordingConfiguration= new ivs.RecordingConfiguration(this, 'RecordingConfiguration', {
  bucket: recordingBucket,

  // set rendition configuration
  renditionConfiguration: ivs.RenditionConfiguration.custom([ivs.Resolution.HD, ivs.Resolution.SD]),
});
```

Python:

```python
# recording_bucket: s3.Bucket

recording_configuration = ivs.RecordingConfiguration(self, "RecordingConfiguration",
    bucket=recording_bucket,

    # set rendition configuration
    rendition_configuration=ivs.RenditionConfiguration.custom([ivs.Resolution.HD, ivs.Resolution.SD])
)
```

Java:

```java
Bucket recordingBucket;

RecordingConfiguration recordingConfiguration = RecordingConfiguration.Builder.create(this, "RecordingConfiguration")
        .bucket(recordingBucket)

        // set rendition configuration
        .renditionConfiguration(RenditionConfiguration.custom(List.of(Resolution.HD, Resolution.SD)))
        .build();
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.AWS.IVS.Alpha
Bucket recordingBucket;

var recordingConfiguration = new RecordingConfiguration(this, "RecordingConfiguration", new RecordingConfigurationProps {
    Bucket = recordingBucket,

    // set rendition configuration
    RenditionConfiguration = RenditionConfiguration.Custom(new [] { Resolution.HD, Resolution.SD })
});
```

Golang:

```go
// Install: go get github.com/aws/aws-cdk-go/awscdkivsalpha/v2
var recordingBucket Bucket

recordingConfiguration := ivs.NewRecordingConfiguration(this, jsii.String("RecordingConfiguration"), &RecordingConfigurationProps{
	Bucket: recordingBucket,

	// set rendition configuration
	RenditionConfiguration: ivs.RenditionConfiguration_Custom([]Resolution{
		ivs.Resolution_HD,
		ivs.Resolution_SD,
	}),
})
```

## Properties

- `bucket`: [IBucketRef](/cdk/api/v2/docs/aws-cdk-lib.interfaces.aws_s3.IBucketRef.html) (required) — S3 bucket where recorded videos will be stored.

- `recordingConfigurationName`: string — The name of the Recording configuration.

  **Default:** auto generate

  The value does not need to be unique.

- `recordingReconnectWindow`: [Duration](/cdk/api/v2/docs/aws-cdk-lib.Duration.html) — If a broadcast disconnects and then reconnects within the specified interval, the multiple streams will be considered a single broadcast and merged together.

  **Default:** 0 seconds (means disabled)

  `recordingReconnectWindow` must be between 0 and 300 seconds

- `renditionConfiguration`: [RenditionConfiguration](/cdk/api/v2/docs/@aws-cdk_aws-ivs-alpha.RenditionConfiguration.html) — A rendition configuration describes which renditions should be recorded for a stream.

  **Default:** no rendition configuration

- `thumbnailConfiguration`: [ThumbnailConfiguration](/cdk/api/v2/docs/@aws-cdk_aws-ivs-alpha.ThumbnailConfiguration.html) — A thumbnail configuration enables/disables the recording of thumbnails for a live session and controls the interval at which thumbnails are generated for the live session.

  **Default:** no thumbnail configuration
