Editing Terraform S3 backend

[[Terraform]] [[S3]] backend. 
* https://www.terraform.io/docs/language/settings/backends/s3.html

== Basic S3 example in [[provider.tf]] ==
 terraform {
   backend "s3" {
     [[bucket]] = "[[aws s3 ls|your-terraform-states]]"
     [[Terraform S3 backend|key]]<ref>https://www.terraform.io/docs/language/settings/backends/s3.html#key</ref>    = "[[terraform.tfstate]]"
     [[profile]] = "your-profile"
   }
 }

https://www.terraform.io/docs/language/settings/backends/s3.html#example-configuration
 terraform {
   backend "s3" {
     [[bucket]] = "mybucket"
     [[key]]    = "path/to/my/key"
     [[region]] = "us-east-1"
   }
 }

== Example including [[DynamoDB]] table ==
 terraform {
   backend "s3" {
     [[bucket]] = "your-terraform-states"
     [[key]]<ref>https://www.terraform.io/docs/language/settings/backends/s3.html#key</ref>    = "[[terraform.tfstate]]"
     region = "[[us-west-2]]"
     [[dynamodb_table]] = "your-terraform-states"
     [[profile]] = "your-profile"
     [[workspace_key_prefix]] = "your-workspace"
   }
 }

* <code>[[profile]]</code>: https://www.terraform.io/docs/language/settings/backends/s3.html#profile
* <code>[[key]]</code>: path to the [[state file]] inside the [[S3 Bucket]]. https://www.terraform.io/docs/language/settings/backends/s3.html#key

 Successfully configured the backend "s3"! Terraform will automatically
 use this backend unless the backend configuration changes.
 Error refreshing state: AccessDenied: Access Denied status code: 403, request id: JDK297FD1E5GY3TT, host id: JJJ1ThvIKmNSYOO3h2IZFECn9l8DnsofwXWk4F6a9/nzrqgNNbOzyw9d2PcAXSb4DDYwkr/VNWZ0

== S3 backend errors ==
* [[Error: Backend configuration changed]]
* [[Error: Failed to get existing workspaces: S3 bucket does not exist.]]: <code>[[aws s3 mb]]</code>

== Related terms ==
* <code>[[terraform init]]</code>
* [[Bucket versioning]]
* [[Remote state backends to manage Terraform state]]
* <code>[[terraform_remote_state]]</code> [[data source]]
* <code>[[aws s3api create-bucket]]</code> and <code>[[aws s3 mb]]</code>
* <code>[[aws s3 ls]]</code>
* <code>[[provider.tf]]</code>

== See also ==
* {{tf files}}
* {{Terraform backends}}

[[Category:Terraform]]