Enumeración de partes (GET uploadID)

Descripción

Esta operación de carga multiparte enumera las partes de un archivo que se han cargado en una carga multiparte específica identificada por un ID de carga. Para obtener información sobre la carga multiparte, consulte Carga de archivos grandes por partes (carga multiparte).

Puede realizar esta solicitud en cualquier momento durante una carga multiparte en curso antes de completar la carga multiparte. S3 Glacier devuelve la lista de partes ordenada por el rango que haya especificado en cada carga de partes. Si envía una solicitud de enumeración de partes una vez finalizada la carga multiparte, Amazon S3 Glacier (S3 Glacier) devuelve un error.

La operación de enumeración de partes admite la paginación. Siempre debe consultar si el campo Marker del cuerpo de la respuesta contiene un marcador en el que continuará la lista; si no hay más elementos, el campo marker será null. Si marker no es un valor nulo, para recuperar el siguiente conjunto de partes, debe enviar otra solicitud de enumeración de partes con el parámetro de solicitud marker establecido en el valor del marcador que S3 Glacier devolvió en respuesta a la solicitud de enumeración de partes anterior.

También puede limitar el número de partes devueltas en la respuesta especificando el parámetro limit en la solicitud.

Solicitudes

Sintaxis

Para enumerar las partes de una carga multiparte en curso, envíe una solicitud GET al URI del recurso de ID de carga multiparte. El ID de carga multiparte se devuelve al iniciar una carga multiparte (Inicio de la carga multiparte (POST cargas-multiparte)). Si lo desea, también puede especificar los parámetros marker y limit.

GET /AccountId/vaults/VaultName/multipart-uploads/uploadID HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
x-amz-glacier-version: 2012-06-01

nota

El valor AccountId es el ID de la Cuenta de AWS propietaria del almacén. Puede especificar un ID de Cuenta de AWS o, si lo desea, un solo carácter “-” (guion), en cuyo caso, Amazon S3 Glacier usa el ID de la Cuenta de AWS asociada con las credenciales empleadas para firmar la solicitud. Si usa un ID de cuenta, no incluya ningún guion (“-”) en el ID.

Parámetros de solicitud

Nombre	Descripción	Obligatorio
limit	Número máximo de partes que se van a devolver. El límite predeterminado es 50. El número de partes devueltas puede ser menor que el límite especificado, pero nunca puede superarlo. Tipo: String Restricciones: el valor entero mínimo es 1. El valor entero máximo es 50.	No
marker	Cadena opaca utilizada para la paginación. marker especifica la parte en la deben comenzar las listas de partes. Obtenga el valor marker de la respuesta de una respuesta anterior de la enumeración de partes. Solo tiene que incluir marker si quiere continuar la paginación de resultados que se inició en una solicitud anterior de enumeración de partes. Tipo: String Restricciones: ninguna	No

Encabezados de solicitud

Esta operación solo usa encabezados de respuesta que sean comunes a la mayoría de las respuestas. Para obtener información acerca de los encabezados de respuestas comunes, consulte Encabezados de respuesta comunes.

Cuerpo de la solicitud

Esta operación no tiene un cuerpo de la solicitud.

Respuestas

Sintaxis

HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: Length

{
    "ArchiveDescription" : String,
    "CreationDate" : String,
    "Marker": String,
    "MultipartUploadId" : String,
    "PartSizeInBytes" : Number,
    "Parts" : 
    [ {
      "RangeInBytes" : String,
      "SHA256TreeHash" : String
      },
      ...
     ],
    "VaultARN" : String
}	

Encabezados de respuesta

Esta operación solo usa encabezados de respuesta que sean comunes a la mayoría de las respuestas. Para obtener información acerca de los encabezados de respuestas comunes, consulte Encabezados de respuesta comunes.

Cuerpo de respuesta

El cuerpo de la respuesta contiene los siguientes campos JSON.

ArchiveDescription

Descripción del archivo que se especificó en la solicitud Initiate Multipart Upload. Este campo es null si no se especificó ninguna descripción del archivo en la operación Initiate Multipart Upload.

Tipo: cadena

CreationDate

Momento en formato UTC en que se creó la carga multiparte.

Tipo: cadena. Una representación de cadena con el formato de fecha ISO 8601; por ejemplo, 2013-03-20T17:03:43.221Z.

