aws.s3.BucketV2
Explore with Pulumi AI
Provides a S3 bucket resource.
This resource provides functionality for managing S3 general purpose buckets in an AWS Partition. To manage Amazon S3 Express directory buckets, use the
aws_directory_bucketresource. To manage S3 on Outposts, use theaws.s3control.Bucketresource.
Object Lock can be enabled by using the
object_lock_enableattribute or by using theaws.s3.BucketObjectLockConfigurationV2resource. Please note, that by using the resource, Object Lock can be enabled/disabled without destroying and recreating the bucket.
Example Usage
Private Bucket With Tags
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const example = new aws.s3.BucketV2("example", {
    bucket: "my-tf-test-bucket",
    tags: {
        Name: "My bucket",
        Environment: "Dev",
    },
});
import pulumi
import pulumi_aws as aws
example = aws.s3.BucketV2("example",
    bucket="my-tf-test-bucket",
    tags={
        "Name": "My bucket",
        "Environment": "Dev",
    })
package main
import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/s3"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := s3.NewBucketV2(ctx, "example", &s3.BucketV2Args{
			Bucket: pulumi.String("my-tf-test-bucket"),
			Tags: pulumi.StringMap{
				"Name":        pulumi.String("My bucket"),
				"Environment": pulumi.String("Dev"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() => 
{
    var example = new Aws.S3.BucketV2("example", new()
    {
        Bucket = "my-tf-test-bucket",
        Tags = 
        {
            { "Name", "My bucket" },
            { "Environment", "Dev" },
        },
    });
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.s3.BucketV2;
import com.pulumi.aws.s3.BucketV2Args;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        var example = new BucketV2("example", BucketV2Args.builder()
            .bucket("my-tf-test-bucket")
            .tags(Map.ofEntries(
                Map.entry("Name", "My bucket"),
                Map.entry("Environment", "Dev")
            ))
            .build());
    }
}
resources:
  example:
    type: aws:s3:BucketV2
    properties:
      bucket: my-tf-test-bucket
      tags:
        Name: My bucket
        Environment: Dev
Create BucketV2 Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new BucketV2(name: string, args?: BucketV2Args, opts?: CustomResourceOptions);@overload
def BucketV2(resource_name: str,
             args: Optional[BucketV2Args] = None,
             opts: Optional[ResourceOptions] = None)
@overload
def BucketV2(resource_name: str,
             opts: Optional[ResourceOptions] = None,
             acceleration_status: Optional[str] = None,
             acl: Optional[str] = None,
             bucket: Optional[str] = None,
             bucket_prefix: Optional[str] = None,
             cors_rules: Optional[Sequence[BucketV2CorsRuleArgs]] = None,
             force_destroy: Optional[bool] = None,
             grants: Optional[Sequence[BucketV2GrantArgs]] = None,
             lifecycle_rules: Optional[Sequence[BucketV2LifecycleRuleArgs]] = None,
             loggings: Optional[Sequence[BucketV2LoggingArgs]] = None,
             object_lock_configuration: Optional[BucketV2ObjectLockConfigurationArgs] = None,
             object_lock_enabled: Optional[bool] = None,
             policy: Optional[str] = None,
             replication_configurations: Optional[Sequence[BucketV2ReplicationConfigurationArgs]] = None,
             request_payer: Optional[str] = None,
             server_side_encryption_configurations: Optional[Sequence[BucketV2ServerSideEncryptionConfigurationArgs]] = None,
             tags: Optional[Mapping[str, str]] = None,
             versionings: Optional[Sequence[BucketV2VersioningArgs]] = None,
             websites: Optional[Sequence[BucketV2WebsiteArgs]] = None)func NewBucketV2(ctx *Context, name string, args *BucketV2Args, opts ...ResourceOption) (*BucketV2, error)public BucketV2(string name, BucketV2Args? args = null, CustomResourceOptions? opts = null)
public BucketV2(String name, BucketV2Args args)
public BucketV2(String name, BucketV2Args args, CustomResourceOptions options)
type: aws:s3:BucketV2
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args BucketV2Args
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args BucketV2Args
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args BucketV2Args
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args BucketV2Args
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args BucketV2Args
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var bucketV2Resource = new Aws.S3.BucketV2("bucketV2Resource", new()
{
    Bucket = "string",
    BucketPrefix = "string",
    ForceDestroy = false,
    ObjectLockEnabled = false,
    Tags = 
    {
        { "string", "string" },
    },
});
example, err := s3.NewBucketV2(ctx, "bucketV2Resource", &s3.BucketV2Args{
	Bucket:            pulumi.String("string"),
	BucketPrefix:      pulumi.String("string"),
	ForceDestroy:      pulumi.Bool(false),
	ObjectLockEnabled: pulumi.Bool(false),
	Tags: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
})
var bucketV2Resource = new BucketV2("bucketV2Resource", BucketV2Args.builder()
    .bucket("string")
    .bucketPrefix("string")
    .forceDestroy(false)
    .objectLockEnabled(false)
    .tags(Map.of("string", "string"))
    .build());
bucket_v2_resource = aws.s3.BucketV2("bucketV2Resource",
    bucket="string",
    bucket_prefix="string",
    force_destroy=False,
    object_lock_enabled=False,
    tags={
        "string": "string",
    })
const bucketV2Resource = new aws.s3.BucketV2("bucketV2Resource", {
    bucket: "string",
    bucketPrefix: "string",
    forceDestroy: false,
    objectLockEnabled: false,
    tags: {
        string: "string",
    },
});
type: aws:s3:BucketV2
properties:
    bucket: string
    bucketPrefix: string
    forceDestroy: false
    objectLockEnabled: false
    tags:
        string: string
BucketV2 Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The BucketV2 resource accepts the following input properties:
- AccelerationStatus string
- Sets the accelerate configuration of an existing bucket. Can be EnabledorSuspended. Cannot be used incn-north-1orus-gov-west-1. This provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAccelerateConfigurationV2instead.
- Acl string
- The canned ACL to apply. Valid values are private,public-read,public-read-write,aws-exec-read,authenticated-read, andlog-delivery-write. Defaults toprivate. Conflicts withgrant. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAclV2instead.
- Bucket string
- Name of the bucket. If omitted, the provider will assign a random, unique name. Must be lowercase and less than or equal to 63 characters in length. A full list of bucket naming rules may be found here. The name must not be in the format [bucket_name]--[azid]--x-s3. Use theaws.s3.DirectoryBucketresource to manage S3 Express buckets.
- BucketPrefix string
- Creates a unique bucket name beginning with the specified prefix. Conflicts with bucket. Must be lowercase and less than or equal to 37 characters in length. A full list of bucket naming rules may be found here.
- CorsRules List<BucketV2Cors Rule> 
- Rule of Cross-Origin Resource Sharing. See CORS rule below for details. This provider will only perform drift detection if a configuration value is provided. Use the resource aws.s3.BucketCorsConfigurationV2instead.
- ForceDestroy bool
- Boolean that indicates all objects (including any locked objects) should be deleted from the bucket when the bucket is destroyed so that the bucket can be destroyed without error. These objects are not recoverable. This only deletes objects when the bucket is destroyed, not when setting this parameter to true. Once this parameter is set totrue, there must be a successfulpulumi uprun before a destroy is required to update this value in the resource state. Without a successfulpulumi upafter this parameter is set, this flag will have no effect. If setting this field in the same operation that would require replacing the bucket or destroying the bucket, this flag will not work. Additionally when importing a bucket, a successfulpulumi upis required to set this value in state before it will take effect on a destroy operation.
- Grants
List<BucketV2Grant> 
- An ACL policy grant. See Grant below for details. Conflicts with acl. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAclV2instead.
- LifecycleRules List<BucketV2Lifecycle Rule> 
- Configuration of object lifecycle management. See Lifecycle Rule below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketLifecycleConfigurationV2instead.
- Loggings
List<BucketV2Logging> 
- Configuration of S3 bucket logging parameters. See Logging below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketLoggingV2instead.
- ObjectLock BucketConfiguration V2Object Lock Configuration 
- Configuration of S3 object locking. See Object Lock Configuration below for details.
The provider wil only perform drift detection if a configuration value is provided.
Use the object_lock_enabledparameter and the resourceaws.s3.BucketObjectLockConfigurationV2instead.
- ObjectLock boolEnabled 
- Indicates whether this bucket has an Object Lock configuration enabled. Valid values are trueorfalse. This argument is not supported in all regions or partitions.
- Policy string
- Valid bucket policy JSON document. Note that if the policy document is not specific enough (but still valid), this provider may view the policy as constantly changing. In this case, please make sure you use the verbose/specific version of the policy. For more information about building AWS IAM policy documents with this provider, see the AWS IAM Policy Document Guide.
The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketPolicyinstead.
- ReplicationConfigurations List<BucketV2Replication Configuration> 
- Configuration of replication configuration. See Replication Configuration below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketReplicationConfiginstead.
- RequestPayer string
- Specifies who should bear the cost of Amazon S3 data transfer.
Can be either BucketOwnerorRequester. By default, the owner of the S3 bucket would incur the costs of any data transfer. See Requester Pays Buckets developer guide for more information. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketRequestPaymentConfigurationV2instead.
- ServerSide List<BucketEncryption Configurations V2Server Side Encryption Configuration> 
- Configuration of server-side encryption configuration. See Server Side Encryption Configuration below for details.
The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketServerSideEncryptionConfigurationV2instead.
- Dictionary<string, string>
- Map of tags to assign to the bucket. If configured with a provider - default_tagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level.- The following arguments are deprecated, and will be removed in a future major version: 
- Versionings
List<BucketV2Versioning> 
- Configuration of the S3 bucket versioning state. See Versioning below for details. The provider will only perform drift detection if a configuration value is provided. Use the resource aws.s3.BucketVersioningV2instead.
- Websites
List<BucketV2Website> 
- Configuration of the S3 bucket website. See Website below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
- AccelerationStatus string
- Sets the accelerate configuration of an existing bucket. Can be EnabledorSuspended. Cannot be used incn-north-1orus-gov-west-1. This provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAccelerateConfigurationV2instead.
- Acl string
- The canned ACL to apply. Valid values are private,public-read,public-read-write,aws-exec-read,authenticated-read, andlog-delivery-write. Defaults toprivate. Conflicts withgrant. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAclV2instead.
- Bucket string
- Name of the bucket. If omitted, the provider will assign a random, unique name. Must be lowercase and less than or equal to 63 characters in length. A full list of bucket naming rules may be found here. The name must not be in the format [bucket_name]--[azid]--x-s3. Use theaws.s3.DirectoryBucketresource to manage S3 Express buckets.
- BucketPrefix string
- Creates a unique bucket name beginning with the specified prefix. Conflicts with bucket. Must be lowercase and less than or equal to 37 characters in length. A full list of bucket naming rules may be found here.
- CorsRules []BucketV2Cors Rule Args 
- Rule of Cross-Origin Resource Sharing. See CORS rule below for details. This provider will only perform drift detection if a configuration value is provided. Use the resource aws.s3.BucketCorsConfigurationV2instead.
- ForceDestroy bool
- Boolean that indicates all objects (including any locked objects) should be deleted from the bucket when the bucket is destroyed so that the bucket can be destroyed without error. These objects are not recoverable. This only deletes objects when the bucket is destroyed, not when setting this parameter to true. Once this parameter is set totrue, there must be a successfulpulumi uprun before a destroy is required to update this value in the resource state. Without a successfulpulumi upafter this parameter is set, this flag will have no effect. If setting this field in the same operation that would require replacing the bucket or destroying the bucket, this flag will not work. Additionally when importing a bucket, a successfulpulumi upis required to set this value in state before it will take effect on a destroy operation.
- Grants
[]BucketV2Grant Args 
- An ACL policy grant. See Grant below for details. Conflicts with acl. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAclV2instead.
- LifecycleRules []BucketV2Lifecycle Rule Args 
- Configuration of object lifecycle management. See Lifecycle Rule below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketLifecycleConfigurationV2instead.
- Loggings
[]BucketV2Logging Args 
- Configuration of S3 bucket logging parameters. See Logging below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketLoggingV2instead.
- ObjectLock BucketConfiguration V2Object Lock Configuration Args 
- Configuration of S3 object locking. See Object Lock Configuration below for details.
The provider wil only perform drift detection if a configuration value is provided.
Use the object_lock_enabledparameter and the resourceaws.s3.BucketObjectLockConfigurationV2instead.
- ObjectLock boolEnabled 
- Indicates whether this bucket has an Object Lock configuration enabled. Valid values are trueorfalse. This argument is not supported in all regions or partitions.
- Policy string
- Valid bucket policy JSON document. Note that if the policy document is not specific enough (but still valid), this provider may view the policy as constantly changing. In this case, please make sure you use the verbose/specific version of the policy. For more information about building AWS IAM policy documents with this provider, see the AWS IAM Policy Document Guide.
The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketPolicyinstead.
- ReplicationConfigurations []BucketV2Replication Configuration Args 
- Configuration of replication configuration. See Replication Configuration below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketReplicationConfiginstead.
- RequestPayer string
- Specifies who should bear the cost of Amazon S3 data transfer.
Can be either BucketOwnerorRequester. By default, the owner of the S3 bucket would incur the costs of any data transfer. See Requester Pays Buckets developer guide for more information. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketRequestPaymentConfigurationV2instead.
- ServerSide []BucketEncryption Configurations V2Server Side Encryption Configuration Args 
- Configuration of server-side encryption configuration. See Server Side Encryption Configuration below for details.
The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketServerSideEncryptionConfigurationV2instead.
- map[string]string
- Map of tags to assign to the bucket. If configured with a provider - default_tagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level.- The following arguments are deprecated, and will be removed in a future major version: 
- Versionings
[]BucketV2Versioning Args 
- Configuration of the S3 bucket versioning state. See Versioning below for details. The provider will only perform drift detection if a configuration value is provided. Use the resource aws.s3.BucketVersioningV2instead.
- Websites
[]BucketV2Website Args 
- Configuration of the S3 bucket website. See Website below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
- accelerationStatus String
- Sets the accelerate configuration of an existing bucket. Can be EnabledorSuspended. Cannot be used incn-north-1orus-gov-west-1. This provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAccelerateConfigurationV2instead.
- acl String
- The canned ACL to apply. Valid values are private,public-read,public-read-write,aws-exec-read,authenticated-read, andlog-delivery-write. Defaults toprivate. Conflicts withgrant. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAclV2instead.
- bucket String
- Name of the bucket. If omitted, the provider will assign a random, unique name. Must be lowercase and less than or equal to 63 characters in length. A full list of bucket naming rules may be found here. The name must not be in the format [bucket_name]--[azid]--x-s3. Use theaws.s3.DirectoryBucketresource to manage S3 Express buckets.
- bucketPrefix String
- Creates a unique bucket name beginning with the specified prefix. Conflicts with bucket. Must be lowercase and less than or equal to 37 characters in length. A full list of bucket naming rules may be found here.
- corsRules List<BucketV2Cors Rule> 
- Rule of Cross-Origin Resource Sharing. See CORS rule below for details. This provider will only perform drift detection if a configuration value is provided. Use the resource aws.s3.BucketCorsConfigurationV2instead.
- forceDestroy Boolean
- Boolean that indicates all objects (including any locked objects) should be deleted from the bucket when the bucket is destroyed so that the bucket can be destroyed without error. These objects are not recoverable. This only deletes objects when the bucket is destroyed, not when setting this parameter to true. Once this parameter is set totrue, there must be a successfulpulumi uprun before a destroy is required to update this value in the resource state. Without a successfulpulumi upafter this parameter is set, this flag will have no effect. If setting this field in the same operation that would require replacing the bucket or destroying the bucket, this flag will not work. Additionally when importing a bucket, a successfulpulumi upis required to set this value in state before it will take effect on a destroy operation.
- grants
List<BucketV2Grant> 
- An ACL policy grant. See Grant below for details. Conflicts with acl. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAclV2instead.
- lifecycleRules List<BucketV2Lifecycle Rule> 
- Configuration of object lifecycle management. See Lifecycle Rule below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketLifecycleConfigurationV2instead.
- loggings
List<BucketV2Logging> 
- Configuration of S3 bucket logging parameters. See Logging below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketLoggingV2instead.
- objectLock BucketConfiguration V2Object Lock Configuration 
- Configuration of S3 object locking. See Object Lock Configuration below for details.
The provider wil only perform drift detection if a configuration value is provided.
Use the object_lock_enabledparameter and the resourceaws.s3.BucketObjectLockConfigurationV2instead.
- objectLock BooleanEnabled 
- Indicates whether this bucket has an Object Lock configuration enabled. Valid values are trueorfalse. This argument is not supported in all regions or partitions.
- policy String
- Valid bucket policy JSON document. Note that if the policy document is not specific enough (but still valid), this provider may view the policy as constantly changing. In this case, please make sure you use the verbose/specific version of the policy. For more information about building AWS IAM policy documents with this provider, see the AWS IAM Policy Document Guide.
The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketPolicyinstead.
- replicationConfigurations List<BucketV2Replication Configuration> 
- Configuration of replication configuration. See Replication Configuration below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketReplicationConfiginstead.
- requestPayer String
- Specifies who should bear the cost of Amazon S3 data transfer.
Can be either BucketOwnerorRequester. By default, the owner of the S3 bucket would incur the costs of any data transfer. See Requester Pays Buckets developer guide for more information. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketRequestPaymentConfigurationV2instead.
- serverSide List<BucketEncryption Configurations V2Server Side Encryption Configuration> 
- Configuration of server-side encryption configuration. See Server Side Encryption Configuration below for details.
The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketServerSideEncryptionConfigurationV2instead.
- Map<String,String>
- Map of tags to assign to the bucket. If configured with a provider - default_tagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level.- The following arguments are deprecated, and will be removed in a future major version: 
- versionings
List<BucketV2Versioning> 
- Configuration of the S3 bucket versioning state. See Versioning below for details. The provider will only perform drift detection if a configuration value is provided. Use the resource aws.s3.BucketVersioningV2instead.
- websites
List<BucketV2Website> 
- Configuration of the S3 bucket website. See Website below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
- accelerationStatus string
- Sets the accelerate configuration of an existing bucket. Can be EnabledorSuspended. Cannot be used incn-north-1orus-gov-west-1. This provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAccelerateConfigurationV2instead.
- acl string
- The canned ACL to apply. Valid values are private,public-read,public-read-write,aws-exec-read,authenticated-read, andlog-delivery-write. Defaults toprivate. Conflicts withgrant. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAclV2instead.
- bucket string
- Name of the bucket. If omitted, the provider will assign a random, unique name. Must be lowercase and less than or equal to 63 characters in length. A full list of bucket naming rules may be found here. The name must not be in the format [bucket_name]--[azid]--x-s3. Use theaws.s3.DirectoryBucketresource to manage S3 Express buckets.
- bucketPrefix string
- Creates a unique bucket name beginning with the specified prefix. Conflicts with bucket. Must be lowercase and less than or equal to 37 characters in length. A full list of bucket naming rules may be found here.
- corsRules BucketV2Cors Rule[] 
- Rule of Cross-Origin Resource Sharing. See CORS rule below for details. This provider will only perform drift detection if a configuration value is provided. Use the resource aws.s3.BucketCorsConfigurationV2instead.
- forceDestroy boolean
- Boolean that indicates all objects (including any locked objects) should be deleted from the bucket when the bucket is destroyed so that the bucket can be destroyed without error. These objects are not recoverable. This only deletes objects when the bucket is destroyed, not when setting this parameter to true. Once this parameter is set totrue, there must be a successfulpulumi uprun before a destroy is required to update this value in the resource state. Without a successfulpulumi upafter this parameter is set, this flag will have no effect. If setting this field in the same operation that would require replacing the bucket or destroying the bucket, this flag will not work. Additionally when importing a bucket, a successfulpulumi upis required to set this value in state before it will take effect on a destroy operation.
- grants
BucketV2Grant[] 
- An ACL policy grant. See Grant below for details. Conflicts with acl. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAclV2instead.
- lifecycleRules BucketV2Lifecycle Rule[] 
- Configuration of object lifecycle management. See Lifecycle Rule below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketLifecycleConfigurationV2instead.
- loggings
BucketV2Logging[] 
- Configuration of S3 bucket logging parameters. See Logging below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketLoggingV2instead.
- objectLock BucketConfiguration V2Object Lock Configuration 
- Configuration of S3 object locking. See Object Lock Configuration below for details.
The provider wil only perform drift detection if a configuration value is provided.
Use the object_lock_enabledparameter and the resourceaws.s3.BucketObjectLockConfigurationV2instead.
- objectLock booleanEnabled 
- Indicates whether this bucket has an Object Lock configuration enabled. Valid values are trueorfalse. This argument is not supported in all regions or partitions.
- policy string
- Valid bucket policy JSON document. Note that if the policy document is not specific enough (but still valid), this provider may view the policy as constantly changing. In this case, please make sure you use the verbose/specific version of the policy. For more information about building AWS IAM policy documents with this provider, see the AWS IAM Policy Document Guide.
The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketPolicyinstead.
- replicationConfigurations BucketV2Replication Configuration[] 
- Configuration of replication configuration. See Replication Configuration below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketReplicationConfiginstead.
- requestPayer string
- Specifies who should bear the cost of Amazon S3 data transfer.
Can be either BucketOwnerorRequester. By default, the owner of the S3 bucket would incur the costs of any data transfer. See Requester Pays Buckets developer guide for more information. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketRequestPaymentConfigurationV2instead.
- serverSide BucketEncryption Configurations V2Server Side Encryption Configuration[] 
- Configuration of server-side encryption configuration. See Server Side Encryption Configuration below for details.
The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketServerSideEncryptionConfigurationV2instead.
- {[key: string]: string}
- Map of tags to assign to the bucket. If configured with a provider - default_tagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level.- The following arguments are deprecated, and will be removed in a future major version: 
- versionings
BucketV2Versioning[] 
- Configuration of the S3 bucket versioning state. See Versioning below for details. The provider will only perform drift detection if a configuration value is provided. Use the resource aws.s3.BucketVersioningV2instead.
- websites
BucketV2Website[] 
- Configuration of the S3 bucket website. See Website below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
- acceleration_status str
- Sets the accelerate configuration of an existing bucket. Can be EnabledorSuspended. Cannot be used incn-north-1orus-gov-west-1. This provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAccelerateConfigurationV2instead.
- acl str
- The canned ACL to apply. Valid values are private,public-read,public-read-write,aws-exec-read,authenticated-read, andlog-delivery-write. Defaults toprivate. Conflicts withgrant. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAclV2instead.
- bucket str
- Name of the bucket. If omitted, the provider will assign a random, unique name. Must be lowercase and less than or equal to 63 characters in length. A full list of bucket naming rules may be found here. The name must not be in the format [bucket_name]--[azid]--x-s3. Use theaws.s3.DirectoryBucketresource to manage S3 Express buckets.
- bucket_prefix str
- Creates a unique bucket name beginning with the specified prefix. Conflicts with bucket. Must be lowercase and less than or equal to 37 characters in length. A full list of bucket naming rules may be found here.
- cors_rules Sequence[BucketV2Cors Rule Args] 
- Rule of Cross-Origin Resource Sharing. See CORS rule below for details. This provider will only perform drift detection if a configuration value is provided. Use the resource aws.s3.BucketCorsConfigurationV2instead.
- force_destroy bool
- Boolean that indicates all objects (including any locked objects) should be deleted from the bucket when the bucket is destroyed so that the bucket can be destroyed without error. These objects are not recoverable. This only deletes objects when the bucket is destroyed, not when setting this parameter to true. Once this parameter is set totrue, there must be a successfulpulumi uprun before a destroy is required to update this value in the resource state. Without a successfulpulumi upafter this parameter is set, this flag will have no effect. If setting this field in the same operation that would require replacing the bucket or destroying the bucket, this flag will not work. Additionally when importing a bucket, a successfulpulumi upis required to set this value in state before it will take effect on a destroy operation.
- grants
Sequence[BucketV2Grant Args] 
- An ACL policy grant. See Grant below for details. Conflicts with acl. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAclV2instead.
- lifecycle_rules Sequence[BucketV2Lifecycle Rule Args] 
- Configuration of object lifecycle management. See Lifecycle Rule below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketLifecycleConfigurationV2instead.
- loggings
Sequence[BucketV2Logging Args] 
- Configuration of S3 bucket logging parameters. See Logging below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketLoggingV2instead.
- object_lock_ Bucketconfiguration V2Object Lock Configuration Args 
- Configuration of S3 object locking. See Object Lock Configuration below for details.
The provider wil only perform drift detection if a configuration value is provided.
Use the object_lock_enabledparameter and the resourceaws.s3.BucketObjectLockConfigurationV2instead.
- object_lock_ boolenabled 
- Indicates whether this bucket has an Object Lock configuration enabled. Valid values are trueorfalse. This argument is not supported in all regions or partitions.
- policy str
- Valid bucket policy JSON document. Note that if the policy document is not specific enough (but still valid), this provider may view the policy as constantly changing. In this case, please make sure you use the verbose/specific version of the policy. For more information about building AWS IAM policy documents with this provider, see the AWS IAM Policy Document Guide.
The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketPolicyinstead.
- replication_configurations Sequence[BucketV2Replication Configuration Args] 
- Configuration of replication configuration. See Replication Configuration below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketReplicationConfiginstead.
- request_payer str
- Specifies who should bear the cost of Amazon S3 data transfer.
Can be either BucketOwnerorRequester. By default, the owner of the S3 bucket would incur the costs of any data transfer. See Requester Pays Buckets developer guide for more information. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketRequestPaymentConfigurationV2instead.
- server_side_ Sequence[Bucketencryption_ configurations V2Server Side Encryption Configuration Args] 
- Configuration of server-side encryption configuration. See Server Side Encryption Configuration below for details.
The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketServerSideEncryptionConfigurationV2instead.
- Mapping[str, str]
- Map of tags to assign to the bucket. If configured with a provider - default_tagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level.- The following arguments are deprecated, and will be removed in a future major version: 
- versionings
Sequence[BucketV2Versioning Args] 
- Configuration of the S3 bucket versioning state. See Versioning below for details. The provider will only perform drift detection if a configuration value is provided. Use the resource aws.s3.BucketVersioningV2instead.
- websites
Sequence[BucketV2Website Args] 
- Configuration of the S3 bucket website. See Website below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
- accelerationStatus String
- Sets the accelerate configuration of an existing bucket. Can be EnabledorSuspended. Cannot be used incn-north-1orus-gov-west-1. This provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAccelerateConfigurationV2instead.
- acl String
- The canned ACL to apply. Valid values are private,public-read,public-read-write,aws-exec-read,authenticated-read, andlog-delivery-write. Defaults toprivate. Conflicts withgrant. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAclV2instead.
- bucket String
- Name of the bucket. If omitted, the provider will assign a random, unique name. Must be lowercase and less than or equal to 63 characters in length. A full list of bucket naming rules may be found here. The name must not be in the format [bucket_name]--[azid]--x-s3. Use theaws.s3.DirectoryBucketresource to manage S3 Express buckets.
- bucketPrefix String
- Creates a unique bucket name beginning with the specified prefix. Conflicts with bucket. Must be lowercase and less than or equal to 37 characters in length. A full list of bucket naming rules may be found here.
- corsRules List<Property Map>
- Rule of Cross-Origin Resource Sharing. See CORS rule below for details. This provider will only perform drift detection if a configuration value is provided. Use the resource aws.s3.BucketCorsConfigurationV2instead.
- forceDestroy Boolean
- Boolean that indicates all objects (including any locked objects) should be deleted from the bucket when the bucket is destroyed so that the bucket can be destroyed without error. These objects are not recoverable. This only deletes objects when the bucket is destroyed, not when setting this parameter to true. Once this parameter is set totrue, there must be a successfulpulumi uprun before a destroy is required to update this value in the resource state. Without a successfulpulumi upafter this parameter is set, this flag will have no effect. If setting this field in the same operation that would require replacing the bucket or destroying the bucket, this flag will not work. Additionally when importing a bucket, a successfulpulumi upis required to set this value in state before it will take effect on a destroy operation.
- grants List<Property Map>
- An ACL policy grant. See Grant below for details. Conflicts with acl. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAclV2instead.
- lifecycleRules List<Property Map>
- Configuration of object lifecycle management. See Lifecycle Rule below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketLifecycleConfigurationV2instead.
- loggings List<Property Map>
- Configuration of S3 bucket logging parameters. See Logging below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketLoggingV2instead.
- objectLock Property MapConfiguration 
- Configuration of S3 object locking. See Object Lock Configuration below for details.
The provider wil only perform drift detection if a configuration value is provided.
Use the object_lock_enabledparameter and the resourceaws.s3.BucketObjectLockConfigurationV2instead.
- objectLock BooleanEnabled 
- Indicates whether this bucket has an Object Lock configuration enabled. Valid values are trueorfalse. This argument is not supported in all regions or partitions.
- policy String
- Valid bucket policy JSON document. Note that if the policy document is not specific enough (but still valid), this provider may view the policy as constantly changing. In this case, please make sure you use the verbose/specific version of the policy. For more information about building AWS IAM policy documents with this provider, see the AWS IAM Policy Document Guide.
The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketPolicyinstead.
- replicationConfigurations List<Property Map>
- Configuration of replication configuration. See Replication Configuration below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketReplicationConfiginstead.
- requestPayer String
- Specifies who should bear the cost of Amazon S3 data transfer.
Can be either BucketOwnerorRequester. By default, the owner of the S3 bucket would incur the costs of any data transfer. See Requester Pays Buckets developer guide for more information. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketRequestPaymentConfigurationV2instead.
- serverSide List<Property Map>Encryption Configurations 
- Configuration of server-side encryption configuration. See Server Side Encryption Configuration below for details.
The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketServerSideEncryptionConfigurationV2instead.
- Map<String>
- Map of tags to assign to the bucket. If configured with a provider - default_tagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level.- The following arguments are deprecated, and will be removed in a future major version: 
- versionings List<Property Map>
- Configuration of the S3 bucket versioning state. See Versioning below for details. The provider will only perform drift detection if a configuration value is provided. Use the resource aws.s3.BucketVersioningV2instead.
- websites List<Property Map>
- Configuration of the S3 bucket website. See Website below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
Outputs
All input properties are implicitly available as output properties. Additionally, the BucketV2 resource produces the following output properties:
- Arn string
- ARN of the bucket. Will be of format arn:aws:s3:::bucketname.
- BucketDomain stringName 
- Bucket domain name. Will be of format bucketname.s3.amazonaws.com.
- BucketRegional stringDomain Name 
- The bucket region-specific domain name. The bucket domain name including the region name. Please refer to the S3 endpoints reference for format. Note: AWS CloudFront allows specifying an S3 region-specific endpoint when creating an S3 origin. This will prevent redirect issues from CloudFront to the S3 Origin URL. For more information, see the Virtual Hosted-Style Requests for Other Regions section in the AWS S3 User Guide.
- HostedZone stringId 
- Route 53 Hosted Zone ID for this bucket's region.
- Id string
- The provider-assigned unique ID for this managed resource.
- Region string
- AWS region this bucket resides in.
- Dictionary<string, string>
- Map of tags assigned to the resource, including those inherited from the provider default_tagsconfiguration block.
- WebsiteDomain string
- (Deprecated) Domain of the website endpoint, if the bucket is configured with a website. If not, this will be an empty string. This is used to create Route 53 alias records. Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
- WebsiteEndpoint string
- (Deprecated) Website endpoint, if the bucket is configured with a website. If not, this will be an empty string. Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
- Arn string
- ARN of the bucket. Will be of format arn:aws:s3:::bucketname.
- BucketDomain stringName 
- Bucket domain name. Will be of format bucketname.s3.amazonaws.com.
- BucketRegional stringDomain Name 
- The bucket region-specific domain name. The bucket domain name including the region name. Please refer to the S3 endpoints reference for format. Note: AWS CloudFront allows specifying an S3 region-specific endpoint when creating an S3 origin. This will prevent redirect issues from CloudFront to the S3 Origin URL. For more information, see the Virtual Hosted-Style Requests for Other Regions section in the AWS S3 User Guide.
- HostedZone stringId 
- Route 53 Hosted Zone ID for this bucket's region.
- Id string
- The provider-assigned unique ID for this managed resource.
- Region string
- AWS region this bucket resides in.
- map[string]string
- Map of tags assigned to the resource, including those inherited from the provider default_tagsconfiguration block.
- WebsiteDomain string
- (Deprecated) Domain of the website endpoint, if the bucket is configured with a website. If not, this will be an empty string. This is used to create Route 53 alias records. Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
- WebsiteEndpoint string
- (Deprecated) Website endpoint, if the bucket is configured with a website. If not, this will be an empty string. Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
- arn String
- ARN of the bucket. Will be of format arn:aws:s3:::bucketname.
- bucketDomain StringName 
- Bucket domain name. Will be of format bucketname.s3.amazonaws.com.
- bucketRegional StringDomain Name 
- The bucket region-specific domain name. The bucket domain name including the region name. Please refer to the S3 endpoints reference for format. Note: AWS CloudFront allows specifying an S3 region-specific endpoint when creating an S3 origin. This will prevent redirect issues from CloudFront to the S3 Origin URL. For more information, see the Virtual Hosted-Style Requests for Other Regions section in the AWS S3 User Guide.
- hostedZone StringId 
- Route 53 Hosted Zone ID for this bucket's region.
- id String
- The provider-assigned unique ID for this managed resource.
- region String
- AWS region this bucket resides in.
- Map<String,String>
- Map of tags assigned to the resource, including those inherited from the provider default_tagsconfiguration block.
- websiteDomain String
- (Deprecated) Domain of the website endpoint, if the bucket is configured with a website. If not, this will be an empty string. This is used to create Route 53 alias records. Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
- websiteEndpoint String
- (Deprecated) Website endpoint, if the bucket is configured with a website. If not, this will be an empty string. Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
- arn string
- ARN of the bucket. Will be of format arn:aws:s3:::bucketname.
- bucketDomain stringName 
- Bucket domain name. Will be of format bucketname.s3.amazonaws.com.
- bucketRegional stringDomain Name 
- The bucket region-specific domain name. The bucket domain name including the region name. Please refer to the S3 endpoints reference for format. Note: AWS CloudFront allows specifying an S3 region-specific endpoint when creating an S3 origin. This will prevent redirect issues from CloudFront to the S3 Origin URL. For more information, see the Virtual Hosted-Style Requests for Other Regions section in the AWS S3 User Guide.
- hostedZone stringId 
- Route 53 Hosted Zone ID for this bucket's region.
- id string
- The provider-assigned unique ID for this managed resource.
- region string
- AWS region this bucket resides in.
- {[key: string]: string}
- Map of tags assigned to the resource, including those inherited from the provider default_tagsconfiguration block.
- websiteDomain string
- (Deprecated) Domain of the website endpoint, if the bucket is configured with a website. If not, this will be an empty string. This is used to create Route 53 alias records. Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
- websiteEndpoint string
- (Deprecated) Website endpoint, if the bucket is configured with a website. If not, this will be an empty string. Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
- arn str
- ARN of the bucket. Will be of format arn:aws:s3:::bucketname.
- bucket_domain_ strname 
- Bucket domain name. Will be of format bucketname.s3.amazonaws.com.
- bucket_regional_ strdomain_ name 
- The bucket region-specific domain name. The bucket domain name including the region name. Please refer to the S3 endpoints reference for format. Note: AWS CloudFront allows specifying an S3 region-specific endpoint when creating an S3 origin. This will prevent redirect issues from CloudFront to the S3 Origin URL. For more information, see the Virtual Hosted-Style Requests for Other Regions section in the AWS S3 User Guide.
- hosted_zone_ strid 
- Route 53 Hosted Zone ID for this bucket's region.
- id str
- The provider-assigned unique ID for this managed resource.
- region str
- AWS region this bucket resides in.
- Mapping[str, str]
- Map of tags assigned to the resource, including those inherited from the provider default_tagsconfiguration block.
- website_domain str
- (Deprecated) Domain of the website endpoint, if the bucket is configured with a website. If not, this will be an empty string. This is used to create Route 53 alias records. Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
- website_endpoint str
- (Deprecated) Website endpoint, if the bucket is configured with a website. If not, this will be an empty string. Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
- arn String
- ARN of the bucket. Will be of format arn:aws:s3:::bucketname.
- bucketDomain StringName 
- Bucket domain name. Will be of format bucketname.s3.amazonaws.com.
- bucketRegional StringDomain Name 
- The bucket region-specific domain name. The bucket domain name including the region name. Please refer to the S3 endpoints reference for format. Note: AWS CloudFront allows specifying an S3 region-specific endpoint when creating an S3 origin. This will prevent redirect issues from CloudFront to the S3 Origin URL. For more information, see the Virtual Hosted-Style Requests for Other Regions section in the AWS S3 User Guide.
- hostedZone StringId 
- Route 53 Hosted Zone ID for this bucket's region.
- id String
- The provider-assigned unique ID for this managed resource.
- region String
- AWS region this bucket resides in.
- Map<String>
- Map of tags assigned to the resource, including those inherited from the provider default_tagsconfiguration block.
- websiteDomain String
- (Deprecated) Domain of the website endpoint, if the bucket is configured with a website. If not, this will be an empty string. This is used to create Route 53 alias records. Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
- websiteEndpoint String
- (Deprecated) Website endpoint, if the bucket is configured with a website. If not, this will be an empty string. Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
Look up Existing BucketV2 Resource
Get an existing BucketV2 resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: BucketV2State, opts?: CustomResourceOptions): BucketV2@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        acceleration_status: Optional[str] = None,
        acl: Optional[str] = None,
        arn: Optional[str] = None,
        bucket: Optional[str] = None,
        bucket_domain_name: Optional[str] = None,
        bucket_prefix: Optional[str] = None,
        bucket_regional_domain_name: Optional[str] = None,
        cors_rules: Optional[Sequence[BucketV2CorsRuleArgs]] = None,
        force_destroy: Optional[bool] = None,
        grants: Optional[Sequence[BucketV2GrantArgs]] = None,
        hosted_zone_id: Optional[str] = None,
        lifecycle_rules: Optional[Sequence[BucketV2LifecycleRuleArgs]] = None,
        loggings: Optional[Sequence[BucketV2LoggingArgs]] = None,
        object_lock_configuration: Optional[BucketV2ObjectLockConfigurationArgs] = None,
        object_lock_enabled: Optional[bool] = None,
        policy: Optional[str] = None,
        region: Optional[str] = None,
        replication_configurations: Optional[Sequence[BucketV2ReplicationConfigurationArgs]] = None,
        request_payer: Optional[str] = None,
        server_side_encryption_configurations: Optional[Sequence[BucketV2ServerSideEncryptionConfigurationArgs]] = None,
        tags: Optional[Mapping[str, str]] = None,
        tags_all: Optional[Mapping[str, str]] = None,
        versionings: Optional[Sequence[BucketV2VersioningArgs]] = None,
        website_domain: Optional[str] = None,
        website_endpoint: Optional[str] = None,
        websites: Optional[Sequence[BucketV2WebsiteArgs]] = None) -> BucketV2func GetBucketV2(ctx *Context, name string, id IDInput, state *BucketV2State, opts ...ResourceOption) (*BucketV2, error)public static BucketV2 Get(string name, Input<string> id, BucketV2State? state, CustomResourceOptions? opts = null)public static BucketV2 get(String name, Output<String> id, BucketV2State state, CustomResourceOptions options)resources:  _:    type: aws:s3:BucketV2    get:      id: ${id}- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- AccelerationStatus string
