**Esta página es solo para los clientes actuales del servicio Amazon Glacier que utilizan Vaults y la API de REST original de 2012.** Si busca soluciones de almacenamiento de archivos, se recomienda que utilice las clases de almacenamiento de Amazon Glacier en Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval y S3 Glacier Deep Archive. Para obtener más información sobre estas opciones de almacenamiento, consulte las [clases de almacenamiento de Amazon Glacier](https://aws.amazon.com/s3/storage-classes/glacier/). Amazon Glacier (servicio original independiente basado en bóveda) ya no acepta nuevos clientes. Amazon Glacier es un servicio independiente propio APIs que almacena datos en almacenes y es distinto de las clases de almacenamiento Amazon S3 y Amazon S3 Glacier. Sus datos actuales permanecerán seguros y accesibles en Amazon Glacier de forma indefinida. No hay que hacer migraciones. Para un almacenamiento de archivos a largo plazo y de bajo costo, AWS recomienda las [clases de almacenamiento Amazon S3 Glacier](https://aws.amazon.com/s3/storage-classes/glacier/), que ofrecen una experiencia de cliente superior con S3 basada en cubos APIs, Región de AWS disponibilidad total, costos más bajos e AWS integración de servicios. Si desea mejorar las capacidades, considere la posibilidad de migrar a las clases de almacenamiento de Amazon S3 Glacier mediante nuestra [AWS Guía de soluciones para la transferencia de datos de los almacenes de Amazon Glacier a las clases de almacenamiento de Amazon S3 Glacier](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/). Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Enumeración de cargas multiparte (GET cargas-multiparte) ## Description (Descripción) Esta operación de carga multiparte muestra las cargas multiparte que están en curso en el almacén especificado. Una carga multiparte en curso es una carga multiparte iniciada por una solicitud [Inicio de la carga multiparte (POST cargas-multiparte)](api-multipart-initiate-upload.md) que aún no se ha completado ni detenido. En la lista que devuelve la respuesta de List Multipart Upload, el orden no está garantizado. La operación List Multipart Uploads admite la paginación. De forma predeterminada, esta operación devuelve un máximo de 50 cargas multiparte en la respuesta. 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 el campo `marker` no tiene un valor nulo, para recuperar el siguiente conjunto de cargas multiparte, debe enviar otra solicitud List Multipart Uploads con el parámetro de solicitud `marker` establecido en el valor del marcador que Amazon Glacier (Amazon Glacier) devolvió en respuesta a la solicitud List Multipart Uploads anterior. Tenga en cuenta que existen diferencias entre esta operación y la operación [Enumeración de partes (GET uploadID)](api-multipart-list-parts.md). La operación List Multipart Uploads muestra todas las cargas multiparte de un almacén. La operación List Parts devuelve las partes de una determinada carga multiparte identificada con un ID de carga. Para obtener información sobre la carga multiparte, consulte [Carga de archivos grandes por partes (carga multiparte)](uploading-archive-mpu.md). ## Solicitudes ### Sintaxis Para mostrar las cargas multiparte, envíe una solicitud `GET` al URI del subrecurso `multipart-uploads` del almacén. Si lo desea, también puede especificar los parámetros `marker` y `limit`. ``` 1. GET /AccountId/vaults/VaultName/multipart-uploads HTTP/1.1 2. Host: glacier.Region.amazonaws.com 3. Date: Date 4. Authorization: SignatureValue 5. x-amz-glacier-version: 2012-06-01 ``` **nota** El `AccountId` valor es el Cuenta de AWS identificador de la cuenta propietaria del almacén. Puede especificar un Cuenta de AWS ID o, si lo desea, un único `-` '' (guión), en cuyo caso Amazon Glacier utilizará el Cuenta de AWS ID asociado a las credenciales utilizadas para firmar la solicitud. Si usa un ID de cuenta, no incluya ningún guion (“-”) en el ID. ### Parámetros de la solicitud | Name | Description (Descripción) | Obligatorio | | --- | --- | --- | | limit | Especifica el número máximo de cargas que se van a devolver en el cuerpo de la respuesta. Si no se especifica, la operación List Uploads devuelve un máximo de 50 cargas. Tipo: cadena 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 carga en la deben comenzar las listas de cargas. El valor de `marker` se obtiene de una respuesta anterior de List Uploads. Solo tiene que incluir `marker` si quiere continuar la paginación de resultados que se inició en una solicitud List Uploads anterior. Tipo: cadena 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](api-common-response-headers.md). ### Cuerpo de la solicitud Esta operación no tiene un cuerpo de la solicitud. ## Respuestas ### Sintaxis ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: x-amzn-RequestId 3. Date: Date 4. Content-Type: application/json 5. Content-Length: Length 6. 7. { 8. "Marker": String, 9. "UploadsList" : [ 10. { 11. "ArchiveDescription": String, 12. "CreationDate": String, 13. "MultipartUploadId": String, 14. "PartSizeInBytes": Number, 15. "VaultARN": String 16. }, 17. ... 18. ] 19. } ``` ### 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](api-common-response-headers.md). ### 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 List Multipart Uploads para obtener otras cargas de la lista. Si no hay más cargas, este valor será `null`. *Tipo:* cadena **PartSizeInBytes** Tamaño de parte especificado en la solicitud [Inicio de la carga multiparte (POST cargas-multiparte)](api-multipart-initiate-upload.md). Este es el tamaño de todas las partes de la carga excepto de la última, que puede ser más pequeña. *Tipo*: Número **MultipartUploadId** ID de la carga multiparte. *Tipo:* cadena **UploadsList** Lista de metadatos sobre los objetos de la carga multiparte. Cada elemento de la lista contiene un conjunto de pares nombre-valor de la carga correspondiente, como `ArchiveDescription`, `CreationDate`, `MultipartUploadId`, `PartSizeInBytes` y `VaultARN`. *Tipo*: Array **VaultARN** Nombre de recurso de Amazon (ARN) del almacén que contiene el archivo. *Tipo:* cadena ### Errores Para obtener información acerca de los mensajes de error y las excepciones de Amazon Glacier, consulte [Respuestas de error](api-error-responses.md). ## Ejemplos ### Ejemplo: Mostrar todas las cargas multiparte En el siguiente ejemplo, se muestran todas las cargas multiparte en curso del almacén. En el ejemplo, se ilustra una solicitud HTTP `GET` dirigida al URI del subrecurso `multipart-uploads` de un almacén especificado. Como los parámetros `marker` y `limit` no están especificados en la solicitud, se devolverán, como máximo, 1000 cargas multiparte en curso. #### Solicitud de ejemplo ``` 1. GET /-/vaults/examplevault/multipart-uploads HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. x-amz-glacier-version: 2012-06-01 5. 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, Amazon Glacier devuelve una lista de todas las cargas multiparte en curso del almacén especificado. El campo `marker` es `null`, lo que indica que no hay más cargas para mostrar. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Content-Type: application/json 5. Content-Length: 1054 6. 7. { 8. "Marker": null, 9. "UploadsList": [ 10. { 11. "ArchiveDescription": "archive 1", 12. "CreationDate": "2012-03-19T23:20:59.130Z", 13. "MultipartUploadId": "xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev", 14. "PartSizeInBytes": 4194304, 15. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" 16. }, 17. { 18. "ArchiveDescription": "archive 2", 19. "CreationDate": "2012-04-01T15:00:00.000Z", 20. "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc", 21. "PartSizeInBytes": 4194304, 22. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" 23. }, 24. { 25. "ArchiveDescription": "archive 3", 26. "CreationDate": "2012-03-20T17:03:43.221Z", 27. "MultipartUploadId": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV", 28. "PartSizeInBytes": 4194304, 29. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" 30. } 31. ] 32. } ``` ### Ejemplo: Lista parcial de cargas multiparte En el siguiente ejemplo, se muestra cómo se utiliza la paginación para obtener un número limitado de resultados. En el ejemplo, se ilustra una solicitud HTTP `GET` dirigida al URI del subrecurso `multipart-uploads` de un almacén especificado. En este ejemplo, el parámetro `limit` está establecido en 1, lo que significa que solo se devuelve una carga en la lista, mientras que el parámetro `marker` indica el ID de la carga multiparte en la que comienza la lista. #### Solicitud de ejemplo ``` 1. GET /-/vaults/examplevault/multipart-uploads?limit=1&marker=xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. x-amz-glacier-version: 2012-06-01 5. 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, Amazon Glacier (Amazon Glacier) devuelve una lista con no más de dos cargas multiparte en curso del almacén indicado; esta lista comienza en el marcador especificado y devuelve dos resultados. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Content-Type: application/json 5. Content-Length: 470 6. 7. { 8. "Marker": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV", 9. "UploadsList" : [ 10. { 11. "ArchiveDescription": "archive 2", 12. "CreationDate": "2012-04-01T15:00:00.000Z", 13. "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc", 14. "PartSizeInBytes": 4194304, 15. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" 16. } 17. ] 18. } ``` ## Secciones relacionadas + [Inicio de la carga multiparte (POST cargas-multiparte)](api-multipart-initiate-upload.md) + [Carga de partes (PUT uploadID)](api-upload-part.md) + [Finalización de una carga multiparte (POST uploadID)](api-multipart-complete-upload.md) + [Anulación de la carga multiparte (DELETE uploadID)](api-multipart-abort-upload.md) + [Enumeración de partes (GET uploadID)](api-multipart-list-parts.md) + [Carga de archivos grandes por partes (carga multiparte)](uploading-archive-mpu.md) + [Administración de identidades y accesos para Amazon Glacier](security-iam.md)