**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.
# Mostrar trabajos (GET trabajos)
## Description (Descripción)
Esta operación enumera los trabajos de un almacén, incluidos los trabajos que están en curso y los trabajos que han terminado recientemente.
**nota**
Amazon Glacier (Amazon Glacier) retiene los trabajos que se han completado recientemente durante un tiempo, aunque al final se eliminan. La salida de los trabajos completados puede recuperarse. La posibilidad de conservar los trabajos completados durante cierto período de tiempo tras su finalización le permite recuperar la salida de un trabajo en caso de que pase por alto la notificación de finalización o de que se produzca un error al intentar descargarlo por primera vez. Por ejemplo, supongamos que inicia un trabajo de recuperación con el fin de descargar un archivo. Una vez que se completa el trabajo, comienza a descargar el archivo, pero se produce un error. En este caso, puede volver a intentarlo y descargar el archivo mientras el trabajo existe.
La operación `List Jobs` admite la paginación. Siempre debe comprobar el campo `Marker` de la respuesta. Si no hay más trabajos que mostrar, el campo `Marker` se establece en `null`. Si hay más trabajos que mostrar, el campo `Marker` se establece en un valor que no es nulo y que se puede utilizar para continuar la paginación de la lista. Para recuperar una lista de trabajos a partir de un trabajo específico, establezca el parámetro `marker` de la solicitud en el valor `Marker` de dicho trabajo, que se obtuvo de una solicitud `List Jobs` anterior.
Puede establecer el límite máximo de trabajos devueltos en la respuesta especificando el parámetro `limit` de la solicitud. El límite predeterminado es 50. El número de trabajos devueltos puede ser menor que el límite, pero nunca puede superarlo.
También puede filtrar la lista de trabajos devueltos especificando el parámetro opcional `statuscode`, `completed` o ambos. Si usa el parámetro `statuscode`, puede indicar que solo deben devolverse los trabajos que coinciden con el estado `InProgress`, `Succeeded` o `Failed`. Si usa el parámetro `completed`, puede indicar que solo deben devolverse los trabajos completados (`true`) o los que no se han completado (`false`).
## Solicitudes
### Sintaxis
Para obtener una lista de trabajos de todos los tipos, envíe una solicitud `GET` al URI del subrecurso `jobs` del almacén.
```
1. GET /AccountId/vaults/VaultName/jobs 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 |
| --- | --- | --- |
| completed | Estado de los trabajos que se van a devolver. Puede especificar `true` o `false`. Tipo: Booleano Restricciones: ninguna | No |
| limit | Número máximo de trabajos que se van a devolver. El límite predeterminado es 50. El número de trabajos devueltos 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 que especifica el trabajo en el que debe comenzar la lista de trabajos. El valor de `marker` se obtiene de la respuesta de una solicitud `List Jobs` anterior. Solo tiene que incluir `marker` si quiere continuar la paginación de resultados que se inició en una solicitud `List Jobs` anterior. Tipo: cadena Restricciones: ninguna | No |
| statuscode | Tipo de estado del trabajo que se va a devolver. Tipo: cadena Restricciones: uno de los siguientes valores: `InProgress`, `Succeeded` o `Failed`. | 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
```
HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Location: Location
Content-Type: application/json
Content-Length: Length
{
"JobList": [
{
"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"
}
],
"Marker": "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.
**JobList**
Lista de objetos. Cada objeto del trabajo contiene metadatos que describen el trabajo.
*Tipo*: Matriz de objetos [GlacierJobDescription](api-GlacierJobDescription.md)
**Marker**
Cadena opaca que indica dónde se va a continuar la paginación de los resultados. Puede utilizar el valor `marker` en una nueva solicitud` List Jobs` para recuperar más trabajos de la lista. Si no hay más trabajos que mostrar, este valor es `null`.
*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 los ejemplos siguientes, se muestra cómo devolver información sobre los trabajos del almacén. El primer ejemplo devuelve una lista de dos trabajos y el segundo devuelve un subconjunto de los trabajos.
### Ejemplo: recuperación de todos los trabajos
#### Solicitud de ejemplo
La siguiente solicitud `GET` devuelve los trabajos de un almacén.
```
1. GET /-/vaults/examplevault/jobs 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
La siguiente respuesta incluye un trabajo de recuperación de un archivo y un trabajo de recuperación de un inventario que contiene un marcador. Este marcador se utiliza para continuar la paginación de la recuperación del inventario del almacén. En la respuesta, el campo `Marker` está establecido en `null`, lo que indica que no hay más trabajos que 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: 1444
6.
7. {
8. "JobList": [
9. {
10. "Action": "ArchiveRetrieval",
11. "ArchiveId": "BDfaUQul0dVzYwAMr8YSa_6_8abbhZq-i1oT69g8ByClfJyBgAGBkWl2QbF5os851P7Y7KdZDOHWJIn4rh1ZHaOYD3MgFhK_g0oDPesW34uHQoVGwoIqubf6BgUEfQm_wrU4Jlm3cA",
12. "ArchiveSizeInBytes": 1048576,
13. "ArchiveSHA256TreeHash": "25499381569ab2f85e1fd0eb93c5406a178ab77c5933056eb5d6e7d4adda609b",
14. "Completed": true,
15. "CompletionDate": "2012-05-01T00:00:09.304Z",
16. "CreationDate": "2012-05-01T00:00:06.663Z",
17. "InventorySizeInBytes": null,
18. "JobDescription": null,
19. "JobId": "hDe9t9DTHXqFw8sBGpLQQOmIM0-JrGtu1O_YFKLnzQ64548qJc667BRWTwBLZC76Ygy1jHYruqXkdcAhRsh0hYv4eVRU",
20. "RetrievalByteRange": "0-1048575",
21. "SHA256TreeHash": "25499381569ab2f85e1fd0eb93c5406a178ab77c5933056eb5d6e7d4adda609b",
22. "SNSTopic": null,
23. "StatusCode": "Succeeded",
24. "StatusMessage": "Succeeded",
25. "Tier": "Bulk",
26. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
27. },
28. {
29. "Action": "InventoryRetrieval",
30. "ArchiveId": null,
31. "ArchiveSizeInBytes": null,
32. "ArchiveSHA256TreeHash": null,
33. "Completed": true,
34. "CompletionDate": "2013-05-11T00:25:18.831Z",
35. "CreationDate": "2013-05-11T00:25:14.981Z",
36. "InventorySizeInBytes": 1988,
37. "JobDescription": null,
38. "JobId": "2cvVOnBL36btzyP3pobwIceiaJebM1bx9vZOOUtmNAr0KaVZ4WkWgVjiPldJ73VU7imlm0pnZriBVBebnqaAcirZq_C5",
39. "RetrievalByteRange": null,
40. "SHA256TreeHash": null,
41. "SNSTopic": null,
42. "StatusCode": "Succeeded",
43. "StatusMessage": "Succeeded",
44. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
45. "InventoryRetrievalParameters": {
46. "StartDate": "2013-11-12T13:43:12Z",
47. "EndDate": "2013-11-20T08:12:45Z",
48. "Limit": "120000",
49. "Format": "JSON",
50. "Marker": "vyS0t2jHQe5qbcDggIeD50chS1SXwYMrkVKo0KHiTUjEYxBGCqRLKaiySzdN7QXGVVV5XZpNVG67pCZ_uykQXFMLaxOSu2hO_-5C0AtWMDrfo7LgVOyfnveDRuOSecUo3Ueq7K0"
51. }
52. ],
53. "Marker": null
54. }
```
### Ejemplo: recuperación de una lista parcial de trabajos
#### Solicitud de ejemplo
La siguiente solicitud `GET` devuelve el trabajo especificado por el parámetro `marker`. Si el parámetro `limit` se establece en `2`, se indica que se van a devolver dos trabajos como máximo.
```
1. GET /-/vaults/examplevault/jobs?marker=HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID&limit=2 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 siguiente se muestran dos trabajos devueltos y el campo `Marker` establecido en un valor que no es nulo y que puede utilizarse para continuar la paginación de la lista de trabajos.
```
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: 1744
6.
7. {
8. "JobList": [
9. {
10. "Action": "ArchiveRetrieval",
11. "ArchiveId": "58-3KpZfcMPUznvMZNPaKyJx9wODCsWTnqcjtx2CjKZ6b-XgxEuA8yvZOYTPQfd7gWR4GRm2XR08gcnWbLV4VPV_kDWtZJKi0TFhKKVPzwrZnA4-FXuIBfViYUIVveeiBE51FO4bvg",
12. "ArchiveSizeInBytes": 8388608,
13. "ArchiveSHA256TreeHash": "106086b256ddf0fedf3d9e72f461d5983a2566247ebe7e1949246bc61359b4f4",
14. "Completed": true,
15. "CompletionDate": "2012-05-01T00:25:20.043Z",
16. "CreationDate": "2012-05-01T00:25:16.344Z",
17. "InventorySizeInBytes": null,
18. "JobDescription": "aaabbbccc",
19. "JobId": "s4MvaNHIh6mOa1f8iY4ioG2921SDPihXxh3Kv0FBX-JbNPctpRvE4c2_BifuhdGLqEhGBNGeB6Ub-JMunR9JoVa8y1hQ",
20. "RetrievalByteRange": "0-8388607",
21. "SHA256TreeHash": "106086b256ddf0fedf3d9e72f461d5983a2566247ebe7e1949246bc61359b4f4",
22. "SNSTopic": null,
23. "StatusCode": "Succeeded",
24. "StatusMessage": "Succeeded",
25. "Tier": "Bulk",
26. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
27. },
28. {
29. "Action": "ArchiveRetrieval",
30. "ArchiveId": "2NVGpf83U6qB9M2u-Ihh61yoFLRDEoh7YLZWKBn80A2i1xG8uieBwGjAr4RkzOHA0E07ZjtI267R03Z-6Hxd8pyGQkBdciCSH1-Lw63Kx9qKpZbPCdU0uTW_WAdwF6lR6w8iSyKdvw",
31. "ArchiveSizeInBytes": 1048576,
32. "ArchiveSHA256TreeHash": "3d2ae052b2978727e0c51c0a5e32961c6a56650d1f2e4ceccab6472a5ed4a0",
33. "Completed": true,
34. "CompletionDate": "2012-05-01T16:59:48.444Z",
35. "CreationDate": "2012-05-01T16:59:42.977Z",
36. "InventorySizeInBytes": null,
37. "JobDescription": "aaabbbccc",
38. "JobId": "CQ_tf6fOR4jrJCL61Mfk6VM03oY8lmnWK93KK4gLig1UPAbZiN3UV4G_5nq4AfmJHQ_dOMLOX5k8ItFv0wCPN0oaz5dG",
39. "RetrievalByteRange": "0-1048575",
40. "SHA256TreeHash": "3d2ae052b2978727e0c51c0a5e32961c6a56650d1f2e4ceccab6472a5ed4a0",
41. "SNSTopic": null,
42. "StatusCode": "Succeeded",
43. "StatusMessage": "Succeeded",
44. "Tier": "Standard",
45. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
46. }
47. ],
48. "Marker": "CQ_tf6fOR4jrJCL61Mfk6VM03oY8lmnWK93KK4gLig1UPAbZiN3UV4G_5nq4AfmJHQ_dOMLOX5k8ItFv0wCPN0oaz5dG"
49. }
```
## Secciones relacionadas
+ [Descripción del trabajo (GET JobID)](api-describe-job-get.md)
+ [Administración de identidades y accesos para Amazon Glacier](security-iam.md)