- Sets the accelerate configuration of an existing bucket. Can be EnabledorSuspended. Cannot be used incn-north-1orus-gov-west-1. This provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAccelerateConfigurationV2instead.
- Acl string
- The canned ACL to apply. Valid values are private,public-read,public-read-write,aws-exec-read,authenticated-read, andlog-delivery-write. Defaults toprivate. Conflicts withgrant. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAclV2instead.
- Arn string
- ARN of the bucket. Will be of format arn:aws:s3:::bucketname.
- Bucket string
- Name of the bucket. If omitted, the provider will assign a random, unique name. Must be lowercase and less than or equal to 63 characters in length. A full list of bucket naming rules may be found here. The name must not be in the format [bucket_name]--[azid]--x-s3. Use theaws.s3.DirectoryBucketresource to manage S3 Express buckets.
- BucketDomain stringName 
- Bucket domain name. Will be of format bucketname.s3.amazonaws.com.
- BucketPrefix string
- Creates a unique bucket name beginning with the specified prefix. Conflicts with bucket. Must be lowercase and less than or equal to 37 characters in length. A full list of bucket naming rules may be found here.
- BucketRegional stringDomain Name 
- The bucket region-specific domain name. The bucket domain name including the region name. Please refer to the S3 endpoints reference for format. Note: AWS CloudFront allows specifying an S3 region-specific endpoint when creating an S3 origin. This will prevent redirect issues from CloudFront to the S3 Origin URL. For more information, see the Virtual Hosted-Style Requests for Other Regions section in the AWS S3 User Guide.
- CorsRules List<BucketV2Cors Rule> 
- Rule of Cross-Origin Resource Sharing. See CORS rule below for details. This provider will only perform drift detection if a configuration value is provided. Use the resource aws.s3.BucketCorsConfigurationV2instead.
- ForceDestroy bool
- Boolean that indicates all objects (including any locked objects) should be deleted from the bucket when the bucket is destroyed so that the bucket can be destroyed without error. These objects are not recoverable. This only deletes objects when the bucket is destroyed, not when setting this parameter to true. Once this parameter is set totrue, there must be a successfulpulumi uprun before a destroy is required to update this value in the resource state. Without a successfulpulumi upafter this parameter is set, this flag will have no effect. If setting this field in the same operation that would require replacing the bucket or destroying the bucket, this flag will not work. Additionally when importing a bucket, a successfulpulumi upis required to set this value in state before it will take effect on a destroy operation.
- Grants
List<BucketV2Grant> 
- An ACL policy grant. See Grant below for details. Conflicts with acl. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAclV2instead.
- HostedZone stringId 
- Route 53 Hosted Zone ID for this bucket's region.
- LifecycleRules List<BucketV2Lifecycle Rule> 
- Configuration of object lifecycle management. See Lifecycle Rule below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketLifecycleConfigurationV2instead.
- Loggings
List<BucketV2Logging> 
- Configuration of S3 bucket logging parameters. See Logging below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketLoggingV2instead.
- ObjectLock BucketConfiguration V2Object Lock Configuration 
- Configuration of S3 object locking. See Object Lock Configuration below for details.
The provider wil only perform drift detection if a configuration value is provided.
Use the object_lock_enabledparameter and the resourceaws.s3.BucketObjectLockConfigurationV2instead.
- ObjectLock boolEnabled 
- Indicates whether this bucket has an Object Lock configuration enabled. Valid values are trueorfalse. This argument is not supported in all regions or partitions.
- Policy string
- Valid bucket policy JSON document. Note that if the policy document is not specific enough (but still valid), this provider may view the policy as constantly changing. In this case, please make sure you use the verbose/specific version of the policy. For more information about building AWS IAM policy documents with this provider, see the AWS IAM Policy Document Guide.
The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketPolicyinstead.
- Region string
- AWS region this bucket resides in.
- ReplicationConfigurations List<BucketV2Replication Configuration> 
- Configuration of replication configuration. See Replication Configuration below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketReplicationConfiginstead.
- RequestPayer string
- Specifies who should bear the cost of Amazon S3 data transfer.
Can be either BucketOwnerorRequester. By default, the owner of the S3 bucket would incur the costs of any data transfer. See Requester Pays Buckets developer guide for more information. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketRequestPaymentConfigurationV2instead.
- ServerSide List<BucketEncryption Configurations V2Server Side Encryption Configuration> 
- Configuration of server-side encryption configuration. See Server Side Encryption Configuration below for details.
The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketServerSideEncryptionConfigurationV2instead.
- Dictionary<string, string>
- Map of tags to assign to the bucket. If configured with a provider - default_tagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level.- The following arguments are deprecated, and will be removed in a future major version: 
- Dictionary<string, string>
- Map of tags assigned to the resource, including those inherited from the provider default_tagsconfiguration block.
- Versionings
List<BucketV2Versioning> 
- Configuration of the S3 bucket versioning state. See Versioning below for details. The provider will only perform drift detection if a configuration value is provided. Use the resource aws.s3.BucketVersioningV2instead.
- WebsiteDomain string
- (Deprecated) Domain of the website endpoint, if the bucket is configured with a website. If not, this will be an empty string. This is used to create Route 53 alias records. Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
- WebsiteEndpoint string
- (Deprecated) Website endpoint, if the bucket is configured with a website. If not, this will be an empty string. Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
- Websites
List<BucketV2Website> 
- Configuration of the S3 bucket website. See Website below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
- AccelerationStatus string
- Sets the accelerate configuration of an existing bucket. Can be EnabledorSuspended. Cannot be used incn-north-1orus-gov-west-1. This provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAccelerateConfigurationV2instead.
- Acl string
- The canned ACL to apply. Valid values are private,public-read,public-read-write,aws-exec-read,authenticated-read, andlog-delivery-write. Defaults toprivate. Conflicts withgrant. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAclV2instead.
- Arn string
- ARN of the bucket. Will be of format arn:aws:s3:::bucketname.
- Bucket string
- Name of the bucket. If omitted, the provider will assign a random, unique name. Must be lowercase and less than or equal to 63 characters in length. A full list of bucket naming rules may be found here. The name must not be in the format [bucket_name]--[azid]--x-s3. Use theaws.s3.DirectoryBucketresource to manage S3 Express buckets.
- BucketDomain stringName 
- Bucket domain name. Will be of format bucketname.s3.amazonaws.com.
- BucketPrefix string
- Creates a unique bucket name beginning with the specified prefix. Conflicts with bucket. Must be lowercase and less than or equal to 37 characters in length. A full list of bucket naming rules may be found here.
- BucketRegional stringDomain Name 
- The bucket region-specific domain name. The bucket domain name including the region name. Please refer to the S3 endpoints reference for format. Note: AWS CloudFront allows specifying an S3 region-specific endpoint when creating an S3 origin. This will prevent redirect issues from CloudFront to the S3 Origin URL. For more information, see the Virtual Hosted-Style Requests for Other Regions section in the AWS S3 User Guide.
- CorsRules []BucketV2Cors Rule Args 
- Rule of Cross-Origin Resource Sharing. See CORS rule below for details. This provider will only perform drift detection if a configuration value is provided. Use the resource aws.s3.BucketCorsConfigurationV2instead.
- ForceDestroy bool
- Boolean that indicates all objects (including any locked objects) should be deleted from the bucket when the bucket is destroyed so that the bucket can be destroyed without error. These objects are not recoverable. This only deletes objects when the bucket is destroyed, not when setting this parameter to true. Once this parameter is set totrue, there must be a successfulpulumi uprun before a destroy is required to update this value in the resource state. Without a successfulpulumi upafter this parameter is set, this flag will have no effect. If setting this field in the same operation that would require replacing the bucket or destroying the bucket, this flag will not work. Additionally when importing a bucket, a successfulpulumi upis required to set this value in state before it will take effect on a destroy operation.
- Grants
[]BucketV2Grant Args 
- An ACL policy grant. See Grant below for details. Conflicts with acl. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAclV2instead.
- HostedZone stringId 
- Route 53 Hosted Zone ID for this bucket's region.
- LifecycleRules []BucketV2Lifecycle Rule Args 
- Configuration of object lifecycle management. See Lifecycle Rule below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketLifecycleConfigurationV2instead.
- Loggings
[]BucketV2Logging Args 
- Configuration of S3 bucket logging parameters. See Logging below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketLoggingV2instead.
- ObjectLock BucketConfiguration V2Object Lock Configuration Args 
- Configuration of S3 object locking. See Object Lock Configuration below for details.
The provider wil only perform drift detection if a configuration value is provided.
Use the object_lock_enabledparameter and the resourceaws.s3.BucketObjectLockConfigurationV2instead.
- ObjectLock boolEnabled 
- Indicates whether this bucket has an Object Lock configuration enabled. Valid values are trueorfalse. This argument is not supported in all regions or partitions.
- Policy string
- Valid bucket policy JSON document. Note that if the policy document is not specific enough (but still valid), this provider may view the policy as constantly changing. In this case, please make sure you use the verbose/specific version of the policy. For more information about building AWS IAM policy documents with this provider, see the AWS IAM Policy Document Guide.
The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketPolicyinstead.
- Region string
- AWS region this bucket resides in.
- ReplicationConfigurations []BucketV2Replication Configuration Args 
- Configuration of replication configuration. See Replication Configuration below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketReplicationConfiginstead.
- RequestPayer string
- Specifies who should bear the cost of Amazon S3 data transfer.
Can be either BucketOwnerorRequester. By default, the owner of the S3 bucket would incur the costs of any data transfer. See Requester Pays Buckets developer guide for more information. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketRequestPaymentConfigurationV2instead.
- ServerSide []BucketEncryption Configurations V2Server Side Encryption Configuration Args 
- Configuration of server-side encryption configuration. See Server Side Encryption Configuration below for details.
The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketServerSideEncryptionConfigurationV2instead.
- map[string]string
- Map of tags to assign to the bucket. If configured with a provider - default_tagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level.- The following arguments are deprecated, and will be removed in a future major version: 
- map[string]string
- Map of tags assigned to the resource, including those inherited from the provider default_tagsconfiguration block.
- Versionings
[]BucketV2Versioning Args 
- Configuration of the S3 bucket versioning state. See Versioning below for details. The provider will only perform drift detection if a configuration value is provided. Use the resource aws.s3.BucketVersioningV2instead.
- WebsiteDomain string
- (Deprecated) Domain of the website endpoint, if the bucket is configured with a website. If not, this will be an empty string. This is used to create Route 53 alias records. Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
- WebsiteEndpoint string
- (Deprecated) Website endpoint, if the bucket is configured with a website. If not, this will be an empty string. Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
- Websites
[]BucketV2Website Args 
- Configuration of the S3 bucket website. See Website below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
- accelerationStatus String
- Sets the accelerate configuration of an existing bucket. Can be EnabledorSuspended. Cannot be used incn-north-1orus-gov-west-1. This provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAccelerateConfigurationV2instead.
- acl String
- The canned ACL to apply. Valid values are private,public-read,public-read-write,aws-exec-read,authenticated-read, andlog-delivery-write. Defaults toprivate. Conflicts withgrant. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAclV2instead.
- arn String
- ARN of the bucket. Will be of format arn:aws:s3:::bucketname.
- bucket String
- Name of the bucket. If omitted, the provider will assign a random, unique name. Must be lowercase and less than or equal to 63 characters in length. A full list of bucket naming rules may be found here. The name must not be in the format [bucket_name]--[azid]--x-s3. Use theaws.s3.DirectoryBucketresource to manage S3 Express buckets.
- bucketDomain StringName 
- Bucket domain name. Will be of format bucketname.s3.amazonaws.com.
- bucketPrefix String
- Creates a unique bucket name beginning with the specified prefix. Conflicts with bucket. Must be lowercase and less than or equal to 37 characters in length. A full list of bucket naming rules may be found here.
- bucketRegional StringDomain Name 
- The bucket region-specific domain name. The bucket domain name including the region name. Please refer to the S3 endpoints reference for format. Note: AWS CloudFront allows specifying an S3 region-specific endpoint when creating an S3 origin. This will prevent redirect issues from CloudFront to the S3 Origin URL. For more information, see the Virtual Hosted-Style Requests for Other Regions section in the AWS S3 User Guide.
- corsRules List<BucketV2Cors Rule> 
- Rule of Cross-Origin Resource Sharing. See CORS rule below for details. This provider will only perform drift detection if a configuration value is provided. Use the resource aws.s3.BucketCorsConfigurationV2instead.
- forceDestroy Boolean
- Boolean that indicates all objects (including any locked objects) should be deleted from the bucket when the bucket is destroyed so that the bucket can be destroyed without error. These objects are not recoverable. This only deletes objects when the bucket is destroyed, not when setting this parameter to true. Once this parameter is set totrue, there must be a successfulpulumi uprun before a destroy is required to update this value in the resource state. Without a successfulpulumi upafter this parameter is set, this flag will have no effect. If setting this field in the same operation that would require replacing the bucket or destroying the bucket, this flag will not work. Additionally when importing a bucket, a successfulpulumi upis required to set this value in state before it will take effect on a destroy operation.
- grants
List<BucketV2Grant> 
- An ACL policy grant. See Grant below for details. Conflicts with acl. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAclV2instead.
- hostedZone StringId 
- Route 53 Hosted Zone ID for this bucket's region.
- lifecycleRules List<BucketV2Lifecycle Rule> 
- Configuration of object lifecycle management. See Lifecycle Rule below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketLifecycleConfigurationV2instead.
- loggings
List<BucketV2Logging> 
- Configuration of S3 bucket logging parameters. See Logging below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketLoggingV2instead.
- objectLock BucketConfiguration V2Object Lock Configuration 
- Configuration of S3 object locking. See Object Lock Configuration below for details.
The provider wil only perform drift detection if a configuration value is provided.
Use the object_lock_enabledparameter and the resourceaws.s3.BucketObjectLockConfigurationV2instead.
- objectLock BooleanEnabled 
- Indicates whether this bucket has an Object Lock configuration enabled. Valid values are trueorfalse. This argument is not supported in all regions or partitions.
- policy String
- Valid bucket policy JSON document. Note that if the policy document is not specific enough (but still valid), this provider may view the policy as constantly changing. In this case, please make sure you use the verbose/specific version of the policy. For more information about building AWS IAM policy documents with this provider, see the AWS IAM Policy Document Guide.
The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketPolicyinstead.
- region String
- AWS region this bucket resides in.
- replicationConfigurations List<BucketV2Replication Configuration> 
- Configuration of replication configuration. See Replication Configuration below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketReplicationConfiginstead.
- requestPayer String
- Specifies who should bear the cost of Amazon S3 data transfer.
Can be either BucketOwnerorRequester. By default, the owner of the S3 bucket would incur the costs of any data transfer. See Requester Pays Buckets developer guide for more information. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketRequestPaymentConfigurationV2instead.
- serverSide List<BucketEncryption Configurations V2Server Side Encryption Configuration> 
- Configuration of server-side encryption configuration. See Server Side Encryption Configuration below for details.
The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketServerSideEncryptionConfigurationV2instead.
- Map<String,String>
- Map of tags to assign to the bucket. If configured with a provider - default_tagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level.- The following arguments are deprecated, and will be removed in a future major version: 
- Map<String,String>
- Map of tags assigned to the resource, including those inherited from the provider default_tagsconfiguration block.
- versionings
List<BucketV2Versioning> 
- Configuration of the S3 bucket versioning state. See Versioning below for details. The provider will only perform drift detection if a configuration value is provided. Use the resource aws.s3.BucketVersioningV2instead.
- websiteDomain String
- (Deprecated) Domain of the website endpoint, if the bucket is configured with a website. If not, this will be an empty string. This is used to create Route 53 alias records. Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
- websiteEndpoint String
- (Deprecated) Website endpoint, if the bucket is configured with a website. If not, this will be an empty string. Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
- websites
List<BucketV2Website> 
- Configuration of the S3 bucket website. See Website below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
- accelerationStatus string
- Sets the accelerate configuration of an existing bucket. Can be EnabledorSuspended. Cannot be used incn-north-1orus-gov-west-1. This provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAccelerateConfigurationV2instead.
- acl string
- The canned ACL to apply. Valid values are private,public-read,public-read-write,aws-exec-read,authenticated-read, andlog-delivery-write. Defaults toprivate. Conflicts withgrant. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAclV2instead.
- arn string
- ARN of the bucket. Will be of format arn:aws:s3:::bucketname.
- bucket string
- Name of the bucket. If omitted, the provider will assign a random, unique name. Must be lowercase and less than or equal to 63 characters in length. A full list of bucket naming rules may be found here. The name must not be in the format [bucket_name]--[azid]--x-s3. Use theaws.s3.DirectoryBucketresource to manage S3 Express buckets.
- bucketDomain stringName 
- Bucket domain name. Will be of format bucketname.s3.amazonaws.com.
- bucketPrefix string
- Creates a unique bucket name beginning with the specified prefix. Conflicts with bucket. Must be lowercase and less than or equal to 37 characters in length. A full list of bucket naming rules may be found here.
- bucketRegional stringDomain Name 
- The bucket region-specific domain name. The bucket domain name including the region name. Please refer to the S3 endpoints reference for format. Note: AWS CloudFront allows specifying an S3 region-specific endpoint when creating an S3 origin. This will prevent redirect issues from CloudFront to the S3 Origin URL. For more information, see the Virtual Hosted-Style Requests for Other Regions section in the AWS S3 User Guide.
- corsRules BucketV2Cors Rule[] 
- Rule of Cross-Origin Resource Sharing. See CORS rule below for details. This provider will only perform drift detection if a configuration value is provided. Use the resource aws.s3.BucketCorsConfigurationV2instead.
- forceDestroy boolean
- Boolean that indicates all objects (including any locked objects) should be deleted from the bucket when the bucket is destroyed so that the bucket can be destroyed without error. These objects are not recoverable. This only deletes objects when the bucket is destroyed, not when setting this parameter to true. Once this parameter is set totrue, there must be a successfulpulumi uprun before a destroy is required to update this value in the resource state. Without a successfulpulumi upafter this parameter is set, this flag will have no effect. If setting this field in the same operation that would require replacing the bucket or destroying the bucket, this flag will not work. Additionally when importing a bucket, a successfulpulumi upis required to set this value in state before it will take effect on a destroy operation.
- grants
BucketV2Grant[] 
- An ACL policy grant. See Grant below for details. Conflicts with acl. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAclV2instead.
- hostedZone stringId 
- Route 53 Hosted Zone ID for this bucket's region.
- lifecycleRules BucketV2Lifecycle Rule[] 
- Configuration of object lifecycle management. See Lifecycle Rule below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketLifecycleConfigurationV2instead.
- loggings
BucketV2Logging[] 
- Configuration of S3 bucket logging parameters. See Logging below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketLoggingV2instead.
- objectLock BucketConfiguration V2Object Lock Configuration 
- Configuration of S3 object locking. See Object Lock Configuration below for details.
The provider wil only perform drift detection if a configuration value is provided.
Use the object_lock_enabledparameter and the resourceaws.s3.BucketObjectLockConfigurationV2instead.
- objectLock booleanEnabled 
- Indicates whether this bucket has an Object Lock configuration enabled. Valid values are trueorfalse. This argument is not supported in all regions or partitions.
- policy string
- Valid bucket policy JSON document. Note that if the policy document is not specific enough (but still valid), this provider may view the policy as constantly changing. In this case, please make sure you use the verbose/specific version of the policy. For more information about building AWS IAM policy documents with this provider, see the AWS IAM Policy Document Guide.
The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketPolicyinstead.
- region string
- AWS region this bucket resides in.
- replicationConfigurations BucketV2Replication Configuration[] 
- Configuration of replication configuration. See Replication Configuration below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketReplicationConfiginstead.
- requestPayer string
- Specifies who should bear the cost of Amazon S3 data transfer.
Can be either BucketOwnerorRequester. By default, the owner of the S3 bucket would incur the costs of any data transfer. See Requester Pays Buckets developer guide for more information. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketRequestPaymentConfigurationV2instead.
- serverSide BucketEncryption Configurations V2Server Side Encryption Configuration[] 
- Configuration of server-side encryption configuration. See Server Side Encryption Configuration below for details.
The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketServerSideEncryptionConfigurationV2instead.
- {[key: string]: string}
- Map of tags to assign to the bucket. If configured with a provider - default_tagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level.- The following arguments are deprecated, and will be removed in a future major version: 
- {[key: string]: string}
- Map of tags assigned to the resource, including those inherited from the provider default_tagsconfiguration block.
- versionings
BucketV2Versioning[] 
- Configuration of the S3 bucket versioning state. See Versioning below for details. The provider will only perform drift detection if a configuration value is provided. Use the resource aws.s3.BucketVersioningV2instead.
- websiteDomain string
- (Deprecated) Domain of the website endpoint, if the bucket is configured with a website. If not, this will be an empty string. This is used to create Route 53 alias records. Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
- websiteEndpoint string
- (Deprecated) Website endpoint, if the bucket is configured with a website. If not, this will be an empty string. Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
- websites
BucketV2Website[] 
- Configuration of the S3 bucket website. See Website below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
- acceleration_status str
- Sets the accelerate configuration of an existing bucket. Can be EnabledorSuspended. Cannot be used incn-north-1orus-gov-west-1. This provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAccelerateConfigurationV2instead.
- acl str
- The canned ACL to apply. Valid values are private,public-read,public-read-write,aws-exec-read,authenticated-read, andlog-delivery-write. Defaults toprivate. Conflicts withgrant. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAclV2instead.
- arn str
- ARN of the bucket. Will be of format arn:aws:s3:::bucketname.
- bucket str
- Name of the bucket. If omitted, the provider will assign a random, unique name. Must be lowercase and less than or equal to 63 characters in length. A full list of bucket naming rules may be found here. The name must not be in the format [bucket_name]--[azid]--x-s3. Use theaws.s3.DirectoryBucketresource to manage S3 Express buckets.
- bucket_domain_ strname 
- Bucket domain name. Will be of format bucketname.s3.amazonaws.com.
- bucket_prefix str
- Creates a unique bucket name beginning with the specified prefix. Conflicts with bucket. Must be lowercase and less than or equal to 37 characters in length. A full list of bucket naming rules may be found here.
- bucket_regional_ strdomain_ name 
- The bucket region-specific domain name. The bucket domain name including the region name. Please refer to the S3 endpoints reference for format. Note: AWS CloudFront allows specifying an S3 region-specific endpoint when creating an S3 origin. This will prevent redirect issues from CloudFront to the S3 Origin URL. For more information, see the Virtual Hosted-Style Requests for Other Regions section in the AWS S3 User Guide.
- cors_rules Sequence[BucketV2Cors Rule Args] 
- Rule of Cross-Origin Resource Sharing. See CORS rule below for details. This provider will only perform drift detection if a configuration value is provided. Use the resource aws.s3.BucketCorsConfigurationV2instead.
- force_destroy bool
- Boolean that indicates all objects (including any locked objects) should be deleted from the bucket when the bucket is destroyed so that the bucket can be destroyed without error. These objects are not recoverable. This only deletes objects when the bucket is destroyed, not when setting this parameter to true. Once this parameter is set totrue, there must be a successfulpulumi uprun before a destroy is required to update this value in the resource state. Without a successfulpulumi upafter this parameter is set, this flag will have no effect. If setting this field in the same operation that would require replacing the bucket or destroying the bucket, this flag will not work. Additionally when importing a bucket, a successfulpulumi upis required to set this value in state before it will take effect on a destroy operation.
- grants
Sequence[BucketV2Grant Args] 
- An ACL policy grant. See Grant below for details. Conflicts with acl. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAclV2instead.
- hosted_zone_ strid 
- Route 53 Hosted Zone ID for this bucket's region.
- lifecycle_rules Sequence[BucketV2Lifecycle Rule Args] 
- Configuration of object lifecycle management. See Lifecycle Rule below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketLifecycleConfigurationV2instead.
- loggings
Sequence[BucketV2Logging Args] 
- Configuration of S3 bucket logging parameters. See Logging below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketLoggingV2instead.
- object_lock_ Bucketconfiguration V2Object Lock Configuration Args 
- Configuration of S3 object locking. See Object Lock Configuration below for details.
The provider wil only perform drift detection if a configuration value is provided.
Use the object_lock_enabledparameter and the resourceaws.s3.BucketObjectLockConfigurationV2instead.
- object_lock_ boolenabled 
- Indicates whether this bucket has an Object Lock configuration enabled. Valid values are trueorfalse. This argument is not supported in all regions or partitions.
- policy str
- Valid bucket policy JSON document. Note that if the policy document is not specific enough (but still valid), this provider may view the policy as constantly changing. In this case, please make sure you use the verbose/specific version of the policy. For more information about building AWS IAM policy documents with this provider, see the AWS IAM Policy Document Guide.
The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketPolicyinstead.
- region str
- AWS region this bucket resides in.
- replication_configurations Sequence[BucketV2Replication Configuration Args] 
- Configuration of replication configuration. See Replication Configuration below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketReplicationConfiginstead.
- request_payer str
- Specifies who should bear the cost of Amazon S3 data transfer.
Can be either BucketOwnerorRequester. By default, the owner of the S3 bucket would incur the costs of any data transfer. See Requester Pays Buckets developer guide for more information. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketRequestPaymentConfigurationV2instead.
- server_side_ Sequence[Bucketencryption_ configurations V2Server Side Encryption Configuration Args] 
- Configuration of server-side encryption configuration. See Server Side Encryption Configuration below for details.
The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketServerSideEncryptionConfigurationV2instead.
- Mapping[str, str]
- Map of tags to assign to the bucket. If configured with a provider - default_tagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level.- The following arguments are deprecated, and will be removed in a future major version: 
- Mapping[str, str]
- Map of tags assigned to the resource, including those inherited from the provider default_tagsconfiguration block.
- versionings
Sequence[BucketV2Versioning Args] 
- Configuration of the S3 bucket versioning state. See Versioning below for details. The provider will only perform drift detection if a configuration value is provided. Use the resource aws.s3.BucketVersioningV2instead.
- website_domain str
- (Deprecated) Domain of the website endpoint, if the bucket is configured with a website. If not, this will be an empty string. This is used to create Route 53 alias records. Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
- website_endpoint str
- (Deprecated) Website endpoint, if the bucket is configured with a website. If not, this will be an empty string. Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
- websites
Sequence[BucketV2Website Args] 
- Configuration of the S3 bucket website. See Website below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
- accelerationStatus String
- Sets the accelerate configuration of an existing bucket. Can be EnabledorSuspended. Cannot be used incn-north-1orus-gov-west-1. This provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAccelerateConfigurationV2instead.
- acl String
- The canned ACL to apply. Valid values are private,public-read,public-read-write,aws-exec-read,authenticated-read, andlog-delivery-write. Defaults toprivate. Conflicts withgrant. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAclV2instead.
- arn String
- ARN of the bucket. Will be of format arn:aws:s3:::bucketname.
- bucket String
- Name of the bucket. If omitted, the provider will assign a random, unique name. Must be lowercase and less than or equal to 63 characters in length. A full list of bucket naming rules may be found here. The name must not be in the format [bucket_name]--[azid]--x-s3. Use theaws.s3.DirectoryBucketresource to manage S3 Express buckets.
- bucketDomain StringName 
- Bucket domain name. Will be of format bucketname.s3.amazonaws.com.
- bucketPrefix String
- Creates a unique bucket name beginning with the specified prefix. Conflicts with bucket. Must be lowercase and less than or equal to 37 characters in length. A full list of bucket naming rules may be found here.
- bucketRegional StringDomain Name 
- The bucket region-specific domain name. The bucket domain name including the region name. Please refer to the S3 endpoints reference for format. Note: AWS CloudFront allows specifying an S3 region-specific endpoint when creating an S3 origin. This will prevent redirect issues from CloudFront to the S3 Origin URL. For more information, see the Virtual Hosted-Style Requests for Other Regions section in the AWS S3 User Guide.
- corsRules List<Property Map>
- Rule of Cross-Origin Resource Sharing. See CORS rule below for details. This provider will only perform drift detection if a configuration value is provided. Use the resource aws.s3.BucketCorsConfigurationV2instead.
- forceDestroy Boolean
- Boolean that indicates all objects (including any locked objects) should be deleted from the bucket when the bucket is destroyed so that the bucket can be destroyed without error. These objects are not recoverable. This only deletes objects when the bucket is destroyed, not when setting this parameter to true. Once this parameter is set totrue, there must be a successfulpulumi uprun before a destroy is required to update this value in the resource state. Without a successfulpulumi upafter this parameter is set, this flag will have no effect. If setting this field in the same operation that would require replacing the bucket or destroying the bucket, this flag will not work. Additionally when importing a bucket, a successfulpulumi upis required to set this value in state before it will take effect on a destroy operation.
- grants List<Property Map>
- An ACL policy grant. See Grant below for details. Conflicts with acl. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAclV2instead.
- hostedZone StringId 
- Route 53 Hosted Zone ID for this bucket's region.
- lifecycleRules List<Property Map>
- Configuration of object lifecycle management. See Lifecycle Rule below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketLifecycleConfigurationV2instead.
- loggings List<Property Map>
- Configuration of S3 bucket logging parameters. See Logging below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketLoggingV2instead.
- objectLock Property MapConfiguration 
- Configuration of S3 object locking. See Object Lock Configuration below for details.
The provider wil only perform drift detection if a configuration value is provided.
Use the object_lock_enabledparameter and the resourceaws.s3.BucketObjectLockConfigurationV2instead.
- objectLock BooleanEnabled 
- Indicates whether this bucket has an Object Lock configuration enabled. Valid values are trueorfalse. This argument is not supported in all regions or partitions.
- policy String
- Valid bucket policy JSON document. Note that if the policy document is not specific enough (but still valid), this provider may view the policy as constantly changing. In this case, please make sure you use the verbose/specific version of the policy. For more information about building AWS IAM policy documents with this provider, see the AWS IAM Policy Document Guide.
The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketPolicyinstead.
- region String
- AWS region this bucket resides in.
- replicationConfigurations List<Property Map>
- Configuration of replication configuration. See Replication Configuration below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketReplicationConfiginstead.
- requestPayer String
- Specifies who should bear the cost of Amazon S3 data transfer.
Can be either BucketOwnerorRequester. By default, the owner of the S3 bucket would incur the costs of any data transfer. See Requester Pays Buckets developer guide for more information. The provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketRequestPaymentConfigurationV2instead.
- serverSide List<Property Map>Encryption Configurations 
- Configuration of server-side encryption configuration. See Server Side Encryption Configuration below for details.
The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketServerSideEncryptionConfigurationV2instead.
- Map<String>
- Map of tags to assign to the bucket. If configured with a provider - default_tagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level.- The following arguments are deprecated, and will be removed in a future major version: 
- Map<String>
- Map of tags assigned to the resource, including those inherited from the provider default_tagsconfiguration block.
- versionings List<Property Map>
- Configuration of the S3 bucket versioning state. See Versioning below for details. The provider will only perform drift detection if a configuration value is provided. Use the resource aws.s3.BucketVersioningV2instead.
- websiteDomain String
- (Deprecated) Domain of the website endpoint, if the bucket is configured with a website. If not, this will be an empty string. This is used to create Route 53 alias records. Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
- websiteEndpoint String
- (Deprecated) Website endpoint, if the bucket is configured with a website. If not, this will be an empty string. Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
- websites List<Property Map>
- Configuration of the S3 bucket website. See Website below for details. The provider will only perform drift detection if a configuration value is provided.
Use the resource aws.s3.BucketWebsiteConfigurationV2instead.
Supporting Types
BucketV2CorsRule, BucketV2CorsRuleArgs      
- AllowedMethods List<string>
- One or more HTTP methods that you allow the origin to execute. Can be GET,PUT,POST,DELETEorHEAD.
- AllowedOrigins List<string>
- One or more origins you want customers to be able to access the bucket from.
- AllowedHeaders List<string>
- List of headers allowed.
- ExposeHeaders List<string>
- One or more headers in the response that you want customers to be able to access from their applications (for example, from a JavaScript XMLHttpRequestobject).
- MaxAge intSeconds 
- Specifies time in seconds that browser can cache the response for a preflight request.
- AllowedMethods []string
- One or more HTTP methods that you allow the origin to execute. Can be GET,PUT,POST,DELETEorHEAD.
- AllowedOrigins []string
- One or more origins you want customers to be able to access the bucket from.
- AllowedHeaders []string
- List of headers allowed.
- ExposeHeaders []string
- One or more headers in the response that you want customers to be able to access from their applications (for example, from a JavaScript XMLHttpRequestobject).
- MaxAge intSeconds 
- Specifies time in seconds that browser can cache the response for a preflight request.
- allowedMethods List<String>
- One or more HTTP methods that you allow the origin to execute. Can be GET,PUT,POST,DELETEorHEAD.
- allowedOrigins List<String>
- One or more origins you want customers to be able to access the bucket from.
- allowedHeaders List<String>
- List of headers allowed.
- exposeHeaders List<String>
- One or more headers in the response that you want customers to be able to access from their applications (for example, from a JavaScript XMLHttpRequestobject).
- maxAge IntegerSeconds 
- Specifies time in seconds that browser can cache the response for a preflight request.
- allowedMethods string[]
- One or more HTTP methods that you allow the origin to execute. Can be GET,PUT,POST,DELETEorHEAD.
- allowedOrigins string[]
- One or more origins you want customers to be able to access the bucket from.
- allowedHeaders string[]
- List of headers allowed.
- exposeHeaders string[]
- One or more headers in the response that you want customers to be able to access from their applications (for example, from a JavaScript XMLHttpRequestobject).
- maxAge numberSeconds 
- Specifies time in seconds that browser can cache the response for a preflight request.
- allowed_methods Sequence[str]
- One or more HTTP methods that you allow the origin to execute. Can be GET,PUT,POST,DELETEorHEAD.
- allowed_origins Sequence[str]
- One or more origins you want customers to be able to access the bucket from.
- allowed_headers Sequence[str]
- List of headers allowed.
- expose_headers Sequence[str]
- One or more headers in the response that you want customers to be able to access from their applications (for example, from a JavaScript XMLHttpRequestobject).
- max_age_ intseconds 
- Specifies time in seconds that browser can cache the response for a preflight request.
- allowedMethods List<String>
- One or more HTTP methods that you allow the origin to execute. Can be GET,PUT,POST,DELETEorHEAD.
- allowedOrigins List<String>
- One or more origins you want customers to be able to access the bucket from.
- allowedHeaders List<String>
- List of headers allowed.
- exposeHeaders List<String>
- One or more headers in the response that you want customers to be able to access from their applications (for example, from a JavaScript XMLHttpRequestobject).
- maxAge NumberSeconds 
- Specifies time in seconds that browser can cache the response for a preflight request.
BucketV2Grant, BucketV2GrantArgs    
- Permissions List<string>
- List of permissions to apply for grantee. Valid values are READ,WRITE,READ_ACP,WRITE_ACP,FULL_CONTROL.
- Type string
- Type of grantee to apply for. Valid values are CanonicalUserandGroup.AmazonCustomerByEmailis not supported.
- Id string
- Canonical user id to grant for. Used only when typeisCanonicalUser.
- Uri string
- Uri address to grant for. Used only when typeisGroup.
- Permissions []string
- List of permissions to apply for grantee. Valid values are READ,WRITE,READ_ACP,WRITE_ACP,FULL_CONTROL.
- Type string
- Type of grantee to apply for. Valid values are CanonicalUserandGroup.AmazonCustomerByEmailis not supported.
- Id string
- Canonical user id to grant for. Used only when typeisCanonicalUser.
- Uri string
- Uri address to grant for. Used only when typeisGroup.
- permissions List<String>
- List of permissions to apply for grantee. Valid values are READ,WRITE,READ_ACP,WRITE_ACP,FULL_CONTROL.
- type String
- Type of grantee to apply for. Valid values are CanonicalUserandGroup.AmazonCustomerByEmailis not supported.
- id String
- Canonical user id to grant for. Used only when typeisCanonicalUser.
- uri String
- Uri address to grant for. Used only when typeisGroup.
- permissions string[]
- List of permissions to apply for grantee. Valid values are READ,WRITE,READ_ACP,WRITE_ACP,FULL_CONTROL.
- type string
- Type of grantee to apply for. Valid values are CanonicalUserandGroup.AmazonCustomerByEmailis not supported.
- id string
- Canonical user id to grant for. Used only when typeisCanonicalUser.
- uri string
- Uri address to grant for. Used only when typeisGroup.
- permissions Sequence[str]
- List of permissions to apply for grantee. Valid values are READ,WRITE,READ_ACP,WRITE_ACP,FULL_CONTROL.
- type str
- Type of grantee to apply for. Valid values are CanonicalUserandGroup.AmazonCustomerByEmailis not supported.
- id str
- Canonical user id to grant for. Used only when typeisCanonicalUser.
- uri str
- Uri address to grant for. Used only when typeisGroup.
- permissions List<String>
- List of permissions to apply for grantee. Valid values are READ,WRITE,READ_ACP,WRITE_ACP,FULL_CONTROL.
- type String
- Type of grantee to apply for. Valid values are CanonicalUserandGroup.AmazonCustomerByEmailis not supported.
- id String
- Canonical user id to grant for. Used only when typeisCanonicalUser.
- uri String
- Uri address to grant for. Used only when typeisGroup.
BucketV2LifecycleRule, BucketV2LifecycleRuleArgs      
- Enabled bool
- Specifies lifecycle rule status.
- AbortIncomplete intMultipart Upload Days 
- Specifies the number of days after initiating a multipart upload when the multipart upload must be completed.
- Expirations
List<BucketV2Lifecycle Rule Expiration> 
- Specifies a period in the object's expire. See Expiration below for details.
- Id string
- Unique identifier for the rule. Must be less than or equal to 255 characters in length.
- NoncurrentVersion List<BucketExpirations V2Lifecycle Rule Noncurrent Version Expiration> 
- Specifies when noncurrent object versions expire. See Noncurrent Version Expiration below for details.
- NoncurrentVersion List<BucketTransitions V2Lifecycle Rule Noncurrent Version Transition> 
- Specifies when noncurrent object versions transitions. See Noncurrent Version Transition below for details.
- Prefix string
- Object key prefix identifying one or more objects to which the rule applies.
- Dictionary<string, string>
- Specifies object tags key and value.
- Transitions
List<BucketV2Lifecycle Rule Transition> 
- Specifies a period in the object's transitions. See Transition below for details.
- Enabled bool
- Specifies lifecycle rule status.
- AbortIncomplete intMultipart Upload Days 
- Specifies the number of days after initiating a multipart upload when the multipart upload must be completed.
- Expirations
[]BucketV2Lifecycle Rule Expiration 
- Specifies a period in the object's expire. See Expiration below for details.
- Id string
- Unique identifier for the rule. Must be less than or equal to 255 characters in length.
- NoncurrentVersion []BucketExpirations V2Lifecycle Rule Noncurrent Version Expiration 
- Specifies when noncurrent object versions expire. See Noncurrent Version Expiration below for details.
- NoncurrentVersion []BucketTransitions V2Lifecycle Rule Noncurrent Version Transition 
- Specifies when noncurrent object versions transitions. See Noncurrent Version Transition below for details.
- Prefix string
- Object key prefix identifying one or more objects to which the rule applies.
- map[string]string
- Specifies object tags key and value.
- Transitions
[]BucketV2Lifecycle Rule Transition 
- Specifies a period in the object's transitions. See Transition below for details.
- enabled Boolean
- Specifies lifecycle rule status.
- abortIncomplete IntegerMultipart Upload Days 
- Specifies the number of days after initiating a multipart upload when the multipart upload must be completed.
- expirations
List<BucketV2Lifecycle Rule Expiration> 
- Specifies a period in the object's expire. See Expiration below for details.
- id String
- Unique identifier for the rule. Must be less than or equal to 255 characters in length.
- noncurrentVersion List<BucketExpirations V2Lifecycle Rule Noncurrent Version Expiration> 
- Specifies when noncurrent object versions expire. See Noncurrent Version Expiration below for details.
- noncurrentVersion List<BucketTransitions V2Lifecycle Rule Noncurrent Version Transition> 
- Specifies when noncurrent object versions transitions. See Noncurrent Version Transition below for details.
- prefix String
- Object key prefix identifying one or more objects to which the rule applies.
- Map<String,String>
- Specifies object tags key and value.
- transitions
List<BucketV2Lifecycle Rule Transition> 
- Specifies a period in the object's transitions. See Transition below for details.
- enabled boolean
- Specifies lifecycle rule status.
- abortIncomplete numberMultipart Upload Days 
- Specifies the number of days after initiating a multipart upload when the multipart upload must be completed.
- expirations
BucketV2Lifecycle Rule Expiration[] 
- Specifies a period in the object's expire. See Expiration below for details.
- id string
- Unique identifier for the rule. Must be less than or equal to 255 characters in length.
- noncurrentVersion BucketExpirations V2Lifecycle Rule Noncurrent Version Expiration[] 
- Specifies when noncurrent object versions expire. See Noncurrent Version Expiration below for details.
- noncurrentVersion BucketTransitions V2Lifecycle Rule Noncurrent Version Transition[] 
- Specifies when noncurrent object versions transitions. See Noncurrent Version Transition below for details.
- prefix string
- Object key prefix identifying one or more objects to which the rule applies.
- {[key: string]: string}
- Specifies object tags key and value.
- transitions
BucketV2Lifecycle Rule Transition[] 
- Specifies a period in the object's transitions. See Transition below for details.
- enabled bool
- Specifies lifecycle rule status.
- abort_incomplete_ intmultipart_ upload_ days 
- Specifies the number of days after initiating a multipart upload when the multipart upload must be completed.
- expirations
Sequence[BucketV2Lifecycle Rule Expiration] 
- Specifies a period in the object's expire. See Expiration below for details.
- id str
- Unique identifier for the rule. Must be less than or equal to 255 characters in length.
- noncurrent_version_ Sequence[Bucketexpirations V2Lifecycle Rule Noncurrent Version Expiration] 
- Specifies when noncurrent object versions expire. See Noncurrent Version Expiration below for details.
- noncurrent_version_ Sequence[Buckettransitions V2Lifecycle Rule Noncurrent Version Transition] 
- Specifies when noncurrent object versions transitions. See Noncurrent Version Transition below for details.
- prefix str
- Object key prefix identifying one or more objects to which the rule applies.
- Mapping[str, str]
- Specifies object tags key and value.
- transitions
Sequence[BucketV2Lifecycle Rule Transition] 
- Specifies a period in the object's transitions. See Transition below for details.
- enabled Boolean
- Specifies lifecycle rule status.
- abortIncomplete NumberMultipart Upload Days 
- Specifies the number of days after initiating a multipart upload when the multipart upload must be completed.
- expirations List<Property Map>
- Specifies a period in the object's expire. See Expiration below for details.
- id String
- Unique identifier for the rule. Must be less than or equal to 255 characters in length.
- noncurrentVersion List<Property Map>Expirations 
- Specifies when noncurrent object versions expire. See Noncurrent Version Expiration below for details.
- noncurrentVersion List<Property Map>Transitions 
- Specifies when noncurrent object versions transitions. See Noncurrent Version Transition below for details.
- prefix String
- Object key prefix identifying one or more objects to which the rule applies.
- Map<String>
- Specifies object tags key and value.
- transitions List<Property Map>
- Specifies a period in the object's transitions. See Transition below for details.
BucketV2LifecycleRuleExpiration, BucketV2LifecycleRuleExpirationArgs        
- Date string
- Specifies the date after which you want the corresponding action to take effect.
- Days int
- Specifies the number of days after object creation when the specific rule action takes effect.
- ExpiredObject boolDelete Marker 
- On a versioned bucket (versioning-enabled or versioning-suspended bucket), you can add this element in the lifecycle configuration to direct Amazon S3 to delete expired object delete markers. This cannot be specified with Days or Date in a Lifecycle Expiration Policy.
- Date string
- Specifies the date after which you want the corresponding action to take effect.
- Days int
- Specifies the number of days after object creation when the specific rule action takes effect.
- ExpiredObject boolDelete Marker 
- On a versioned bucket (versioning-enabled or versioning-suspended bucket), you can add this element in the lifecycle configuration to direct Amazon S3 to delete expired object delete markers. This cannot be specified with Days or Date in a Lifecycle Expiration Policy.
- date String
- Specifies the date after which you want the corresponding action to take effect.
- days Integer
- Specifies the number of days after object creation when the specific rule action takes effect.
- expiredObject BooleanDelete Marker 
- On a versioned bucket (versioning-enabled or versioning-suspended bucket), you can add this element in the lifecycle configuration to direct Amazon S3 to delete expired object delete markers. This cannot be specified with Days or Date in a Lifecycle Expiration Policy.
- date string
- Specifies the date after which you want the corresponding action to take effect.
- days number
- Specifies the number of days after object creation when the specific rule action takes effect.
- expiredObject booleanDelete Marker 
- On a versioned bucket (versioning-enabled or versioning-suspended bucket), you can add this element in the lifecycle configuration to direct Amazon S3 to delete expired object delete markers. This cannot be specified with Days or Date in a Lifecycle Expiration Policy.
- date str
- Specifies the date after which you want the corresponding action to take effect.
- days int
- Specifies the number of days after object creation when the specific rule action takes effect.
- expired_object_ booldelete_ marker 
- On a versioned bucket (versioning-enabled or versioning-suspended bucket), you can add this element in the lifecycle configuration to direct Amazon S3 to delete expired object delete markers. This cannot be specified with Days or Date in a Lifecycle Expiration Policy.
- date String
- Specifies the date after which you want the corresponding action to take effect.
- days Number
- Specifies the number of days after object creation when the specific rule action takes effect.
- expiredObject BooleanDelete Marker 
- On a versioned bucket (versioning-enabled or versioning-suspended bucket), you can add this element in the lifecycle configuration to direct Amazon S3 to delete expired object delete markers. This cannot be specified with Days or Date in a Lifecycle Expiration Policy.
BucketV2LifecycleRuleNoncurrentVersionExpiration, BucketV2LifecycleRuleNoncurrentVersionExpirationArgs            
- Days int
- Specifies the number of days noncurrent object versions expire.
- Days int
- Specifies the number of days noncurrent object versions expire.
- days Integer
- Specifies the number of days noncurrent object versions expire.
- days number
- Specifies the number of days noncurrent object versions expire.
- days int
- Specifies the number of days noncurrent object versions expire.
- days Number
- Specifies the number of days noncurrent object versions expire.
BucketV2LifecycleRuleNoncurrentVersionTransition, BucketV2LifecycleRuleNoncurrentVersionTransitionArgs            
- StorageClass string
- Specifies the Amazon S3 storage class to which you want the object to transition.
- Days int
- Specifies the number of days noncurrent object versions transition.
- StorageClass string
- Specifies the Amazon S3 storage class to which you want the object to transition.
- Days int
- Specifies the number of days noncurrent object versions transition.
- storageClass String
- Specifies the Amazon S3 storage class to which you want the object to transition.
- days Integer
- Specifies the number of days noncurrent object versions transition.
- storageClass string
- Specifies the Amazon S3 storage class to which you want the object to transition.
- days number
- Specifies the number of days noncurrent object versions transition.
- storage_class str
- Specifies the Amazon S3 storage class to which you want the object to transition.
- days int
- Specifies the number of days noncurrent object versions transition.
- storageClass String
- Specifies the Amazon S3 storage class to which you want the object to transition.
- days Number
- Specifies the number of days noncurrent object versions transition.
BucketV2LifecycleRuleTransition, BucketV2LifecycleRuleTransitionArgs        
- StorageClass string
- Specifies the Amazon S3 storage class to which you want the object to transition.
- Date string
- Specifies the date after which you want the corresponding action to take effect.
- Days int
- Specifies the number of days after object creation when the specific rule action takes effect.
- StorageClass string
- Specifies the Amazon S3 storage class to which you want the object to transition.
- Date string
- Specifies the date after which you want the corresponding action to take effect.
- Days int
- Specifies the number of days after object creation when the specific rule action takes effect.
- storageClass String
- Specifies the Amazon S3 storage class to which you want the object to transition.
- date String
- Specifies the date after which you want the corresponding action to take effect.
- days Integer
- Specifies the number of days after object creation when the specific rule action takes effect.
- storageClass string
- Specifies the Amazon S3 storage class to which you want the object to transition.
- date string
- Specifies the date after which you want the corresponding action to take effect.
- days number
- Specifies the number of days after object creation when the specific rule action takes effect.
- storage_class str
- Specifies the Amazon S3 storage class to which you want the object to transition.
- date str
- Specifies the date after which you want the corresponding action to take effect.
- days int
- Specifies the number of days after object creation when the specific rule action takes effect.
- storageClass String
- Specifies the Amazon S3 storage class to which you want the object to transition.
- date String
- Specifies the date after which you want the corresponding action to take effect.
- days Number
- Specifies the number of days after object creation when the specific rule action takes effect.
BucketV2Logging, BucketV2LoggingArgs    
- TargetBucket string
- Name of the bucket that will receive the log objects.
- TargetPrefix string
- To specify a key prefix for log objects.
- TargetBucket string
- Name of the bucket that will receive the log objects.
- TargetPrefix string
- To specify a key prefix for log objects.
- targetBucket String
- Name of the bucket that will receive the log objects.
- targetPrefix String
- To specify a key prefix for log objects.
- targetBucket string
- Name of the bucket that will receive the log objects.
- targetPrefix string
- To specify a key prefix for log objects.
- target_bucket str
- Name of the bucket that will receive the log objects.
- target_prefix str
- To specify a key prefix for log objects.
- targetBucket String
- Name of the bucket that will receive the log objects.
- targetPrefix String
- To specify a key prefix for log objects.
BucketV2ObjectLockConfiguration, BucketV2ObjectLockConfigurationArgs        
- ObjectLock stringEnabled 
- Indicates whether this bucket has an Object Lock configuration enabled. Valid values are trueorfalse. This argument is not supported in all regions or partitions.
- Rules
List<BucketV2Object Lock Configuration Rule> 
- Object Lock rule in place for this bucket (documented below).
- ObjectLock stringEnabled 
- Indicates whether this bucket has an Object Lock configuration enabled. Valid values are trueorfalse. This argument is not supported in all regions or partitions.
- Rules
[]BucketV2Object Lock Configuration Rule 
- Object Lock rule in place for this bucket (documented below).
- objectLock StringEnabled 
- Indicates whether this bucket has an Object Lock configuration enabled. Valid values are trueorfalse. This argument is not supported in all regions or partitions.
- rules
List<BucketV2Object Lock Configuration Rule> 
- Object Lock rule in place for this bucket (documented below).
- objectLock stringEnabled 
- Indicates whether this bucket has an Object Lock configuration enabled. Valid values are trueorfalse. This argument is not supported in all regions or partitions.
- rules
BucketV2Object Lock Configuration Rule[] 
- Object Lock rule in place for this bucket (documented below).
- object_lock_ strenabled 
- Indicates whether this bucket has an Object Lock configuration enabled. Valid values are trueorfalse. This argument is not supported in all regions or partitions.
- rules
Sequence[BucketV2Object Lock Configuration Rule] 
- Object Lock rule in place for this bucket (documented below).
- objectLock StringEnabled 
- Indicates whether this bucket has an Object Lock configuration enabled. Valid values are trueorfalse. This argument is not supported in all regions or partitions.
- rules List<Property Map>
- Object Lock rule in place for this bucket (documented below).
BucketV2ObjectLockConfigurationRule, BucketV2ObjectLockConfigurationRuleArgs          
- DefaultRetentions List<BucketV2Object Lock Configuration Rule Default Retention> 
- Default retention period that you want to apply to new objects placed in this bucket (documented below).
- DefaultRetentions []BucketV2Object Lock Configuration Rule Default Retention 
- Default retention period that you want to apply to new objects placed in this bucket (documented below).
- defaultRetentions List<BucketV2Object Lock Configuration Rule Default Retention> 
- Default retention period that you want to apply to new objects placed in this bucket (documented below).
- defaultRetentions BucketV2Object Lock Configuration Rule Default Retention[] 
- Default retention period that you want to apply to new objects placed in this bucket (documented below).
- default_retentions Sequence[BucketV2Object Lock Configuration Rule Default Retention] 
- Default retention period that you want to apply to new objects placed in this bucket (documented below).
- defaultRetentions List<Property Map>
- Default retention period that you want to apply to new objects placed in this bucket (documented below).
BucketV2ObjectLockConfigurationRuleDefaultRetention, BucketV2ObjectLockConfigurationRuleDefaultRetentionArgs              
- Mode string
- Default Object Lock retention mode you want to apply to new objects placed in this bucket. Valid values are GOVERNANCEandCOMPLIANCE.
- Days int
- Number of days that you want to specify for the default retention period.
- Years int
- Number of years that you want to specify for the default retention period.
- Mode string
- Default Object Lock retention mode you want to apply to new objects placed in this bucket. Valid values are GOVERNANCEandCOMPLIANCE.
- Days int
- Number of days that you want to specify for the default retention period.
- Years int
- Number of years that you want to specify for the default retention period.
- mode String
- Default Object Lock retention mode you want to apply to new objects placed in this bucket. Valid values are GOVERNANCEandCOMPLIANCE.
- days Integer
- Number of days that you want to specify for the default retention period.
- years Integer
- Number of years that you want to specify for the default retention period.
- mode string
- Default Object Lock retention mode you want to apply to new objects placed in this bucket. Valid values are GOVERNANCEandCOMPLIANCE.
- days number
- Number of days that you want to specify for the default retention period.
- years number
- Number of years that you want to specify for the default retention period.
- mode str
- Default Object Lock retention mode you want to apply to new objects placed in this bucket. Valid values are GOVERNANCEandCOMPLIANCE.
- days int
- Number of days that you want to specify for the default retention period.
- years int
- Number of years that you want to specify for the default retention period.
- mode String
- Default Object Lock retention mode you want to apply to new objects placed in this bucket. Valid values are GOVERNANCEandCOMPLIANCE.
- days Number
- Number of days that you want to specify for the default retention period.
- years Number
- Number of years that you want to specify for the default retention period.
BucketV2ReplicationConfiguration, BucketV2ReplicationConfigurationArgs      
- Role string
- ARN of the IAM role for Amazon S3 to assume when replicating the objects.
- Rules
List<BucketV2Replication Configuration Rule> 
- Specifies the rules managing the replication (documented below).
- Role string
- ARN of the IAM role for Amazon S3 to assume when replicating the objects.
- Rules
[]BucketV2Replication Configuration Rule 
- Specifies the rules managing the replication (documented below).
- role String
- ARN of the IAM role for Amazon S3 to assume when replicating the objects.
- rules
List<BucketV2Replication Configuration Rule> 
- Specifies the rules managing the replication (documented below).
- role string
- ARN of the IAM role for Amazon S3 to assume when replicating the objects.
- rules
BucketV2Replication Configuration Rule[] 
- Specifies the rules managing the replication (documented below).
- role str
- ARN of the IAM role for Amazon S3 to assume when replicating the objects.
- rules
Sequence[BucketV2Replication Configuration Rule] 
- Specifies the rules managing the replication (documented below).
- role String
- ARN of the IAM role for Amazon S3 to assume when replicating the objects.
- rules List<Property Map>
- Specifies the rules managing the replication (documented below).
BucketV2ReplicationConfigurationRule, BucketV2ReplicationConfigurationRuleArgs        
- Destinations
List<BucketV2Replication Configuration Rule Destination> 
- Specifies the destination for the rule (documented below).
- Status string
- Status of the rule. Either EnabledorDisabled. The rule is ignored if status is not Enabled.
- DeleteMarker stringReplication Status 
- Whether delete markers are replicated. The only valid value is Enabled. To disable, omit this argument. This argument is only valid with V2 replication configurations (i.e., whenfilteris used).
- Filters
List<BucketV2Replication Configuration Rule Filter> 
- Filter that identifies subset of objects to which the replication rule applies (documented below).
- Id string
- Unique identifier for the rule. Must be less than or equal to 255 characters in length.
- Prefix string
- Object keyname prefix identifying one or more objects to which the rule applies. Must be less than or equal to 1024 characters in length.
- Priority int
- Priority associated with the rule. Priority should only be set if filteris configured. If not provided, defaults to0. Priority must be unique between multiple rules.
- SourceSelection List<BucketCriterias V2Replication Configuration Rule Source Selection Criteria> 
- Specifies special object selection criteria (documented below).
- Destinations
[]BucketV2Replication Configuration Rule Destination 
- Specifies the destination for the rule (documented below).
- Status string
- Status of the rule. Either EnabledorDisabled. The rule is ignored if status is not Enabled.
- DeleteMarker stringReplication Status 
- Whether delete markers are replicated. The only valid value is Enabled. To disable, omit this argument. This argument is only valid with V2 replication configurations (i.e., whenfilteris used).
- Filters
[]BucketV2Replication Configuration Rule Filter 
- Filter that identifies subset of objects to which the replication rule applies (documented below).
- Id string
- Unique identifier for the rule. Must be less than or equal to 255 characters in length.
- Prefix string
- Object keyname prefix identifying one or more objects to which the rule applies. Must be less than or equal to 1024 characters in length.
- Priority int
- Priority associated with the rule. Priority should only be set if filteris configured. If not provided, defaults to0. Priority must be unique between multiple rules.
- SourceSelection []BucketCriterias V2Replication Configuration Rule Source Selection Criteria 
- Specifies special object selection criteria (documented below).
- destinations
List<BucketV2Replication Configuration Rule Destination> 
- Specifies the destination for the rule (documented below).
- status String
- Status of the rule. Either EnabledorDisabled. The rule is ignored if status is not Enabled.
- deleteMarker StringReplication Status 
- Whether delete markers are replicated. The only valid value is Enabled. To disable, omit this argument. This argument is only valid with V2 replication configurations (i.e., whenfilteris used).
- filters
List<BucketV2Replication Configuration Rule Filter> 
- Filter that identifies subset of objects to which the replication rule applies (documented below).
- id String
- Unique identifier for the rule. Must be less than or equal to 255 characters in length.
- prefix String
- Object keyname prefix identifying one or more objects to which the rule applies. Must be less than or equal to 1024 characters in length.
- priority Integer
- Priority associated with the rule. Priority should only be set if filteris configured. If not provided, defaults to0. Priority must be unique between multiple rules.
- sourceSelection List<BucketCriterias V2Replication Configuration Rule Source Selection Criteria> 
- Specifies special object selection criteria (documented below).
- destinations
BucketV2Replication Configuration Rule Destination[] 
- Specifies the destination for the rule (documented below).
- status string
- Status of the rule. Either EnabledorDisabled. The rule is ignored if status is not Enabled.
- deleteMarker stringReplication Status 
- Whether delete markers are replicated. The only valid value is Enabled. To disable, omit this argument. This argument is only valid with V2 replication configurations (i.e., whenfilteris used).
- filters
BucketV2Replication Configuration Rule Filter[] 
- Filter that identifies subset of objects to which the replication rule applies (documented below).
- id string
- Unique identifier for the rule. Must be less than or equal to 255 characters in length.
- prefix string
- Object keyname prefix identifying one or more objects to which the rule applies. Must be less than or equal to 1024 characters in length.
- priority number
- Priority associated with the rule. Priority should only be set if filteris configured. If not provided, defaults to0. Priority must be unique between multiple rules.
- sourceSelection BucketCriterias V2Replication Configuration Rule Source Selection Criteria[] 
- Specifies special object selection criteria (documented below).
- destinations
Sequence[BucketV2Replication Configuration Rule Destination] 
- Specifies the destination for the rule (documented below).
- status str
- Status of the rule. Either EnabledorDisabled. The rule is ignored if status is not Enabled.
- delete_marker_ strreplication_ status 
- Whether delete markers are replicated. The only valid value is Enabled. To disable, omit this argument. This argument is only valid with V2 replication configurations (i.e., whenfilteris used).
- filters
Sequence[BucketV2Replication Configuration Rule Filter] 
- Filter that identifies subset of objects to which the replication rule applies (documented below).
- id str
- Unique identifier for the rule. Must be less than or equal to 255 characters in length.
- prefix str
- Object keyname prefix identifying one or more objects to which the rule applies. Must be less than or equal to 1024 characters in length.
- priority int
- Priority associated with the rule. Priority should only be set if filteris configured. If not provided, defaults to0. Priority must be unique between multiple rules.
- source_selection_ Sequence[Bucketcriterias V2Replication Configuration Rule Source Selection Criteria] 
- Specifies special object selection criteria (documented below).
- destinations List<Property Map>
- Specifies the destination for the rule (documented below).
- status String
- Status of the rule. Either EnabledorDisabled. The rule is ignored if status is not Enabled.
- deleteMarker StringReplication Status 
- Whether delete markers are replicated. The only valid value is Enabled. To disable, omit this argument. This argument is only valid with V2 replication configurations (i.e., whenfilteris used).
- filters List<Property Map>
- Filter that identifies subset of objects to which the replication rule applies (documented below).
- id String
- Unique identifier for the rule. Must be less than or equal to 255 characters in length.
- prefix String
- Object keyname prefix identifying one or more objects to which the rule applies. Must be less than or equal to 1024 characters in length.
- priority Number
- Priority associated with the rule. Priority should only be set if filteris configured. If not provided, defaults to0. Priority must be unique between multiple rules.
- sourceSelection List<Property Map>Criterias 
- Specifies special object selection criteria (documented below).
BucketV2ReplicationConfigurationRuleDestination, BucketV2ReplicationConfigurationRuleDestinationArgs          
- Bucket string
- ARN of the S3 bucket where you want Amazon S3 to store replicas of the object identified by the rule.
- AccessControl List<BucketTranslations V2Replication Configuration Rule Destination Access Control Translation> 
- Specifies the overrides to use for object owners on replication (documented below). Must be used in conjunction with account_idowner override configuration.
- AccountId string
- Account ID to use for overriding the object owner on replication. Must be used in conjunction with access_control_translationoverride configuration.
- Metrics
List<BucketV2Replication Configuration Rule Destination Metric> 
- Enables replication metrics (required for S3 RTC) (documented below).
- ReplicaKms stringKey Id 
- Destination KMS encryption key ARN for SSE-KMS replication. Must be used in conjunction with
sse_kms_encrypted_objectssource selection criteria.
- ReplicationTimes List<BucketV2Replication Configuration Rule Destination Replication Time> 
- Enables S3 Replication Time Control (S3 RTC) (documented below).
- StorageClass string
- The storage class used to store the object. By default, Amazon S3 uses the storage class of the source object to create the object replica.
- Bucket string
- ARN of the S3 bucket where you want Amazon S3 to store replicas of the object identified by the rule.
- AccessControl []BucketTranslations V2Replication Configuration Rule Destination Access Control Translation 
- Specifies the overrides to use for object owners on replication (documented below). Must be used in conjunction with account_idowner override configuration.
- AccountId string
- Account ID to use for overriding the object owner on replication. Must be used in conjunction with access_control_translationoverride configuration.
- Metrics
[]BucketV2Replication Configuration Rule Destination Metric 
- Enables replication metrics (required for S3 RTC) (documented below).
- ReplicaKms stringKey Id 
- Destination KMS encryption key ARN for SSE-KMS replication. Must be used in conjunction with
sse_kms_encrypted_objectssource selection criteria.
- ReplicationTimes []BucketV2Replication Configuration Rule Destination Replication Time 
- Enables S3 Replication Time Control (S3 RTC) (documented below).
- StorageClass string
- The storage class used to store the object. By default, Amazon S3 uses the storage class of the source object to create the object replica.
- bucket String
- ARN of the S3 bucket where you want Amazon S3 to store replicas of the object identified by the rule.
- accessControl List<BucketTranslations V2Replication Configuration Rule Destination Access Control Translation> 
- Specifies the overrides to use for object owners on replication (documented below). Must be used in conjunction with account_idowner override configuration.
- accountId String
- Account ID to use for overriding the object owner on replication. Must be used in conjunction with access_control_translationoverride configuration.
- metrics
List<BucketV2Replication Configuration Rule Destination Metric> 
- Enables replication metrics (required for S3 RTC) (documented below).
- replicaKms StringKey Id 
- Destination KMS encryption key ARN for SSE-KMS replication. Must be used in conjunction with
sse_kms_encrypted_objectssource selection criteria.
- replicationTimes List<BucketV2Replication Configuration Rule Destination Replication Time> 
- Enables S3 Replication Time Control (S3 RTC) (documented below).
- storageClass String
- The storage class used to store the object. By default, Amazon S3 uses the storage class of the source object to create the object replica.
- bucket string
- ARN of the S3 bucket where you want Amazon S3 to store replicas of the object identified by the rule.
- accessControl BucketTranslations V2Replication Configuration Rule Destination Access Control Translation[] 
- Specifies the overrides to use for object owners on replication (documented below). Must be used in conjunction with account_idowner override configuration.
- accountId string
- Account ID to use for overriding the object owner on replication. Must be used in conjunction with access_control_translationoverride configuration.
- metrics
BucketV2Replication Configuration Rule Destination Metric[] 
- Enables replication metrics (required for S3 RTC) (documented below).
- replicaKms stringKey Id 
- Destination KMS encryption key ARN for SSE-KMS replication. Must be used in conjunction with
sse_kms_encrypted_objectssource selection criteria.
- replicationTimes BucketV2Replication Configuration Rule Destination Replication Time[] 
- Enables S3 Replication Time Control (S3 RTC) (documented below).
- storageClass string
- The storage class used to store the object. By default, Amazon S3 uses the storage class of the source object to create the object replica.
- bucket str
- ARN of the S3 bucket where you want Amazon S3 to store replicas of the object identified by the rule.
- access_control_ Sequence[Buckettranslations V2Replication Configuration Rule Destination Access Control Translation] 
- Specifies the overrides to use for object owners on replication (documented below). Must be used in conjunction with account_idowner override configuration.
- account_id str
- Account ID to use for overriding the object owner on replication. Must be used in conjunction with access_control_translationoverride configuration.
- metrics
Sequence[BucketV2Replication Configuration Rule Destination Metric] 
- Enables replication metrics (required for S3 RTC) (documented below).
- replica_kms_ strkey_ id 
- Destination KMS encryption key ARN for SSE-KMS replication. Must be used in conjunction with
sse_kms_encrypted_objectssource selection criteria.
- replication_times Sequence[BucketV2Replication Configuration Rule Destination Replication Time] 
- Enables S3 Replication Time Control (S3 RTC) (documented below).
- storage_class str
- The storage class used to store the object. By default, Amazon S3 uses the storage class of the source object to create the object replica.
- bucket String
- ARN of the S3 bucket where you want Amazon S3 to store replicas of the object identified by the rule.
- accessControl List<Property Map>Translations 
- Specifies the overrides to use for object owners on replication (documented below). Must be used in conjunction with account_idowner override configuration.
- accountId String
- Account ID to use for overriding the object owner on replication. Must be used in conjunction with access_control_translationoverride configuration.
- metrics List<Property Map>
- Enables replication metrics (required for S3 RTC) (documented below).
- replicaKms StringKey Id 
- Destination KMS encryption key ARN for SSE-KMS replication. Must be used in conjunction with
sse_kms_encrypted_objectssource selection criteria.
- replicationTimes List<Property Map>
- Enables S3 Replication Time Control (S3 RTC) (documented below).
- storageClass String
- The storage class used to store the object. By default, Amazon S3 uses the storage class of the source object to create the object replica.
BucketV2ReplicationConfigurationRuleDestinationAccessControlTranslation, BucketV2ReplicationConfigurationRuleDestinationAccessControlTranslationArgs                
- Owner string
- Specifies the replica ownership. For default and valid values, see PUT bucket replication in the Amazon S3 API Reference. The only valid value is Destination.
- Owner string
- Specifies the replica ownership. For default and valid values, see PUT bucket replication in the Amazon S3 API Reference. The only valid value is Destination.
- owner String
- Specifies the replica ownership. For default and valid values, see PUT bucket replication in the Amazon S3 API Reference. The only valid value is Destination.
- owner string
- Specifies the replica ownership. For default and valid values, see PUT bucket replication in the Amazon S3 API Reference. The only valid value is Destination.
- owner str
- Specifies the replica ownership. For default and valid values, see PUT bucket replication in the Amazon S3 API Reference. The only valid value is Destination.
- owner String
- Specifies the replica ownership. For default and valid values, see PUT bucket replication in the Amazon S3 API Reference. The only valid value is Destination.
BucketV2ReplicationConfigurationRuleDestinationMetric, BucketV2ReplicationConfigurationRuleDestinationMetricArgs            
BucketV2ReplicationConfigurationRuleDestinationReplicationTime, BucketV2ReplicationConfigurationRuleDestinationReplicationTimeArgs              
BucketV2ReplicationConfigurationRuleFilter, BucketV2ReplicationConfigurationRuleFilterArgs          
- Prefix string
- Object keyname prefix that identifies subset of objects to which the rule applies. Must be less than or equal to 1024 characters in length.
- Dictionary<string, string>
- A map of tags that identifies subset of objects to which the rule applies. The rule applies only to objects having all the tags in its tagset.
- Prefix string
- Object keyname prefix that identifies subset of objects to which the rule applies. Must be less than or equal to 1024 characters in length.
- map[string]string
- A map of tags that identifies subset of objects to which the rule applies. The rule applies only to objects having all the tags in its tagset.
- prefix String
- Object keyname prefix that identifies subset of objects to which the rule applies. Must be less than or equal to 1024 characters in length.
- Map<String,String>
- A map of tags that identifies subset of objects to which the rule applies. The rule applies only to objects having all the tags in its tagset.
- prefix string
- Object keyname prefix that identifies subset of objects to which the rule applies. Must be less than or equal to 1024 characters in length.
- {[key: string]: string}
- A map of tags that identifies subset of objects to which the rule applies. The rule applies only to objects having all the tags in its tagset.
- prefix str
- Object keyname prefix that identifies subset of objects to which the rule applies. Must be less than or equal to 1024 characters in length.
- Mapping[str, str]
- A map of tags that identifies subset of objects to which the rule applies. The rule applies only to objects having all the tags in its tagset.
- prefix String
- Object keyname prefix that identifies subset of objects to which the rule applies. Must be less than or equal to 1024 characters in length.
- Map<String>
- A map of tags that identifies subset of objects to which the rule applies. The rule applies only to objects having all the tags in its tagset.
BucketV2ReplicationConfigurationRuleSourceSelectionCriteria, BucketV2ReplicationConfigurationRuleSourceSelectionCriteriaArgs              
- SseKms List<BucketEncrypted Objects V2Replication Configuration Rule Source Selection Criteria Sse Kms Encrypted Object> 
- Match SSE-KMS encrypted objects (documented below). If specified, replica_kms_key_idindestinationmust be specified as well.
- SseKms []BucketEncrypted Objects V2Replication Configuration Rule Source Selection Criteria Sse Kms Encrypted Object 
- Match SSE-KMS encrypted objects (documented below). If specified, replica_kms_key_idindestinationmust be specified as well.
- sseKms List<BucketEncrypted Objects V2Replication Configuration Rule Source Selection Criteria Sse Kms Encrypted Object> 
- Match SSE-KMS encrypted objects (documented below). If specified, replica_kms_key_idindestinationmust be specified as well.
- sseKms BucketEncrypted Objects V2Replication Configuration Rule Source Selection Criteria Sse Kms Encrypted Object[] 
- Match SSE-KMS encrypted objects (documented below). If specified, replica_kms_key_idindestinationmust be specified as well.
- sse_kms_ Sequence[Bucketencrypted_ objects V2Replication Configuration Rule Source Selection Criteria Sse Kms Encrypted Object] 
- Match SSE-KMS encrypted objects (documented below). If specified, replica_kms_key_idindestinationmust be specified as well.
- sseKms List<Property Map>Encrypted Objects 
- Match SSE-KMS encrypted objects (documented below). If specified, replica_kms_key_idindestinationmust be specified as well.
BucketV2ReplicationConfigurationRuleSourceSelectionCriteriaSseKmsEncryptedObject, BucketV2ReplicationConfigurationRuleSourceSelectionCriteriaSseKmsEncryptedObjectArgs                      
- Enabled bool
- Boolean which indicates if this criteria is enabled.
- Enabled bool
- Boolean which indicates if this criteria is enabled.
- enabled Boolean
- Boolean which indicates if this criteria is enabled.
- enabled boolean
- Boolean which indicates if this criteria is enabled.
- enabled bool
- Boolean which indicates if this criteria is enabled.
- enabled Boolean
- Boolean which indicates if this criteria is enabled.
BucketV2ServerSideEncryptionConfiguration, BucketV2ServerSideEncryptionConfigurationArgs          
- Rules
List<BucketV2Server Side Encryption Configuration Rule> 
- Single object for server-side encryption by default configuration. (documented below)
- Rules
[]BucketV2Server Side Encryption Configuration Rule 
- Single object for server-side encryption by default configuration. (documented below)
- rules
List<BucketV2Server Side Encryption Configuration Rule> 
- Single object for server-side encryption by default configuration. (documented below)
- rules
BucketV2Server Side Encryption Configuration Rule[] 
- Single object for server-side encryption by default configuration. (documented below)
- rules
Sequence[BucketV2Server Side Encryption Configuration Rule] 
- Single object for server-side encryption by default configuration. (documented below)
- rules List<Property Map>
- Single object for server-side encryption by default configuration. (documented below)
BucketV2ServerSideEncryptionConfigurationRule, BucketV2ServerSideEncryptionConfigurationRuleArgs            
- ApplyServer List<BucketSide Encryption By Defaults V2Server Side Encryption Configuration Rule Apply Server Side Encryption By Default> 
- Single object for setting server-side encryption by default. (documented below)
- BucketKey boolEnabled 
- Whether or not to use Amazon S3 Bucket Keys for SSE-KMS.
- ApplyServer []BucketSide Encryption By Defaults V2Server Side Encryption Configuration Rule Apply Server Side Encryption By Default 
- Single object for setting server-side encryption by default. (documented below)
- BucketKey boolEnabled 
- Whether or not to use Amazon S3 Bucket Keys for SSE-KMS.
- applyServer List<BucketSide Encryption By Defaults V2Server Side Encryption Configuration Rule Apply Server Side Encryption By Default> 
- Single object for setting server-side encryption by default. (documented below)
- bucketKey BooleanEnabled 
- Whether or not to use Amazon S3 Bucket Keys for SSE-KMS.
- applyServer BucketSide Encryption By Defaults V2Server Side Encryption Configuration Rule Apply Server Side Encryption By Default[] 
- Single object for setting server-side encryption by default. (documented below)
- bucketKey booleanEnabled 
- Whether or not to use Amazon S3 Bucket Keys for SSE-KMS.
- apply_server_ Sequence[Bucketside_ encryption_ by_ defaults V2Server Side Encryption Configuration Rule Apply Server Side Encryption By Default] 
- Single object for setting server-side encryption by default. (documented below)
- bucket_key_ boolenabled 
- Whether or not to use Amazon S3 Bucket Keys for SSE-KMS.
- applyServer List<Property Map>Side Encryption By Defaults 
- Single object for setting server-side encryption by default. (documented below)
- bucketKey BooleanEnabled 
- Whether or not to use Amazon S3 Bucket Keys for SSE-KMS.
BucketV2ServerSideEncryptionConfigurationRuleApplyServerSideEncryptionByDefault, BucketV2ServerSideEncryptionConfigurationRuleApplyServerSideEncryptionByDefaultArgs                        
- SseAlgorithm string
- Server-side encryption algorithm to use. Valid values are AES256andaws:kms
- KmsMaster stringKey Id 
- AWS KMS master key ID used for the SSE-KMS encryption. This can only be used when you set the value of sse_algorithmasaws:kms. The defaultaws/s3AWS KMS master key is used if this element is absent while thesse_algorithmisaws:kms.
- SseAlgorithm string
- Server-side encryption algorithm to use. Valid values are AES256andaws:kms
- KmsMaster stringKey Id 
- AWS KMS master key ID used for the SSE-KMS encryption. This can only be used when you set the value of sse_algorithmasaws:kms. The defaultaws/s3AWS KMS master key is used if this element is absent while thesse_algorithmisaws:kms.
- sseAlgorithm String
- Server-side encryption algorithm to use. Valid values are AES256andaws:kms
- kmsMaster StringKey Id 
- AWS KMS master key ID used for the SSE-KMS encryption. This can only be used when you set the value of sse_algorithmasaws:kms. The defaultaws/s3AWS KMS master key is used if this element is absent while thesse_algorithmisaws:kms.
- sseAlgorithm string
- Server-side encryption algorithm to use. Valid values are AES256andaws:kms
- kmsMaster stringKey Id 
- AWS KMS master key ID used for the SSE-KMS encryption. This can only be used when you set the value of sse_algorithmasaws:kms. The defaultaws/s3AWS KMS master key is used if this element is absent while thesse_algorithmisaws:kms.
- sse_algorithm str
- Server-side encryption algorithm to use. Valid values are AES256andaws:kms
- kms_master_ strkey_ id 
- AWS KMS master key ID used for the SSE-KMS encryption. This can only be used when you set the value of sse_algorithmasaws:kms. The defaultaws/s3AWS KMS master key is used if this element is absent while thesse_algorithmisaws:kms.
- sseAlgorithm String
- Server-side encryption algorithm to use. Valid values are AES256andaws:kms
- kmsMaster StringKey Id 
- AWS KMS master key ID used for the SSE-KMS encryption. This can only be used when you set the value of sse_algorithmasaws:kms. The defaultaws/s3AWS KMS master key is used if this element is absent while thesse_algorithmisaws:kms.
BucketV2Versioning, BucketV2VersioningArgs    
- Enabled bool
- Enable versioning. Once you version-enable a bucket, it can never return to an unversioned state. You can, however, suspend versioning on that bucket.
- MfaDelete bool
- Enable MFA delete for either Change the versioning state of your bucketorPermanently delete an object version. Default isfalse. This cannot be used to toggle this setting but is available to allow managed buckets to reflect the state in AWS
- Enabled bool
- Enable versioning. Once you version-enable a bucket, it can never return to an unversioned state. You can, however, suspend versioning on that bucket.
- MfaDelete bool
- Enable MFA delete for either Change the versioning state of your bucketorPermanently delete an object version. Default isfalse. This cannot be used to toggle this setting but is available to allow managed buckets to reflect the state in AWS
- enabled Boolean
- Enable versioning. Once you version-enable a bucket, it can never return to an unversioned state. You can, however, suspend versioning on that bucket.
- mfaDelete Boolean
- Enable MFA delete for either Change the versioning state of your bucketorPermanently delete an object version. Default isfalse. This cannot be used to toggle this setting but is available to allow managed buckets to reflect the state in AWS
- enabled boolean
- Enable versioning. Once you version-enable a bucket, it can never return to an unversioned state. You can, however, suspend versioning on that bucket.
- mfaDelete boolean
- Enable MFA delete for either Change the versioning state of your bucketorPermanently delete an object version. Default isfalse. This cannot be used to toggle this setting but is available to allow managed buckets to reflect the state in AWS
- enabled bool
- Enable versioning. Once you version-enable a bucket, it can never return to an unversioned state. You can, however, suspend versioning on that bucket.
- mfa_delete bool
- Enable MFA delete for either Change the versioning state of your bucketorPermanently delete an object version. Default isfalse. This cannot be used to toggle this setting but is available to allow managed buckets to reflect the state in AWS
- enabled Boolean
- Enable versioning. Once you version-enable a bucket, it can never return to an unversioned state. You can, however, suspend versioning on that bucket.
- mfaDelete Boolean
- Enable MFA delete for either Change the versioning state of your bucketorPermanently delete an object version. Default isfalse. This cannot be used to toggle this setting but is available to allow managed buckets to reflect the state in AWS
BucketV2Website, BucketV2WebsiteArgs    
- ErrorDocument string
- Absolute path to the document to return in case of a 4XX error.
- IndexDocument string
- Amazon S3 returns this index document when requests are made to the root domain or any of the subfolders.
- RedirectAll stringRequests To 
- Hostname to redirect all website requests for this bucket to. Hostname can optionally be prefixed with a protocol (http://orhttps://) to use when redirecting requests. The default is the protocol that is used in the original request.
- RoutingRules string
- JSON array containing routing rules describing redirect behavior and when redirects are applied.
- ErrorDocument string
- Absolute path to the document to return in case of a 4XX error.
- IndexDocument string
- Amazon S3 returns this index document when requests are made to the root domain or any of the subfolders.
- RedirectAll stringRequests To 
- Hostname to redirect all website requests for this bucket to. Hostname can optionally be prefixed with a protocol (http://orhttps://) to use when redirecting requests. The default is the protocol that is used in the original request.
- RoutingRules string
- JSON array containing routing rules describing redirect behavior and when redirects are applied.
- errorDocument String
- Absolute path to the document to return in case of a 4XX error.
- indexDocument String
- Amazon S3 returns this index document when requests are made to the root domain or any of the subfolders.
- redirectAll StringRequests To 
- Hostname to redirect all website requests for this bucket to. Hostname can optionally be prefixed with a protocol (http://orhttps://) to use when redirecting requests. The default is the protocol that is used in the original request.
- routingRules String
- JSON array containing routing rules describing redirect behavior and when redirects are applied.
- errorDocument string
- Absolute path to the document to return in case of a 4XX error.
- indexDocument string
- Amazon S3 returns this index document when requests are made to the root domain or any of the subfolders.
- redirectAll stringRequests To 
- Hostname to redirect all website requests for this bucket to. Hostname can optionally be prefixed with a protocol (http://orhttps://) to use when redirecting requests. The default is the protocol that is used in the original request.
- routingRules string
- JSON array containing routing rules describing redirect behavior and when redirects are applied.
- error_document str
- Absolute path to the document to return in case of a 4XX error.
- index_document str
- Amazon S3 returns this index document when requests are made to the root domain or any of the subfolders.
- redirect_all_ strrequests_ to 
- Hostname to redirect all website requests for this bucket to. Hostname can optionally be prefixed with a protocol (http://orhttps://) to use when redirecting requests. The default is the protocol that is used in the original request.
- routing_rules str
- JSON array containing routing rules describing redirect behavior and when redirects are applied.
- errorDocument String
- Absolute path to the document to return in case of a 4XX error.
- indexDocument String
- Amazon S3 returns this index document when requests are made to the root domain or any of the subfolders.
- redirectAll StringRequests To 
- Hostname to redirect all website requests for this bucket to. Hostname can optionally be prefixed with a protocol (http://orhttps://) to use when redirecting requests. The default is the protocol that is used in the original request.
- routingRules String
- JSON array containing routing rules describing redirect behavior and when redirects are applied.
Import
Using pulumi import, import S3 bucket using the bucket. For example:
$ pulumi import aws:s3/bucketV2:BucketV2 bucket bucket-name
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- AWS Classic pulumi/pulumi-aws
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the awsTerraform Provider.