ORCH-1073 [UDX-37] Casper Support large file handling

Added an availability to specify source path to the file. File content
will be split and uploaded by parts.

Author: afedorch

CHANGELOG.md

@@ -3,6 +3,11 @@ All notable changes to this project are documented in this file.
 
 The format is based on [Keep a Changelog](http://keepachangelog.com/).
 
+## 2.2.1 - 2018-08-23
+
+### Added
+- Support for efficient large file upload using the `source` path to the file
+
 ## 2.2.1 - 2018-08-16
 
 ### Added

docs/examples/object_storage/object.tf

@@ -13,12 +13,27 @@ resource "oci_objectstorage_object" "object1" {
   content          = "${file("index.html")}"
 }
 
+resource "oci_objectstorage_object" "source-object" {
+  namespace        = "${data.oci_objectstorage_namespace.ns.namespace}"
+  bucket           = "${oci_objectstorage_bucket.bucket1.name}"
+  object           = "same_index.html"
+  content_language = "en-US"
+  content_type     = "text/html"
+  source           = "index.html"
+}
+
 data "oci_objectstorage_object_head" "object-head1" {
   namespace = "${data.oci_objectstorage_namespace.ns.namespace}"
   bucket    = "${oci_objectstorage_bucket.bucket1.name}"
   object    = "${oci_objectstorage_object.object1.object}"
 }
 
+data "oci_objectstorage_object_head" "source-object-head" {
+  namespace = "${data.oci_objectstorage_namespace.ns.namespace}"
+  bucket    = "${oci_objectstorage_bucket.bucket1.name}"
+  object    = "${oci_objectstorage_object.source-object.object}"
+}
+
 data "oci_objectstorage_objects" "objects1" {
   namespace = "${data.oci_objectstorage_namespace.ns.namespace}"
   bucket    = "${oci_objectstorage_bucket.bucket1.name}"
@@ -33,6 +48,15 @@ output object-head-data {
 EOF
 }
 
+output object-source-head-data {
+  value = <<EOF
+
+  object = ${data.oci_objectstorage_object_head.source-object-head.object}
+  content-length = ${data.oci_objectstorage_object_head.source-object-head.content-length}
+  content-type = ${data.oci_objectstorage_object_head.source-object-head.content-type}
+EOF
+}
+
 output objects {
   value = "${data.oci_objectstorage_objects.objects1.objects}"
 }

docs/object_storage/objects.md

@@ -17,6 +17,7 @@ The following attributes are exported:
 Note: Metadata keys are case-insensitive and all returned keys will be lower case.
 * `namespace` - The top-level namespace used for the request.
 * `object` - The name of the object. Avoid entering confidential information. Example: `test/object1.log` 
+* `source` - An absolute path to a file on the local system to upload to the object store.
 
 
 
@@ -27,14 +28,15 @@ Creates a new object or overwrites an existing one.
 The following arguments are supported:
 
 * `bucket` - (Required) The name of the bucket. Avoid entering confidential information. Example: `my-new-bucket1` 
-* `content` - (Optional) The object to upload to the object store.
+* `content` - (Optional) The object to upload to the object store.  Cannot be defined if `source` is defined.
 * `content_encoding` - (Optional) The content encoding of the object.
 * `content_language` - (Optional) The content language of the object.
 * `content_type` - (Optional) The content type of the object.  Defaults to 'application/octet-stream' if not overridden during the PutObject call.
 * `metadata` - (Optional) Optional user-defined metadata key and value.
 Note: All specified keys must be in lower case.
 * `namespace` - (Required) The top-level namespace used for the request.
 * `object` - (Required) The name of the object. Avoid entering confidential information. Example: `test/object1.log` 
+* `source` - (Optional) An absolute path to a file on the local system. Cannot be defined if `content` is defined.
 
 
 ### Update Operation