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 IsTruncated
campo 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-parts
e part-number-marker
consulta 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 IsTruncated
elemento com o valor true
. A resposta também retornará o NextPartNumberMarker
elemento com o valor 3
, que deve ser usado para o valor do part-number-marker
parâmetro de seqüência de caracteres da consulta de solicitação na próxima solicitação de ListParts.
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
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>