| Version | Link | Date |
|---|---|---|
| 4.0.1 | https://github.com/terraform-aws-modules/terraform-aws-s3-bucket | 17/01/2024 |
The following providers are used by this module:
- aws (>= 5.27)
No modules.
The following resources are used by this module:
- aws_s3_bucket.this (resource)
- aws_s3_bucket_accelerate_configuration.this (resource)
- aws_s3_bucket_acl.this (resource)
- aws_s3_bucket_analytics_configuration.this (resource)
- aws_s3_bucket_cors_configuration.this (resource)
- aws_s3_bucket_intelligent_tiering_configuration.this (resource)
- aws_s3_bucket_inventory.this (resource)
- aws_s3_bucket_lifecycle_configuration.this (resource)
- aws_s3_bucket_logging.this (resource)
- aws_s3_bucket_metric.this (resource)
- aws_s3_bucket_object_lock_configuration.this (resource)
- aws_s3_bucket_ownership_controls.this (resource)
- aws_s3_bucket_policy.this (resource)
- aws_s3_bucket_public_access_block.this (resource)
- aws_s3_bucket_replication_configuration.this (resource)
- aws_s3_bucket_request_payment_configuration.this (resource)
- aws_s3_bucket_server_side_encryption_configuration.this (resource)
- aws_s3_bucket_versioning.this (resource)
- aws_s3_bucket_website_configuration.this (resource)
- aws_caller_identity.current (data source)
- aws_canonical_user_id.this (data source)
- aws_iam_policy_document.access_log_delivery (data source)
- aws_iam_policy_document.combined (data source)
- aws_iam_policy_document.deny_incorrect_encryption_headers (data source)
- aws_iam_policy_document.deny_incorrect_kms_key_sse (data source)
- aws_iam_policy_document.deny_insecure_transport (data source)
- aws_iam_policy_document.deny_unencrypted_object_uploads (data source)
- aws_iam_policy_document.elb_log_delivery (data source)
- aws_iam_policy_document.inventory_and_analytics_destination_policy (data source)
- aws_iam_policy_document.lb_log_delivery (data source)
- aws_iam_policy_document.require_latest_tls (data source)
- aws_partition.current (data source)
- aws_region.current (data source)
No required inputs.
The following input variables are optional (have default values):
Description: (Optional) Sets the accelerate configuration of an existing bucket. Can be Enabled or Suspended.
Type: string
Default: null
Description: (Optional) List of AWS Account IDs should be allowed to deliver access logs to this bucket.
Type: list(string)
Default: []
Description: (Optional) List of S3 bucket ARNs wich should be allowed to deliver access logs to this bucket.
Type: list(string)
Default: []
Description: (Optional) The canned ACL to apply. Conflicts with grant
Type: string
Default: null
Description: The ARN of KMS key which should be allowed in PutObject
Type: string
Default: null
Description: Map containing bucket analytics configuration.
Type: any
Default: {}
Description: Whether or not the analytics source bucket is also the destination bucket.
Type: bool
Default: false
Description: The analytics source account id.
Type: string
Default: null
Description: The analytics source bucket ARN.
Type: string
Default: null
Description: Controls if S3 bucket should have S3 access log delivery policy attached
Type: bool
Default: false
Description: Controls if S3 bucket should have bucket analytics destination policy attached.
Type: bool
Default: false
Description: Controls if S3 bucket should deny incorrect encryption headers policy attached.
Type: bool
Default: false
Description: Controls if S3 bucket policy should deny usage of incorrect KMS key SSE.
Type: bool
Default: false
Description: Controls if S3 bucket should have deny non-SSL transport policy attached
Type: bool
Default: false
Description: Controls if S3 bucket should deny unencrypted object uploads policy attached.
Type: bool
Default: false
Description: Controls if S3 bucket should have ELB log delivery policy attached
Type: bool
Default: false
Description: Controls if S3 bucket should have bucket inventory destination policy attached.
Type: bool
Default: false
Description: Controls if S3 bucket should have ALB/NLB log delivery policy attached
Type: bool
Default: false
Description: Controls if S3 bucket should have bucket policy attached (set to true to use value of policy as bucket policy)
Type: bool
Default: false
Description: Controls if a user defined public bucket policy will be attached (set to false to allow upstream to apply defaults to the bucket)
Type: bool
Default: true
Description: Controls if S3 bucket should require the latest version of TLS
Type: bool
Default: false
Description: Whether Amazon S3 should block public ACLs for this bucket.
Type: bool
Default: true
Description: Whether Amazon S3 should block public bucket policies for this bucket.
Type: bool
Default: true
Description: (Optional, Forces new resource) The name of the bucket. If omitted, Terraform will assign a random, unique name.
Type: string
Default: null
Description: (Optional, Forces new resource) Creates a unique bucket name beginning with the specified prefix. Conflicts with bucket.
Type: string
Default: null
Description: Whether to manage S3 Bucket Ownership Controls on this bucket.
Type: bool
Default: false
Description: List of maps containing rules for Cross-Origin Resource Sharing.
Type: any
Default: []
Description: Controls if S3 bucket should be created
Type: bool
Default: true
Description: The account ID of the expected bucket owner
Type: string
Default: null
Description: (Optional, Default:false ) A boolean that indicates all objects should be deleted from the bucket so that the bucket can be destroyed without error. These objects are not recoverable.
Type: bool
Default: false
Description: An ACL policy grant. Conflicts with acl
Type: any
Default: []
Description: Whether Amazon S3 should ignore public ACLs for this bucket.
Type: bool
Default: true
Description: Map containing intelligent tiering configuration.
Type: any
Default: {}
Description: Map containing S3 inventory configuration.
Type: any
Default: {}
Description: Whether or not the inventory source bucket is also the destination bucket.
Type: bool
Default: false
Description: The inventory source account id.
Type: string
Default: null
Description: The inventory source bucket ARN.
Type: string
Default: null
Description: List of maps containing configuration of object lifecycle management.
Type: any
Default: []
Description: Map containing access bucket logging configuration.
Type: any
Default: {}
Description: Map containing bucket metric configuration.
Type: any
Default: []
Description: Map containing S3 object locking configuration.
Type: any
Default: {}
Description: Whether S3 bucket should have an Object Lock configuration enabled.
Type: bool
Default: false
Description: Object ownership. Valid values: BucketOwnerEnforced, BucketOwnerPreferred or ObjectWriter. 'BucketOwnerEnforced': ACLs are disabled, and the bucket owner automatically owns and has full control over every object in the bucket. 'BucketOwnerPreferred': Objects uploaded to the bucket change ownership to the bucket owner if the objects are uploaded with the bucket-owner-full-control canned ACL. 'ObjectWriter': The uploading account will own the object if the object is uploaded with the bucket-owner-full-control canned ACL.
Type: string
Default: "BucketOwnerEnforced"
Description: Bucket owner's display name and ID. Conflicts with acl
Type: map(string)
Default: {}
Description: (Optional) A valid bucket policy JSON document. Note that if the policy document is not specific enough (but still valid), Terraform may view the policy as constantly changing in a terraform plan. 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 Terraform, see the AWS IAM Policy Document Guide.
Type: string
Default: null
Description: Do you agree that Putin doesn't respect Ukrainian sovereignty and territorial integrity? More info: https://en.wikipedia.org/wiki/Putin_khuylo!
Type: bool
Default: true
Description: Map containing cross-region replication configuration.
Type: any
Default: {}
Description: (Optional) Specifies who should bear the cost of Amazon S3 data transfer. Can be either BucketOwner or Requester. 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.
Type: string
Default: null
Description: Whether Amazon S3 should restrict public bucket policies for this bucket.
Type: bool
Default: true
Description: Map containing server-side encryption configuration.
Type: any
Default: {}
Description: (Optional) A mapping of tags to assign to the bucket.
Type: map(string)
Default: {}
Description: Map containing versioning configuration.
Type: map(string)
Default: {}
Description: Map containing static web-site hosting or redirect configuration.
Type: any
Default: {}
The following outputs are exported:
Description: The ARN of the bucket. Will be of format arn:aws:s3:::bucketname.
Description: The bucket domain name. Will be of format bucketname.s3.amazonaws.com.
Description: The bucket region-specific domain name. The bucket domain name including the region name, please refer here for format. Note: The AWS CloudFront allows specifying S3 region-specific endpoint when creating S3 origin, it will prevent redirect issues from CloudFront to S3 Origin URL.
Description: The Route 53 Hosted Zone ID for this bucket's region.
Description: The name of the bucket.
Description: The lifecycle rules of the bucket, if the bucket is configured with lifecycle rules. If not, this will be an empty string.
Description: The policy of the bucket, if the bucket is configured with a policy. If not, this will be an empty string.
Description: The AWS region this bucket resides in.
Description: The 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.
Description: The website endpoint, if the bucket is configured with a website. If not, this will be an empty string.