ListMultipartUploads
Esta operação lista os carregamentos com várias partes em andamento. Um upload multipart em andamento é um upload multipart que foi iniciado usando a solicitação Initiate Multipart Upload, mas ainda não foi concluído ou interrompido.
Esta operação retorna no máximo 1.000 uploads com várias partes na resposta. 1.000 uploads com várias partes é o número máximo de uploads que uma resposta pode incluir, que também é o valor padrão. Você pode limitar ainda mais o número de uploads em uma resposta especificando o max-uploads
parâmetro na resposta. Se uploads adicionais com várias partes atenderem aos critérios da lista, a resposta conterá um IsTruncated
elemento com o valor true. Para listar os uploads adicionais com várias partes, use os parâmetros key-marker
e upload-id-marker
request.
Request Syntax
GET /?uploads&Delimiter=Delimiter&EncodingType=EncodingType&KeyMarker=KeyMarker&MaxUploads=MaxUploads&Prefix=Prefix&UploadIdMarker=UploadIdMarker HTTP/1.1 Host: bucket-name.bigfile.brascloud.com.br:443
Response Syntax
HTTP/1.1 200 <?xml version="1.0" encoding="UTF-8"?> <ListMultipartUploadsOutput> <Bucket>string</Bucket> <KeyMarker>string</KeyMarker> <UploadIdMarker>string</UploadIdMarker> <NextKeyMarker>string</NextKeyMarker> <Prefix>string</Prefix> <Delimiter>string</Delimiter> <NextUploadIdMarker>string</NextUploadIdMarker> <MaxUploads>integer</MaxUploads> <IsTruncated>boolean</IsTruncated> <Upload> <Initiated>timestamp</Initiated> <Initiator> <DisplayName>string</DisplayName> <ID>string</ID> </Initiator> <Key>string</Key> <Owner> <DisplayName>string</DisplayName> <ID>string</ID> </Owner> <StorageClass>string</StorageClass> <UploadId>string</UploadId> </Upload> ... <CommonPrefixes> <Prefix>string</Prefix> </CommonPrefixes> ... <EncodingType>string</EncodingType> </ListMultipartUploadsOutput>
Exemplos
A solicitação a seguir lista três uploads com várias partes. A solicitação especifica o max-uploads
parâmetro request para definir o número máximo de uploads com várias partes a serem retornados no corpo da resposta.
GET /?uploads&max-uploads=3 HTTP/1.1 Host: bucket.bigfile.brascloud.com.br:443 Date: Mon, 1 Nov 2010 20:34:56 GMT Authorization: authorization string
A resposta de amostra a seguir indica que a lista de upload com várias partes foi truncada e fornece NextKeyMarker
os NextUploadIdMarker
elementos e. Você especifica esses valores em suas solicitações subsequentes para ler o próximo conjunto de uploads com várias partes. Ou seja, envie uma solicitação subsequente especificando key-marker=my-movie2.m2ts
(valor do NextKeyMarker
elemento) e upload-id-marker=YW55IGlkZWEgd2h5IGVsdmluZydzIHVwbG9hZCBmYWlsZWQ
(valor do NextUploadIdMarker
).
A resposta de amostra também mostra um caso de dois uploads com várias partes em andamento com a mesma chave ( my-movie.m2ts
). Ou seja, a resposta mostra dois envios com a mesma chave. Essa resposta mostra os uploads classificados por chave e, em cada chave, os uploads são classificados em ordem crescente no momento em que o upload com várias partes foi iniciado.
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: 1330 Connection: keep-alive Server: AmazonS3 <?xml version="1.0" encoding="UTF-8"?> <ListMultipartUploadsResult xmlns="http://bigfile.brascloud.com.br:443/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> <Owner> <ID>75aa57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a</ID> <DisplayName>OwnerDisplayName</DisplayName> </Owner> <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> <Owner> <ID>b1d16700c70b0b05597d7acd6a3f92be</ID> <DisplayName>OwnerDisplayName</DisplayName> </Owner> <StorageClass>STANDARD</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> <Owner> <ID>b1d16700c70b0b05597d7acd6a3f92be</ID> <DisplayName>OwnerDisplayName</DisplayName> </Owner> <StorageClass>STANDARD</StorageClass> <Initiated>2010-11-10T20:49:33.000Z</Initiated> </Upload> </ListMultipartUploadsResult>