Package software.amazon.awscdk.services.kinesisfirehose.destinations.alpha

Interface DestinationS3BackupProps

All Superinterfaces:

CommonDestinationS3Props, software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

DestinationS3BackupProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.104.0 (build e79254c)",
           date="2024-11-22T02:24:11.919Z")
@Stability(Experimental)
public interface DestinationS3BackupProps
extends software.amazon.jsii.JsiiSerializable, CommonDestinationS3Props

(experimental) Properties for defining an S3 backup destination.

S3 backup is available for all destinations, regardless of whether the final destination is S3 or not.

Example:

 // Enable backup of all source records (to an S3 bucket created by CDK).
 Bucket bucket;
 // Explicitly provide an S3 bucket to which all source records will be backed up.
 Bucket backupBucket;
 DeliveryStream.Builder.create(this, "Delivery Stream Backup All")
         .destination(
         S3Bucket.Builder.create(bucket)
                 .s3Backup(DestinationS3BackupProps.builder()
                         .mode(BackupMode.ALL)
                         .build())
                 .build())
         .build();
 DeliveryStream.Builder.create(this, "Delivery Stream Backup All Explicit Bucket")
         .destination(
         S3Bucket.Builder.create(bucket)
                 .s3Backup(DestinationS3BackupProps.builder()
                         .bucket(backupBucket)
                         .build())
                 .build())
         .build();
 // Explicitly provide an S3 prefix under which all source records will be backed up.
 // Explicitly provide an S3 prefix under which all source records will be backed up.
 DeliveryStream.Builder.create(this, "Delivery Stream Backup All Explicit Prefix")
         .destination(
         S3Bucket.Builder.create(bucket)
                 .s3Backup(DestinationS3BackupProps.builder()
                         .mode(BackupMode.ALL)
                         .dataOutputPrefix("mybackup")
                         .build())
                 .build())
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final class	DestinationS3BackupProps.Builder	A builder for DestinationS3BackupProps
static final class	DestinationS3BackupProps.Jsii$Proxy	An implementation for DestinationS3BackupProps

Method Summary

Modifier and Type	Method	Description
static DestinationS3BackupProps.Builder	builder()
default IBucket	getBucket()	(experimental) The S3 bucket that will store data and failed records.
default ILoggingConfig	getLoggingConfig()	(experimental) Configuration that determines whether to log errors during data transformation or delivery failures, and specifies the CloudWatch log group for storing error logs.
default BackupMode	getMode()	(experimental) Indicates the mode by which incoming records should be backed up to S3, if any.

Methods inherited from interface software.amazon.awscdk.services.kinesisfirehose.destinations.alpha.CommonDestinationS3Props

getBufferingInterval, getBufferingSize, getCompression, getDataOutputPrefix, getEncryptionKey, getErrorOutputPrefix

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getBucket

@Stability(Experimental)
@Nullable
default IBucket getBucket()

(experimental) The S3 bucket that will store data and failed records.

Default: - If `mode` is set to `BackupMode.ALL` or `BackupMode.FAILED`, a bucket will be created for you.

getLoggingConfig

@Stability(Experimental)
@Nullable
default ILoggingConfig getLoggingConfig()

(experimental) Configuration that determines whether to log errors during data transformation or delivery failures, and specifies the CloudWatch log group for storing error logs.

Default: - errors will be logged and a log group will be created for you.

getMode

@Stability(Experimental)
@Nullable
default BackupMode getMode()

(experimental) Indicates the mode by which incoming records should be backed up to S3, if any.

If bucket is provided, this will be implicitly set to BackupMode.ALL.

Default: - If `bucket` is provided, the default will be `BackupMode.ALL`. Otherwise, source records are not backed up to S3.

builder

@Stability(Experimental)
static DestinationS3BackupProps.Builder builder()

Returns:

a DestinationS3BackupProps.Builder of DestinationS3BackupProps