Package software.amazon.awscdk.mixins.preview.services.logs

Interface S3DeliveryDestinationProps

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

S3DeliveryDestinationProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.127.0 (build 2117ad5)",
           date="2026-03-02T12:05:27.413Z")
@Stability(Experimental)
public interface S3DeliveryDestinationProps
extends software.amazon.jsii.JsiiSerializable

(experimental) Properties for S3 delivery destination.

Example:

 import software.amazon.awscdk.mixins.preview.services.logs.*;
 import software.amazon.awscdk.mixins.preview.services.cloudfront.mixins.*;
 // Create CloudFront distribution
 IBucket origin;
 String destinationAccount = "123456789012";
 String sourceAccount = "234567890123";
 String region = "us-east-1";
 App app = new App();
 Stack destStack = Stack.Builder.create(app, "destination-stack")
         .env(Environment.builder()
                 .account(destinationAccount)
                 .region(region)
                 .build())
         .build();
 // Create destination bucket
 Bucket destBucket = new Bucket(destStack, "DeliveryBucket");
 S3DeliveryDestination.Builder.create(destStack, "Destination")
         .bucket(destBucket)
         .sourceAccountId(sourceAccount)
         .build();
 Stack sourceStack = Stack.Builder.create(app, "source-stack")
         .env(Environment.builder()
                 .account(sourceAccount)
                 .region(region)
                 .build())
         .build();
 Distribution distribution = Distribution.Builder.create(sourceStack, "Distribution")
         .defaultBehavior(BehaviorOptions.builder()
                 .origin(S3BucketOrigin.withOriginAccessControl(origin))
                 .build())
         .build();
 IDeliveryDestinationRef destination = CfnDeliveryDestination.fromDeliveryDestinationArn(sourceStack, "Destination", "arn of Delivery Destination in destinationAccount");
 distribution.with(CfnDistributionLogsMixin.CONNECTION_LOGS.toDestination(destination));
 

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method	Description
static S3DeliveryDestinationProps.Builder	builder()
IBucketRef	getBucket()	(experimental) The S3 bucket to deliver logs to.
default IKeyRef	getEncryptionKey()	(experimental) KMS key to use for encrypting logs in the S3 bucket.
default String	getOutputFormat()	(experimental) Format of the logs that are sent to this delivery destination.
default S3LogsDeliveryPermissionsVersion	getPermissionsVersion()	(experimental) The permissions version ('V1' or 'V2') to be used for this delivery.
default String	getSourceAccountId()	(experimental) Optional acount id for account the delivery source is in for cross account Vended Logs.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getBucket

@Stability(Experimental)
@NotNull
IBucketRef getBucket()

(experimental) The S3 bucket to deliver logs to.

getEncryptionKey

@Stability(Experimental)
@Nullable
default IKeyRef getEncryptionKey()

(experimental) KMS key to use for encrypting logs in the S3 bucket.

When provided, grants the logs delivery service permissions to use the key.

Default: - No encryption key is configured

getOutputFormat

@Stability(Experimental)
@Nullable
default String getOutputFormat()

(experimental) Format of the logs that are sent to this delivery destination.

getPermissionsVersion

@Stability(Experimental)
@Nullable
default S3LogsDeliveryPermissionsVersion getPermissionsVersion()

(experimental) The permissions version ('V1' or 'V2') to be used for this delivery.

Depending on the source of the logs, different permissions are required.

Default: "V2"

getSourceAccountId

@Stability(Experimental)
@Nullable
default String getSourceAccountId()

(experimental) Optional acount id for account the delivery source is in for cross account Vended Logs.

builder

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

Returns:

a S3DeliveryDestinationProps.Builder of S3DeliveryDestinationProps