» 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

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 unless source 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 - the key 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).
  • version_id - A unique version ID value for the object, if bucket versioning is enabled.