Подключиться
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 преобразует по правилу: X-Amz-Meta-foo-bar_baz → X-Amz-Meta-Foo-Bar_baz.

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

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

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