BucketProps.Builder

java.lang.Object
- software.amazon.awscdk.services.s3.BucketProps.Builder

Enclosing interface:: BucketProps

public static final class BucketProps.Builder
extends java.lang.Object

A builder for BucketProps

Constructor Summary

Constructors
Constructor and Description

Builder()

Constructors
Constructor and Description
`Builder()`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`BucketProps.Builder`	`accessControl(BucketAccessControl accessControl)` Sets the value of `BucketProps.getAccessControl()`
`BucketProps.Builder`	`autoDeleteObjects(java.lang.Boolean autoDeleteObjects)` Sets the value of `BucketProps.getAutoDeleteObjects()`
`BucketProps.Builder`	`blockPublicAccess(BlockPublicAccess blockPublicAccess)` Sets the value of `BucketProps.getBlockPublicAccess()`
`BucketProps.Builder`	`bucketKeyEnabled(java.lang.Boolean bucketKeyEnabled)` Sets the value of `BucketProps.getBucketKeyEnabled()`
`BucketProps.Builder`	`bucketName(java.lang.String bucketName)` Sets the value of `BucketProps.getBucketName()`
`BucketProps`	`build()` Builds the configured instance.
`BucketProps.Builder`	`cors(java.util.List<? extends CorsRule> cors)` Sets the value of `BucketProps.getCors()`
`BucketProps.Builder`	`encryption(BucketEncryption encryption)` Sets the value of `BucketProps.getEncryption()`
`BucketProps.Builder`	`encryptionKey(IKey encryptionKey)` Sets the value of `BucketProps.getEncryptionKey()`
`BucketProps.Builder`	`enforceSsl(java.lang.Boolean enforceSsl)` Sets the value of `BucketProps#getEnforceSsl`
`BucketProps.Builder`	`eventBridgeEnabled(java.lang.Boolean eventBridgeEnabled)` Sets the value of `BucketProps.getEventBridgeEnabled()`
`BucketProps.Builder`	`intelligentTieringConfigurations(java.util.List<? extends IntelligentTieringConfiguration> intelligentTieringConfigurations)` Sets the value of `BucketProps.getIntelligentTieringConfigurations()`
`BucketProps.Builder`	`inventories(java.util.List<? extends Inventory> inventories)` Sets the value of `BucketProps.getInventories()`
`BucketProps.Builder`	`lifecycleRules(java.util.List<? extends LifecycleRule> lifecycleRules)` Sets the value of `BucketProps.getLifecycleRules()`
`BucketProps.Builder`	`metrics(java.util.List<? extends BucketMetrics> metrics)` Sets the value of `BucketProps.getMetrics()`
`BucketProps.Builder`	`notificationsHandlerRole(IRole notificationsHandlerRole)` Sets the value of `BucketProps.getNotificationsHandlerRole()`
`BucketProps.Builder`	`objectOwnership(ObjectOwnership objectOwnership)` Sets the value of `BucketProps.getObjectOwnership()`
`BucketProps.Builder`	`publicReadAccess(java.lang.Boolean publicReadAccess)` Sets the value of `BucketProps.getPublicReadAccess()`
`BucketProps.Builder`	`removalPolicy(RemovalPolicy removalPolicy)` Sets the value of `BucketProps.getRemovalPolicy()`
`BucketProps.Builder`	`serverAccessLogsBucket(IBucket serverAccessLogsBucket)` Sets the value of `BucketProps.getServerAccessLogsBucket()`
`BucketProps.Builder`	`serverAccessLogsPrefix(java.lang.String serverAccessLogsPrefix)` Sets the value of `BucketProps.getServerAccessLogsPrefix()`
`BucketProps.Builder`	`transferAcceleration(java.lang.Boolean transferAcceleration)` Sets the value of `BucketProps.getTransferAcceleration()`
`BucketProps.Builder`	`versioned(java.lang.Boolean versioned)` Sets the value of `BucketProps.getVersioned()`
`BucketProps.Builder`	`websiteErrorDocument(java.lang.String websiteErrorDocument)` Sets the value of `BucketProps.getWebsiteErrorDocument()`
`BucketProps.Builder`	`websiteIndexDocument(java.lang.String websiteIndexDocument)` Sets the value of `BucketProps.getWebsiteIndexDocument()`
`BucketProps.Builder`	`websiteRedirect(RedirectTarget websiteRedirect)` Sets the value of `BucketProps.getWebsiteRedirect()`
`BucketProps.Builder`	`websiteRoutingRules(java.util.List<? extends RoutingRule> websiteRoutingRules)` Sets the value of `BucketProps.getWebsiteRoutingRules()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - Builder
```
public Builder()
```
- Method Detail
  - accessControl
```
public BucketProps.Builder accessControl(BucketAccessControl accessControl)
```
    Sets the value of BucketProps.getAccessControl()
    
    Parameters:
    
    accessControl - Specifies a canned ACL that grants predefined permissions to the bucket.
    
    Returns:
    
    this
  - autoDeleteObjects
```
public BucketProps.Builder autoDeleteObjects(java.lang.Boolean autoDeleteObjects)
```
    Sets the value of BucketProps.getAutoDeleteObjects()
    
    Parameters:
    
    autoDeleteObjects - Whether all objects should be automatically deleted when the bucket is removed from the stack or when the stack is deleted. Requires the removalPolicy to be set to RemovalPolicy.DESTROY.
    Warning if you have deployed a bucket with autoDeleteObjects: true, switching this to false in a CDK version before 1.126.0 will lead to all objects in the bucket being deleted. Be sure to update your bucket resources by deploying with CDK version 1.126.0 or later before switching this value to false.
    
    Returns:
    
    this
  - blockPublicAccess
```
public BucketProps.Builder blockPublicAccess(BlockPublicAccess blockPublicAccess)
```
    Sets the value of BucketProps.getBlockPublicAccess()
    
    Parameters:
    
    blockPublicAccess - The block public access configuration of this bucket.
    
    Returns:
    
    this
  - bucketKeyEnabled
```
public BucketProps.Builder bucketKeyEnabled(java.lang.Boolean bucketKeyEnabled)
```
    Sets the value of BucketProps.getBucketKeyEnabled()
    
    Parameters:
    
    bucketKeyEnabled - Specifies whether Amazon S3 should use an S3 Bucket Key with server-side encryption using KMS (SSE-KMS) for new objects in the bucket. Only relevant, when Encryption is set to {@link BucketEncryption.KMS}
    
    Returns:
    
    this
  - bucketName
```
public BucketProps.Builder bucketName(java.lang.String bucketName)
```
    Sets the value of BucketProps.getBucketName()
    
    Parameters:
    
    bucketName - Physical name of this bucket.
    
    Returns:
    
    this
  - cors
```
public BucketProps.Builder cors(java.util.List<? extends CorsRule> cors)
```
    Sets the value of BucketProps.getCors()
    
    Parameters:
    
    cors - The CORS configuration of this bucket.
    
    Returns:
    
    this
  - encryption
```
public BucketProps.Builder encryption(BucketEncryption encryption)
```
    Sets the value of BucketProps.getEncryption()
    
    Parameters:
    
    encryption - The kind of server-side encryption to apply to this bucket. If you choose KMS, you can specify a KMS key via encryptionKey. If encryption key is not specified, a key will automatically be created.
    
    Returns:
    
    this
  - encryptionKey
```
public BucketProps.Builder encryptionKey(IKey encryptionKey)
```
    Sets the value of BucketProps.getEncryptionKey()
    
    Parameters:
    
    encryptionKey - External KMS key to use for bucket encryption. The 'encryption' property must be either not specified or set to "Kms". An error will be emitted if encryption is set to "Unencrypted" or "Managed".
    
    Returns:
    
    this
  - enforceSsl
```
public BucketProps.Builder enforceSsl(java.lang.Boolean enforceSsl)
```
    Sets the value of BucketProps#getEnforceSsl
    
    Parameters:
    
    enforceSsl - Enforces SSL for requests. S3.5 of the AWS Foundational Security Best Practices Regarding S3.
    
    Returns:
    
    this
  - eventBridgeEnabled
```
public BucketProps.Builder eventBridgeEnabled(java.lang.Boolean eventBridgeEnabled)
```
    Sets the value of BucketProps.getEventBridgeEnabled()
    
    Parameters:
    
    eventBridgeEnabled - Whether this bucket should send notifications to Amazon EventBridge or not.
    
    Returns:
    
    this
  - intelligentTieringConfigurations
```
public BucketProps.Builder intelligentTieringConfigurations(java.util.List<? extends IntelligentTieringConfiguration> intelligentTieringConfigurations)
```
    Sets the value of BucketProps.getIntelligentTieringConfigurations()
    
    Parameters:
    
    intelligentTieringConfigurations - Inteligent Tiering Configurations.
    
    Returns:
    
    this
  - inventories
```
public BucketProps.Builder inventories(java.util.List<? extends Inventory> inventories)
```
    Sets the value of BucketProps.getInventories()
    
    Parameters:
    
    inventories - The inventory configuration of the bucket.
    
    Returns:
    
    this
  - lifecycleRules
```
public BucketProps.Builder lifecycleRules(java.util.List<? extends LifecycleRule> lifecycleRules)
```
    Sets the value of BucketProps.getLifecycleRules()
    
    Parameters:
    
    lifecycleRules - Rules that define how Amazon S3 manages objects during their lifetime.
    
    Returns:
    
    this
  - metrics
```
public BucketProps.Builder metrics(java.util.List<? extends BucketMetrics> metrics)
```
    Sets the value of BucketProps.getMetrics()
    
    Parameters:
    
    metrics - The metrics configuration of this bucket.
    
    Returns:
    
    this
  - notificationsHandlerRole
```
public BucketProps.Builder notificationsHandlerRole(IRole notificationsHandlerRole)
```
    Sets the value of BucketProps.getNotificationsHandlerRole()
    
    Parameters:
    
    notificationsHandlerRole - The role to be used by the notifications handler.
    
    Returns:
    
    this
  - objectOwnership
```
public BucketProps.Builder objectOwnership(ObjectOwnership objectOwnership)
```
    Sets the value of BucketProps.getObjectOwnership()
    
    Parameters:
    
    objectOwnership - The objectOwnership of the bucket.
    
    Returns:
    
    this
  - publicReadAccess
```
public BucketProps.Builder publicReadAccess(java.lang.Boolean publicReadAccess)
```
    Sets the value of BucketProps.getPublicReadAccess()
    
    Parameters:
    
    publicReadAccess - Grants public read access to all objects in the bucket. Similar to calling bucket.grantPublicAccess()
    
    Returns:
    
    this
  - removalPolicy
```
public BucketProps.Builder removalPolicy(RemovalPolicy removalPolicy)
```
    Sets the value of BucketProps.getRemovalPolicy()
    
    Parameters:
    
    removalPolicy - Policy to apply when the bucket is removed from this stack.
    
    Returns:
    
    this
  - serverAccessLogsBucket
```
public BucketProps.Builder serverAccessLogsBucket(IBucket serverAccessLogsBucket)
```
    Sets the value of BucketProps.getServerAccessLogsBucket()
    
    Parameters:
    
    serverAccessLogsBucket - Destination bucket for the server access logs.
    
    Returns:
    
    this
  - serverAccessLogsPrefix
```
public BucketProps.Builder serverAccessLogsPrefix(java.lang.String serverAccessLogsPrefix)
```
    Sets the value of BucketProps.getServerAccessLogsPrefix()
    
    Parameters:
    
    serverAccessLogsPrefix - Optional log file prefix to use for the bucket's access logs. If defined without "serverAccessLogsBucket", enables access logs to current bucket with this prefix.
    
    Returns:
    
    this
  - transferAcceleration
```
public BucketProps.Builder transferAcceleration(java.lang.Boolean transferAcceleration)
```
    Sets the value of BucketProps.getTransferAcceleration()
    
    Parameters:
    
    transferAcceleration - Whether this bucket should have transfer acceleration turned on or not.
    
    Returns:
    
    this
  - versioned
```
public BucketProps.Builder versioned(java.lang.Boolean versioned)
```
    Sets the value of BucketProps.getVersioned()
    
    Parameters:
    
    versioned - Whether this bucket should have versioning turned on or not.
    
    Returns:
    
    this
  - websiteErrorDocument
```
public BucketProps.Builder websiteErrorDocument(java.lang.String websiteErrorDocument)
```
    Sets the value of BucketProps.getWebsiteErrorDocument()
    
    Parameters:
    
    websiteErrorDocument - The name of the error document (e.g. "404.html") for the website. `websiteIndexDocument` must also be set if this is set.
    
    Returns:
    
    this
  - websiteIndexDocument
```
public BucketProps.Builder websiteIndexDocument(java.lang.String websiteIndexDocument)
```
    Sets the value of BucketProps.getWebsiteIndexDocument()
    
    Parameters:
    
    websiteIndexDocument - The name of the index document (e.g. "index.html") for the website. Enables static website hosting for this bucket.
    
    Returns:
    
    this
  - websiteRedirect
```
public BucketProps.Builder websiteRedirect(RedirectTarget websiteRedirect)
```
    Sets the value of BucketProps.getWebsiteRedirect()
    
    Parameters:
    
    websiteRedirect - Specifies the redirect behavior of all requests to a website endpoint of a bucket. If you specify this property, you can't specify "websiteIndexDocument", "websiteErrorDocument" nor , "websiteRoutingRules".
    
    Returns:
    
    this
  - websiteRoutingRules
```
public BucketProps.Builder websiteRoutingRules(java.util.List<? extends RoutingRule> websiteRoutingRules)
```
    Sets the value of BucketProps.getWebsiteRoutingRules()
    
    Parameters:
    
    websiteRoutingRules - Rules that define when a redirect is applied and the redirect behavior.
    
    Returns:
    
    this
  - build
```
public BucketProps build()
```
    Builds the configured instance.
    
    Returns:
    
    a new instance of BucketProps
    
    Throws:
    
    java.lang.NullPointerException - if any required attribute was not provided

Class BucketProps.Builder

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Builder

Method Detail

accessControl

autoDeleteObjects

blockPublicAccess

bucketKeyEnabled

bucketName

cors

encryption

encryptionKey

enforceSsl

eventBridgeEnabled

intelligentTieringConfigurations

inventories

lifecycleRules

metrics

notificationsHandlerRole

objectOwnership

publicReadAccess

removalPolicy

serverAccessLogsBucket

serverAccessLogsPrefix

transferAcceleration

versioned

websiteErrorDocument

websiteIndexDocument

websiteRedirect

websiteRoutingRules

build