**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. # Obtención de la salida del trabajo (GET output) ## Description (Descripción) Esta operación descarga la salida del trabajo que ha iniciado con [Inicialización de trabajos (POST trabajos)](api-initiate-job-post.md). En función del tipo de trabajo que haya especificado al iniciar el trabajo, la salida será el contenido de un archivo o un inventario de almacén. Puede descargar toda la salida de trabajo o descargar una parte de la salida especificando un rango de bytes. En los trabajos de recuperación de inventario y archivo, debe verificar el tamaño descargado con el tamaño devuelto en los encabezados de la respuesta **Get Job Output**. En el caso de los trabajos de recuperación de archivo, también debe verificar que el tamaño sea el previsto. Si descarga una parte de la salida, el tamaño esperado se basa en el rango de bytes especificado. Por ejemplo, si especifica un rango de `bytes=0-1048575`, debe verificar que el tamaño de descarga sea de 1.048.576 bytes. Si descarga un archivo completo, el tamaño previsto es el del archivo cuando lo cargó en Amazon Glacier (Amazon Glacier). El tamaño esperado también se devuelve en los encabezados de la respuesta **Get Job Output (Obtener salida de trabajo)**. En el caso de un trabajo de recuperación de archivo, según el rango de bytes que especifique, Amazon Glacier devuelve la suma de comprobación correspondiente a la parte de los datos. Para asegurarse de que la parte que ha descargado es la correcta, calcule la suma de comprobación en el cliente, verifique que coinciden los valores y compruebe que el tamaño es el esperado. El ID de trabajo se mantiene en vigor al menos 24 horas después de que Amazon Glacier finalice el trabajo. Es decir, puede descargar la salida de trabajo durante el periodo de 24 horas después de que Amazon Glacier finalice el trabajo. ## Solicitudes ### Sintaxis Para recuperar una salida de trabajo, envíe la solicitud HTTP `GET` al URI de `output` del trabajo específico. ``` 1. GET /AccountId/vaults/VaultName/jobs/JobID/output HTTP/1.1 2. Host: glacier.Region.amazonaws.com 3. Date: Date 4. Authorization: SignatureValue 5. Range: ByteRangeToRetrieve 6. 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 solo `-` '' (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 | | --- | --- | --- | | Range | El rango de bytes que se recuperará de la salida. Por ejemplo, si desea descargar los primeros 1.048.576 bytes, especifique el rango como `bytes=0-1048575`. Para obtener más información, consulte [Definición de los campos de encabezado de rango](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35). El rango es relativo a cualquier otro especificado en la solicitud de inicio de trabajo. De forma predeterminada, esta operación descarga toda la salida. Si la salida del trabajo es grande, puede utilizar el encabezado de la solicitud `Range` para recuperar una parte de la salida. Esto le permite descargar toda la salida en fragmentos de bytes más pequeños. Por ejemplo, suponga que tiene 1 GB de salida de trabajo que desea descargar y decide descargar fragmentos de datos de 128 MB simultáneamente, un total de ocho solicitudes de obtener la salida de trabajo. Utilizará el siguiente proceso para descargar la salida de trabajo: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/amazonglacier/latest/dev/api-job-output-get.html) Tipo: cadena Valor predeterminado: None Restricciones: ninguna | No | ### Cuerpo de la solicitud Esta operación no tiene un cuerpo de la solicitud. ## Respuestas ### Sintaxis En el caso de una solicitud de recuperación que devuelve todos los datos del trabajo, la respuesta de la salida del trabajo devuelve un código de respuesta `200 OK`. Cuando se solicita el contenido parcial, por ejemplo, si ha especificado el encabezado `Range` en la solicitud, se devuelve el código de respuesta `206 Partial Content`. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: x-amzn-RequestId 3. Date: Date 4. Content-Type: ContentType 5. Content-Length: Length 6. x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier 7. 8. [Body containing job output.] ``` ### Encabezados de respuesta | Encabezado | Description (Descripción) | | --- | --- | | Content-Range | El rango de bytes que devuelve Amazon Glacier. Si solo se ha descargado la salida parcial, la respuesta proporciona el rango de bytes que ha devuelto Amazon Glacier. Por ejemplo, `bytes 0-1048575/8388608` devuelve el primer 1 MB de 8 MB. Para obtener más información sobre el encabezado `Content-Range`, consulte [Definición de campos del encabezado Content-Range (Contenido-Rango)](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.16). Tipo: cadena | | Content-Type | Content-Type depende de si la salida del trabajo es un archivo o un inventario de almacén. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/amazonglacier/latest/dev/api-job-output-get.html) Tipo: cadena | | x-amz-sha256-tree-hash​ | La suma de comprobación de los datos de la respuesta. Este encabezado solo se devuelve al recuperar la salida de un trabajo de recuperación de archivo. Además, este encabezado aparece cuando el rango de datos recuperados solicitados en la solicitud de inicio de trabajo está alineado con el hash en árbol y el rango para descarga en la solicitud de obtención de salida de trabajo también está alineado con el hash en árbol. Para obtener más información sobre los intervalos alineados con un algoritmo hasta en árbol, consulte [Recuperación de sumas de comprobación al descargar datos](checksum-calculations-range.md). Por ejemplo, si en su solicitud de inicio de trabajo ha especificado un rango alineado con el hash en árbol para recuperarlo (lo que incluye todo el archivo), recibirá la suma de comprobación de los datos que descargue con las condiciones siguientes: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/amazonglacier/latest/dev/api-job-output-get.html) Tipo: cadena | ### Cuerpo de respuesta Amazon Glacier devuelve la salida del trabajo en el cuerpo de la respuesta. Según el tipo de trabajo, la salida puede ser el contenido del archivo o el inventario de almacén. En el caso de un inventario de almacén, de forma predeterminada, se devuelve la lista de inventarios como el siguiente cuerpo JSON. ``` 1. { 2. "VaultARN": String, 3. "InventoryDate": String, 4. "ArchiveList": [ 5. {"ArchiveId": String, 6. "ArchiveDescription": String, 7. "CreationDate": String, 8. "Size": Number, 9. "SHA256TreeHash": String 10. }, 11. ... 12. ] 13. } ``` Si ha solicitado el formato de salida de valores separados por comas (CSV) al iniciar el trabajo de inventario de almacén, el inventario de almacén se devuelve en formato CSV en el cuerpo. El formato CSV tiene cinco columnas "ArchiveId«," ArchiveDescription «, CreationDate «Tamaño» y "SHA256TreeHash" con las mismas definiciones que los campos JSON correspondientes. **nota** En el formato CSV devuelto, los campos se pueden devolver con el campo completo entre comillas. Los campos que contienen una coma o comillas siempre se devuelven entre comillas. Por ejemplo, `my archive description,1` se devuelve como `"my archive description,1"`. Los caracteres de comillas que están en los campos devueltos entre comillas se *escapan* anteponiéndoles un carácter de barra oblicua inversa. Por ejemplo, `my archive description,1"2` se devuelve como `"my archive description,1\"2"` y `my archive description,1\"2` se devuelve como `"my archive description,1\\"2"`. El carácter de barra oblicua inversa no está escapado. El cuerpo de la respuesta JSON contiene los siguientes campos JSON. **ArchiveDescription** La descripción de un archivo. *Tipo:* cadena **ArchiveId** El ID de un archivo. *Tipo:* cadena **ArchiveList** Una matriz de metadatos de archivo. Cada objeto de la matriz representa los metadatos de un archivo incluido en el almacén. *Tipo*: Array **CreationDate** La fecha y hora UTC en que se creó el archivo. *Tipo*: una representación de cadena con el formato de fecha ISO 8601; por ejemplo, `2013-03-20T17:03:43.221Z`. **InventoryDate** La fecha y la hora UTC del último inventario del almacén que se completó después de los cambios en el almacén. Aunque Amazon Glacier prepara un inventario de almacén una vez al día, la fecha de inventario solo se actualiza si ha habido adiciones o eliminaciones de archivo en el almacén desde el último inventario. *Tipo*: una representación de cadena con el formato de fecha ISO 8601; por ejemplo, `2013-03-20T17:03:43.221Z`. **SHA256TreeHash** El hash en árbol del archivo. *Tipo:* cadena **Size (Tamaño)** El tamaño en bytes del archivo. *Tipo*: Número **VaultARN** El recurso del nombre de recurso de Amazon (ARN) para el que se solicitó la recuperación del 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 En el ejemplo siguiente, se muestra una solicitud de un trabajo que recupera un archivo. ### Ejemplo 1: Descargar la salida Este ejemplo recupera los datos preparados por Amazon Glacier en respuesta a su solicitud de inicio del trabajo de recuperación de archivo. #### Solicitud de ejemplo ``` 1. GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID/output 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 A continuación, se muestra una respuesta de ejemplo de un trabajo de recuperación de archivo. Tenga en cuenta que el encabezado `Content-Type` es `application/octet-stream` y que el encabezado `x-amz-sha256-tree-hash` se incluye en la respuesta, lo que significa que se devuelven todos los datos de trabajo. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60 4. Date: Wed, 10 Feb 2017 12:00:00 GMT 5. Content-Type: application/octet-stream 6. Content-Length: 1048576 7. 8. [Archive data.] ``` A continuación, se muestra una respuesta de ejemplo de un trabajo de recuperación de inventario. Observe que el encabezado `Content-Type` es `application/json`. Además, tenga en cuenta que la respuesta no incluye el encabezado `x-amz-sha256-tree-hash`. ``` 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: 906 6. 7. { 8. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault", 9. "InventoryDate": "2011-12-12T14:19:01Z", 10. "ArchiveList": [ 11. { 12. "ArchiveId": "DMTmICA2n5Tdqq5BV2z7og-A20xnpAPKt3UXwWxdWsn_D6auTUrW6kwy5Qyj9xd1MCE1mBYvMQ63LWaT8yTMzMaCxB_9VBWrW4Jw4zsvg5kehAPDVKcppUD1X7b24JukOr4mMAq-oA", 13. "ArchiveDescription": "my archive1", 14. "CreationDate": "2012-05-15T17:19:46.700Z", 15. "Size": 2140123, 16. "SHA256TreeHash": "6b9d4cf8697bd3af6aa1b590a0b27b337da5b18988dbcc619a3e608a554a1e62" 17. }, 18. { 19. "ArchiveId": "2lHzwhKhgF2JHyvCS-ZRuF08IQLuyB4265Hs3AXj9MoAIhz7tbXAvcFeHusgU_hViO1WeCBe0N5lsYYHRyZ7rrmRkNRuYrXUs_sjl2K8ume_7mKO_0i7C-uHE1oHqaW9d37pabXrSA", 20. "ArchiveDescription": "my archive2", 21. "CreationDate": "2012-05-15T17:21:39.339Z", 22. "Size": 2140123, 23. "SHA256TreeHash": "7f2fe580edb35154041fa3d4b41dd6d3adaef0c85d2ff6309f1d4b520eeecda3" 24. } 25. ] 26. } ``` ### Ejemplo 2: Descargar solo la salida parcial Este ejemplo recupera solo una parte del archivo preparado por Amazon Glacier en respuesta a su solicitud de inicio del trabajo de recuperación de archivo. La solicitud utiliza el encabezado `Range` opcional para recuperar solo los primeros 1024 bytes. #### Solicitud de ejemplo ``` 1. GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID/output HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. Range: bytes=0-1023 5. x-amz-glacier-version: 2012-06-01 6. 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 La siguiente respuesta correcta muestra la respuesta `206 Partial Content`. En este caso, la respuesta también incluye un encabezado `Content-Range` que especifica el rango de bytes que devuelve Amazon Glacier. ``` 1. HTTP/1.1 206 Partial Content 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Content-Range: bytes 0-1023/8388608 5. Content-Type: application/octet-stream 6. Content-Length: 1024 7. 8. [Archive data.] ``` ## Secciones relacionadas + [Descripción del trabajo (GET JobID)](api-describe-job-get.md) + [Inicialización de trabajos (POST trabajos)](api-initiate-job-post.md) + [Administración de identidades y accesos para Amazon Glacier](security-iam.md)