RESTObjects

Upload object

Preview

Uploads an object. The object must be 1 GiB or smaller.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

objectPathstringRequiredformat: "^[a-zA-Z0-9/_=\-.]*$"
Path of the Object that is to be uploaded.

Headers

Time-To-LivelongOptional
An optional expiry TTL associated with an object. The value represents the number of nanoseconds the object will exist in the local store. If no TTL is supplied, the server applies a default TTL. In most cases, the default TTL is 90 days. However, it might be higher or lower, depending on the retention requirements of your environment.
Distribution-ModeenumOptional

Controls how the object is distributed across the mesh. If set to force, the object will be force distributed to all nodes. Force-distributed objects are subject to a size limit.

Allowed values:

Request

This endpoint expects binary data of type application/octet-stream.

Response headers

PathstringOptional
ChecksumstringOptional
Last-ModifiedstringOptional
ExpiresstringOptional

Response

Successful upload
content_identifierobject
size_bytesuint64
last_updated_atdatetime
When this object arrived on the node that holds it, according to that node's clock. Because an object is never modified in place, this is effectively the time the object was created on that node. The value is local to the node holding the object and may differ when the same object is held on multiple nodes. It is not propagated from the node where the object originated.
expiry_timedatetimeOptional

Errors

400
Bad Request Error
413
Content Too Large Error
500
Internal Server Error
507
Insufficient Storage Error