Метод upload
Загружает объект и его метаданные в Yandex Object Storage.
Примечание
Object Storage не блокирует объект на запись и может принимать одновременно несколько запросов на запись одного объекта, однако по умолчанию пользователь сможет получить из Object Storage только последний записанный объект. Чтобы при перезаписи или удалении объектов сохранялась история, включите версионирование.
Чтобы убедиться, что объект передан по сети без повреждений, используйте заголовок Content-MD5. Object Storage вычислит MD5 для сохраненного объекта и если вычисленная MD5 не совпадет с переданной в заголовке, вернет ошибку. Эту проверку можно выполнить и на стороне клиента, сравнив ETag из ответа Object Storage с предварительно вычисленной MD5.
Запрос
PUT /{bucket}/{key} HTTP/2
Path параметры
| Параметр | Описание |
|---|---|
bucket |
Имя бакета. |
key |
Ключ объекта. Идентификатор, под которым объект будет сохранен в Object Storage. |
Заголовки
Используйте в запросе необходимые общие заголовки.
Дополнительно можно использовать заголовки, перечисленные в таблице ниже.
| Заголовок | Описание |
|---|---|
X-Amz-Meta-* |
Пользовательские метаданные объекта. Все заголовки, начинающиеся с X-Amz-Meta-, Object Storage преобразует по правилу: X-Amz-Meta-foo-bar_baz → X-Amz-Meta-Foo-Bar_baz.Общий размер пользовательских заголовков не должен превышать 2KB. Размер пользовательских данных определяется как длина строки в кодировке UTF-8. В размере учитываются и названия заголовков и их значения. |
X-Amz-Storage-Class |
Класс хранилища объекта. Может иметь любое из значений:
|
X-Amz-Server-Side-Encryption |
Алгоритм шифрования загружаемого объекта. Доступные значения: aws:kms. |
X-Amz-Server-Side-Encryption-Aws-Kms-Key-Id |
Идентификатор ключа KMS для шифрования загружаемого объекта. |
С помощью заголовков, перечисленных ниже, можно установить ACL для загружаемого объекта.
| Заголовок | Описание |
|---|---|
X-Amz-Acl |
Устанавливает предопределенный ACL для объекта. |
X-Amz-Grant-Read |
Устанавливает получателю доступа разрешение на чтение объекта. |
X-Amz-Grant-Read-Acp |
Устанавливает получателю доступа разрешение на чтение ACL объекта. |
X-Amz-Grant-Write-Acp |
Устанавливает получателю доступа разрешение на запись ACL объекта. |
X-Amz-Grant-Full-Control |
Устанавливает получателю доступа разрешения: READ, WRITE, READ_ACP, WRITE_ACP на объект. |
Значение для заголовков X-Amz-Grant-* представляет собой разделенный запятыми список получателей доступа. Каждый получатель доступа идентифицируется структурой вида <тип получателя доступа>:<идентификатор получателя доступа>. Object Storage поддерживает следующие типы получателей:
id— получатель доступа — пользователь облака.uri— получатель доступа — системная группа.
Пример:
X-Amz-Grant-Read: uri="http://acs.amazonaws.com/groups/s3/AuthenticatedUsers"
Ответ
Заголовки
Ответ может содержать только общие заголовки.
Коды ответов
Перечень возможных ответов смотрите в разделе Ответы.