Create or update object metadata
/v1/{account}/{container}/{object}
Request
-
account: string
The unique name for the account. An account is also known as the project or tenant.
-
container: string
The unique name for the container. The container name must be from 1 to 256 characters long and can start with any character and contain any pattern. Character set must be UTF-8. The container name cannot contain a slash (
/
) character because this character delimits the container and object name. For example,/account/container/object
. -
object: string
The unique name for the object.
-
temp_url_expires: integer(timestamp)
Minimum Value:
0
The date and time in UNIX Epoch time stamp format when the signature for temporary URLs expires.For example,
1440619048
is equivalent toMon, Wed, 26 Aug 2015 19:57:28 GMT
. -
temp_url_sig: string
Used with temporary URLs to sign the request with an HMAC-SHA1 cryptographic signature that defines the allowed HTTP method, expiration date, full path to the object, and the secret key for the temporary URL.
-
Content-Disposition(optional): string
If set, specifies the override behavior for the browser. For example, this header might specify that the browser use a download program to save this file rather than show the file, which is the default.
-
Content-Encoding(optional): string
If set, the value of the
Content-Encoding
metadata. -
Content-Type(optional): string
Changes the MIME type for the object.
-
X-Auth-Token(optional): string
Authentication token. If you omit this header, your request fails unless the account owner has granted you access through an access control list (ACL).
-
X-Delete-After(optional): integer
Minimum Value:
0
Minimum Value:> true
The number of seconds after which the system removes the object. Internally, the Object Storage system stores this value in theX-Delete-At
metadata item. -
X-Delete-At(optional): integer(timestamp)
Minimum Value:
0
The date and time in UNIX Epoch time stamp format when the system removes the object.For example,
1440619048
is equivalent toMon, Wed, 26 Aug 2015 19:57:28 GMT
. -
X-Object-Meta-{name}(optional): string
The object metadata, where
{name}
is the name of the metadata item.You must specify an
X-Object-Meta-{name}
header for each metadata{name}
item that you want to add or update.
Response
- application/json
202 Response
-
Content-Length: integer
Minimum Value:
0
This value is the length of the response text in the response body. -
Content-Type: string
The MIME type of the object.
-
Date: string(date-time)
The transaction date and time.
The date and time stamp format is ISO 8601:
CCYY-MM-DDThh:mm:ss±hh:mm
For example,2015-08-27T09:49:58-05:00
.The
±hh:mm
value, if included, is the time zone as an offset from UTC. In the previous example, the offset value is-05:00
.A
null
value indicates that the token never expires. -
X-Timestamp: integer(timestamp)
Minimum Value:
0
The date and time in UNIX Epoch time stamp format when the account, container, or object was initially created as a current version.For example,
1440619048
is equivalent toMon, Wed, 26 Aug 2015 19:57:28 GMT
. -
X-Trans-Id: string(uuid)
A unique transaction ID for this request. Your service provider might need this value if you report a problem.
401 Response
-
Content-Length: integer
Minimum Value:
0
The length of the error text in the response body. -
Content-Type: string
The MIME type of the error text in the response body.
403 Response
- A data center has not been selected for your service in Oracle Cloud My Services.
- The request was sent to an incorrect data center. For example, the data center for your service is Chicago (us2), but the request was sent to the URL corresponding to the Ashburn (us6) data center.
- You don't have the required permission to perform the operation on the specified container. For example, there may be a change in the roles assigned to your user or the access privileges defined for the container specified in the request.
- The specified operation is not permitted for archive objects or containers with storage class
Archive
- Violating a container or object level WORM policy by trying to PUT, POST, or DELETE an object that has not expired or trying to update an existing container level WORM policy.
-
Content-Length: integer
Minimum Value:
0
The length of the error text in the response body. -
Content-Type: string
The MIME type of the error text in the response body.
404 Response
-
Content-Length: integer
Minimum Value:
0
The length of the error text in the response body. -
Content-Type: string
The MIME type of the error text in the response body.
Examples
cURL Command
The following example shows how to create and update any custom or arbitrary metadata (X-Object-Meta-Language: english
in this example) that you need for an object in a container in your account in Oracle Cloud Infrastructure Object Storage Classic by submitting a POST request on the REST resource using cURL. For more information about cURL, see Use cURL.
curl -v -X POST \ -H "X-Auth-Token: AUTH_tkb4fdf39c92e9f62cca9b7c196f8b6e6b" \ -H "X-Object-Meta-Language: english" \ https://foo.storage.oraclecloud.com/v1/myservice-bar/FirstContainer/myObject
Sample Response
The following is a sample response of this command:
HTTP/1.1 202 Accepted Date: Mon, 09 Mar 2015 11:46:34 GMT Content-Length: 76 Content-Type: text/html; charset=UTF-8 X-Trans-Id: tx23a1084b8c674fdeae8d4-0054f982ac Content-Language: en