2.8 KiB
layout | page_title | sidebar_current | description |
---|---|---|---|
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 asstring
to be uploaded. Must be defined ifsource
is not. -
source
- (Optional) A path to the data you want to upload. Must be defined ifcontent
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 togoogle_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.