Multipart

Благодаря составной или многокомпонентной загрузке объекты в Объектном хранилище Linx S3 можно сохранять по частям. Стоит использовать составную загрузку для объектов от 100 МБ.

Шаги многокомпонентной загрузки:

• Initiate Multipart Upload — инициализация загрузки.
  
• Upload Part — загрузка объекта по частям.
  
• Complete Multipart Upload — завершение загрузки путем объединения ранее загруженных частей.
  
• Abort Multipart Upload — прерывание загрузки
  
• List Parts — возврат списка загруженных частей.
  

Эта операция начинает составную загрузку и возвращает идентификатор загрузки, используемый для объединения всех частей данной загрузки. Нужно указывать этот идентификатор для каждом из последующих запросов на загрузку части.

При настройке правила жизненного цикла на прерывание неоконченных многокомпонентных загрузок, загрузка будет завершена в течение количества дней, которое указанно в конфигурации жизненного цикла бакета. Иначе для незавершенной составной загрузки становится доступна операция прерывания, и сервис прерывает загрузку.

Примечание

После начала составной загрузки и собственно загрузки одной или нескольких частей необходимо завершить или прервать многокомпонентную загрузку, чтобы приостановить списание оплаты за хранение загруженных частей. Только после завершения или прерывания многокомпонентной загрузки LinxCloud S3 освобождает место, которое предоставлено частям в хранилище, и прекращает производить списание оплаты за хранение этих частей.

Запрос:

Ответ:

Эта операция используется для загрузки части составной загрузки. Для выполнения операции нужно предоставить данные из части в запросе. Операция загрузки части (копии) используется для загрузки части из существующего объекта.

Часть может иметь любой номер от 1 до 10 000 включительно. Номер части однозначно определяет часть и ее положение в создаваемом объекте. Если загружается новая част с уже существующим номером, то имеющаяся часть будет перезаписана. Размер каждой части, за исключением последней (она не имеет ограничения по размеру), должен быть не менее 5 МБ.

Рекомендуется указать заголовок Content-MD5 в запросе загрузки части, чтобы удостовериться в том, что данные не исказятся при их передаче по сети. LinxCloud сверяет данные из частей с предоставленным значением MD5-хеша и при их несовпадении возвращает ошибку.

Запрос:

Ответ

Эта операция для завершения составной загрузки, объединяя уже загруженные части. По этому запросу LinxCloud объединяет все загруженные части в возрастающем порядке по номеру частей, создавая новый объект. В запросе на завершение составной загрузки нужно предоставить список частей. Для каждой части из списка следует предоставить номер части и значение заголовка ETag, возвращаемое после загрузки этой части.

После начала обработки запроса, LinxCloud отправляет заголовок ответа HTTP, содержащий ответ «200 OK». В процессе обработки запроса периодически отправляются пробельные символы, чтобы не допустить превышения лимита времени ожидания. Нужно проверять тело ответа для определения успешности исполнения запроса, т.к. может возникнуть ошибка в запросе после отправления первоначального ответа «200 OK»

Запрос:

Ответ

Эта операция может прерывать многокомпонентную загрузку. Дополнительные части уже нельзя загрузить, используя идентификатор загрузки прерванной составной загрузки. Место, выделенное для хранения ранее загруженных частей, будет освобождено. Если происходит загрузка каких-либо частей, то такая операция может завершиться или прерваться. И может понадобится многократное прерывание составной загрузки для полного высвобождения пространства, которое занимают все части.

Запрос:

Ответ

Эта операция используется для возвращения списка частей, которые загружены по определенной многокомпонентной загрузке. Операция обязана содержать идентификатор загрузки, полученный после отправки запроса на инициализацию составной загрузки. Подобный запрос возвращает не более 1000 загруженных частей. Указав параметр запроса max-parts, можно ограничить количество возвращаемых частей. Если многокомпонентная загрузка состоит более чем из 1000 частей, то ответ возвращает элемент NextPartNumberMarker и поле IsTruncated со значением true. В последующих запросах на просмотр списка частей можно включать параметр строки запроса part-number-marker, устанавливая для него значение поля NextPartNumberMarker из предыдущего ответа.

Запрос:

Ответ