Create object PUT /v1/{account}/{container}/{object}{?multipart-manifest}

Request headers

X-Object-Manifest

Sets the manifest object of a dynamic large object. This value takes the container name and prefix name of the split object as follows: {container}/{prefix}. Also, it is necessary for the container name and prefix name of the split object to be UTF-8-encoded as well as URL-encoded before being set in the header.

X-Auth-Token

Authentication token

Content-Length

Size of object (bytes). This item cannot be set if transferring in chunked format.

Transfer-Encoding

If transferring in chunked format, use Transfer-Encoding: chunked. If using this header, a Content-Length header cannot be assigned.

Content-Type

Changes the MIME type of an object.

X-Detect-Content-Type

When "true" is set, the object storage will automatically set the MIME type based on the file extension. Settings using the Content-Type header will be ignored.

X-Copy-From

Specifies the copy source object name.

This value is specified in {container}/{object} format.

Also, it is necessary for this value to be UTF-8-encoded as well as URL-encoded before being set in the header.

A PUT operation using the X-Copy-From header is the same as performing a COPY operation.

ETag

MD5 checksum of the request body. For example, an MD5 checksum of the files to be uploaded. In order to perform full uploads, it is strongly recommended to calculate the M5 checksum of the object in advance, set it for this header and issue the request. This value is not to be enclosed in quotation marks.

Content-Disposition

Sets the browser behavior.

Refer to "http://www.ietf.org/rfc/rfc2183.txt" for details on the value to set.

Content-Encoding

Sets the Content-Encoding metadata.

X-Delete-At

Specify the date on which an object should be deleted in UNIX Epoch timestamp format.

X-Delete-After

Specify the number of seconds until an object is deleted. This value is converted to X-Delete-At in the object storage.

X-Object-Meta-name

Object metadata {name} is the name of the metadata item.

If-None-Match

Expect: Use in combination with 100-Continue. This is used to check if the server is holding a cache of the data already specified in the header.

Request Parameter

{account}

Name uniquely assigned by project

{container}

Container name

{object}

Object name

multipart-manifest

When ?multipart-manifest=put is specified, the object is uploaded as the manifest of a static large object. The request body includes a description of the manifest.

Response Headers

Content-Length

Number of bytes of the response body

ETag

When an object is smaller than 5 GB, this value will be the MD5 checksum of the uploaded object. This value is not to be enclosed in quotation marks.

When an ETag header is assigned and the PUT operation is successful for the request, this value will be the same as the specified ETag.

Also, when an ETag header has not been assigned, check if this value is the same as the ETag value of the object that was uploaded.

In the case of a static large object, a value with the retrieved MD5 checksum for a string that combines the ETag and MD5 checksums of each segment of the manifest is returned.

In the case of a dynamic large object, this value will be the MD5 checksum of a null character.

Content-Type

MIME type of an object

X-Trans-Id

ID assigned to this request. This is used when inquiring about issues.

Date

Datetime when the transaction was executed

Response Elements

None

Example of Request

curl -i $publicURL/janeausten/helloworld.txt -X PUT -H "Content-Length: 1" -H "Content-Type: text/html; charset=UTF-8" -H "X-Auth-Token: $token"
     

Example of Response

HTTP/1.1 201 Created
Last-Modified: Fri, 17 Jan 2014 17:28:35 GMT
Content-Length: 116
Etag: d41d8cd98f00b204e9800998ecf8427e
Content-Type: text/html; charset=UTF-8
X-Trans-Id: tx4d5e4f06d357462bb732f-0052d96843
Date: Fri, 17 Jan 2014 17:28:35 GMT