interface ExtendedS3DestinationConfigurationProperty
Language | Type name |
---|---|
.NET | Amazon.CDK.AWS.KinesisFirehose.CfnDeliveryStream.ExtendedS3DestinationConfigurationProperty |
Java | software.amazon.awscdk.services.kinesisfirehose.CfnDeliveryStream.ExtendedS3DestinationConfigurationProperty |
Python | aws_cdk.aws_kinesisfirehose.CfnDeliveryStream.ExtendedS3DestinationConfigurationProperty |
TypeScript | @aws-cdk/aws-kinesisfirehose » CfnDeliveryStream » ExtendedS3DestinationConfigurationProperty |
The ExtendedS3DestinationConfiguration
property type configures an Amazon S3 destination for an Amazon Kinesis 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 * as kinesisfirehose from '@aws-cdk/aws-kinesisfirehose';
const extendedS3DestinationConfigurationProperty: kinesisfirehose.CfnDeliveryStream.ExtendedS3DestinationConfigurationProperty = {
bucketArn: 'bucketArn',
roleArn: 'roleArn',
// the properties below are optional
bufferingHints: {
intervalInSeconds: 123,
sizeInMBs: 123,
},
cloudWatchLoggingOptions: {
enabled: false,
logGroupName: 'logGroupName',
logStreamName: 'logStreamName',
},
compressionFormat: 'compressionFormat',
dataFormatConversionConfiguration: {
enabled: false,
inputFormatConfiguration: {
deserializer: {
hiveJsonSerDe: {
timestampFormats: ['timestampFormats'],
},
openXJsonSerDe: {
caseInsensitive: false,
columnToJsonKeyMappings: {
columnToJsonKeyMappingsKey: 'columnToJsonKeyMappings',
},
convertDotsInJsonKeysToUnderscores: false,
},
},
},
outputFormatConfiguration: {
serializer: {
orcSerDe: {
blockSizeBytes: 123,
bloomFilterColumns: ['bloomFilterColumns'],
bloomFilterFalsePositiveProbability: 123,
compression: 'compression',
dictionaryKeyThreshold: 123,
enablePadding: false,
formatVersion: 'formatVersion',
paddingTolerance: 123,
rowIndexStride: 123,
stripeSizeBytes: 123,
},
parquetSerDe: {
blockSizeBytes: 123,
compression: 'compression',
enableDictionaryCompression: false,
maxPaddingBytes: 123,
pageSizeBytes: 123,
writerVersion: 'writerVersion',
},
},
},
schemaConfiguration: {
catalogId: 'catalogId',
databaseName: 'databaseName',
region: 'region',
roleArn: 'roleArn',
tableName: 'tableName',
versionId: 'versionId',
},
},
dynamicPartitioningConfiguration: {
enabled: false,
retryOptions: {
durationInSeconds: 123,
},
},
encryptionConfiguration: {
kmsEncryptionConfig: {
awskmsKeyArn: 'awskmsKeyArn',
},
noEncryptionConfig: 'noEncryptionConfig',
},
errorOutputPrefix: 'errorOutputPrefix',
prefix: 'prefix',
processingConfiguration: {
enabled: false,
processors: [{
type: 'type',
// the properties below are optional
parameters: [{
parameterName: 'parameterName',
parameterValue: 'parameterValue',
}],
}],
},
s3BackupConfiguration: {
bucketArn: 'bucketArn',
roleArn: 'roleArn',
// the properties below are optional
bufferingHints: {
intervalInSeconds: 123,
sizeInMBs: 123,
},
cloudWatchLoggingOptions: {
enabled: false,
logGroupName: 'logGroupName',
logStreamName: 'logStreamName',
},
compressionFormat: 'compressionFormat',
encryptionConfiguration: {
kmsEncryptionConfig: {
awskmsKeyArn: 'awskmsKeyArn',
},
noEncryptionConfig: 'noEncryptionConfig',
},
errorOutputPrefix: 'errorOutputPrefix',
prefix: 'prefix',
},
s3BackupMode: 's3BackupMode',
};
Properties
Name | Type | Description |
---|---|---|
bucket | string | The Amazon Resource Name (ARN) of the Amazon S3 bucket. |
role | string | The Amazon Resource Name (ARN) of the AWS credentials. |
buffering | IResolvable | Buffering | The buffering option. |
cloud | IResolvable | Cloud | The Amazon CloudWatch logging options for your delivery stream. |
compression | string | The compression format. |
data | IResolvable | Data | The serializer, deserializer, and schema for converting data from the JSON format to the Parquet or ORC format before writing it to Amazon S3. |
dynamic | IResolvable | Dynamic | The configuration of the dynamic partitioning mechanism that creates targeted data sets from the streaming data by partitioning it based on partition keys. |
encryption | IResolvable | Encryption | The encryption configuration for the Kinesis Data Firehose delivery stream. |
error | string | A prefix that Kinesis Data Firehose evaluates and adds to failed records before writing them to S3. |
prefix? | string | The YYYY/MM/DD/HH time format prefix is automatically used for delivered Amazon S3 files. |
processing | IResolvable | Processing | The data processing configuration for the Kinesis Data Firehose delivery stream. |
s3 | IResolvable | S3 | The configuration for backup in Amazon S3. |
s3 | string | The Amazon S3 backup mode. |
bucketArn
Type:
string
The Amazon Resource Name (ARN) of the Amazon S3 bucket.
For constraints, see ExtendedS3DestinationConfiguration in the Amazon Kinesis Data Firehose API Reference .
roleArn
Type:
string
The Amazon Resource Name (ARN) of the AWS credentials.
For constraints, see ExtendedS3DestinationConfiguration in the Amazon Kinesis Data Firehose API Reference .
bufferingHints?
Type:
IResolvable
|
Buffering
(optional)
The buffering option.
cloudWatchLoggingOptions?
Type:
IResolvable
|
Cloud
(optional)
The Amazon CloudWatch logging options for your delivery stream.
compressionFormat?
Type:
string
(optional)
The compression format.
If no value is specified, the default is UNCOMPRESSED
.
dataFormatConversionConfiguration?
Type:
IResolvable
|
Data
(optional)
The serializer, deserializer, and schema for converting data from the JSON format to the Parquet or ORC format before writing it to Amazon S3.
dynamicPartitioningConfiguration?
Type:
IResolvable
|
Dynamic
(optional)
The configuration of the dynamic partitioning mechanism that creates targeted data sets from the streaming data by partitioning it based on partition keys.
encryptionConfiguration?
Type:
IResolvable
|
Encryption
(optional)
The encryption configuration for the Kinesis Data Firehose delivery stream.
The default value is NoEncryption
.
errorOutputPrefix?
Type:
string
(optional)
A prefix that Kinesis Data Firehose evaluates and adds to failed records before writing them to S3.
This prefix appears immediately following the bucket name. For information about how to specify this prefix, see Custom Prefixes for Amazon S3 Objects .
prefix?
Type:
string
(optional)
The YYYY/MM/DD/HH
time format prefix is automatically used for delivered Amazon S3 files.
For more information, see ExtendedS3DestinationConfiguration in the Amazon Kinesis Data Firehose API Reference .
processingConfiguration?
Type:
IResolvable
|
Processing
(optional)
The data processing configuration for the Kinesis Data Firehose delivery stream.
s3BackupConfiguration?
Type:
IResolvable
|
S3
(optional)
The configuration for backup in Amazon S3.
s3BackupMode?
Type:
string
(optional)
The Amazon S3 backup mode.
After you create a delivery stream, you can update it to enable Amazon S3 backup if it is disabled. If backup is enabled, you can't update the delivery stream to disable it.