Связаться с намиПодключиться

Метод listParts

Статья создана
Обновлена 6 сентября 2024 г.

Возвращает список уже загруженных частей для указанной составной загрузки.

Ответ не может содержать более 1000 элементов. Если в составной загрузке больше частей, то Object Storage возвращает маркер IsTruncated и элемент NextPartNumberMarker. Оставшиеся элементы можно получить последовательными запросами, в которых параметр part-number-marker равен NextPartNumberMarker из предыдущего запроса.

Подробнее о подготовке к работе с API и общем виде запроса см. в разделе Как пользоваться S3 API.

Запрос

GET /{bucket}/{key}?uploadId=UploadId HTTP/2

Path параметры

Параметр Описание
bucket Имя бакета.
key Ключ объекта.

Query параметры

Изменить ответ от Object Storage можно параметрами, описанными в таблице ниже.

Параметр Описание
encoding-type Кодировка ответа от сервера.

Object Storage по требованию клиента может закодировать ответ в требуемом виде.
max-parts Максимальное количество элементов в ответе за один запрос.

По умолчанию 1000.
part-number-marker Номер части, с которого должен начинаться ответ.

Object Storage включит в ответ только части, номера которых больше указанного.
uploadId Идентификатор составной загрузки.

Обязателен только параметр uploadId.

Заголовки

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

Ответ

Заголовки

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

Коды ответов

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

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

Схема данных

<ListPartsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Bucket>example-bucket</Bucket>
  <Key>example-object</Key>
  <UploadId>0005B465********</UploadId>
  <Initiator>
      <ID>ajeanexa********</ID>
      <DisplayName>ajeanexampleuser</DisplayName>
  </Initiator>
  <Owner>
      <ID>ajeanexa********</ID>
      <DisplayName>ajeanexampleuser</DisplayName>
  </Owner>
  <StorageClass>STANDARD</StorageClass>
  <PartNumberMarker>0</PartNumberMarker>
  <NextPartNumberMarker>2</NextPartNumberMarker>
  <MaxParts>2</MaxParts>
  <IsTruncated>true</IsTruncated>
  <Part>
    <PartNumber>1</PartNumber>
    <LastModified>2020-11-18T17:33:46.787Z</LastModified>
    <ETag>"1430884b802ee5206cbe0ca0cf9b73d4"</ETag>
    <Size>8388608</Size>
  </Part>
  <Part>
    <PartNumber>2</PartNumber>
    <LastModified>2020-11-18T17:33:46.812Z</LastModified>
    <ETag>"449aa7eaff2e841923b0da9ff2be5946"</ETag>
    <Size>8388608</Size>
  </Part>
</ListPartsResult>

Возможные теги ответа описаны в таблице ниже.

Тег Описание
ListPartsResult Корневой элемент ответа.

Путь: /ListPartsResult.
Bucket Бакет, к которому относится составная загрузка.

Путь: /ListPartsResult/Bucket.
Encoding-Type Кодировка, в которой Object Storage представляет ключ в XML-ответе.

Появляется, если клиент при запросе передал параметр encoding-type.

Путь: /ListPartsResult/Encoding-Type.
Key Ключ, для которого производится составная загрузка.

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

Путь: /ListPartsResult/UploadId.
Initiator Информация о пользователе, инициировавшем загрузку.

Путь: /ListPartsResult/Initiator.
ID Идентификатор пользователя.

Путь: /ListPartsResult/Initiator/ID.
DisplayName Отображаемое имя пользователя.

Путь: /ListPartsResult/Initiator/DisplayName.
Owner Информация о владельце объекта, совпадает с Initiator.

Путь: /ListPartsResult/Owner.
StorageClass Класс хранилища объекта: STANDARD, COLD или ICE.

Путь: /ListPartsResult/StorageClass.
PartNumberMarker Номер части, после которого начинается список.

Первый элемент списка имеет номер, следующий за PartNumberMarker.

Путь: /ListPartsResult/PartNumberMarker.
NextPartNumberMarker Номер части, которым заканчивается текущий список.

Присутствует в случае, когда в ответ не поместился весь перечень частей.

Путь: /ListPartsResult/NextPartNumberMarker.
MaxParts Максимальная длина списка для одного ответа.

Путь: /ListPartsResult/MaxParts.
IsTruncated Признак неполноты списка.

Если IsTruncated — true, то это означает, что Object Storage вернул не полный список частей.

Путь: /ListPartsResult/IsTruncated.
Part Описание части загрузки.

Путь: /ListPartsResult/Part.
PartNumber Номер части.

Уникальный целочисленный идентификатор, определяющий положение части в загрузке.

Путь: /ListPartsResult/Part/PartNumber.
LastModified Дата и время загрузки части.

Путь: /ListPartsResult/Part/LastModified.
ETag ETag загруженной части.

Путь: /ListPartsResult/Part/ETag.
Size Размер загруженной части.

Путь: /ListPartsResult/Part/Size.

См. также

Предыдущая
copyPart
Следующая
abortUpload