» opc_storage_object
Creates and manages a Object in an Oracle Cloud Infrastructure Storage Classic container. storage_endpoint
must be set in the provider or environment to manage these resources.
» Example Usage
resource "opc_storage_object" "default" {
name = "storage-object-1"
container = "${opc_storage_container.container.name}"
file = "${"./source_file.txt"}"
etag = "${md5(file("./source_file.txt"))}"
content_type = "text/plain;charset=utf-8"
}
» Argument Reference
The following arguments are supported:
-
name
- (Required) The name of the Storage Object. -
container
- (Required) The name of Storage Container the store the object in.
Note: One of content
, file
, or copy_from
must be specified
-
content
- (Optional) Raw content in string-form of the data. -
file
- (Optional) File path for the content to use for data. -
copy_from
- (Optional) name of an existing object used to create the new object as a copy. The value is in formcontainer/object
. You must UTF-8-encode and then URL-encode the names of the container and object. -
content_disposition
- (Optional) Set the HTTPContent-Disposition
header to specify the override behaviour for the browser, e.g.inline
orattachment
. -
content_encoding
- (Optional) set the HTTPContent-Encoding
for the object. -
content_type
- (Optional) set the MIME type for the object. -
delete_at
- (Optional) The date and time in UNIX Epoch time stamp format when the system removes the object. -
etag
- (Optional) MD5 checksum value of the request body. Strongly Recommended. -
transfer_encoding
- (Optional) Set tochunked
to enable chunked transfer encoding. -
metadata
- (Optional) Additional object metadata headers. See Object Metadata below for more information.
» Attributes
In addition to the attributes listed above, the following attributes are exported:
-
id
- The combined container and object name path of the object. -
accept_ranges
- Type of ranges that the object accepts. -
content_length
- Length of the object in bytes. -
last_modified
- Date and Time that the object was created/modified in ISO 8601. -
object_manifest
- The dynamic large-object manifest object. -
timestamp
- Date and Time in UNIX EPOCH when the account, container, or object was initially created at the current version. -
transaction_id
- Transaction ID of the request.
» Object Metadata
The metadata
config defines a map of additional meta data header name value pairs. The additional meta data items are set HTTP Headers on the object in the form X-Object-Meta-{name}: {value}
, where {name}
is the name of the metadata item {value}
is the header content. For example:
metadata {
"Foo-Bar" = "barfoo",
"Sha256" = "e91ed4f93637379a7539cb5d8d0b5bca3972755de4f9371ab2e123e7b4c53680"
}
» Import
Object's can be imported using the resource id
, e.g.
$ terraform import opc_storage_object.default container/example
Please note though, importing a Storage Object does not allow a user to modify the content, or attributes for the Storage Object. It is, however, possible to import a Storage Object, and replace the object with new content, or a copy of another Storage Object. It is also possible to import a Storage Object into Terraform in order to delete the object.