Метод listParts
Статья создана
Возвращает список уже загруженных частей для указанной составной загрузки.
Ответ не может содержать более 1000 элементов. Если в составной загрузке больше частей, то Object Storage возвращает маркер IsTruncated и элемент NextPartNumberMarker. Оставшиеся элементы можно получить последовательными запросами, в которых параметр part-number-marker равен NextPartNumberMarker из предыдущего запроса.
Запрос
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>0005B46503714F29</UploadId>
<Initiator>
<ID>ajeanexampleuser</ID>
<DisplayName>ajeanexampleuser</DisplayName>
</Initiator>
<Owner>
<ID>ajeanexampleuser</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.Путь: /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. |