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

Метод listParts

Статья создана
Обновлена 15 августа 2025 г.

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

Ответ не может содержать более 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, схема которого описана ниже.

Схема данных

<ListBucketResult
          xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
          <KeyCount>1</KeyCount>
          <Name>my-sample-bucket</Name>
          <Prefix></Prefix>
          <MaxKeys>1000</MaxKeys>
          <IsTruncated>false</IsTruncated>
          <Contents>
              <Key>text.txt</Key>
              <LastModified>2025-05-15T07:23:08.030Z</LastModified>
              <Owner>
                  <ID>ajegtlf2q28a********</ID>
                  <DisplayName>ajegtlf2q28a********</DisplayName>
              </Owner>
              <ETag>&#34;f75a361db63aa4722fb8e083********&#34;</ETag>
              <Size>103</Size>
              <StorageClass>STANDARD</StorageClass>
              <TagSet></TagSet>
          </Contents>
      </ListBucketResult>

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

Тег Описание
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