Метод listUploads

Запрос
Ответ

Возвращает список текущих составных загрузок.

Ответ не может содержать более 1000 элементов. Если загрузок больше, то Object Storage возвращает элемент IsTruncated, а также элементы NextKeyMarker и NextUploadIdMarker, которые необходимо использовать для параметров key-marker и upload-id-marker последующего запроса.

Запрос

GET /{bucket}?uploads HTTP/1.1

Path параметры

Параметр	Описание
`bucket`	Имя бакета.

Query параметры

Параметр	Описание
`delimiter`	Символ-разделитель. Если параметр указан, то Object Storage рассматривает ключ как путь к файлу, где имена каталогов разделяются символом `delimiter`. На выходе пользователь увидит перечень файлов и каталогов в корне бакета. Файлы будут выведены в элементах `Uploads`, а каталоги в элементах `CommonPrefixes`. Если в запросе указан еще и параметр `prefix`, то Object Storage вернет перечень файлов и каталогов в каталоге`prefix`.
`max-uploads`	Максимальное количество загрузок в ответе. По умолчанию Object Storage выдает не более 1000 ключей. Этот параметр следует использовать если вам нужно получать менее 1000 ключей в одном ответе. Если под критерии отбора попадает больше ключей, чем поместилось в выдаче, то ответ содержит `<IsTruncated>true</IsTruncated>`. Чтобы получить все объекты выдачи, если их больше `max-keys`, необходимо выполнить несколько последовательных запросов к Object Storage с параметром `key-marker`, где для каждого запроса `key-marker` равен значению элемента `NextKeyMarker` предыдущего ответа.
`key-marker`	Ключ. Выдача начнется с ключа, следующего за указанным в значении параметра. Используется вместе с `upload-id-marker` для фильтрации выдачи. Если `upload-id-marker` указан, то в выдачу попадет и `key-marker` тоже.
`prefix`	Строка, с которой должен начинаться ключ. Object Storage выберет только те ключи, которые начинаются с `prefix`.
`upload-id-marker`	Идентификатор загрузки. Выдача начнется с той загрузки, идентификатор которой следует за указанной в параметре. При обработке учитывается `key-marker`, т.е. в выдачу попадут те загрузки для которых пересекутся фильтр по `upload-id-marker` и фильтр по `key-marker`. Если `key-marker` не указан, то `upload-id-marker` игнорируется.
`uploads`	Флаг, обозначающий операцию составной загрузки.

Заголовки

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

Ответ

Заголовки

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

Коды ответов

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

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

Схема данных

<ListMultipartUploadsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Bucket>bucket</Bucket>
  <KeyMarker></KeyMarker>
  <UploadIdMarker></UploadIdMarker>
  <NextKeyMarker>my-movie.m2ts</NextKeyMarker>
  <NextUploadIdMarker>YW55IGlkZWEgd2h5IGVsdmluZydzIHVwbG9hZCBmYWlsZWQ</NextUploadIdMarker>
  <MaxUploads>3</MaxUploads>
  <IsTruncated>true</IsTruncated>
  <Upload>
    <Key>my-divisor</Key>
    <UploadId>XMgbGlrZSBlbHZpbmcncyBub3QgaGF2aW5nIG11Y2ggbHVjaw</UploadId>
    <Initiator>
      <ID>arn:aws:iam::111122223333:user/user1-11111a31-17b5-4fb7-9df5-b111111f13de</ID>
      <DisplayName>user1-11111a31-17b5-4fb7-9df5-b111111f13de</DisplayName>
    </Initiator>
    <StorageClass>STANDARD</StorageClass>
    <Initiated>2010-11-10T20:48:33.000Z</Initiated>
  </Upload>
  <Upload>
    <Key>my-movie.m2ts</Key>
    <UploadId>VXBsb2FkIElEIGZvciBlbHZpbmcncyBteS1tb3ZpZS5tMnRzIHVwbG9hZA</UploadId>
    <Initiator>
      <ID>b1d16700c70b0b05597d7acd6a3f92be</ID>
      <DisplayName>InitiatorDisplayName</DisplayName>
    </Initiator>
    <StorageClass>COLD</StorageClass>
    <Initiated>2010-11-10T20:48:33.000Z</Initiated>
  </Upload>
  <Upload>
    <Key>my-movie.m2ts</Key>
    <UploadId>YW55IGlkZWEgd2h5IGVsdmluZydzIHVwbG9hZCBmYWlsZWQ</UploadId>
    <Initiator>
      <ID>arn:aws:iam::444455556666:user/user1-22222a31-17b5-4fb7-9df5-b222222f13de</ID>
      <DisplayName>user1-22222a31-17b5-4fb7-9df5-b222222f13de</DisplayName>
    </Initiator>
    <StorageClass>STANDARD</StorageClass>
    <Initiated>2010-11-10T20:49:33.000Z</Initiated>
  </Upload>
