List Parts

Описание

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

Операция должна включать в себя идентификатор загрузки, который вы получаете после отправки запроса на инициализацию многокомпонентной загрузки. Такой запрос возвращает не более 1000 загруженных частей. По умолчанию количество возвращаемых частей — 1000. Вы можете ограничить количество возвращаемых частей, указав параметр запроса max-parts. Если ваша многокомпонентная загрузка состоит из более, чем 1 000 частей, то ответ возвращает элемент NextPartNumberMarker и поле IsTruncated со значением true. В последующих запросах на просмотр списка частей вы можете включать параметр строки запроса part-number-marker, устанавливая для него значение поля NextPartNumberMarker из предыдущего ответа.

Запросы

Синтаксис

 GET /ObjectName?uploadId=UploadId HTTP/1.1
 Host: BucketName.hb.bizmrg.com (BucketName.ib.bizmrg.com)
 Date: date
 Authorization: authorization string

Параметры запроса

Данная реализация операции GET использует параметры из нижеуказанной таблицы для возврата поднабора объектов в бакете.


Имя
Описание
Обязательно
encoding-type

Запрос для сервиса на кодировку ответа с указанием используемого метода кодировки.

Ключ объекта может содержать любой символ Unicode, однако парсер XML 1.0 не может анализировать некоторые символы, например символы со значением ASCII от 0 до 10. Вы можете добавить этот параметр для того, чтобы сервис установил кодировку ключей в ответе при наличии символов, неподдерживаемых XML 1.0.


  • Тип: String
  • По умолчанию: нет значения
  • Допустимое значение: url


Нет
uploadId

Идентификатор загрузки, определяющий многокомпонентную загрузку, список частей которой просматривается.

  • Тип: String
  • По умолчанию: нет значения
Да
max-parts

Устанавливает максимальное количество частей, возвращаемых в теле ответа.

  • Тип: String
  • По умолчанию: 1000
Нет
part-number?-marker

Указывает ту часть, после которой необходимо начинать просмотр. Будут показаны части только с бóльшим номером.

  • Тип: String
  • По умолчанию: нет значения
Нет

Элементы запроса

Эта операция не использует элементы запроса.

Ответы

Элементы ответа

Имя
Описание
x-amz-abort-date

Если бакет содержит правило цикла жизни, настроенное на прерывание незавершенных многокомпонентных загрузок, и префикс правила жизненного цикла совпадает с именем объекта в запросе, то ответ включает в себя этот заголовок, обозначающий тот момент, когда будет возможно воспользоваться операцией прерывания для инициализированной многокомпонентной загрузки. 

Ответ также будет включать в себя заголовок x-amz-abort-rule-id, который будет предоставлять идентификатор правила конфигурации жизненного цикла, определяющего данное действие.

  • Тип: String
x-amz-abort?-rule-id

Данный заголовок возвращается вместе с заголовком x-amz-abort-date и определяет релевантное правило конфигурации жизненного цикла, которое устанавливает действие прерывания для незавершенных многокомпонентных загрузок.

  • Тип: String
ListPartsResult

Контейнер для ответа.

  • Дочерние элементы:

Bucket, Key, UploadId, Initiator, Owner,StorageClass, PartNumberMarker, 

NextPartNumberMarker, MaxParts, IsTruncated, Part

  • Тип: Container
Bucket

Имя бакета, для которого инициализирована многокомпонентная загрузка.

  • Тип: String
  • Предок: ListPartsResult
Encoding-Type

Тип кодировки, используемой сервисом для кодирования имен ключей объекта в ответе XML.

Если вы указываете параметр запроса encoding-type, то сервис включает этот элемент в запрос и возвращает закодированные значения имен ключей в элементе Key.

  • Тип: String
  • Предок: ListBucketResult
Key

Ключ объекта, для которого инициализирована многокомпонентная загрузка.

  • Тип: String
  • Предок: ListPartsResult
UploadId

Идентификатор загрузки, определяющий многокомпонентную загрузку, список частей которой просматривается.

  • Тип: String
  • Предок: ListPartsResult
Initiator

Элемент контейнера, определяющий того, кто инициализировал многокомпонентную загрузку. Если инициатором является проект сервиса, то этот элемент предоставляет ту же информацию, что и элемент Owner. Если инициатором является пользователь IAM, то данный элемент предоставляет пользовательское имя ресурса сервиса и отображаемое имя.


  • Дочерние элементы: ID, DisplayName
  • Тип: Container
  • Предок: ListPartsResult


ID

Если сущностью является проект сервиса, то элемент предоставляет канонический идентификатор пользователя. Если сущностью является пользователь IAM, то элемент предоставляет значение пользовательского имени ресурса сервиса.

  • Тип: String
  • Предок: Initiator
DisplayName

Имя сущности.

  • Тип: String
  • Предок: Initiator
Owner

