Package software.amazon.awscdk.services.kinesisfirehose

Interface CommonDestinationS3Props

All Superinterfaces:
software.amazon.jsii.JsiiSerializable
All Known Subinterfaces:
DestinationS3BackupProps, S3BucketProps
All Known Implementing Classes:
CommonDestinationS3Props.Jsii$Proxy, DestinationS3BackupProps.Jsii$Proxy, S3BucketProps.Jsii$Proxy
@Generated(value="jsii-pacmak/1.119.0 (build 1634eac)", date="2025-11-13T16:10:08.240Z") @Stability(Stable) public interface CommonDestinationS3Props extends software.amazon.jsii.JsiiSerializable
Common properties for defining a backup, intermediary, or final S3 destination for a Amazon Data Firehose delivery stream.

Example: 

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.*;
 import software.amazon.awscdk.services.kinesisfirehose.*;
 import software.amazon.awscdk.services.kms.*;
 Compression compression;
 Key key;
 Size size;
 CommonDestinationS3Props commonDestinationS3Props = CommonDestinationS3Props.builder()
         .bufferingInterval(Duration.minutes(30))
         .bufferingSize(size)
         .compression(compression)
         .dataOutputPrefix("dataOutputPrefix")
         .encryptionKey(key)
         .errorOutputPrefix("errorOutputPrefix")
         .build();

  • Method Details

    • getBufferingInterval

      @Stability(Stable) @Nullable default Duration getBufferingInterval()
      The length of time that Firehose buffers incoming data before delivering it to the S3 bucket.

      Minimum: Duration.seconds(0) Maximum: Duration.seconds(900)

      Default: Duration.seconds(300)

    • getBufferingSize

      @Stability(Stable) @Nullable default Size getBufferingSize()
      The size of the buffer that Amazon Data Firehose uses for incoming data before delivering it to the S3 bucket.

      Minimum: Size.mebibytes(1) when record data format conversion is disabled, Size.mebibytes(64) when it is enabled Maximum: Size.mebibytes(128)

      Default: Size.mebibytes(5) when record data format conversion is disabled, Size.mebibytes(128) when it is enabled

    • getCompression

      @Stability(Stable) @Nullable default Compression getCompression()
      The type of compression that Amazon Data Firehose uses to compress the data that it delivers to the Amazon S3 bucket.

      The compression formats SNAPPY or ZIP cannot be specified for Amazon Redshift destinations because they are not supported by the Amazon Redshift COPY operation that reads from the S3 bucket.

      Default: - UNCOMPRESSED

    • getDataOutputPrefix

      @Stability(Stable) @Nullable default String getDataOutputPrefix()
      A prefix that Amazon Data Firehose evaluates and adds to records before writing them to S3.

      This prefix appears immediately following the bucket name.

      Default: "YYYY/MM/DD/HH"

      See Also:

    • getEncryptionKey

      @Stability(Stable) @Nullable default IKey getEncryptionKey()
      The AWS KMS key used to encrypt the data that it delivers to your Amazon S3 bucket.

      Default: - Data is not encrypted.

    • getErrorOutputPrefix

      @Stability(Stable) @Nullable default String getErrorOutputPrefix()
      A prefix that Amazon Data Firehose evaluates and adds to failed records before writing them to S3.

      This prefix appears immediately following the bucket name.

      Default: "YYYY/MM/DD/HH"

      See Also:

    • builder

      @Stability(Stable) static CommonDestinationS3Props.Builder builder()
      Returns:
      a CommonDestinationS3Props.Builder of CommonDestinationS3Props