</ListMultipartUploadsResult>

Тег	Описание
`ListMultipartUploadsResult`	Корневой тег ответа. Путь: `/ListMultipartUploadsResult`.
`Bucket`	Бакет, к которому относится составная загрузка. Путь: `/ListMultipartUploadsResult/Bucket`.
`KeyMarker`	Ключ. Выдача начинается с ключа, следующего за указанным в значении элемента. Смотрите описание параметра запроса `key-marker`. Путь: `/ListMultipartUploadsResult/KeyMarker`.
`UploadIdMarker`	Идентификатор загрузки. Выдача начнется с той загрузки, идентификатор которой следует за указанной в параметре. Смотрите описание параметра запроса `upload-id-marker`. Путь: `/ListMultipartUploadsResult/UploadIdMarker`.
`NextKeyMarker`	Ключ. Если выдача не вместила все элементы, которые должен получить пользователь, то это значение необходимо использовать в параметре `key-marker` для последующих запросов. Присутствует в случае, когда в ответ не поместился все элементы. Путь: `/ListMultipartUploadsResult/NextKeyMarker`.
`NextUploadIdMarker`	Идентификатор загрузки. Если выдача не вместила все элементы, которые должен получить пользователь, то это значение необходимо использовать в параметре `upload-id-marker` для последующих запросов. Присутствует в случае, когда в ответ не поместились все элементы. Путь: `/ListMultipartUploadsResult/NextUploadMarker`.
`Encoding-Type`	Кодировка, в которой Object Storage представляет ключ в XML-ответе. Смотрите описание параметра запроса `encoding-type`. Путь: `/ListMultipartUploadsResult/Encoding-Type`.
`MaxUploads`	Максимальная длина списка для одного ответа. Смотрите параметр запроса `max-uploads`. Путь: `/ListMultipartUploadsResult/MaxUploads`.
`IsTruncated`	Признак неполноты списка. Если `IsTruncated` — `true`, то это означает, что Object Storage вернуло не полный список загрузок. Путь: `/ListMultipartUploadsResult/IsTruncated`.
`Upload`	Описание загрузки. Путь: `/ListMultipartUploadsResult/Upload`.
`Key`	Ключ конечного объекта загрузки. Путь: `/ListMultipartUploadsResult/Upload/Key`.
`UploadId`	Идентификатор составной загрузки. Путь: `/ListMultipartUploadsResult/Upload/UploadId`.
`Initiator`	Инициатор составной загрузки. Путь: `/ListMultipartUploadsResult/Upload/Initiator`.
`ID`	Идентификатор пользователя. Возможные пути: - `/ListMultipartUploadsResult/Upload/Initiator/ID`
`DisplayName`	Отображаемое имя пользователя. Возможные пути: - `/ListMultipartUploadsResult/Upload/Initiator/DisplayName`
`StorageClass`	Класс хранения объекта: `STANDARD` или `COLD`. Путь: `/ListMultipartUploadsResult/Upload/StorageClass`.
`Initiated`	Дата и время запроса на начало составной загрузки.
`/ListMultipartUploadsResult/Prefix`	Префикс ключа. Смотрите параметр запроса `prefix`. Путь: `/ListMultipartUploadsResult/Prefix`.
`Delimiter`	Символ-разделитель, который использовался при формировании выдачи. Смотрите описание параметра запроса `delimiter`. Путь: `/ListMultipartUploadsResult/Delimiter`.
`CommonPrefixes`	Содержит элемент `Prefix`. Путь: `/ListMultipartUploadsResult/CommonPrefixes`.
`CommonPrefixes/Prefix`	Часть имени ключа, которая определяется при обработке параметров запроса `delimiter` и `prefix`. Путь: `/ListMultipartUploadsResult/CommonPrefixes/Prefix`.