Descripción de cargas multiparte
Puede utilizar la AWS CLI, la API de REST o los AWS SDK para obtener una lista de cargas multiparte en curso en Amazon S3. Puede utilizar la carga multiparte para cargar mediante programación un solo objeto en Amazon S3. Las cargas multiparte trasladan objetos a Amazon S3 moviendo una parte de los datos de un objeto a la vez. Para obtener más información general sobre las cargas multiparte, consulte Carga y copia de objetos con la carga multiparte en Amazon S3.
Para conocer un procedimiento integral sobre la carga de un objeto con carga multiparte con una suma de comprobación adicional, consulte Tutorial: Cargar un objeto mediante una carga multiparte y verificar la integridad de sus datos.
En la siguiente sección se muestra cómo obtener una lista de las cargas multiparte en curso con la AWS Command Line Interface, la API de REST de Amazon S3 y los AWS SDK.
En las siguientes secciones de AWS Command Line Interface, se describen las operaciones para visualizar listas de las cargas multiparte.
Las siguientes secciones de la Referencia de API de Amazon Simple Storage Service especifican la API de REST para describir cargas multiparte:
- Java
-
Las siguientes tareas lo guían a través del proceso de uso de las clases de Java de nivel bajo para enumerar las cargas multipartes en proceso en un bucket.
Proceso de descripción de cargas multiparte de API de bajo nivel
1 |
Cree una instancia de la clase ListMultipartUploadsRequest y proporcione el nombre del bucket. |
2 |
Ejecute el método AmazonS3Client.listMultipartUploads. El método devuelve una instancia de la clase MultipartUploadListing que le brinda información sobre las cargas multipartes en proceso. |
En el siguiente ejemplo de código Java se muestran las tareas anteriores.
ListMultipartUploadsRequest allMultpartUploadsRequest =
new ListMultipartUploadsRequest(existingBucketName);
MultipartUploadListing multipartUploadListing =
s3Client.listMultipartUploads(allMultpartUploadsRequest);
- .NET
Para enumerar todas las cargas multiparte en curso en un bucket concreto, use la clase ListMultipartUploadsRequest de la API de carga multiparte de bajo nivel de AWS SDK for .NET. El método AmazonS3Client.ListMultipartUploads devuelve una instancia de la clase ListMultipartUploadsResponse que ofrece información sobre las cargas multiparte en curso.
Una carga multiparte en curso es una carga multiparte que se ha iniciado mediante una solicitud de carga multiparte pero que aún no se ha completado o detenido. Para obtener más información acerca de las cargas multiparte en Amazon S3, consulte Carga y copia de objetos con la carga multiparte en Amazon S3.
En el siguiente ejemplo de código C# se muestra cómo usar AWS SDK for .NET para enumerar todas las cargas multiparte en curso en un bucket. Para obtener información acerca de cómo configurar y ejecutar ejemplos de código, consulte Introducción al SDK de AWS para .NET en la Guía para desarrolladores del SDK de AWS para .NET.
ListMultipartUploadsRequest request = new ListMultipartUploadsRequest
{
BucketName = bucketName // Bucket receiving the uploads.
};
ListMultipartUploadsResponse response = await AmazonS3Client.ListMultipartUploadsAsync(request);
- PHP
Este tema muestra cómo usar las clases de API de bajo nivel de la versión 3 de AWS SDK for PHP para crear una lista de todas las cargas multiparte en curso en un bucket. Para obtener más información acerca de la API del SDK de AWS para Ruby, consulte SDK de AWS para Ruby, versión 2.
El siguiente ejemplo de PHP demuestra cómo enumerar todas las cargas multiparte en curso en un 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());
