software.amazon.awscdk.services.s3

Class BucketPolicy

java.lang.Object

software.constructs.Construct

software.amazon.awscdk.core.Construct

software.amazon.awscdk.core.Resource

software.amazon.awscdk.services.s3.BucketPolicy

All Implemented Interfaces:

IConstruct, IDependable, IResource

@Generated(value="jsii-pacmak/1.74.0 (build 6d08790)",
           date="2023-03-28T21:34:20.699Z")
public class BucketPolicy
extends Resource

The bucket policy for an Amazon S3 bucket.

Policies define the operations that are allowed on this resource.

You almost never need to define this construct directly.

All AWS resources that support resource policies have a method called addToResourcePolicy(), which will automatically create a new resource policy if one doesn't exist yet, otherwise it will add to the existing policy.

Prefer to use addToResourcePolicy() instead.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.s3.*;
 import software.amazon.awscdk.core.*;
 Bucket bucket;
 BucketPolicy bucketPolicy = BucketPolicy.Builder.create(this, "MyBucketPolicy")
         .bucket(bucket)
         // the properties below are optional
         .removalPolicy(RemovalPolicy.DESTROY)
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	BucketPolicy.Builder A fluent builder for BucketPolicy.

Nested classes/interfaces inherited from interface software.amazon.awscdk.core.IResource

IResource.Jsii$Default

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	BucketPolicy(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	BucketPolicy(software.amazon.jsii.JsiiObjectRef objRef)
	BucketPolicy(software.constructs.Construct scope, java.lang.String id, BucketPolicyProps props)

Method Summary

Modifier and Type	Method and Description
void	applyRemovalPolicy(RemovalPolicy removalPolicy) Sets the removal policy for the BucketPolicy.
PolicyDocument	getDocument() A policy document containing permissions to add to the specified bucket.

Methods inherited from class software.amazon.awscdk.core.Resource

generatePhysicalName, getEnv, getPhysicalName, getResourceArnAttribute, getResourceNameAttribute, getStack, isResource

Methods inherited from class software.amazon.awscdk.core.Construct

getNode, isConstruct, onPrepare, onSynthesize, onValidate, prepare, synthesize, validate

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface software.amazon.awscdk.core.IConstruct

getNode

Constructor Detail

BucketPolicy

protected BucketPolicy(software.amazon.jsii.JsiiObjectRef objRef)

BucketPolicy

protected BucketPolicy(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

BucketPolicy

public BucketPolicy(software.constructs.Construct scope,
                    java.lang.String id,
                    BucketPolicyProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

Method Detail

applyRemovalPolicy

public void applyRemovalPolicy(RemovalPolicy removalPolicy)

Sets the removal policy for the BucketPolicy.

Specified by:

applyRemovalPolicy in interface IResource

Overrides:

applyRemovalPolicy in class Resource

Parameters:

removalPolicy - the RemovalPolicy to set. This parameter is required.

getDocument

public PolicyDocument getDocument()

A policy document containing permissions to add to the specified bucket.

For more information, see Access Policy Language Overview in the Amazon Simple Storage Service Developer Guide.