**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.
# Operaciones de carga multiparte
A continuación, se muestran las operaciones de carga multiparte disponibles en Amazon Glacier.
**Topics**
+ [Anulación de la carga multiparte (DELETE uploadID)](api-multipart-abort-upload.md)
+ [Finalización de una carga multiparte (POST uploadID)](api-multipart-complete-upload.md)
+ [Inicio de la carga multiparte (POST cargas-multiparte)](api-multipart-initiate-upload.md)
+ [Enumeración de partes (GET uploadID)](api-multipart-list-parts.md)
+ [Enumeración de cargas multiparte (GET cargas-multiparte)](api-multipart-list-uploads.md)
+ [Carga de partes (PUT uploadID)](api-upload-part.md)
# Anulación de la carga multiparte (DELETE uploadID)
## Description (Descripción)
Este comando para la operación de carga multiparte detiene una carga multiparte identificada por el ID de carga.
Después de que la solicitud de anulación de carga multiparte se realice correctamente, no podrá utilizar el ID de carga para cargar más partes o realizar otras operaciones. La detención de una carga multiparte completada produce un error. Sin embargo, la detención de una carga ya detenida se realizará correctamente, durante un breve periodo de tiempo.
Esta operación es idempotente.
Para obtener información sobre la carga multiparte, consulte [Carga de archivos grandes por partes (carga multiparte)](uploading-archive-mpu.md).
## Solicitudes
Para detener una carga multiparte, envíe una solicitud HTTP `DELETE` al URI del subrecurso `multipart-uploads` del almacén e identifique el ID de carga multiparte específico como parte del URI.
### Sintaxis
```
1. DELETE /AccountId/vaults/VaultName/multipart-uploads/uploadID 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
Esta operación no usa parámetros de solicitud.
### Encabezados de solicitud
Esta operación solo usa encabezados de solicitud que sean comunes para todas las operaciones. Para obtener información acerca de los encabezados de solicitudes comunes, consulte [Encabezados de solicitudes comunes](api-common-request-headers.md).
### Cuerpo de la solicitud
Esta operación no tiene un cuerpo de la solicitud.
## Respuestas
### Sintaxis
```
HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
```
### 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
Esta operación no devuelve ningún cuerpo de respuesta.
### 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).
## Ejemplo
### Solicitud de ejemplo
En el siguiente ejemplo, se envía una solicitud `DELETE` al URI de un recurso de ID de carga multiparte.
```
1. DELETE /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE 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
```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
```
## 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)
+ [Enumeración de cargas multiparte (GET cargas-multiparte)](api-multipart-list-uploads.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)
# Finalización de una carga multiparte (POST uploadID)
## Descripción
Puede llamar a esta operación de carga multiparte para informar a Amazon Glacier (Amazon Glacier) de que se han cargado todas las partes de archivo y de que Amazon Glacier ahora puede montar el archivo a partir de las partes cargadas.
Para obtener información sobre la carga multiparte, consulte [Carga de archivos grandes por partes (carga multiparte)](uploading-archive-mpu.md).
Después de montar y guardar el archivo en el almacén, Amazon Glacier devuelve el ID de archivo del recurso de archivo creado recientemente. Tras cargar un archivo, debe guardar el ID de archivo devuelto para recuperar el archivo en otro momento.
En la solicitud, debe incluir el algoritmo hash en árbol SHA256 calculado de todo el archivo que ha cargado. Para obtener información acerca de cómo calcular un hash en árbol SHA256, consulte [Cálculo de sumas de comprobación](checksum-calculations.md). En el servidor, Amazon Glacier también construye el algoritmo hash en árbol SHA256 del archivo montado. Si los valores coinciden, Amazon Glacier guarda el archivo en el almacén; de lo contrario, devuelve un error y se produce un error en la operación. La operación [Enumeración de partes (GET uploadID)](api-multipart-list-parts.md) devuelve la lista de las partes cargadas para una carga multiparte específica. Incluye la información de suma de comprobación de cada carga parte que se puede usar para depurar un problema de suma de comprobación.
Además, Amazon Glacier también comprueba si faltan rangos de contenido. Al cargar las partes, especifique los valores de rango que identifican dónde encaja cada parte en el montaje final del archivo. Al montar el archivo final, Amazon Glacier busca si faltan rangos de contenido y, en caso de que falten, devuelve un error, por lo que no se realiza la operación de completar la carga multiparte.
La operación de completar carga multiparte es idempotente. Después de completar correctamente por primera vez la carga multiparte, si vuelve a llamar a la operación en un breve periodo, esta se realizará correctamente y devolverá el mismo ID de archivo. Esto resulta útil si tiene un problema de red o recibe un error de servidor 500, en cuyo caso puede repetir la solicitud de completar carga multiparte y obtener el mismo ID de archivo sin crear archivos duplicados. Sin embargo, tenga en cuenta que, después de que se complete la carga multiparte, no puede llamar a la operación de enumeración de partes y la carga multiparte no aparecerá en la respuesta de enumerar cargas multiparte aunque sea posible la realización idempotente.
## Solicitudes
Para completar una carga multiparte, envíe una solicitud HTTP POST al URI del ID de la carga que Amazon Glacier ha creado en respuesta a la solicitud de inicio de carga multiparte. Es el mismo URI que ha usado al cargar las partes. Además de los encabezados obligatorios comunes, debe incluir el resultado del hash en árbol SHA256 de todo el archivo y el tamaño total del archivo en bytes.
### Sintaxis
```
1. POST /AccountId/vaults/VaultName/multipart-uploads/uploadID
2. Host: glacier.Region.amazonaws.com
3. Date: date
4. Authorization: SignatureValue
5. x-amz-sha256-tree-hash: SHA256 tree hash of the archive
6. x-amz-archive-size: ArchiveSize in bytes
7. 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 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 la solicitud
Esta operación no usa parámetros de solicitud.
### Encabezados de solicitud
Esta operación utiliza los siguientes encabezados de solicitud, además de los encabezados de solicitud comunes a todas las operaciones. Para obtener más información acerca de los encabezados de solicitudes comunes, consulte [Encabezados de solicitudes comunes](api-common-request-headers.md).
| Nombre | Descripción | Obligatorio |
| --- | --- | --- |
| x-amz-archive-size | El tamaño total, en bytes, de todo el archivo. Este valor debe ser la suma de todos los tamaños de las partes individuales que ha cargado. Tipo: cadena Valor predeterminado: None Restricciones: ninguna | Sí |
| x-amz-sha256-tree-hash | El hash en árbol SHA256 de todo el archivo. Es el hash en árbol SHA256 de las partes individuales. Si el valor que especifique en la solicitud no coincide con el hash en árbol SHA256 del archivo montado final tal como lo ha calculado Amazon Glacier, este último devuelve un error y no se puede realizar la solicitud. Tipo: cadena Valor predeterminado: None Restricciones: ninguna | Sí |
### Elementos de la solicitud
Esta operación no usa los elementos de la solicitud.
## Respuestas
Amazon Glacier (Amazon Glacier) crea un hash en árbol SHA256 de todo el archivo. Si el valor coincide con el hash en árbol SHA256 de todo el archivo que ha especificado en la solicitud, Amazon Glacier agrega el archivo al almacén. En respuesta, devuelve el encabezado HTTP `Location` con la ruta URL del recurso de archivo agregado recientemente. Si el tamaño de archivo o SHA256 que ha enviado en la solicitud no coincide, Amazon Glacier devolverá un error y la carga permanece en estado incompleto. Es posible reintentar la operación de finalización de carga multiparte posteriormente con los valores correctos, en cuyo momento puede crear correctamente un archivo. Si no se completa una carga multiparte, Amazon Glacier reclamará finalmente el ID de carga.
### Sintaxis
```
HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Location: Location
x-amz-archive-id: ArchiveId
```
### Encabezados de respuesta
Una respuesta correcta incluye los siguientes encabezados de respuesta, además de los encabezados de respuesta comunes a todas las operaciones. Para obtener más información acerca de los encabezados de respuesta comunes, consulte [Encabezados de respuesta comunes](api-common-response-headers.md).
| Nombre | Descripción |
| --- | --- |
| Location | La ruta del URI relativo del archivo creado recientemente. Esta URL incluye el ID de archivo que Amazon Glacier ha generado. Tipo: cadena |
| x-amz-archive-id | El ID del archivo. Este valor también forma parte del encabezado `Location`. Tipo: cadena |
### Campos de respuesta
Esta operación no devuelve ningún cuerpo de respuesta.
## Ejemplo
### Solicitud de ejemplo
En este ejemplo, se envía una solicitud HTTP POST al URI que devolvió una solicitud de inicio de carga multiparte. La solicitud especifica el hash en árbol SHA256 de todo el archivo y el tamaño total del archivo.
```
1. POST /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. z-amz-Date: 20170210T120000Z
4. x-amz-sha256-tree-hash:1ffc0f54dd5fdd66b62da70d25edacd0
5. x-amz-archive-size:8388608
6. x-amz-glacier-version: 2012-06-01
7. 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 el siguiente ejemplo de respuesta se muestra que Amazon Glacier ha creado correctamente un archivo a partir de las partes que ha cargado. La respuesta incluye el ID de archivo con la ruta completa.
```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Location: /111122223333/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
5. x-amz-archive-id: NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
```
Ahora puede enviar solicitudes HTTP al URI del recurso/archivo creado recientemente. Por ejemplo, puede enviar una solicitud GET para recuperar el archivo.
## Secciones relacionadas
+ [Inicio de la carga multiparte (POST cargas-multiparte)](api-multipart-initiate-upload.md)
+ [Carga de partes (PUT uploadID)](api-upload-part.md)
+ [Anulación de la carga multiparte (DELETE uploadID)](api-multipart-abort-upload.md)
+ [Enumeración de cargas multiparte (GET cargas-multiparte)](api-multipart-list-uploads.md)
+ [Enumeración de partes (GET uploadID)](api-multipart-list-parts.md)
+ [Carga de archivos grandes por partes (carga multiparte)](uploading-archive-mpu.md)
+ [Eliminación de archivo (DELETE archivo)](api-archive-delete.md)
+ [Administración de identidades y accesos para Amazon Glacier](security-iam.md)
# Inicio de la carga multiparte (POST cargas-multiparte)
## Description (Descripción)
Esta operación inicia una carga multiparte (consulte [Carga de archivos grandes por partes (carga multiparte)](uploading-archive-mpu.md)). Amazon Glacier (Amazon Glacier) crea un recurso de carga multiparte y devuelve su ID en la respuesta. Puede utilizar este ID de carga en las operaciones de carga multiparte que realice posteriormente.
Cuando inicie una carga multiparte, debe especificar el tamaño de la parte en número de bytes. El tamaño de la parte debe ser de un mebibyte (MiB) (1024 kibibytes [KiB]) multiplicado por una potencia de 2; por ejemplo, 1 048 576 (1 MiB), 2 097 152 (2 MiB), 4 194 304 (4 MiB), 8 388 608 (8 MiB) y así sucesivamente. El tamaño de parte mínimo permitido es de 1 MiB y el máximo es de 4 gibibytes (GiB).
Todas las partes que cargue con este ID de carga, salvo la última, deben tener el mismo tamaño. La última puede tener el mismo tamaño o ser más pequeña. Por ejemplo, supongamos que quiere cargar un archivo de 16,2 MiB. Si inicia la carga multiparte con un tamaño de parte de 4 MiB, cargará cuatro partes de 4 MiB cada una y otra parte de 0,2 MiB.
**nota**
No es necesario conocer el tamaño del archivo al iniciar una carga multiparte, ya que Amazon Glacier no requiere que se especifique el tamaño total del archivo.
Una vez que se completa la carga multiparte, Amazon Glacier elimina el recurso de carga multiparte al que hace referencia el ID. Amazon Glacier también eliminará este recurso si cancela la carga multiparte o podría eliminarlo si no hay actividad durante un periodo de 24 horas. Es posible que el ID siguiera disponible después de 24 horas, pero no es conveniente que las aplicaciones esperen que sea así.
## Solicitudes
Para iniciar una carga multiparte, envíe una solicitud HTTP `POST` al URI del subrecurso `multipart-uploads` del almacén en el que desea guardar el archivo. La solicitud debe incluir el tamaño de la parte y, de manera opcional, una descripción del archivo.
### Sintaxis
```
1. POST /AccountId/vaults/VaultName/multipart-uploads
2. Host: glacier.us-west-2.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. x-amz-glacier-version: 2012-06-01
6. x-amz-archive-description: ArchiveDescription
7. x-amz-part-size: PartSize
```
**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
Esta operación no usa parámetros de solicitud.
### Encabezados de solicitud
Esta operación utiliza los siguientes encabezados de solicitud, además de los encabezados de solicitud comunes a todas las operaciones. Para obtener más información acerca de los encabezados de solicitudes comunes, consulte [Encabezados de solicitudes comunes](api-common-request-headers.md).
| Name | Description (Descripción) | Obligatorio |
| --- | --- | --- |
| x-amz-part-size | Tamaño en bytes de cada parte, excepto la última. La última parte puede ser más pequeña. Tipo: cadena Valor predeterminado: None Restricciones: el tamaño de la parte debe ser de un mebibyte (MiB) (1024 KiB) multiplicado por una potencia de 2; por ejemplo, 1 048 576 (1 MiB), 2 097 152 (2 MiB), 4 194 304 (4 MiB), 8 388 608 (8 MiB) y así sucesivamente. El tamaño de parte mínimo permitido es de 1 MiB y el máximo es de 4 GiB (4 096 MiB). | Sí |
| x-amz-archive-description | Descripción del archivo que está cargando por partes. Puede ser una descripción en lenguaje natural o un identificador único que decida asignar. Cuando recupere un inventario de almacén (consulte [Inicialización de trabajos (POST trabajos)](api-initiate-job-post.md) ), el inventario incluirá esta descripción en cada uno de los archivos que devuelva la respuesta. Los espacios iniciales de las descripciones de archivo se quitan. Tipo: cadena Valor predeterminado: None Restricciones: la descripción debe tener 1024 bytes o menos. Los caracteres permitidos son caracteres ASCII de 7 bits sin códigos de control; en particular, valores ASCII de 32 a 126 en decimal o de 0x20 a 0x7E en hexadecimal. | No |
### Cuerpo de la solicitud
Esta operación no tiene un cuerpo de la solicitud.
## Respuestas
En la respuesta, Amazon Glacier crea un recurso de carga multiparte identificado por un ID y devuelve la ruta de URI relativa del ID de carga multiparte.
### Sintaxis
```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: x-amzn-RequestId
3. Date: Date
4. Location: Location
5. x-amz-multipart-upload-id: multiPartUploadId
```
### Encabezados de respuesta
Una respuesta correcta incluye los siguientes encabezados de respuesta, además de los encabezados de respuesta comunes a todas las operaciones. Para obtener más información acerca de los encabezados de respuesta comunes, consulte [Encabezados de respuesta comunes](api-common-response-headers.md).
| Name | Description (Descripción) |
| --- | --- |
| Location | Ruta de URI relativa del ID de carga multiparte creado por Amazon Glacier. Puede utilizar esta ruta de URI para establecer el ámbito de las solicitudes cuyas partes se van a cargar y para completar la carga multiparte. Tipo: cadena |
| x-amz-multipart-upload-id | ID de la carga multiparte. Este valor también forma parte del encabezado `Location`. Tipo: cadena |
### Cuerpo de respuesta
Esta operación no devuelve ningún cuerpo de respuesta.
### 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).
## Ejemplo
### Solicitud de ejemplo
En el siguiente ejemplo, se inicia una carga multiparte enviando una solicitud HTTP `POST` al URI del subrecurso `multipart-uploads` de un almacén llamado `examplevault`. La solicitud incluye encabezados para especificar un tamaño de parte de 4 MiB (4 194 304 bytes) y la descripción opcional del archivo.
```
1. POST /-/vaults/examplevault/multipart-uploads
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-archive-description: MyArchive-101
5. x-amz-part-size: 4194304
6. x-amz-glacier-version: 2012-06-01
7. 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
Amazon Glacier crea un recurso de carga multiparte y lo agrega al subrecurso `multipart-uploads` del almacén. El encabezado `Location` de la respuesta contiene la ruta de URI relativa al ID de carga multiparte.
```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Location: /111122223333/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE
5. x-amz-multipart-upload-id: OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE
```
Para obtener más información sobre la carga de partes individuales, consulte [Carga de partes (PUT uploadID)](api-upload-part.md).
## Secciones relacionadas
+ [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 cargas multiparte (GET cargas-multiparte)](api-multipart-list-uploads.md)
+ [Enumeración de partes (GET uploadID)](api-multipart-list-parts.md)
+ [Eliminación de archivo (DELETE archivo)](api-archive-delete.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)
# Enumeración de partes (GET uploadID)
## Description (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)](uploading-archive-mpu.md).
Puede realizar esta solicitud en cualquier momento durante una carga multiparte en curso antes de completar la carga multiparte. Amazon Glacier devuelve la lista de partes ordenada por 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 Glacier (Amazon 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 Amazon 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)](api-multipart-initiate-upload.md)). Si lo desea, también puede especificar los parámetros `marker` y `limit`.
```
1. GET /AccountId/vaults/VaultName/multipart-uploads/uploadID 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 | 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: 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 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: 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. "ArchiveDescription" : String,
9. "CreationDate" : String,
10. "Marker": String,
11. "MultipartUploadId" : String,
12. "PartSizeInBytes" : Number,
13. "Parts" :
14. [ {
15. "RangeInBytes" : String,
16. "SHA256TreeHash" : String
17. },
18. ...
19. ],
20. "VaultARN" : String
21. }
```
### 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 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**
El valor hash del SHA256 árbol que Amazon Glacier calculó para la pieza. 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 Glacier, consulte [Respuestas de error](api-error-responses.md).
## 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
```
1. GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE 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 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.
```
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: 412
6.
7. {
8. "ArchiveDescription" : "archive description",
9. "CreationDate" : "2012-03-20T17:03:43.221Z",
10. "Marker": null,
11. "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE",
12. "PartSizeInBytes" : 4194304,
13. "Parts" :
14. [ {
15. "RangeInBytes" : "0-4194303",
16. "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4"
17. },
18. {
19. "RangeInBytes" : "4194304-8388607",
20. "SHA256TreeHash" : "0195875365afda349fc21c84c099987164"
21. }],
22. "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault"
23. }
```
### 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
```
1. GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE?marker=1001&limit=1 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 las partes cargadas que están asociadas con el ID de carga multiparte en curso especificado.
```
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: text/json
5. Content-Length: 412
6.
7. {
8. "ArchiveDescription" : "archive description 1",
9. "CreationDate" : "2012-03-20T17:03:43.221Z",
10. "Marker": "MfgsKHVjbQ6EldVl72bn3_n5h2TaGZQUO-Qb3B9j3TITf7WajQ",
11. "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE",
12. "PartSizeInBytes" : 4194304,
13. "Parts" :
14. [ {
15. "RangeInBytes" : "4194304-8388607",
16. "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4"
17. }],
18. "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault"
19. }
```
## 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 cargas multiparte (GET cargas-multiparte)](api-multipart-list-uploads.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)
# 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)
# Carga de partes (PUT uploadID)
## Descripción
Esta operación de carga multiparte carga una parte de un archivo. Las partes de un archivo se pueden cargar en cualquier orden, ya que, en la solicitud Upload Part, se especifica el intervalo de bytes del archivo montado que se va a cargar en esa parte. Las partes también pueden cargarse en paralelo. En una carga multiparte, se pueden cargar hasta 10 000 partes.
Para obtener información sobre la carga multiparte, consulte [Carga de archivos grandes por partes (carga multiparte)](uploading-archive-mpu.md).
Amazon Glacier (Amazon Glacier) rechaza la solicitud de carga de la parte si se cumple alguna de las siguientes condiciones:
+ **El hash en árbol SHA256 no coincide:** para garantizar que los datos de la parte no se dañan durante la transmisión, calcule un hash en árbol SHA256 de la parte e inclúyalo en la solicitud. Cuando reciba los datos, Amazon Glacier calculará también un hash en árbol SHA256. Si los dos valores hash no coinciden, se producirá un error en la operación. Para obtener información acerca de cómo calcular un hash en árbol SHA256, consulte [Cálculo de sumas de comprobación](checksum-calculations.md).
+ **El hash lineal SHA256 no coincide:** como es un requisito para la autorización, debe calcular un hash lineal SHA256 de toda la carga e incluirlo en la solicitud. Para obtener más información acerca de cómo calcular un hash lineal SHA256, consulte [Cálculo de sumas de comprobación](checksum-calculations.md).
+ **El tamaño de la parte no coincide:** el tamaño de cada una de las partes excepto de la última debe coincidir con el tamaño especificado en la solicitud [Inicio de la carga multiparte (POST cargas-multiparte)](api-multipart-initiate-upload.md) correspondiente. El tamaño de la última parte debe ser igual o menor que el tamaño especificado.
**nota**
Si carga una parte cuyo tamaño es menor que el tamaño especificado en la solicitud Initiate Multipart Upload y esa parte no es la última, la solicitud Upload Part se ejecutará correctamente. Sin embargo, se producirá un error en la solicitud Complete Multipart Upload siguiente.
+ **El intervalo no está alineado:** el valor del intervalo de bytes de la solicitud no coincide con el tamaño de parte especificado en la solicitud de inicio correspondiente. Por ejemplo, si especifica un tamaño de parte de 4 194 304 bytes (4 MB), entonces los intervalos de 0 a 4 194 303 bytes (4 MB - 1) y de 4 194 304 (4 MB) a 8 388 607 (8 MB - 1) son intervalos de partes válidos. Sin embargo, si establece un valor de intervalo de 2 MB a 6 MB, el intervalo no estará alineado con el tamaño de la parte y la carga no se realizará correctamente.
Esta operación es idempotente. Si carga la misma parte varias veces, los datos incluidos en la solicitud más reciente sobrescribirán los datos cargados anteriormente.
## Solicitudes
Puede enviar esta solicitud HTTP `PUT` al URI del ID de carga que devolvió la solicitud Initiate Multipart Upload. Amazon Glacier utiliza el ID de carga para asociar la carga por partes con una carga multiparte específica. La solicitud debe incluir un hash en árbol SHA256 de los datos de las partes (encabezado `x-amz-SHA256-tree-hash`), un hash lineal SHA256 de toda la carga (encabezado `x-amz-content-sha256`), el intervalo de bytes (encabezado `Content-Range`) y la longitud de la parte en bytes (encabezado `Content-Length`).
### Sintaxis
```
1. PUT /AccountId/vaults/VaultName/multipart-uploads/uploadID HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. Content-Range: ContentRange
6. Content-Length: PayloadSize
7. Content-Type: application/octet-stream
8. x-amz-sha256-tree-hash: Checksum of the part
9. x-amz-content-sha256: Checksum of the entire payload
10. 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 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 la solicitud
Esta operación no usa parámetros de solicitud.
### Encabezados de solicitud
Esta operación utiliza los siguientes encabezados de solicitud, además de los encabezados de solicitud comunes a todas las operaciones. Para obtener más información acerca de los encabezados de solicitudes comunes, consulte [Encabezados de solicitudes comunes](api-common-request-headers.md).
| Nombre | Descripción | Obligatorio |
| --- | --- | --- |
| Content-Length | Identifica la longitud de la parte en bytes. Tipo: cadena Valor predeterminado: None Restricciones: ninguna | No |
| Content-Range | Identifica el intervalo de bytes del archivo montado que se va a cargar en esta parte. Amazon Glacier utiliza esta información para montar el archivo en el orden correcto. El formato de este encabezado sigue la especificación [RFC 2616](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.16). Un encabezado de ejemplo podría ser `Content-Range:bytes 0-4194303/*`. Tipo: cadena Valor predeterminado: None Restricciones: el intervalo no puede ser mayor que el tamaño de parte que especificó al iniciar la carga multiparte. | Sí |
| x-amz-content-sha256 | Suma de comprobación SHA256 (hash lineal) de los datos cargados. No es el mismo valor que se especifica en el encabezado `x-amz-sha256-tree-hash`. Tipo: cadena Valor predeterminado: None Restricciones: ninguna | Sí |
| x-amz-sha256-tree-hash | Especifica un hash en árbol SHA256 de los datos que se están cargando. Para obtener información acerca de cómo calcular un hash en árbol SHA256, consulte [Cálculo de sumas de comprobación](checksum-calculations.md). Tipo: cadena Valor predeterminado: None Restricciones: ninguna | Sí |
### Cuerpo de la solicitud
El cuerpo de la solicitud contiene los datos que se van a cargar.
## Respuestas
Una vez que la carga de partes se ha realizado correctamente, Amazon Glacier devuelve una respuesta `204 No Content`.
### Sintaxis
```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: x-amzn-RequestId
3. Date: Date
4. x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier
```
### Encabezados de respuesta
Una respuesta correcta incluye los siguientes encabezados de respuesta, además de los encabezados de respuesta comunes a todas las operaciones. Para obtener más información acerca de los encabezados de respuesta comunes, consulte [Encabezados de respuesta comunes](api-common-response-headers.md).
| Nombre | Descripción |
| --- | --- |
| x-amz-sha256-tree-hash | Hash en árbol SHA256 que Amazon Glacier calculó para la parte cargada. Tipo: cadena |
### Cuerpo de respuesta
Esta operación no devuelve ningún cuerpo de respuesta.
## Ejemplo
La siguiente solicitud carga una parte de 4 MB. La solicitud define el intervalo de bytes que se va a convertir en la primera parte del archivo.
### Solicitud de ejemplo
El ejemplo envía una solicitud HTTP `PUT` para cargar una parte de 4 MB. La solicitud se envía al URI del ID de carga que devolvió la solicitud Initiate Multipart Upload. El encabezado `Content-Range` identifica la parte como los primeros 4 MB de datos del archivo.
```
1. PUT /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Content-Range:bytes 0-4194303/*
5. x-amz-sha256-tree-hash:c06f7cd4baacb087002a99a5f48bf953
6. x-amz-content-sha256:726e392cb4d09924dbad1cc0ba3b00c3643d03d14cb4b823e2f041cff612a628
7. Content-Length: 4194304
8. Authorization: Authorization=AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-content-sha256;x-amz-date;x-amz-glacier-version,Signature=16b9a9e220a37e32f2e7be196b4ebb87120ca7974038210199ac5982e792cace
```
Para cargar la parte siguiente, el procedimiento es el mismo; sin embargo, debe calcular un nuevo hash en árbol SHA256 de la parte que está cargando y especificar además un intervalo de bytes para indicar en qué lugar del conjunto final irá dicha parte. La siguiente solicitud carga otra parte con el mismo ID de carga. La solicitud especifica los siguientes 4 MB del archivo tras la solicitud anterior y un tamaño de parte de 4 MB.
```
1. PUT /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Content-Range:bytes 4194304-8388607/*
5. Content-Length: 4194304
6. x-amz-sha256-tree-hash:f10e02544d651e2c3ce90a4307427493
7. x-amz-content-sha256:726e392cb4d09924dbad1cc0ba3b00c3643d03d14cb4b823e2f041cff612a628
8. x-amz-glacier-version: 2012-06-01
9. Authorization: Authorization=AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20120525/us-west-2/glacier/aws4_request, SignedHeaders=host;x-amz-content-sha256;x-amz-date;x-amz-glacier-version, Signature=16b9a9e220a37e32f2e7be196b4ebb87120ca7974038210199ac5982e792cace
```
Las partes se pueden cargar en cualquier orden. Amazon Glacier utiliza la especificación del intervalo de cada parte para determinar el orden en que deben montarse.
### Respuesta de ejemplo
```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. x-amz-sha256-tree-hash: c06f7cd4baacb087002a99a5f48bf953
4. Date: Wed, 10 Feb 2017 12:00:00 GMT
```
## Secciones relacionadas
+ [Inicio de la carga multiparte (POST cargas-multiparte)](api-multipart-initiate-upload.md)
+ [Carga de partes (PUT uploadID)](#api-upload-part)
+ [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 cargas multiparte (GET cargas-multiparte)](api-multipart-list-uploads.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)