Элемент контейнера, определяющий после создания объекта его владельца. Если многокомпонентная загрузка инициализирована пользователем IAM, то данный элемент предоставляет идентификатор родительского проекта и отображаемое имя.


  • Дочерние элементы: ID, DisplayName
  • Тип: Container
  • Предок: ListPartsResult


StorageClass

Класс хранения (STANDARD или REDUCED_REDUNDANCY), используемый для хранения загруженного объекта.

  • Тип: String
  • Предок: ListPartsResult
PartNumberMarker

Номер части, с которой начинается отображение списка.

  • Тип: Integer
  • Предок: ListPartsResult
NextPartNumberMarker

Когда список усечен, данный элемент указывает последнюю часть в этом списке и значение, которое необходимо использовать с параметром запроса part-number-marker в последующем запросе.

  • Тип: Integer
  • Предок: ListPartsResult
MaxParts

Указывает, усечен ли возвращаемый список частей. Значение true указывает на то, что список является усеченным. Список может быть усечен, если количество частей превышает предельное значение, возвращаемое в элементе MaxParts.

  • Тип: Boolean
  • Предок: ListPartsResult
Part

Контейнер для элементов, относящихся к определенной части. Ответ может содержать ни одного или несколько элементов Part.

  • Дочерние элементы: PartNumber, LastModified, ETag, Size
  • Тип: String
  • Предок: ListPartsResult
PartNumber

Номер, определяющий часть.

  • Тип: Integer
  • Предок: Part
LastModified

Дата и время загрузки части.

  • Тип: Date
  • Предок: Part
ETag

Тег сущности, возвращаемый при загрузке части.

  • Тип: String
  • Предок: Part
Size

Размер объема данных загружаемой части.

  • Тип: Integer
  • Предок: Part

Пример

Запрос

Например, вы загрузили части с последовательной нумерацией, начинающейся с 1. Следующий запрос на просмотр списка частей указывает параметры запроса max-parts и part-number-marker. Запрос возвращает список из первых двух частей, которые следуют за частью номер 1, т. е. в ответе будут выданы части 2 и 3. Если существуют дополнительные части, то результатом будет являться усеченный результат и, следовательно, ответ вернет элемент IsTruncated со значением true. Ответ также вернет элемент NextPartNumberMarker со значением 3, которое должно будет использоваться для значения параметра строки запроса part-number-marker в следующем запросе на просмотр списка частей.

 GET /example-object?uploadId=XXBsb2FkIElEIGZvciBlbHZpbmcncyVcdS1tb3ZpZS5tMnRzEEEwbG9hZA&max-parts=2&part-number-marker=1 HTTP/1.1
 Host: example-bucket.hb.bizmrg.com (example-bucket.ib.bizmrg.com)
 Date: Mon, 1 Nov 2010 20:34:56 GMT
 Authorization: authorization string

Ответ

 HTTP/1.1 200 OK
 x-amz-id-2: Uuag1LuByRx9e6j5Onimru9pO4ZVKnJ2Qz7/C1NPcfTWAtRPfTaOFg==
 x-amz-request-id: 656c76696e6727732072657175657374
 Date: Mon, 1 Nov 2010 20:34:56 GMT
 Content-Length: 985
 Connection: keep-alive
 Server: HbBizmrg
<?xml version="1.0" encoding="UTF-8"?>
<ListPartsResult xmlns="http://hb.bizmrg.com/doc/2006-03-01/">
  <Bucket>example-bucket</Bucket>
  <Key>example-object</Key>
  <UploadId>XXBsb2FkIElEIGZvciBlbHZpbmcncyVcdS1tb3ZpZS5tMnRzEEEwbG9hZA</UploadId>
  <Initiator>
      <ID>arn:aws:iam::111122223333:user/some-user-11116a31-17b5-4fb7-9df5-b288870f11xx</ID>
      <DisplayName>umat-user-11116a31-17b5-4fb7-9df5-b288870f11xx</DisplayName>
  </Initiator>
  <Owner>
    <ID>75aa57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a</ID>
    <DisplayName>someName</DisplayName>
  </Owner>
  <StorageClass>STANDARD</StorageClass>
  <PartNumberMarker>1</PartNumberMarker>
  <NextPartNumberMarker>3</NextPartNumberMarker>
  <MaxParts>2</MaxParts>
  <IsTruncated>true</IsTruncated>
  <Part>
    <PartNumber>2</PartNumber>
    <LastModified>2010-11-10T20:48:34.000Z</LastModified>
    <ETag>"7778aef83f66abc1fa1e8477f296d394"</ETag>
    <Size>10485760</Size>
  </Part>
  <Part>
    <PartNumber>3</PartNumber>
    <LastModified>2010-11-10T20:48:33.000Z</LastModified>
    <ETag>"aaaa18db4cc2f85cedef654fccc4a4x8"</ETag>
    <Size>10485760</Size>
  </Part>
</ListPartsResult>