Подключиться
Yandex Object Storage

Метод startUpload

Статья создана

Возвращает идентификатор, который следует использовать во всех дальнейших операциях по загрузке объекта.

Если вместе с объектом необходимо хранить пользовательские метаданные, то передавать их следует в этом запросе.

Запрос

POST /{bucket}/{key}?uploads HTTP/2

Path параметры

Параметр Описание
bucket Имя бакета.
key Ключ объекта. Под указанным именем объект будет сохранен в Object Storage.

Query параметры

Параметр Описание
uploads Флаг, обозначающий операцию составной загрузки.

Заголовки

Используйте в запросе необходимые общие заголовки.

Дополнительно можно использовать заголовки, перечисленные в таблице ниже.

Заголовок Описание
x-amz-meta-* Пользовательские метаданные объекта.

Все заголовки, начинающиеся с x-amz-meta-Object Storage воспринимает как пользовательские, не обрабатывает их и сохраняет в том виде, в котором они переданы.

Общий размер пользовательских заголовков не должен превышать 2 КБ. Размер пользовательских данных определяется как длина строки в кодировке UTF-8. В размере учитываются и названия заголовков и их значения.
x-amz-storage-class Класс хранилища объекта.

Может иметь любое из значений:
- STANDARD для загрузки объекта в стандартное хранилище.
- COLD, STANDARD_IA и NEARLINE для загрузки объекта в холодное хранилище.

Если заголовок не указан, то объект сохраняется в хранилище, установленном в настройках бакета.

С помощью заголовков, перечисленных ниже, можно установить 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"

Ответ

Заголовки

Ответ может содержать только общие заголовки.

Коды ответов

Перечень возможных ответов смотрите в разделе Ответы.

Успешный ответ содержит дополнительные данные в формате XML, схема которого описана ниже.

Схема данных

<InitiateMultipartUploadResult>
  <Bucket>bucket-name</Bucket>
  <Key>object-key</Key>
  <UploadId>upload-id</UploadId>
</InitiateMultipartUploadResult>
Тег Описание
InitiateMultipartUploadResult Корневой тег ответа.

Путь: /InitiateMultipartUploadResult.
Bucket Имя бакета в который загружается объект.

Путь: /InitiateMultipartUploadResult/Bucket.
Key Ключ, который ассоциируется с объектом, после окончания загрузки.

Путь: /InitiateMultipartUploadResult/Key.
UploadId Идентификатор загрузки.

Все последующие операции с загрузкой должны передавать в Object Storage этот идентификатор.

Путь: /InitiateMultipartUploadResult/UploadId.
В этой статье: