ListParts


Lista as partes que foram carregadas para um carregamento multipart específico. Esta operação deve incluir o ID de upload, que você obtém enviando a solicitação de upload de várias partes iniciada (consulte CreateMultipartUpload ). Essa solicitação retorna no máximo 1.000 peças carregadas. O número padrão de peças retornadas é 1.000 peças. Você pode restringir o número de peças retornadas especificando o max-parts. Se o seu upload com várias partes consistir em mais de 1.000 partes, a resposta retornará um IsTruncatedcampo com o valor true e um NextPartNumberMarker. 

Request Syntax

GET /Key+?MaxParts=MaxParts&PartNumberMarker=PartNumberMarker&UploadId=UploadId HTTP/1.1
Host: bucket-name.bigfile.brascloud.com.br:443
x-amz-request-payer: RequestPayer

Response Syntax

HTTP/1.1 200
x-amz-abort-date: AbortDate
x-amz-abort-rule-id: AbortRuleId
x-amz-request-charged: RequestCharged
<?xml version="1.0" encoding="UTF-8"?>
<ListPartsOutput>
   <Bucket>string</Bucket>
   <Key>string</Key>
   <UploadId>string</UploadId>
   <PartNumberMarker>integer</PartNumberMarker>
   <NextPartNumberMarker>integer</NextPartNumberMarker>
   <MaxParts>integer</MaxParts>
   <IsTruncated>boolean</IsTruncated>
   <Part>
      <ETag>string</ETag>
      <LastModified>timestamp</LastModified>
      <PartNumber>integer</PartNumber>
      <Size>integer</Size>
   </Part>
   ...
   <Initiator>
      <DisplayName>string</DisplayName>
      <ID>string</ID>
   </Initiator>
   <Owner>
      <DisplayName>string</DisplayName>
      <ID>string</ID>
   </Owner>
   <StorageClass>string</StorageClass>
</ListPartsOutput>

Exemplos

Suponha que você fez o upload de peças com números de peça seqüenciais começando com 1. A solicitação de lista de peças a seguir especifica max-partse part-number-markerconsulta parâmetros. A solicitação lista as duas primeiras partes que seguem o número da peça 1, ou seja, você receberá as partes 2 e 3 na resposta. Se existir mais partes, o resultado é um resultado truncado e, por conseguinte, a resposta vai devolver um IsTruncatedelemento com o valor true. A resposta também retornará o NextPartNumberMarkerelemento com o valor 3, que deve ser usado para o valor do part-number-markerparâmetro de seqüência de caracteres da consulta de solicitação na próxima solicitação de ListParts.

Request
GET /example-object?uploadId=XXBsb2FkIElEIGZvciBlbHZpbmcncyVcdS1tb3ZpZS5tMnRzEEEwbG9hZA&max-parts=2&part-number-marker=1 HTTP/1.1
Host: bucket.bigfile.brascloud.com.br:443
Date: Mon, 1 Nov 2010 20:34:56 GMT
Authorization: authorization string

Response
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: AmazonS3

<?xml version="1.0" encoding="UTF-8"?>
<ListPartsResult xmlns="http://s3.amazonaws.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>