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 upload fracionado no Amazon S3.

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

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 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 ListMultipartUploadsRequest da API de multipart upload do SDK para .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 upload fracionado no Amazon S3.

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 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.

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