**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.
# Descripción del trabajo (GET JobID)
## Description (Descripción)
Esta operación devuelve información sobre un trabajo que se inició previamente, incluidos la fecha de inicio, el usuario que lo inició, el mensaje o código de estado del trabajo y el tema de Amazon Simple Notification Service (Amazon SNS) que se va a utilizar con las notificaciones una vez que Amazon Glacier (Amazon Glacier) complete el trabajo. Para obtener más información acerca de cómo iniciar un trabajo, consulte [Inicialización de trabajos (POST trabajos)](api-initiate-job-post.md).
**nota**
Esta operación le permite comprobar el estado del trabajo. Sin embargo, le recomendamos encarecidamente que configure un tema de Amazon SNS y lo especifique en la solicitud de inicio de trabajo para que Amazon Glacier pueda enviar una notificación al tema cuando se complete el trabajo.
El ID de trabajo se mantendrá en vigor al menos 24 horas después de que Amazon Glacier haya finalizado el trabajo.
## Solicitudes
### Sintaxis
Para obtener información acerca de un trabajo, utilice el método HTTP `GET` y delimite él ámbito de la solicitud a ese trabajo específico. Tenga en cuenta que la ruta relativa del URI es la misma que Amazon Glacier devolvió cuando se inició el trabajo.
```
1. GET /AccountID/vaults/VaultName/jobs/JobID 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.
**nota**
En la solicitud, si se omite `JobID`, la respuesta devuelve una lista de todos los trabajos que están activos en el almacén especificado. Para obtener más información sobre las listas de trabajos, consulte [Mostrar trabajos (GET trabajos)](api-jobs-get.md).
### 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 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: Length
{
"Action": "string",
"ArchiveId": "string",
"ArchiveSHA256TreeHash": "string",
"ArchiveSizeInBytes": number,
"Completed": boolean,
"CompletionDate": "string",
"CreationDate": "string",
"InventoryRetrievalParameters": {
"EndDate": "string",
"Format": "string",
"Limit": "string",
"Marker": "string",
"StartDate": "string"
},
"InventorySizeInBytes": number,
"JobDescription": "string",
"JobId": "string",
"JobOutputPath": "string",
"OutputLocation": {
"S3": {
"AccessControlList": [
{
"Grantee": {
"DisplayName": "string",
"EmailAddress": "string",
"ID": "string",
"Type": "string",
"URI": "string"
},
"Permission": "string"
}
],
"BucketName": "string",
"CannedACL": "string",
"Encryption": {
"EncryptionType": "string",
"KMSContext": "string",
"KMSKeyId": "string"
},
"Prefix": "string",
"StorageClass": "string",
"Tagging": {
"string": "string"
},
"UserMetadata": {
"string": "string"
}
}
},
"RetrievalByteRange": "string",
"SelectParameters": {
"Expression": "string",
"ExpressionType": "string",
"InputSerialization": {
"csv": {
"Comments": "string",
"FieldDelimiter": "string",
"FileHeaderInfo": "string",
"QuoteCharacter": "string",
"QuoteEscapeCharacter": "string",
"RecordDelimiter": "string"
}
},
"OutputSerialization": {
"csv": {
"FieldDelimiter": "string",
"QuoteCharacter": "string",
"QuoteEscapeCharacter": "string",
"QuoteFields": "string",
"RecordDelimiter": "string"
}
}
},
"SHA256TreeHash": "string",
"SNSTopic": "string",
"StatusCode": "string",
"StatusMessage": "string",
"Tier": "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](api-common-response-headers.md).
### Cuerpo de respuesta
El cuerpo de la respuesta contiene los siguientes campos JSON.
**Action**
Tipo de trabajo. Es `ArchiveRetrieval`, `InventoryRetrieval` o `Select`.
*Tipo:* cadena
**ArchiveId**
ID del archivo solicitado para un trabajo de selección o recuperación de archivo. De lo contrario, este campo es `null`.
*Tipo:* cadena
**Archive (Archivado)SHA256TreeHash**
El hash de SHA256 árbol de todo el archivo para un trabajo de recuperación de archivos. En el caso de los trabajos de recuperación de inventario, este campo es `null`.
*Tipo:* cadena
**ArchiveSizeInBytes**
Si es un trabajo `ArchiveRetrieval`, es el tamaño en bytes del archivo que se está solicitando para descargarlo. Si se trata de un trabajo de tipo `InventoryRetrieval`, el valor es `null`.
*Tipo*: Número
**Completed**
Estado del trabajo. Cuando un trabajo de recuperación de archivo o inventario se completa, la salida del trabajo puede obtenerse utilizando [Obtención de la salida del trabajo (GET output)](api-job-output-get.md).
*Tipo*: Booleano
**CompletionDate**
Hora en formato UTC (Hora Universal Coordinada) en la que se completó la solicitud. Mientras el trabajo está en curso, el valor es null.
*Tipo:* cadena
**CreationDate**
Hora en formato UTC en la que se creó el trabajo.
*Tipo*: una representación de cadena con el formato de fecha ISO 8601, por ejemplo, `2013-03-20T17:03:43.221Z`.
**InventoryRetrievalParameters**
Parámetros de entrada que se utilizan en una recuperación de inventario por intervalos.
*Tipo*: [InventoryRetrievalJobInput](api-InventoryRetrievalJobInput.md) objeto
**InventorySizeInBytes**
Si es un trabajo `InventoryRetrieval`, es el tamaño en bytes del inventario que se está solicitando para descargarlo. En el caso de los trabajos `ArchiveRetrieval` o `Select`, el valor es `null`.
*Tipo*: Número
**JobDescription**
Descripción del trabajo que se proporcionó cuando se inició el trabajo.
*Tipo:* cadena
**JobId**
ID que identifica el trabajo en Amazon Glacier.
*Tipo:* cadena
**JobOutputPath**
Contiene la ubicación de salida del trabajo.
*Tipo:* cadena
**OutputLocation**
Objeto que contiene información sobre la ubicación en la que se guardan los resultados y errores del trabajo de selección.
*Tipo*: [OutputLocation](api-OutputLocation.md) objeto
**RetrievalByteRange**
El rango de bytes recuperado para los trabajos de recuperación de archivos tiene el formato "*StartByteValue*-*EndByteValue*». Si no especifica ningún rango en la recuperación del archivo, se recupera todo el archivo; también es *StartByteValue*igual a 0 y es *EndByteValue*igual al tamaño del archivo menos 1. En el caso de los trabajos de selección o recuperación de inventario, este campo es `null`.
*Tipo:* cadena
**SelectParameters**
Objeto que contiene información sobre los parámetros que se utilizan en una selección.
*Tipo*: [SelectParameters](api-SelectParameters.md) objeto
**SHA256TreeHash**
El valor hash del SHA256 árbol para el rango solicitado de un archivo. Si en la solicitud [Inicialización de trabajos (POST trabajos)](api-initiate-job-post.md) del archivo se especificó un intervalo alineado con un algoritmo hash en árbol, este campo devuelve un valor. Para obtener más información sobre la alineación con algoritmos hash en árbol para recuperaciones de archivos por intervalos, consulte [Recuperación de sumas de comprobación al descargar datos](checksum-calculations-range.md).
En el caso puntual en que se recupere todo el archivo, este valor será igual que el valor de `ArchiveSHA256TreeHash`.
Este campo es `null` en los casos siguientes:
+ En los trabajos de recuperación de archivos que especifican un intervalo que no está alineado con un algoritmo hash en árbol.
+ En los trabajos de archivo que especifican un intervalo que es igual al archivo completo y cuyo estado de trabajo es `InProgress`.
+ En los trabajos de inventario.
+ En los trabajos de selección.
*Tipo:* cadena
**SNSTopic**
Tema de Amazon SNS que recibe la notificación.
*Tipo:* cadena
**StatusCode**
Código que indica el estado del trabajo.
*Valores válidos*: `InProgress` \$1 `Succeeded` \$1 `Failed`
*Tipo:* cadena
**StatusMessage**
Mensaje en el que se describe el estado del trabajo.
*Tipo:* cadena
**datos y búsqueda**
Nivel de acceso a los datos que se va a utilizar en la selección o recuperación de archivo.
*Valores válidos*: `Bulk` \$1 `Expedited` \$1 `Standard`
*Tipo:* cadena
**VaultARN**
Nombre de recurso de Amazon (ARN) del almacén del que el trabajo es un subrecurso.
*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.
### Solicitud de ejemplo: obtención de la descripción de un trabajo
```
1. GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 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
El cuerpo de la respuesta contiene código JSON donde se describe el trabajo especificado. Tenga en cuenta que los campos JSON son iguales en los trabajos de recuperación de inventario y en los trabajos de recuperación de archivo. Sin embargo, cuando un campo no es aplicable al tipo de trabajo, su valor es `null`. A continuación, se muestra una respuesta de ejemplo de un trabajo de recuperación de archivo. Tenga en cuenta lo siguiente:
+ El valor del campo `Action` es `ArchiveRetrieval`.
+ El campo `ArchiveSizeInBytes` indica el tamaño del archivo solicitado en el trabajo de recuperación de archivo.
+ El `ArchiveSHA256TreeHash` campo muestra el hash de SHA256 árbol de todo el archivo.
+ El campo `RetrievalByteRange` indica el intervalo solicitado en la solicitud Initiate Job. En este ejemplo, se solicita todo el archivo.
+ El `SHA256TreeHash` campo muestra el hash del SHA256 árbol para el rango solicitado en la solicitud Initiate Job. En este ejemplo, es igual que el campo `ArchiveSHA256TreeHash`, lo que significa que se ha solicitado todo el archivo.
+ El valor del campo `InventorySizeInBytes` es `null`, ya que no es aplicable a los trabajos de recuperación de archivos.
```
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: 419
6. {
7. "Action": "ArchiveRetrieval",
8. "ArchiveId": "NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId",
9. "ArchiveSizeInBytes": 16777216,
10. "ArchiveSHA256TreeHash": "beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60",
11. "Completed": false,
12. "CompletionDate": null,
13. "CreationDate": "2012-05-15T17:21:39.339Z",
14. "InventorySizeInBytes": null,
15. "JobDescription": "My ArchiveRetrieval Job",
16. "JobId": "HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID",
17. "RetrievalByteRange": "0-16777215",
18. "SHA256TreeHash": "beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60",
19. "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic",
20. "StatusCode": "InProgress",
21. "StatusMessage": "Operation in progress.",
22. "Tier": "Bulk",
23. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
24. }
```
A continuación, se muestra una respuesta de ejemplo de un trabajo de recuperación de inventario. Tenga en cuenta lo siguiente:
+ El valor del campo `Action` es `InventoryRetrieval`.
+ Los valores de los campos `ArchiveSizeInBytes`, `ArchiveSHA256TreeHash` y `RetrievalByteRange` son null porque estos campos no son aplicables a los trabajos de recuperación de inventario.
+ El valor del campo `InventorySizeInBytes` es `null` porque el trabajo sigue en curso y el inventario no está completamente preparado para su descarga. Si el trabajo se completó antes de la solicitud Describe Job, este campo indicará el tamaño de la salida.
```
{
"Action": "InventoryRetrieval",
"ArchiveId": null,
"ArchiveSizeInBytes": null,
"ArchiveSHA256TreeHash": null,
"Completed": false,
"CompletionDate": null,
"CreationDate": "2012-05-15T23:18:13.224Z",
"InventorySizeInBytes": null,
"JobDescription": "Inventory Description",
"JobId": "HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID",
"RetrievalByteRange": null,
"SHA256TreeHash": null,
"SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic",
"StatusCode": "InProgress",
"StatusMessage": "Operation in progress.",
"VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
}
```
A continuación, se muestra una respuesta de ejemplo de un trabajo de recuperación de inventario completado que contiene un marcador. Este marcador se utiliza para continuar la paginación de la recuperación del inventario del almacén.
```
{
"Action": "InventoryRetrieval",
"ArchiveId": null,
"ArchiveSHA256TreeHash": null,
"ArchiveSizeInBytes": null,
"Completed": true,
"CompletionDate": "2013-12-05T21:51:13.591Z",
"CreationDate": "2013-12-05T21:51:12.281Z",
"InventorySizeInBytes": 777062,
"JobDescription": null,
"JobId": "sCC2RZNBF2nildYD_roe0J9bHRdPQUbDRkmTdg-mXi2u3lc49uW6TcEhDF2D9pB2phx-BN30JaBru7PMyOlfXHdStzu8",
"NextInventoryRetrievalMarker": null,
"RetrievalByteRange": null,
"SHA256TreeHash": null,
"SNSTopic": null,
"StatusCode": "Succeeded",
"StatusMessage": "Succeeded",
"Tier": "Bulk",
"VaultARN": "arn:aws:glacier-devo:us-west-2:836579025725:vaults/inventory-icecube-2",
"InventoryRetrievalParameters": {
"StartDate": "2013-11-12T13:43:12Z",
"EndDate": "2013-11-20T08:12:45Z",
"Limit": "120000",
"Format": "JSON",
"Marker": "vyS0t2jHQe5qbcDggIeD50chS1SXwYMrkVKo0KHiTUjEYxBGCqRLKaiySzdN7QXGVVV5XZpNVG67pCZ_uykQXFMLaxOSu2hO_-5C0AtWMDrfo7LgVOyfnveDRuOSecUo3Ueq7K0"
},
}
```
## Secciones relacionadas
+ [Obtención de la salida del trabajo (GET output)](api-job-output-get.md)
+ [Administración de identidades y accesos para Amazon Glacier](security-iam.md)