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

2.8 KiB
Raw Blame History

layout page_title sidebar_current description
google Google: google_storage_bucket_object docs-google-storage-bucket-object Creates a new object inside a specified bucket

google_storage_bucket_object

Creates a new object inside an existing bucket in Google cloud storage service (GCS). Currently, it does not support creating custom ACLs. For more information see the official documentation and API.

Example Usage

Example creating a public object in an existing image-store bucket.

resource "google_storage_bucket_object" "picture" {
  name   = "butterfly01"
  source = "/images/nature/garden-tiger-moth.jpg"
  bucket = "image-store"
}

Argument Reference

The following arguments are supported:

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

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

One of the following is required:

  • content - (Optional) Data as string to be uploaded. Must be defined if source is not.

  • source - (Optional) A path to the data you want to upload. Must be defined if content is not.

  • cache_control - (Optional) Cache-Control directive to specify caching behavior of object data. If omitted and object is accessible to all anonymous users, the default will be public, max-age=3600

  • content_disposition - (Optional) Content-Disposition of the object data.

  • content_encoding - (Optional) Content-Encoding of the object data.

  • content_language - (Optional) Content-Language of the object data.

  • content_type - (Optional) Content-Type of the object data. Defaults to "application/octet-stream" or "text/plain; charset=utf-8".

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

  • storage_class - (Optional) The StorageClass of the new bucket object. Supported values include: MULTI_REGIONAL, REGIONAL, NEARLINE, COLDLINE. If not provided, this defaults to the bucket's default storage class or to a standard class.

Attributes Reference

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

  • crc32c - (Computed) Base 64 CRC32 hash of the uploaded data.

  • md5hash - (Computed) Base 64 MD5 hash of the uploaded data.