resilien
/
terraform
2
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
terraform/website/source/docs/providers/google/r/storage_bucket.html.markdown

2.3 KiB
Raw Blame History

layout page_title sidebar_current description
google Google: google_storage_bucket docs-google-storage-bucket Creates a new bucket in Google Cloud Storage.

google_storage_bucket

Creates a new bucket in Google cloud storage service(GCS). Currently, it will not change location nor ACL once a bucket has been created with Terraform. For more information see the official documentation and API.

Example Usage

Example creating a private bucket in standard storage, in the EU region.

resource "google_storage_bucket" "image-store" {
  name     = "image-store-bucket"
  location = "EU"

  website {
    main_page_suffix = "index.html"
    not_found_page   = "404.html"
  }
}

Argument Reference

The following arguments are supported:

  • name - (Required) The name of the bucket.

  • force_destroy - (Optional, Default: false) When deleting a bucket, this boolean option will delete all contained objects. If you try to delete a bucket that contains objects, Terraform will fail that run.

  • location - (Optional, Default: 'US') The GCS location

  • predefined_acl - (Optional, Deprecated) The canned GCS ACL to apply. Please switch to google_storage_bucket_acl.predefined_acl.

  • project - (Optional) The project in which the resource belongs. If it is not provided, the provider project is used.

  • storage_class - (Optional) The Storage Class of the new bucket. Supported values include: MULTI_REGIONAL, REGIONAL, NEARLINE, COLDLINE.

  • website - (Optional) Configuration if the bucket acts as a website.

The optional website block supports:

  • main_page_suffix - (Optional) Behaves as the bucket's directory index where missing objects are treated as potential directories.

  • not_found_page - (Optional) The custom object to return when a requested resource is not found.

Attributes Reference

In addition to the arguments listed above, the following computed attributes are exported:

  • self_link - The URI of the created resource.

  • url - The base URL of the bucket, in the format gs://<bucket-name>.