Struct BucketBuilder 

pub struct BucketBuilder<T: BucketBuilderState> { /* private fields */ }

Builder for S3 buckets.

Provides configuration for S3 buckets including versioning, lifecycle rules, encryption, CORS, and static website hosting.

Example

use rusty_cdk_core::stack::StackBuilder;
use rusty_cdk_core::s3::{BucketBuilder, VersioningConfig, Encryption, VersioningConfiguration};
use rusty_cdk_core::wrappers::*;
use rusty_cdk_macros::bucket_name;

let mut stack_builder = StackBuilder::new();

// Create a simple bucket
let bucket = BucketBuilder::new("my-bucket")
    .name(bucket_name!("my-unique-bucket"))
    .versioning_configuration(VersioningConfiguration::Enabled)
    .encryption(Encryption::S3Managed)
    .build(&mut stack_builder);

// Create a website bucket
let (website_bucket, policy) = BucketBuilder::new("website-bucket")
    .website("index.html")
    .error_document("error.html")
    .build(&mut stack_builder);

Implementations

impl BucketBuilder<StartState>

pub fn new(id: &str) -> Self

Creates a new S3 bucket builder.

Arguments

• id - Unique identifier for the bucket

pub fn build(self, stack_builder: &mut StackBuilder) -> BucketRef

impl<T: BucketBuilderState> BucketBuilder<T>

pub fn name(self, name: BucketName) -> Self

pub fn versioning_configuration(self, config: VersioningConfiguration) -> Self

pub fn lifecycle_configuration(self, config: LifecycleConfiguration) -> Self

pub fn public_access_block_configuration( self, access: PublicAccessBlockConfiguration, ) -> Self

pub fn encryption(self, encryption: Encryption) -> Self

pub fn add_notification(self, destination: NotificationDestination<'_>) -> Self

pub fn website<I: Into<String>>( self, index_document: I, ) -> BucketBuilder<WebsiteState>

Configures the bucket for static website hosting.

Automatically disables public access blocks and creates a bucket policy allowing public GetObject access.

impl BucketBuilder<WebsiteState>

pub fn error_document<I: Into<String>>(self, error: I) -> Self

pub fn redirect_all<I: Into<String>>( self, hostname: I, protocol: Option<Protocol>, ) -> Self

pub fn cors_config(self, config: CorsConfiguration) -> Self

pub fn build( self, stack_builder: &mut StackBuilder, ) -> (BucketRef, BucketPolicyRef)

Builds the website bucket and adds it to the stack.

Returns both the bucket and the automatically created bucket policy that allows public read access.