Marker

Cadena opaca que indica dónde se va a continuar la paginación de los resultados. Puede utilizar marker en una nueva solicitud de enumeración de partes para recuperar más trabajos de la lista. Si no hay más partes, este valor es null.

Tipo: cadena

MultipartUploadId

El ID de la carga a la que están asociadas las partes.

Tipo: cadena

PartSizeInBytes

El tamaño de la parte en bytes. Es el mismo valor que ha especificado en la solicitud de inicio de carga multiparte.

Tipo: Número

Partes

Una lista de los tamaños de parte de la carga multiparte. Cada objeto de la matriz contiene un parte de nombre/valor RangeBytes y sha256-tree-hash.

Tipo: Array

RangeInBytes

El rango de bytes de una parte, incluido el valor superior del rango.

Tipo: cadena

SHA256TreeHash

Valor de hash en árbol SHA256 que S3 Glacier calculó para la parte. Este campo nunca es null.

Tipo: cadena

VaultARN

Nombre de recurso de Amazon (ARN) del almacén en el que se inició la carga multiparte.

Tipo: cadena

Errores

Para obtener información acerca de los mensajes de error y las excepciones de Amazon S3 Glacier, consulte Respuestas de error.

Ejemplos

Ejemplo: enumeración de partes de una carga multiparte

En el siguiente ejemplo se enumeran todas las partes de una carga. El ejemplo envía una solicitud HTTP GET al URI del ID de una carga multiparte específica en curso y devuelve un máximo de 1000 partes.

Solicitud de ejemplo

GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2

Respuesta de ejemplo

En la respuesta, S3 Glacier devuelve una lista de las partes cargadas asociadas con el ID de carga multiparte especificado. En este ejemplo, solo hay dos partes. El campo Marker devuelto es null, lo que indica que no hay más partes de la carga multiparte.

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Type: application/json
Content-Length: 412
      
{
    "ArchiveDescription" : "archive description",
    "CreationDate" : "2012-03-20T17:03:43.221Z",
    "Marker": null,
    "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE",
    "PartSizeInBytes" : 4194304,
    "Parts" : 
    [ {
      "RangeInBytes" : "0-4194303",
      "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4"
      },
      {
      "RangeInBytes" : "4194304-8388607",
      "SHA256TreeHash" : "0195875365afda349fc21c84c099987164"
      }],
    "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault"
}	

Ejemplo: enumeración de partes de una carga multiparte (especificar el marcador y los parámetros de solicitud de límite)

En el siguiente ejemplo, se muestra cómo se utiliza la paginación para obtener un número limitado de resultados. El ejemplo envía una solicitud HTTP GET al URI del ID de una carga multiparte específica en curso para devolver una parte. Un parámetro marker de inicio especifica en qué parte comienza la lista de partes. Puede obtener el valor marker de la respuesta de una solicitud anteriores de una lista de partes. Además, en este ejemplo el parámetro limit se establece en 1 y devuelve una parte. Tenga en cuenta que el campo Marker no es null, lo que indica que hay al menos una parte para obtener.

Solicitud de ejemplo

GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE?marker=1001&limit=1 HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2

Respuesta de ejemplo

En la respuesta, S3 Glacier devuelve una lista de las partes cargadas que están asociadas con el ID de carga multiparte en curso especificado.

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Type: text/json
Content-Length: 412
      
{
    "ArchiveDescription" : "archive description 1",
    "CreationDate" : "2012-03-20T17:03:43.221Z",
    "Marker": "MfgsKHVjbQ6EldVl72bn3_n5h2TaGZQUO-Qb3B9j3TITf7WajQ",
    "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE",
    "PartSizeInBytes" : 4194304,
    "Parts" : 
    [ {
      "RangeInBytes" : "4194304-8388607",
      "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4"
      }],
    "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault"
}	

Secciones relacionadas

• Inicio de la carga multiparte (POST cargas-multiparte)

• Carga de partes (PUT uploadID)

• Finalización de una carga multiparte (POST uploadID)

• Anulación de la carga multiparte (DELETE uploadID)

• Enumeración de cargas multiparte (GET cargas-multiparte)

• Carga de archivos grandes por partes (carga multiparte)

• Administración de identidades y accesos para Amazon S3 Glacier