» alicloud_oss_bucket_object
Provides a resource to put a object(content or file) to a oss bucket.
» Example Usage
» Uploading a file to a bucket
resource "alicloud_oss_bucket_object" "object-source" {
bucket = "your_bucket_name"
key = "new_object_key"
source = "path/to/file"
}
» Uploading a content to a bucket
resource "alicloud_oss_bucket" "example" {
bucket = "your_bucket_name"
acl = "public-read"
}
resource "alicloud_oss_bucket_object" "object-content" {
bucket = "${alicloud_oss_bucket.example.bucket}"
key = "new_object_key"
content = "the content that you want to upload."
}
» Argument Reference
Note: If you specify content_encoding
you are responsible for encoding the body appropriately (i.e. source
and content
both expect already encoded/compressed bytes)
The following arguments are supported:
-
bucket
- (Required) The name of the bucket to put the file in. -
key
- (Required) The name of the object once it is in the bucket. -
source
- (Optional) The path to the source file being uploaded to the bucket. -
content
- (Optional unlesssource
given) The literal content being uploaded to the bucket. -
acl
- (Optional) The canned ACL to apply. Defaults to "private". -
content_type
- (Optional) A standard MIME type describing the format of the object data, e.g. application/octet-stream. All Valid MIME Types are valid for this input. -
cache_control
- (Optional) Specifies caching behavior along the request/reply chain. Read RFC2616 Cache-Control for further details. -
content_disposition
- (Optional) Specifies presentational information for the object. Read RFC2616 Content-Disposition for further details. -
content_encoding
- (Optional) Specifies what content encodings have been applied to the object and thus what decoding mechanisms must be applied to obtain the media-type referenced by the Content-Type header field. Read RFC2616 Content-Encoding for further details. -
content_md5
- (Optional) The MD5 value of the content. Read MD5 for computing method. -
expires
- (Optional) Specifies expire date for the the request/response. Read RFC2616 Expires for further details. -
server_side_encryption
- (Optional) Specifies server-side encryption of the object in OSS. At present, it valid value is "AES256
".
Either source
or content
must be provided to specify the bucket content.
These two arguments are mutually-exclusive.
» Attributes Reference
The following attributes are exported
-
id
- thekey
of the resource supplied above. -
content_length
- the content length of request. -
etag
- the ETag generated for the object (an MD5 sum of the object content).