Try AWS Native preview for resources not in the classic version.
aws.s3.BucketV2
Explore with Pulumi AI
Try AWS Native preview for resources not in the classic version.
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_bucket
resource. To manage S3 on Outposts, use theaws.s3control.Bucket
resource.
Object Lock can be enabled by using the
object_lock_enable
attribute or by using theaws.s3.BucketObjectLockConfigurationV2
resource. 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
The BucketV2 resource accepts the following input properties:
- Acceleration
Status string - Sets the accelerate configuration of an existing bucket. Can be
Enabled
orSuspended
. Cannot be used incn-north-1
orus-gov-west-1
. This provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAccelerateConfigurationV2
instead. - 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.BucketAclV2
instead. - 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.DirectoryBucket
resource to manage S3 Express buckets. - Bucket
Prefix 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. - Cors
Rules 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.BucketCorsConfigurationV2
instead. - 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 up
run before a destroy is required to update this value in the resource state. Without a successfulpulumi up
after 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 up
is required to set this value in state before it will take effect on a destroy operation. - Grants
List<Bucket
V2Grant> - 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.BucketAclV2
instead. - Lifecycle
Rules 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.BucketLifecycleConfigurationV2
instead. - Loggings
List<Bucket
V2Logging> - 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.BucketLoggingV2
instead. - Object
Lock 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_enabled
parameter and the resourceaws.s3.BucketObjectLockConfigurationV2
instead. - Object
Lock boolEnabled - Indicates whether this bucket has an Object Lock configuration enabled. Valid values are
true
orfalse
. 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.BucketPolicy
instead. - Replication
Configurations 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.BucketReplicationConfig
instead. - Request
Payer string - Specifies who should bear the cost of Amazon S3 data transfer.
Can be either
BucketOwner
orRequester
. 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.BucketRequestPaymentConfigurationV2
instead. - Server
Side 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.BucketServerSideEncryptionConfigurationV2
instead. - Dictionary<string, string>
Map of tags to assign to the bucket. If configured with a provider
default_tags
configuration 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<Bucket
V2Versioning> - 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.BucketVersioningV2
instead. - Websites
List<Bucket
V2Website> - 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.BucketWebsiteConfigurationV2
instead.
- Acceleration
Status string - Sets the accelerate configuration of an existing bucket. Can be
Enabled
orSuspended
. Cannot be used incn-north-1
orus-gov-west-1
. This provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAccelerateConfigurationV2
instead. - 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.BucketAclV2
instead. - 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.DirectoryBucket
resource to manage S3 Express buckets. - Bucket
Prefix 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. - Cors
Rules []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.BucketCorsConfigurationV2
instead. - 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 up
run before a destroy is required to update this value in the resource state. Without a successfulpulumi up
after 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 up
is required to set this value in state before it will take effect on a destroy operation. - Grants
[]Bucket
V2Grant 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.BucketAclV2
instead. - Lifecycle
Rules []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.BucketLifecycleConfigurationV2
instead. - Loggings
[]Bucket
V2Logging 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.BucketLoggingV2
instead. - 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_enabled
parameter and the resourceaws.s3.BucketObjectLockConfigurationV2
instead. - Object
Lock boolEnabled - Indicates whether this bucket has an Object Lock configuration enabled. Valid values are
true
orfalse
. 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.BucketPolicy
instead. - Replication
Configurations []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.BucketReplicationConfig
instead. - Request
Payer string - Specifies who should bear the cost of Amazon S3 data transfer.
Can be either
BucketOwner
orRequester
. 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.BucketRequestPaymentConfigurationV2
instead. - Server
Side []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.BucketServerSideEncryptionConfigurationV2
instead. - map[string]string
Map of tags to assign to the bucket. If configured with a provider
default_tags
configuration 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
[]Bucket
V2Versioning 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.BucketVersioningV2
instead. - Websites
[]Bucket
V2Website 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.BucketWebsiteConfigurationV2
instead.
- acceleration
Status String - Sets the accelerate configuration of an existing bucket. Can be
Enabled
orSuspended
. Cannot be used incn-north-1
orus-gov-west-1
. This provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAccelerateConfigurationV2
instead. - 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.BucketAclV2
instead. - 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.DirectoryBucket
resource to manage S3 Express buckets. - bucket
Prefix 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. - cors
Rules 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.BucketCorsConfigurationV2
instead. - force
Destroy 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 up
run before a destroy is required to update this value in the resource state. Without a successfulpulumi up
after 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 up
is required to set this value in state before it will take effect on a destroy operation. - grants
List<Bucket
V2Grant> - 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.BucketAclV2
instead. - lifecycle
Rules 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.BucketLifecycleConfigurationV2
instead. - loggings
List<Bucket
V2Logging> - 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.BucketLoggingV2
instead. - object
Lock 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_enabled
parameter and the resourceaws.s3.BucketObjectLockConfigurationV2
instead. - object
Lock BooleanEnabled - Indicates whether this bucket has an Object Lock configuration enabled. Valid values are
true
orfalse
. 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.BucketPolicy
instead. - replication
Configurations 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.BucketReplicationConfig
instead. - request
Payer String - Specifies who should bear the cost of Amazon S3 data transfer.
Can be either
BucketOwner
orRequester
. 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.BucketRequestPaymentConfigurationV2
instead. - server
Side 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.BucketServerSideEncryptionConfigurationV2
instead. - Map<String,String>
Map of tags to assign to the bucket. If configured with a provider
default_tags
configuration 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<Bucket
V2Versioning> - 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.BucketVersioningV2
instead. - websites
List<Bucket
V2Website> - 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.BucketWebsiteConfigurationV2
instead.
- acceleration
Status string - Sets the accelerate configuration of an existing bucket. Can be
Enabled
orSuspended
. Cannot be used incn-north-1
orus-gov-west-1
. This provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAccelerateConfigurationV2
instead. - 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.BucketAclV2
instead. - 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.DirectoryBucket
resource to manage S3 Express buckets. - bucket
Prefix 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. - cors
Rules 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.BucketCorsConfigurationV2
instead. - force
Destroy 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 up
run before a destroy is required to update this value in the resource state. Without a successfulpulumi up
after 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 up
is required to set this value in state before it will take effect on a destroy operation. - grants
Bucket
V2Grant[] - 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.BucketAclV2
instead. - lifecycle
Rules 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.BucketLifecycleConfigurationV2
instead. - loggings
Bucket
V2Logging[] - 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.BucketLoggingV2
instead. - object
Lock 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_enabled
parameter and the resourceaws.s3.BucketObjectLockConfigurationV2
instead. - object
Lock booleanEnabled - Indicates whether this bucket has an Object Lock configuration enabled. Valid values are
true
orfalse
. 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.BucketPolicy
instead. - replication
Configurations 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.BucketReplicationConfig
instead. - request
Payer string - Specifies who should bear the cost of Amazon S3 data transfer.
Can be either
BucketOwner
orRequester
. 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.BucketRequestPaymentConfigurationV2
instead. - server
Side 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.BucketServerSideEncryptionConfigurationV2
instead. - {[key: string]: string}
Map of tags to assign to the bucket. If configured with a provider
default_tags
configuration 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
Bucket
V2Versioning[] - 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.BucketVersioningV2
instead. - websites
Bucket
V2Website[] - 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.BucketWebsiteConfigurationV2
instead.
- acceleration_
status str - Sets the accelerate configuration of an existing bucket. Can be
Enabled
orSuspended
. Cannot be used incn-north-1
orus-gov-west-1
. This provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAccelerateConfigurationV2
instead. - 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.BucketAclV2
instead. - 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.DirectoryBucket
resource 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.BucketCorsConfigurationV2
instead. - 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 up
run before a destroy is required to update this value in the resource state. Without a successfulpulumi up
after 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 up
is required to set this value in state before it will take effect on a destroy operation. - grants
Sequence[Bucket
V2Grant 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.BucketAclV2
instead. - 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.BucketLifecycleConfigurationV2
instead. - loggings
Sequence[Bucket
V2Logging 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.BucketLoggingV2
instead. - 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_enabled
parameter and the resourceaws.s3.BucketObjectLockConfigurationV2
instead. - object_
lock_ boolenabled - Indicates whether this bucket has an Object Lock configuration enabled. Valid values are
true
orfalse
. 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.BucketPolicy
instead. - 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.BucketReplicationConfig
instead. - request_
payer str - Specifies who should bear the cost of Amazon S3 data transfer.
Can be either
BucketOwner
orRequester
. 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.BucketRequestPaymentConfigurationV2
instead. - 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.BucketServerSideEncryptionConfigurationV2
instead. - Mapping[str, str]
Map of tags to assign to the bucket. If configured with a provider
default_tags
configuration 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[Bucket
V2Versioning 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.BucketVersioningV2
instead. - websites
Sequence[Bucket
V2Website 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.BucketWebsiteConfigurationV2
instead.
- acceleration
Status String - Sets the accelerate configuration of an existing bucket. Can be
Enabled
orSuspended
. Cannot be used incn-north-1
orus-gov-west-1
. This provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAccelerateConfigurationV2
instead. - 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.BucketAclV2
instead. - 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.DirectoryBucket
resource to manage S3 Express buckets. - bucket
Prefix 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. - cors
Rules 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.BucketCorsConfigurationV2
instead. - force
Destroy 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 up
run before a destroy is required to update this value in the resource state. Without a successfulpulumi up
after 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 up
is 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.BucketAclV2
instead. - lifecycle
Rules 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.BucketLifecycleConfigurationV2
instead. - 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.BucketLoggingV2
instead. - object
Lock 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_enabled
parameter and the resourceaws.s3.BucketObjectLockConfigurationV2
instead. - object
Lock BooleanEnabled - Indicates whether this bucket has an Object Lock configuration enabled. Valid values are
true
orfalse
. 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.BucketPolicy
instead. - replication
Configurations 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.BucketReplicationConfig
instead. - request
Payer String - Specifies who should bear the cost of Amazon S3 data transfer.
Can be either
BucketOwner
orRequester
. 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.BucketRequestPaymentConfigurationV2
instead. - server
Side 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.BucketServerSideEncryptionConfigurationV2
instead. - Map<String>
Map of tags to assign to the bucket. If configured with a provider
default_tags
configuration 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.BucketVersioningV2
instead. - 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.BucketWebsiteConfigurationV2
instead.
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
. - Bucket
Domain stringName - Bucket domain name. Will be of format
bucketname.s3.amazonaws.com
. - Bucket
Regional 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.
- Hosted
Zone 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_tags
configuration block. - Website
Domain 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.BucketWebsiteConfigurationV2
instead. - Website
Endpoint 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.BucketWebsiteConfigurationV2
instead.
- Arn string
- ARN of the bucket. Will be of format
arn:aws:s3:::bucketname
. - Bucket
Domain stringName - Bucket domain name. Will be of format
bucketname.s3.amazonaws.com
. - Bucket
Regional 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.
- Hosted
Zone 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_tags
configuration block. - Website
Domain 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.BucketWebsiteConfigurationV2
instead. - Website
Endpoint 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.BucketWebsiteConfigurationV2
instead.
- arn String
- ARN of the bucket. Will be of format
arn:aws:s3:::bucketname
. - bucket
Domain StringName - Bucket domain name. Will be of format
bucketname.s3.amazonaws.com
. - bucket
Regional 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.
- hosted
Zone 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_tags
configuration block. - website
Domain 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.BucketWebsiteConfigurationV2
instead. - website
Endpoint 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.BucketWebsiteConfigurationV2
instead.
- arn string
- ARN of the bucket. Will be of format
arn:aws:s3:::bucketname
. - bucket
Domain stringName - Bucket domain name. Will be of format
bucketname.s3.amazonaws.com
. - bucket
Regional 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.
- hosted
Zone 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_tags
configuration block. - website
Domain 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.BucketWebsiteConfigurationV2
instead. - website
Endpoint 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.BucketWebsiteConfigurationV2
instead.
- 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_tags
configuration 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.BucketWebsiteConfigurationV2
instead. - 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.BucketWebsiteConfigurationV2
instead.
- arn String
- ARN of the bucket. Will be of format
arn:aws:s3:::bucketname
. - bucket
Domain StringName - Bucket domain name. Will be of format
bucketname.s3.amazonaws.com
. - bucket
Regional 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.
- hosted
Zone 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_tags
configuration block. - website
Domain 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.BucketWebsiteConfigurationV2
instead. - website
Endpoint 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.BucketWebsiteConfigurationV2
instead.
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) -> BucketV2
func 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)
Resource lookup is not supported in YAML
- 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.
- Acceleration
Status string - Sets the accelerate configuration of an existing bucket. Can be
Enabled
orSuspended
. Cannot be used incn-north-1
orus-gov-west-1
. This provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAccelerateConfigurationV2
instead. - 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.BucketAclV2
instead. - 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.DirectoryBucket
resource to manage S3 Express buckets. - Bucket
Domain stringName - Bucket domain name. Will be of format
bucketname.s3.amazonaws.com
. - Bucket
Prefix 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. - Bucket
Regional 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.
- Cors
Rules 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.BucketCorsConfigurationV2
instead. - 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 up
run before a destroy is required to update this value in the resource state. Without a successfulpulumi up
after 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 up
is required to set this value in state before it will take effect on a destroy operation. - Grants
List<Bucket
V2Grant> - 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.BucketAclV2
instead. - Hosted
Zone stringId - Route 53 Hosted Zone ID for this bucket's region.
- Lifecycle
Rules 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.BucketLifecycleConfigurationV2
instead. - Loggings
List<Bucket
V2Logging> - 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.BucketLoggingV2
instead. - Object
Lock 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_enabled
parameter and the resourceaws.s3.BucketObjectLockConfigurationV2
instead. - Object
Lock boolEnabled - Indicates whether this bucket has an Object Lock configuration enabled. Valid values are
true
orfalse
. 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.BucketPolicy
instead. - Region string
- AWS region this bucket resides in.
- Replication
Configurations 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.BucketReplicationConfig
instead. - Request
Payer string - Specifies who should bear the cost of Amazon S3 data transfer.
Can be either
BucketOwner
orRequester
. 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.BucketRequestPaymentConfigurationV2
instead. - Server
Side 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.BucketServerSideEncryptionConfigurationV2
instead. - Dictionary<string, string>
Map of tags to assign to the bucket. If configured with a provider
default_tags
configuration 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_tags
configuration block. - Versionings
List<Bucket
V2Versioning> - 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.BucketVersioningV2
instead. - Website
Domain 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.BucketWebsiteConfigurationV2
instead. - Website
Endpoint 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.BucketWebsiteConfigurationV2
instead. - Websites
List<Bucket
V2Website> - 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.BucketWebsiteConfigurationV2
instead.
- Acceleration
Status string - Sets the accelerate configuration of an existing bucket. Can be
Enabled
orSuspended
. Cannot be used incn-north-1
orus-gov-west-1
. This provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAccelerateConfigurationV2
instead. - 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.BucketAclV2
instead. - 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.DirectoryBucket
resource to manage S3 Express buckets. - Bucket
Domain stringName - Bucket domain name. Will be of format
bucketname.s3.amazonaws.com
. - Bucket
Prefix 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. - Bucket
Regional 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.
- Cors
Rules []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.BucketCorsConfigurationV2
instead. - 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 up
run before a destroy is required to update this value in the resource state. Without a successfulpulumi up
after 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 up
is required to set this value in state before it will take effect on a destroy operation. - Grants
[]Bucket
V2Grant 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.BucketAclV2
instead. - Hosted
Zone stringId - Route 53 Hosted Zone ID for this bucket's region.
- Lifecycle
Rules []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.BucketLifecycleConfigurationV2
instead. - Loggings
[]Bucket
V2Logging 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.BucketLoggingV2
instead. - 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_enabled
parameter and the resourceaws.s3.BucketObjectLockConfigurationV2
instead. - Object
Lock boolEnabled - Indicates whether this bucket has an Object Lock configuration enabled. Valid values are
true
orfalse
. 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.BucketPolicy
instead. - Region string
- AWS region this bucket resides in.
- Replication
Configurations []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.BucketReplicationConfig
instead. - Request
Payer string - Specifies who should bear the cost of Amazon S3 data transfer.
Can be either
BucketOwner
orRequester
. 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.BucketRequestPaymentConfigurationV2
instead. - Server
Side []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.BucketServerSideEncryptionConfigurationV2
instead. - map[string]string
Map of tags to assign to the bucket. If configured with a provider
default_tags
configuration 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_tags
configuration block. - Versionings
[]Bucket
V2Versioning 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.BucketVersioningV2
instead. - Website
Domain 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.BucketWebsiteConfigurationV2
instead. - Website
Endpoint 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.BucketWebsiteConfigurationV2
instead. - Websites
[]Bucket
V2Website 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.BucketWebsiteConfigurationV2
instead.
- acceleration
Status String - Sets the accelerate configuration of an existing bucket. Can be
Enabled
orSuspended
. Cannot be used incn-north-1
orus-gov-west-1
. This provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAccelerateConfigurationV2
instead. - 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.BucketAclV2
instead. - 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.DirectoryBucket
resource to manage S3 Express buckets. - bucket
Domain StringName - Bucket domain name. Will be of format
bucketname.s3.amazonaws.com
. - bucket
Prefix 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. - bucket
Regional 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.
- cors
Rules 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.BucketCorsConfigurationV2
instead. - force
Destroy 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 up
run before a destroy is required to update this value in the resource state. Without a successfulpulumi up
after 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 up
is required to set this value in state before it will take effect on a destroy operation. - grants
List<Bucket
V2Grant> - 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.BucketAclV2
instead. - hosted
Zone StringId - Route 53 Hosted Zone ID for this bucket's region.
- lifecycle
Rules 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.BucketLifecycleConfigurationV2
instead. - loggings
List<Bucket
V2Logging> - 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.BucketLoggingV2
instead. - object
Lock 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_enabled
parameter and the resourceaws.s3.BucketObjectLockConfigurationV2
instead. - object
Lock BooleanEnabled - Indicates whether this bucket has an Object Lock configuration enabled. Valid values are
true
orfalse
. 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.BucketPolicy
instead. - region String
- AWS region this bucket resides in.
- replication
Configurations 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.BucketReplicationConfig
instead. - request
Payer String - Specifies who should bear the cost of Amazon S3 data transfer.
Can be either
BucketOwner
orRequester
. 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.BucketRequestPaymentConfigurationV2
instead. - server
Side 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.BucketServerSideEncryptionConfigurationV2
instead. - Map<String,String>
Map of tags to assign to the bucket. If configured with a provider
default_tags
configuration 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_tags
configuration block. - versionings
List<Bucket
V2Versioning> - 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.BucketVersioningV2
instead. - website
Domain 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.BucketWebsiteConfigurationV2
instead. - website
Endpoint 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.BucketWebsiteConfigurationV2
instead. - websites
List<Bucket
V2Website> - 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.BucketWebsiteConfigurationV2
instead.
- acceleration
Status string - Sets the accelerate configuration of an existing bucket. Can be
Enabled
orSuspended
. Cannot be used incn-north-1
orus-gov-west-1
. This provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAccelerateConfigurationV2
instead. - 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.BucketAclV2
instead. - 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.DirectoryBucket
resource to manage S3 Express buckets. - bucket
Domain stringName - Bucket domain name. Will be of format
bucketname.s3.amazonaws.com
. - bucket
Prefix 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. - bucket
Regional 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.
- cors
Rules 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.BucketCorsConfigurationV2
instead. - force
Destroy 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 up
run before a destroy is required to update this value in the resource state. Without a successfulpulumi up
after 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 up
is required to set this value in state before it will take effect on a destroy operation. - grants
Bucket
V2Grant[] - 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.BucketAclV2
instead. - hosted
Zone stringId - Route 53 Hosted Zone ID for this bucket's region.
- lifecycle
Rules 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.BucketLifecycleConfigurationV2
instead. - loggings
Bucket
V2Logging[] - 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.BucketLoggingV2
instead. - object
Lock 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_enabled
parameter and the resourceaws.s3.BucketObjectLockConfigurationV2
instead. - object
Lock booleanEnabled - Indicates whether this bucket has an Object Lock configuration enabled. Valid values are
true
orfalse
. 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.BucketPolicy
instead. - region string
- AWS region this bucket resides in.
- replication
Configurations 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.BucketReplicationConfig
instead. - request
Payer string - Specifies who should bear the cost of Amazon S3 data transfer.
Can be either
BucketOwner
orRequester
. 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.BucketRequestPaymentConfigurationV2
instead. - server
Side 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.BucketServerSideEncryptionConfigurationV2
instead. - {[key: string]: string}
Map of tags to assign to the bucket. If configured with a provider
default_tags
configuration 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_tags
configuration block. - versionings
Bucket
V2Versioning[] - 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.BucketVersioningV2
instead. - website
Domain 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.BucketWebsiteConfigurationV2
instead. - website
Endpoint 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.BucketWebsiteConfigurationV2
instead. - websites
Bucket
V2Website[] - 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.BucketWebsiteConfigurationV2
instead.
- acceleration_
status str - Sets the accelerate configuration of an existing bucket. Can be
Enabled
orSuspended
. Cannot be used incn-north-1
orus-gov-west-1
. This provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAccelerateConfigurationV2
instead. - 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.BucketAclV2
instead. - 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.DirectoryBucket
resource 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.BucketCorsConfigurationV2
instead. - 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 up
run before a destroy is required to update this value in the resource state. Without a successfulpulumi up
after 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 up
is required to set this value in state before it will take effect on a destroy operation. - grants
Sequence[Bucket
V2Grant 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.BucketAclV2
instead. - 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.BucketLifecycleConfigurationV2
instead. - loggings
Sequence[Bucket
V2Logging 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.BucketLoggingV2
instead. - 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_enabled
parameter and the resourceaws.s3.BucketObjectLockConfigurationV2
instead. - object_
lock_ boolenabled - Indicates whether this bucket has an Object Lock configuration enabled. Valid values are
true
orfalse
. 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.BucketPolicy
instead. - 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.BucketReplicationConfig
instead. - request_
payer str - Specifies who should bear the cost of Amazon S3 data transfer.
Can be either
BucketOwner
orRequester
. 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.BucketRequestPaymentConfigurationV2
instead. - 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.BucketServerSideEncryptionConfigurationV2
instead. - Mapping[str, str]
Map of tags to assign to the bucket. If configured with a provider
default_tags
configuration 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_tags
configuration block. - versionings
Sequence[Bucket
V2Versioning 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.BucketVersioningV2
instead. - 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.BucketWebsiteConfigurationV2
instead. - 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.BucketWebsiteConfigurationV2
instead. - websites
Sequence[Bucket
V2Website 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.BucketWebsiteConfigurationV2
instead.
- acceleration
Status String - Sets the accelerate configuration of an existing bucket. Can be
Enabled
orSuspended
. Cannot be used incn-north-1
orus-gov-west-1
. This provider will only perform drift detection if a configuration value is provided. Use the resourceaws.s3.BucketAccelerateConfigurationV2
instead. - 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.BucketAclV2
instead. - 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.DirectoryBucket
resource to manage S3 Express buckets. - bucket
Domain StringName - Bucket domain name. Will be of format
bucketname.s3.amazonaws.com
. - bucket
Prefix 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. - bucket
Regional 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.
- cors
Rules 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.BucketCorsConfigurationV2
instead. - force
Destroy 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 up
run before a destroy is required to update this value in the resource state. Without a successfulpulumi up
after 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 up
is 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.BucketAclV2
instead. - hosted
Zone StringId - Route 53 Hosted Zone ID for this bucket's region.
- lifecycle
Rules 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.BucketLifecycleConfigurationV2
instead. - 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.BucketLoggingV2
instead. - object
Lock 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_enabled
parameter and the resourceaws.s3.BucketObjectLockConfigurationV2
instead. - object
Lock BooleanEnabled - Indicates whether this bucket has an Object Lock configuration enabled. Valid values are
true
orfalse
. 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.BucketPolicy
instead. - region String
- AWS region this bucket resides in.
- replication
Configurations 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.BucketReplicationConfig
instead. - request
Payer String - Specifies who should bear the cost of Amazon S3 data transfer.
Can be either
BucketOwner
orRequester
. 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.BucketRequestPaymentConfigurationV2
instead. - server
Side 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.BucketServerSideEncryptionConfigurationV2
instead. - Map<String>
Map of tags to assign to the bucket. If configured with a provider
default_tags
configuration 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_tags
configuration 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.BucketVersioningV2
instead. - website
Domain 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.BucketWebsiteConfigurationV2
instead. - website
Endpoint 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.BucketWebsiteConfigurationV2
instead. - 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.BucketWebsiteConfigurationV2
instead.
Supporting Types
BucketV2CorsRule, BucketV2CorsRuleArgs
- Allowed
Methods List<string> - One or more HTTP methods that you allow the origin to execute. Can be
GET
,PUT
,POST
,DELETE
orHEAD
. - Allowed
Origins List<string> - One or more origins you want customers to be able to access the bucket from.
- Allowed
Headers List<string> - List of headers allowed.
- Expose
Headers 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
XMLHttpRequest
object). - Max
Age intSeconds - Specifies time in seconds that browser can cache the response for a preflight request.
- Allowed
Methods []string - One or more HTTP methods that you allow the origin to execute. Can be
GET
,PUT
,POST
,DELETE
orHEAD
. - Allowed
Origins []string - One or more origins you want customers to be able to access the bucket from.
- Allowed
Headers []string - List of headers allowed.
- Expose
Headers []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
XMLHttpRequest
object). - Max
Age intSeconds - Specifies time in seconds that browser can cache the response for a preflight request.
- allowed
Methods List<String> - One or more HTTP methods that you allow the origin to execute. Can be
GET
,PUT
,POST
,DELETE
orHEAD
. - allowed
Origins List<String> - One or more origins you want customers to be able to access the bucket from.
- allowed
Headers List<String> - List of headers allowed.
- expose
Headers 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
XMLHttpRequest
object). - max
Age IntegerSeconds - Specifies time in seconds that browser can cache the response for a preflight request.
- allowed
Methods string[] - One or more HTTP methods that you allow the origin to execute. Can be
GET
,PUT
,POST
,DELETE
orHEAD
. - allowed
Origins string[] - One or more origins you want customers to be able to access the bucket from.
- allowed
Headers string[] - List of headers allowed.
- expose
Headers 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
XMLHttpRequest
object). - max
Age 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
,DELETE
orHEAD
. - 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
XMLHttpRequest
object). - max_
age_ intseconds - Specifies time in seconds that browser can cache the response for a preflight request.
- allowed
Methods List<String> - One or more HTTP methods that you allow the origin to execute. Can be
GET
,PUT
,POST
,DELETE
orHEAD
. - allowed
Origins List<String> - One or more origins you want customers to be able to access the bucket from.
- allowed
Headers List<String> - List of headers allowed.
- expose
Headers 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
XMLHttpRequest
object). - max
Age 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
CanonicalUser
andGroup
.AmazonCustomerByEmail
is not supported. - Id string
- Canonical user id to grant for. Used only when
type
isCanonicalUser
. - Uri string
- Uri address to grant for. Used only when
type
isGroup
.
- 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
CanonicalUser
andGroup
.AmazonCustomerByEmail
is not supported. - Id string
- Canonical user id to grant for. Used only when
type
isCanonicalUser
. - Uri string
- Uri address to grant for. Used only when
type
isGroup
.
- 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
CanonicalUser
andGroup
.AmazonCustomerByEmail
is not supported. - id String
- Canonical user id to grant for. Used only when
type
isCanonicalUser
. - uri String
- Uri address to grant for. Used only when
type
isGroup
.
- 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
CanonicalUser
andGroup
.AmazonCustomerByEmail
is not supported. - id string
- Canonical user id to grant for. Used only when
type
isCanonicalUser
. - uri string
- Uri address to grant for. Used only when
type
isGroup
.
- 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
CanonicalUser
andGroup
.AmazonCustomerByEmail
is not supported. - id str
- Canonical user id to grant for. Used only when
type
isCanonicalUser
. - uri str
- Uri address to grant for. Used only when
type
isGroup
.
- 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
CanonicalUser
andGroup
.AmazonCustomerByEmail
is not supported. - id String
- Canonical user id to grant for. Used only when
type
isCanonicalUser
. - uri String
- Uri address to grant for. Used only when
type
isGroup
.
BucketV2LifecycleRule, BucketV2LifecycleRuleArgs
- 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
List<Bucket
V2Lifecycle 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.
- Noncurrent
Version List<BucketExpirations V2Lifecycle Rule Noncurrent Version Expiration> - Specifies when noncurrent object versions expire. See Noncurrent Version Expiration below for details.
- Noncurrent
Version 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<Bucket
V2Lifecycle 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
[]Bucket
V2Lifecycle 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.
- Noncurrent
Version []BucketExpirations V2Lifecycle Rule Noncurrent Version Expiration - Specifies when noncurrent object versions expire. See Noncurrent Version Expiration below for details.
- Noncurrent
Version []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
[]Bucket
V2Lifecycle Rule Transition - Specifies a period in the object's transitions. See Transition below for details.
- enabled Boolean
- Specifies lifecycle rule status.
- abort
Incomplete IntegerMultipart Upload Days - Specifies the number of days after initiating a multipart upload when the multipart upload must be completed.
- expirations
List<Bucket
V2Lifecycle 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.
- noncurrent
Version List<BucketExpirations V2Lifecycle Rule Noncurrent Version Expiration> - Specifies when noncurrent object versions expire. See Noncurrent Version Expiration below for details.
- noncurrent
Version 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<Bucket
V2Lifecycle Rule Transition> - Specifies a period in the object's transitions. See Transition below for details.
- enabled boolean
- Specifies lifecycle rule status.
- abort
Incomplete numberMultipart Upload Days - Specifies the number of days after initiating a multipart upload when the multipart upload must be completed.
- expirations
Bucket
V2Lifecycle 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.
- noncurrent
Version BucketExpirations V2Lifecycle Rule Noncurrent Version Expiration[] - Specifies when noncurrent object versions expire. See Noncurrent Version Expiration below for details.
- noncurrent
Version 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
Bucket
V2Lifecycle 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[Bucket
V2Lifecycle 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[Bucket
V2Lifecycle Rule Transition] - Specifies a period in the object's transitions. See Transition below for details.
- enabled Boolean
- Specifies lifecycle rule status.
- abort
Incomplete 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.
- noncurrent
Version List<Property Map>Expirations - Specifies when noncurrent object versions expire. See Noncurrent Version Expiration below for details.
- noncurrent
Version 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.
- 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 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 Integer
- Specifies the number of days after object creation when the specific rule action takes effect.
- expired
Object 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.
- expired
Object 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.
- expired
Object 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
- Storage
Class 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.
- Storage
Class 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.
- storage
Class 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.
- storage
Class 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.
- storage
Class 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
- Storage
Class 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.
- Storage
Class 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.
- storage
Class 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.
- storage
Class 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.
- storage
Class 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
- Target
Bucket string - Name of the bucket that will receive the log objects.
- Target
Prefix string - To specify a key prefix for log objects.
- Target
Bucket string - Name of the bucket that will receive the log objects.
- Target
Prefix string - To specify a key prefix for log objects.
- target
Bucket String - Name of the bucket that will receive the log objects.
- target
Prefix String - To specify a key prefix for log objects.
- target
Bucket string - Name of the bucket that will receive the log objects.
- target
Prefix 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.
- target
Bucket String - Name of the bucket that will receive the log objects.
- target
Prefix String - To specify a key prefix for log objects.
BucketV2ObjectLockConfiguration, BucketV2ObjectLockConfigurationArgs
- Object
Lock stringEnabled - Indicates whether this bucket has an Object Lock configuration enabled. Valid values are
true
orfalse
. This argument is not supported in all regions or partitions. - Rules
List<Bucket
V2Object Lock Configuration Rule> - Object Lock rule in place for this bucket (documented below).
- Object
Lock stringEnabled - Indicates whether this bucket has an Object Lock configuration enabled. Valid values are
true
orfalse
. This argument is not supported in all regions or partitions. - Rules
[]Bucket
V2Object Lock Configuration Rule - Object Lock rule in place for this bucket (documented below).
- object
Lock StringEnabled - Indicates whether this bucket has an Object Lock configuration enabled. Valid values are
true
orfalse
. This argument is not supported in all regions or partitions. - rules
List<Bucket
V2Object Lock Configuration Rule> - Object Lock rule in place for this bucket (documented below).
- object
Lock stringEnabled - Indicates whether this bucket has an Object Lock configuration enabled. Valid values are
true
orfalse
. This argument is not supported in all regions or partitions. - rules
Bucket
V2Object 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
true
orfalse
. This argument is not supported in all regions or partitions. - rules
Sequence[Bucket
V2Object Lock Configuration Rule] - Object Lock rule in place for this bucket (documented below).
- object
Lock StringEnabled - Indicates whether this bucket has an Object Lock configuration enabled. Valid values are
true
orfalse
. 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
- Default
Retentions List<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 []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 List<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 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).
- default
Retentions 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
GOVERNANCE
andCOMPLIANCE
. - 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
GOVERNANCE
andCOMPLIANCE
. - 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
GOVERNANCE
andCOMPLIANCE
. - 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
GOVERNANCE
andCOMPLIANCE
. - 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
GOVERNANCE
andCOMPLIANCE
. - 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
GOVERNANCE
andCOMPLIANCE
. - 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<Bucket
V2Replication 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
[]Bucket
V2Replication 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<Bucket
V2Replication 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
Bucket
V2Replication 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[Bucket
V2Replication 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<Bucket
V2Replication Configuration Rule Destination> - Specifies the destination for the rule (documented below).
- Status string
- Status of the rule. Either
Enabled
orDisabled
. The rule is ignored if status is not Enabled. - Delete
Marker 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., whenfilter
is used). - Filters
List<Bucket
V2Replication 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
filter
is configured. If not provided, defaults to0
. Priority must be unique between multiple rules. - Source
Selection List<BucketCriterias V2Replication Configuration Rule Source Selection Criteria> - Specifies special object selection criteria (documented below).
- Destinations
[]Bucket
V2Replication Configuration Rule Destination - Specifies the destination for the rule (documented below).
- Status string
- Status of the rule. Either
Enabled
orDisabled
. The rule is ignored if status is not Enabled. - Delete
Marker 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., whenfilter
is used). - Filters
[]Bucket
V2Replication 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
filter
is configured. If not provided, defaults to0
. Priority must be unique between multiple rules. - Source
Selection []BucketCriterias V2Replication Configuration Rule Source Selection Criteria - Specifies special object selection criteria (documented below).
- destinations
List<Bucket
V2Replication Configuration Rule Destination> - Specifies the destination for the rule (documented below).
- status String
- Status of the rule. Either
Enabled
orDisabled
. The rule is ignored if status is not Enabled. - delete
Marker 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., whenfilter
is used). - filters
List<Bucket
V2Replication 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
filter
is configured. If not provided, defaults to0
. Priority must be unique between multiple rules. - source
Selection List<BucketCriterias V2Replication Configuration Rule Source Selection Criteria> - Specifies special object selection criteria (documented below).
- destinations
Bucket
V2Replication Configuration Rule Destination[] - Specifies the destination for the rule (documented below).
- status string
- Status of the rule. Either
Enabled
orDisabled
. The rule is ignored if status is not Enabled. - delete
Marker 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., whenfilter
is used). - filters
Bucket
V2Replication 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
filter
is configured. If not provided, defaults to0
. Priority must be unique between multiple rules. - source
Selection BucketCriterias V2Replication Configuration Rule Source Selection Criteria[] - Specifies special object selection criteria (documented below).
- destinations
Sequence[Bucket
V2Replication Configuration Rule Destination] - Specifies the destination for the rule (documented below).
- status str
- Status of the rule. Either
Enabled
orDisabled
. 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., whenfilter
is used). - filters
Sequence[Bucket
V2Replication 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
filter
is 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
Enabled
orDisabled
. The rule is ignored if status is not Enabled. - delete
Marker 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., whenfilter
is 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
filter
is configured. If not provided, defaults to0
. Priority must be unique between multiple rules. - source
Selection 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.
- Access
Control 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_id
owner override configuration. - Account
Id string - Account ID to use for overriding the object owner on replication. Must be used in conjunction with
access_control_translation
override configuration. - Metrics
List<Bucket
V2Replication Configuration Rule Destination Metric> - Enables replication metrics (required for S3 RTC) (documented below).
- Replica
Kms stringKey Id - Destination KMS encryption key ARN for SSE-KMS replication. Must be used in conjunction with
sse_kms_encrypted_objects
source selection criteria. - Replication
Times List<BucketV2Replication Configuration Rule Destination Replication Time> - Enables S3 Replication Time Control (S3 RTC) (documented below).
- Storage
Class 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.
- Access
Control []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_id
owner override configuration. - Account
Id string - Account ID to use for overriding the object owner on replication. Must be used in conjunction with
access_control_translation
override configuration. - Metrics
[]Bucket
V2Replication Configuration Rule Destination Metric - Enables replication metrics (required for S3 RTC) (documented below).
- Replica
Kms stringKey Id - Destination KMS encryption key ARN for SSE-KMS replication. Must be used in conjunction with
sse_kms_encrypted_objects
source selection criteria. - Replication
Times []BucketV2Replication Configuration Rule Destination Replication Time - Enables S3 Replication Time Control (S3 RTC) (documented below).
- Storage
Class 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.
- access
Control 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_id
owner override configuration. - account
Id String - Account ID to use for overriding the object owner on replication. Must be used in conjunction with
access_control_translation
override configuration. - metrics
List<Bucket
V2Replication Configuration Rule Destination Metric> - Enables replication metrics (required for S3 RTC) (documented below).
- replica
Kms StringKey Id - Destination KMS encryption key ARN for SSE-KMS replication. Must be used in conjunction with
sse_kms_encrypted_objects
source selection criteria. - replication
Times List<BucketV2Replication Configuration Rule Destination Replication Time> - Enables S3 Replication Time Control (S3 RTC) (documented below).
- storage
Class 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.
- access
Control 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_id
owner override configuration. - account
Id string - Account ID to use for overriding the object owner on replication. Must be used in conjunction with
access_control_translation
override configuration. - metrics
Bucket
V2Replication Configuration Rule Destination Metric[] - Enables replication metrics (required for S3 RTC) (documented below).
- replica
Kms stringKey Id - Destination KMS encryption key ARN for SSE-KMS replication. Must be used in conjunction with
sse_kms_encrypted_objects
source selection criteria. - replication
Times BucketV2Replication Configuration Rule Destination Replication Time[] - Enables S3 Replication Time Control (S3 RTC) (documented below).
- storage
Class 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_id
owner override configuration. - account_
id str - Account ID to use for overriding the object owner on replication. Must be used in conjunction with
access_control_translation
override configuration. - metrics
Sequence[Bucket
V2Replication 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_objects
source 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.
- access
Control List<Property Map>Translations - Specifies the overrides to use for object owners on replication (documented below). Must be used in conjunction with
account_id
owner override configuration. - account
Id String - Account ID to use for overriding the object owner on replication. Must be used in conjunction with
access_control_translation
override configuration. - metrics List<Property Map>
- Enables replication metrics (required for S3 RTC) (documented below).
- replica
Kms StringKey Id - Destination KMS encryption key ARN for SSE-KMS replication. Must be used in conjunction with
sse_kms_encrypted_objects
source selection criteria. - replication
Times List<Property Map> - Enables S3 Replication Time Control (S3 RTC) (documented below).
- storage
Class 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
- Sse
Kms 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_id
indestination
must be specified as well.
- Sse
Kms []BucketEncrypted Objects V2Replication Configuration Rule Source Selection Criteria Sse Kms Encrypted Object - Match SSE-KMS encrypted objects (documented below). If specified,
replica_kms_key_id
indestination
must be specified as well.
- sse
Kms 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_id
indestination
must be specified as well.
- sse
Kms BucketEncrypted Objects V2Replication Configuration Rule Source Selection Criteria Sse Kms Encrypted Object[] - Match SSE-KMS encrypted objects (documented below). If specified,
replica_kms_key_id
indestination
must 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_id
indestination
must be specified as well.
- sse
Kms List<Property Map>Encrypted Objects - Match SSE-KMS encrypted objects (documented below). If specified,
replica_kms_key_id
indestination
must 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<Bucket
V2Server Side Encryption Configuration Rule> - Single object for server-side encryption by default configuration. (documented below)
- Rules
[]Bucket
V2Server Side Encryption Configuration Rule - Single object for server-side encryption by default configuration. (documented below)
- rules
List<Bucket
V2Server Side Encryption Configuration Rule> - Single object for server-side encryption by default configuration. (documented below)
- rules
Bucket
V2Server Side Encryption Configuration Rule[] - Single object for server-side encryption by default configuration. (documented below)
- rules
Sequence[Bucket
V2Server 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
- Apply
Server 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)
- Bucket
Key boolEnabled - Whether or not to use Amazon S3 Bucket Keys for SSE-KMS.
- Apply
Server []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.
- apply
Server 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)
- bucket
Key BooleanEnabled - Whether or not to use Amazon S3 Bucket Keys for SSE-KMS.
- apply
Server 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 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.
- apply
Server List<Property Map>Side Encryption By Defaults - Single object for setting server-side encryption by default. (documented below)
- bucket
Key BooleanEnabled - Whether or not to use Amazon S3 Bucket Keys for SSE-KMS.
BucketV2ServerSideEncryptionConfigurationRuleApplyServerSideEncryptionByDefault, BucketV2ServerSideEncryptionConfigurationRuleApplyServerSideEncryptionByDefaultArgs
- Sse
Algorithm string - Server-side encryption algorithm to use. Valid values are
AES256
andaws:kms
- Kms
Master 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_algorithm
asaws:kms
. The defaultaws/s3
AWS KMS master key is used if this element is absent while thesse_algorithm
isaws:kms
.
- Sse
Algorithm string - Server-side encryption algorithm to use. Valid values are
AES256
andaws:kms
- Kms
Master 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_algorithm
asaws:kms
. The defaultaws/s3
AWS KMS master key is used if this element is absent while thesse_algorithm
isaws:kms
.
- sse
Algorithm String - Server-side encryption algorithm to use. Valid values are
AES256
andaws:kms
- kms
Master 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_algorithm
asaws:kms
. The defaultaws/s3
AWS KMS master key is used if this element is absent while thesse_algorithm
isaws:kms
.
- sse
Algorithm string - Server-side encryption algorithm to use. Valid values are
AES256
andaws:kms
- kms
Master 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_algorithm
asaws:kms
. The defaultaws/s3
AWS KMS master key is used if this element is absent while thesse_algorithm
isaws:kms
.
- sse_
algorithm str - Server-side encryption algorithm to use. Valid values are
AES256
andaws: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_algorithm
asaws:kms
. The defaultaws/s3
AWS KMS master key is used if this element is absent while thesse_algorithm
isaws:kms
.
- sse
Algorithm String - Server-side encryption algorithm to use. Valid values are
AES256
andaws:kms
- kms
Master 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_algorithm
asaws:kms
. The defaultaws/s3
AWS KMS master key is used if this element is absent while thesse_algorithm
isaws: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.
- Mfa
Delete bool - Enable MFA delete for either
Change the versioning state of your bucket
orPermanently 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 bucket
orPermanently 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.
- mfa
Delete Boolean - Enable MFA delete for either
Change the versioning state of your bucket
orPermanently 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.
- mfa
Delete boolean - Enable MFA delete for either
Change the versioning state of your bucket
orPermanently 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 bucket
orPermanently 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.
- mfa
Delete Boolean - Enable MFA delete for either
Change the versioning state of your bucket
orPermanently 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
- Error
Document string - Absolute path to the document to return in case of a 4XX error.
- Index
Document string - Amazon S3 returns this index document when requests are made to the root domain or any of the subfolders.
- Redirect
All 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. - Routing
Rules string - JSON array containing routing rules describing redirect behavior and when redirects are applied.
- Error
Document string - Absolute path to the document to return in case of a 4XX error.
- Index
Document string - Amazon S3 returns this index document when requests are made to the root domain or any of the subfolders.
- Redirect
All 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. - Routing
Rules string - JSON array containing routing rules describing redirect behavior and when redirects are applied.
- error
Document String - Absolute path to the document to return in case of a 4XX error.
- index
Document String - Amazon S3 returns this index document when requests are made to the root domain or any of the subfolders.
- redirect
All 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. - routing
Rules String - JSON array containing routing rules describing redirect behavior and when redirects are applied.
- error
Document string - Absolute path to the document to return in case of a 4XX error.
- index
Document string - Amazon S3 returns this index document when requests are made to the root domain or any of the subfolders.
- redirect
All 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. - routing
Rules 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.
- error
Document String - Absolute path to the document to return in case of a 4XX error.
- index
Document String - Amazon S3 returns this index document when requests are made to the root domain or any of the subfolders.
- redirect
All 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. - routing
Rules 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
aws
Terraform Provider.
Try AWS Native preview for resources not in the classic version.