Esta página es solo para los clientes actuales del servicio S3 Glacier que utilizan Vaults y el original de 2012. REST API
Si busca soluciones de almacenamiento de archivos, le sugerimos que utilice las clases de almacenamiento S3 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 Clases de almacenamiento de S3 Glacier y Almacenamiento
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)
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 S3 Glacier (S3 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.
GET /
AccountId
/vaults/VaultName
/jobs HTTP/1.1 Host: glacier.Region
.amazonaws.com Date:Date
Authorization:SignatureValue
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 S3 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 solicitud
Nombre | Descripción | Obligatorio |
---|---|---|
completed
|
Estado de los trabajos que se van a devolver. Puede especificar 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: String 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 Tipo: String Restricciones: ninguna |
No |
statuscode
|
Tipo de estado del trabajo que se va a devolver. Tipo: String Restricciones: uno de los siguientes valores: |
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.
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.
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
- 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 solicitudList Jobs
para recuperar más trabajos de la lista. Si no hay más trabajos que mostrar, este valor esnull
.Tipo: cadena
Errores
Para obtener información acerca de los mensajes de error y las excepciones de Amazon S3 Glacier, consulte Respuestas de error.
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.
GET /-/vaults/examplevault/jobs HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-glacier-version: 2012-06-01 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.
HTTP/1.1 200 OK x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:00:00 GMT Content-Type: application/json Content-Length: 1444 { "JobList": [ { "Action": "ArchiveRetrieval", "ArchiveId": "BDfaUQul0dVzYwAMr8YSa_6_8abbhZq-i1oT69g8ByClfJyBgAGBkWl2QbF5os851P7Y7KdZDOHWJIn4rh1ZHaOYD3MgFhK_g0oDPesW34uHQoVGwoIqubf6BgUEfQm_wrU4Jlm3cA", "ArchiveSizeInBytes": 1048576, "ArchiveSHA256TreeHash": "25499381569ab2f85e1fd0eb93c5406a178ab77c5933056eb5d6e7d4adda609b", "Completed": true, "CompletionDate": "2012-05-01T00:00:09.304Z", "CreationDate": "2012-05-01T00:00:06.663Z", "InventorySizeInBytes": null, "JobDescription": null, "JobId": "hDe9t9DTHXqFw8sBGpLQQOmIM0-JrGtu1O_YFKLnzQ64548qJc667BRWTwBLZC76Ygy1jHYruqXkdcAhRsh0hYv4eVRU", "RetrievalByteRange": "0-1048575", "SHA256TreeHash": "25499381569ab2f85e1fd0eb93c5406a178ab77c5933056eb5d6e7d4adda609b", "SNSTopic": null, "StatusCode": "Succeeded", "StatusMessage": "Succeeded", "Tier": "Bulk", "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" }, { "Action": "InventoryRetrieval", "ArchiveId": null, "ArchiveSizeInBytes": null, "ArchiveSHA256TreeHash": null, "Completed": true, "CompletionDate": "2013-05-11T00:25:18.831Z", "CreationDate": "2013-05-11T00:25:14.981Z", "InventorySizeInBytes": 1988, "JobDescription": null, "JobId": "2cvVOnBL36btzyP3pobwIceiaJebM1bx9vZOOUtmNAr0KaVZ4WkWgVjiPldJ73VU7imlm0pnZriBVBebnqaAcirZq_C5", "RetrievalByteRange": null, "SHA256TreeHash": null, "SNSTopic": null, "StatusCode": "Succeeded", "StatusMessage": "Succeeded", "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" "InventoryRetrievalParameters": { "StartDate": "2013-11-12T13:43:12Z", "EndDate": "2013-11-20T08:12:45Z", "Limit": "120000", "Format": "JSON", "Marker": "vyS0t2jHQe5qbcDggIeD50chS1SXwYMrkVKo0KHiTUjEYxBGCqRLKaiySzdN7QXGVVV5XZpNVG67pCZ_uykQXFMLaxOSu2hO_-5C0AtWMDrfo7LgVOyfnveDRuOSecUo3Ueq7K0" } ], "Marker": null }
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.
GET /-/vaults/examplevault/jobs?marker=HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID&limit=2 HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-glacier-version: 2012-06-01 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.
HTTP/1.1 200 OK x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:00:00 GMT Content-Type: application/json Content-Length: 1744 { "JobList": [ { "Action": "ArchiveRetrieval", "ArchiveId": "58-3KpZfcMPUznvMZNPaKyJx9wODCsWTnqcjtx2CjKZ6b-XgxEuA8yvZOYTPQfd7gWR4GRm2XR08gcnWbLV4VPV_kDWtZJKi0TFhKKVPzwrZnA4-FXuIBfViYUIVveeiBE51FO4bvg", "ArchiveSizeInBytes": 8388608, "ArchiveSHA256TreeHash": "106086b256ddf0fedf3d9e72f461d5983a2566247ebe7e1949246bc61359b4f4", "Completed": true, "CompletionDate": "2012-05-01T00:25:20.043Z", "CreationDate": "2012-05-01T00:25:16.344Z", "InventorySizeInBytes": null, "JobDescription": "aaabbbccc", "JobId": "s4MvaNHIh6mOa1f8iY4ioG2921SDPihXxh3Kv0FBX-JbNPctpRvE4c2_BifuhdGLqEhGBNGeB6Ub-JMunR9JoVa8y1hQ", "RetrievalByteRange": "0-8388607", "SHA256TreeHash": "106086b256ddf0fedf3d9e72f461d5983a2566247ebe7e1949246bc61359b4f4", "SNSTopic": null, "StatusCode": "Succeeded", "StatusMessage": "Succeeded", "Tier": "Bulk", "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" }, { "Action": "ArchiveRetrieval", "ArchiveId": "2NVGpf83U6qB9M2u-Ihh61yoFLRDEoh7YLZWKBn80A2i1xG8uieBwGjAr4RkzOHA0E07ZjtI267R03Z-6Hxd8pyGQkBdciCSH1-Lw63Kx9qKpZbPCdU0uTW_WAdwF6lR6w8iSyKdvw", "ArchiveSizeInBytes": 1048576, "ArchiveSHA256TreeHash": "3d2ae052b2978727e0c51c0a5e32961c6a56650d1f2e4ceccab6472a5ed4a0", "Completed": true, "CompletionDate": "2012-05-01T16:59:48.444Z", "CreationDate": "2012-05-01T16:59:42.977Z", "InventorySizeInBytes": null, "JobDescription": "aaabbbccc", "JobId": "CQ_tf6fOR4jrJCL61Mfk6VM03oY8lmnWK93KK4gLig1UPAbZiN3UV4G_5nq4AfmJHQ_dOMLOX5k8ItFv0wCPN0oaz5dG", "RetrievalByteRange": "0-1048575", "SHA256TreeHash": "3d2ae052b2978727e0c51c0a5e32961c6a56650d1f2e4ceccab6472a5ed4a0", "SNSTopic": null, "StatusCode": "Succeeded", "StatusMessage": "Succeeded", "Tier": "Standard", "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" } ], "Marker": "CQ_tf6fOR4jrJCL61Mfk6VM03oY8lmnWK93KK4gLig1UPAbZiN3UV4G_5nq4AfmJHQ_dOMLOX5k8ItFv0wCPN0oaz5dG" }
Secciones relacionadas