# Listar multipart uploads
<a name="list-mpu"></a>

É possível usar a AWS CLI, a API REST ou os SDKs da AWS para recuperar uma lista de carregamentos fracionados em andamento no Amazon S3. Você pode usar o multipart upload para fazer upload programático de um único objeto para o Amazon S3. Carregamentos fracionados movem objetos para o Amazon S3 movendo uma parte dos dados de um objeto por vez. Consulte mais informações gerais sobre carregamentos fracionados em [Carregar e copiar objetos usando upload fracionado no Amazon S3](mpuoverview.md). 

Consulte um procedimento completo sobre o upload de um objeto com carregamento fracionado e com uma soma de verificação adicional em [Tutorial: Fazer upload de um objeto por meio do carregamento fracionado e conferir a integridade dos dados](tutorial-s3-mpu-additional-checksums.md).

A seção a seguir mostra como listar carregamentos fracionados em andamento com a AWS Command Line Interface, a API REST do Amazon S3 e os SDKs da AWS.

## Listagem de carregamentos fracionados usando a AWS CLI
<a name="list-mpu-cli"></a>

As seções a seguir na AWS Command Line Interface descrevem as operações de listagem de carregamentos fracionados. 
+ [list-parts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/list-parts.html): liste as partes enviadas por upload de um multipart upload específico.
+ [list-multipart-uploads](https://docs.aws.amazon.com/cli/latest/reference/s3api/list-multipart-uploads.html): liste multipart uploads em andamento.

## Listagem de uploads fracionados usando o AWS SDK (API de baixo nível)
<a name="list-aws-sdk"></a>

------
#### [ Java ]

Para listar todos os multipart uploads em andamento em um bucket usando o AWS SDK para Java, você pode usar as classes de API de baixo nível para:


**Processo de listagem de multipart uploads da API de baixo nível**  

|  |  | 
| --- |--- |
| 1 | Crie uma instância da classe `ListMultipartUploadsRequest` e forneça o nome do bucket. | 
| 2 | Executar o método `listMultipartUploads` da S3Client. O método retorna uma instância da classe `ListMultipartUploadsResponse` que fornece informações sobre os multipart uploads em andamento. | 

Para ver exemplos de como listar multipart uploads com o AWS SDK para Java, consulte [List multipart uploads](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_ListMultipartUploads_section.html) na *Referência de API do Amazon S3*.

------
#### [ .NET ]

Para listar todos os multipart uploads em andamento em um bucket específico, use a classe SDK para .NET da API de multipart upload do `ListMultipartUploadsRequest` de nível baixo. O `AmazonS3Client.ListMultipartUploads` método retorna uma instância da classe `ListMultipartUploadsResponse` que fornece informações sobre multipart uploads em andamento. 

Um multipart upload em andamento é um multipart upload que foi iniciado com o uso da solicitação para iniciar o multipart upload, mas que ainda não foi concluído ou parado. Para obter mais informações sobre multipart uploads do Amazon S3, consulte [Carregar e copiar objetos usando upload fracionado no Amazon S3](mpuoverview.md).

O exemplo do C\# a seguir mostra como usar o SDK para .NET para listar todos os multipart uploads em andamento em um bucket. Para obter informações sobre como configurar e executar exemplos de código, consulte [Conceitos básicos do AWS SDK for .NET](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/net-dg-setup.html) no *Guia do desenvolvedor do AWS SDK for .NET*. 

```
ListMultipartUploadsRequest request = new ListMultipartUploadsRequest
{
	 BucketName = bucketName // Bucket receiving the uploads.
};

ListMultipartUploadsResponse response = await AmazonS3Client.ListMultipartUploadsAsync(request);
```

------
#### [ PHP ]

Este tópico mostra como usar as classes da API de baixo nível da versão 3 do AWS SDK para PHP para listar todos os multipart uploads em andamento em um bucket. Para obter mais informações sobre a API do AWS SDK for Ruby, acesse [AWS SDK for Ruby Version 2](https://docs.aws.amazon.com/sdkforruby/api/index.html).

O exemplo de PHP a seguir demonstra a listagem de todos os multipart uploads em andamento em um bucket.

```
 require 'vendor/autoload.php';

use Aws\S3\S3Client;

$bucket = '*** Your Bucket Name ***';

$s3 = new S3Client([
    'version' => 'latest',
    'region'  => 'us-east-1'
]);

// Retrieve a list of the current multipart uploads.
$result = $s3->listMultipartUploads([
    'Bucket' => $bucket
]);

// Write the list of uploads to the page.
print_r($result->toArray());
```

------