Listar multipart uploads - Amazon Simple Storage Service

Listar multipart uploads

É 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 multipart upload.

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.

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.

As seções a seguir na AWS Command Line Interface descrevem as operações de listagem de carregamentos fracionados.

As seções a seguir na Referência de APIs do Amazon Simple Storage Service descrevem a API REST para listagem de multipart uploads:

Java

As tarefas a seguir fornecem orientações para usar as classes Java de baixo nível para listar todos os multipart uploads em andamento em um bucket.

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

Execute o método AmazonS3Client.listMultipartUploads. O método retorna uma instância da classe MultipartUploadListing que fornece informações sobre os multipart uploads em andamento.

O exemplo de código Java a seguir demonstra as tarefas anteriores.

ListMultipartUploadsRequest allMultpartUploadsRequest = 
     new ListMultipartUploadsRequest(existingBucketName);
MultipartUploadListing multipartUploadListing = 
     s3Client.listMultipartUploads(allMultpartUploadsRequest);
.NET

Para listar todos os multipart uploads em andamento em um bucket específico, use a classe ListMultipartUploadsRequest da API de multipart upload do AWS SDK for .NET 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 multipart upload.

O exemplo do C# a seguir mostra como usar o AWS SDK for .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 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 for 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.

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());