upload method
Uploads an object and its metadata to Yandex Object Storage.
Note
Object Storage does not lock an object for writing and can simultaneously accept multiple write requests for the same object, but the user will only get the last object written from Object Storage.
To make sure an object is passed via the network without any corruption, use the Content-MD5 header. Object Storage calculates the MD5 value for a saved object and, if the calculated MD5 value does not match the one passed in the header, it returns an error. You can also perform this check on the client side by comparing the ETag from the Object Storage response with the precalculated MD5 value.
Request
PUT /{bucket}/{key} HTTP/1.1
Path parameters
| Parameter | Description |
|---|---|
bucket |
Bucket name. |
key |
Object key. ID to use for saving the object in Object Storage. |
Headers
In a request, use the necessary common request headers.
You can also use the headers listed in the table below.
| Header name | Description |
|---|---|
x-amz-meta-* |
User-defined metadata for the object. All headers starting with x-amz-meta- are considered by Object Storage to be user-defined. It does not process these headers, but saves them in the original form.The total size of user-defined headers should not exceed 2 KB. The size of user-defined data is determined as the length of the UTF-8 encoded string. The header names and their values are included when calculating the size. |
x-amz-storage-class |
Object storage class. Possible values: - COLD for uploading an object to the cold storage.- STANDARD for uploading an object to the standard storage.If no header is specified, the object is saved to the standard storage. |
Response
Headers
A response can only contain common response headers.
Response codes
For a list of possible responses, see Responses.