[Документация Yandex Cloud](../../../../index.md) > [Yandex Object Storage](../../../index.md) > Справочник API > [AWS S3 REST](../../index.md) > [REST](../index.md) > Multipart upload > ListParts

# Object Storage API, REST совместимый с Amazon S3: ListParts

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

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

Подробнее о подготовке к работе с API и общем виде запроса в разделе [Как пользоваться S3 API](../../index.md).

## Запрос {#request}

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

### Path параметры {#path-parameters}

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


### Query параметры {#request-parameters}

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

Параметр | Описание
----- | -----
`encoding-type` | Кодировка ответа от сервера.<br/><br/>Object Storage по требованию клиента может закодировать ответ в требуемом виде.
`max-parts` | Максимальное количество элементов в ответе за один запрос.<br/><br/>По умолчанию 1000.
`part-number-marker` | Номер части, с которого должен начинаться ответ.<br/><br/>Object Storage включит в ответ только части, номера которых больше указанного.
`uploadId` | Идентификатор составной загрузки.


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

### Заголовки {#request-headers}

Используйте в запросе необходимые [общие заголовки](../common-request-headers.md).


## Ответ {#response}

### Заголовки {#response-headers}

Ответ может содержать только [общие заголовки](../common-response-headers.md).

### Коды ответов {#response-codes}

Перечень возможных ответов смотрите в разделе [Ответы](../response-codes.md).

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

### Схема данных {#response-scheme}

```
<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` | Корневой элемент ответа.<br/><br/>Путь: `/ListPartsResult`.
`Bucket` | Бакет, к которому относится составная загрузка.<br/><br/>Путь: `/ListPartsResult/Bucket`.
`Encoding-Type` | Кодировка, в которой Object Storage представляет ключ в XML-ответе.<br/><br/>Появляется, если клиент при запросе передал параметр `encoding-type`.<br/><br/>Путь: `/ListPartsResult/Encoding-Type`.
`Key` | Ключ, для которого производится составная загрузка.<br/><br/>Путь: `/ListPartsResult/Key`.
`UploadId` | Идентификатор составной загрузки.<br/><br/>Путь: `/ListPartsResult/UploadId`.
`Initiator` | Информация о пользователе, инициировавшем загрузку.<br/><br/>Путь: `/ListPartsResult/Initiator`.
`ID` | Идентификатор пользователя.<br/><br/>Путь: `/ListPartsResult/Initiator/ID`.
`DisplayName` | Отображаемое имя пользователя.<br/><br/>Путь: `/ListPartsResult/Initiator/DisplayName`.
`Owner` | Информация о владельце объекта, совпадает с `Initiator`.<br/><br/>Путь: `/ListPartsResult/Owner`.
`StorageClass` | [Класс хранилища](../../../concepts/storage-class.md) объекта: `STANDARD`, `COLD`, `ICE`.<br/><br/>Путь: `/ListPartsResult/StorageClass`.
`PartNumberMarker` | Номер части, после которого начинается список.<br/><br/>Первый элемент списка имеет номер, следующий за `PartNumberMarker`.<br/><br/>Путь: `/ListPartsResult/PartNumberMarker`.
`NextPartNumberMarker` | Номер части, которым заканчивается текущий список.<br/><br/>Присутствует в случае, когда в ответ не поместился весь перечень частей.<br/><br/>Путь: `/ListPartsResult/NextPartNumberMarker`.
`MaxParts` | Максимальная длина списка для одного ответа.<br/><br/>Путь: `/ListPartsResult/MaxParts`.
`IsTruncated` | Признак неполноты списка.<br/><br/>Если `IsTruncated` — `true`, то это означает, что Object Storage вернул не полный список частей.<br/><br/>Путь: `/ListPartsResult/IsTruncated`.
`Part` | Описание части загрузки.<br/><br/>Путь: `/ListPartsResult/Part`.
`PartNumber` | Номер части.<br/><br/>Уникальный целочисленный идентификатор, определяющий положение части в загрузке.<br/><br/>Путь: `/ListPartsResult/Part/PartNumber`.
`LastModified` | Дата и время загрузки части.<br/><br/>Путь: `/ListPartsResult/Part/LastModified`.
`ETag` | `ETag` загруженной части.<br/><br/>Путь: `/ListPartsResult/Part/ETag`.
`Size` | Размер загруженной части.<br/><br/>Путь: `/ListPartsResult/Part/Size`.

#### Связанные статьи {#related-articles}

* [Составная (multipart) загрузка](../../../concepts/multipart.md)

* [Составная загрузка объекта](../../../operations/objects/multipart-upload.md)

#### Полезные ссылки {#see-also}

* [Начало работы с AWS S3 API в Yandex Object Storage](../../s3-api-quickstart.md)

* [Отладка запросов с помощью утилиты AWS CLI](../../signing-requests.md#debugging)

* [Пример отправки подписанного запроса с помощью утилиты curl](../../../api-ref/authentication.md#s3-api-example)

* [Пример кода для генерации подписи](../../../concepts/pre-signed-urls.md#code-examples)