Yandex.Cloud
  • Сервисы
  • Почему Yandex.Cloud
  • Сообщество
  • Тарифы
  • Документация
  • Связаться с нами
Подключиться
Yandex Object Storage
  • Начало работы
  • Пошаговые инструкции
    • Все инструкции
    • Бакеты
      • Создание бакета
      • Удаление бакета
      • Ограничение максимального размера бакета
      • Открытие публичного доступа к бакету
      • Шифрование бакета
      • Управление жизненными циклами объектов
      • Управление конфигурацией CORS
      • Редактирование ACL бакета
      • Включение механизма логированния
    • Объекты
      • Загрузка объекта
      • Получение информации об объекте
      • Скачивание объекта
      • Получение публичной ссылки на объект
      • Удаление объекта
      • Удаление частично загруженного объекта
      • Редактирование ACL объекта
    • Хостинг статических сайтов
      • Настройка хостинга
      • Поддержка собственного домена
      • Поддержка нескольких доменных имен
      • Настройка HTTPS
  • Концепции
    • Обзор
    • Бакет
    • Объект
    • Версионирование бакета
    • Жизненные циклы объектов
    • CORS
    • Хостинг статических сайтов
    • Подписанные (pre-signed) URL
    • Составная (multipart) загрузка
    • Список управления доступом (ACL)
    • Политика доступа (Bucket Policy)
    • Загрузка файла через HTML форму
    • Класс хранилища
    • Механизм логирования действий с бакетом
    • Резервное копирование
    • Протокол TLS
    • Квоты и лимиты
  • Инструменты
    • Все инструменты
    • Консольные клиенты
      • AWS CLI
      • S3cmd
    • Файловые браузеры
      • CyberDuck
      • WinSCP
    • SDK
      • AWS SDK для Java
      • Python SDK (boto)
    • FUSE
      • s3fs
      • goofys
  • HTTP API, совместимый с Amazon S3
    • Как пользоваться API
    • Подписывание запросов
    • Справочник API
      • Все сервисы и методы
      • Bucket
        • Все методы
        • create
        • getBucketEncryption
        • getMeta
        • listObjects
        • listBuckets
        • deleteBucket
        • deleteBucketEncryption
        • putBucketEncryption
        • putBucketVersioning
        • getBucketVersioning
        • putBucketLogging
        • getBucketLogging
        • listObjectVersions
      • Object
        • Все методы
        • upload
        • get
        • copy
        • getObjectMeta
        • delete
        • deleteMultipleObjects
        • options
      • Multipart upload
        • Общий порядок составной загрузки
        • startUpload
        • uploadPart
        • copyPart
        • listParts
        • abortUpload
        • completeUpload
        • listUploads
      • Static Website Hosting
        • Все методы
        • upload
        • get
        • delete
        • Коды ответов статического сайта
      • CORS
        • Все методы
        • XML-структура конфигурации CORS
        • upload
        • get
        • delete
      • Lifecycles
        • Все методы
        • XML-структура конфигурации жизненных циклов
        • upload
        • get
        • delete
      • ACL
        • Все методы
        • XML-структура конфигурации ACL
        • objectGetAcl
        • objectPutAcl
        • bucketGetAcl
        • bucketPutAcl
      • Bucket Policy
        • Все методы
        • GetBucketPolicy
        • PutBucketPolicy
        • DeleteBucketPolicy
        • Схема данных
        • Действия
        • Условия
      • Общие заголовки запросов
      • Общие заголовки ответов
      • Ответы
  • Управление доступом
  • Правила тарификации
    • Действующие правила
    • Архив
      • До 1 января 2019 года
      • С 1 января до 1 марта 2019 года
  • Вопросы и ответы
  1. HTTP API, совместимый с Amazon S3
  2. Справочник API
  3. Multipart upload
  4. listParts

Метод listParts

  • Запрос
    • Path параметры
    • Query параметры
    • Заголовки
  • Ответ
    • Заголовки
    • Коды ответов
    • Схема данных

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

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

Запрос

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

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.
В этой статье:
  • Запрос
  • Path параметры
  • Query параметры
  • Заголовки
  • Ответ
  • Заголовки
  • Коды ответов
  • Схема данных
Language
Вакансии
Политика конфиденциальности
Условия использования
© 2021 ООО «Яндекс.Облако»