**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 tareas A continuación, se muestran las operaciones de trabajo disponibles en Amazon Glacier. **Topics** + [Descripción del trabajo (GET JobID)](api-describe-job-get.md) + [Obtención de la salida del trabajo (GET output)](api-job-output-get.md) + [Inicialización de trabajos (POST trabajos)](api-initiate-job-post.md) + [Mostrar trabajos (GET trabajos)](api-jobs-get.md) # 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) # 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) # Inicialización de trabajos (POST trabajos) Esta operación inicia los siguientes tipos de trabajos de Amazon Glacier (Amazon Glacier): + `archive-retrieval`: recuperación de un archivo + `inventory-retrieval`: inventario de un almacén **Topics** + [Inicialización de un trabajo de recuperación de archivo o de inventario de almacén](#api-initiate-job-post-description) + [Solicitudes](#api-initiate-job-post-requests) + [Respuestas](#api-initiate-job-post-responses) + [Ejemplos](#api-initiate-job-post-examples) + [Secciones relacionadas](#more-info-api-initiate-job-post) ## Inicialización de un trabajo de recuperación de archivo o de inventario de almacén Las operaciones de recuperación de un archivo o de un inventario del almacén son asincrónicas, por lo que es necesario iniciar un trabajo. Una vez iniciado, el trabajo no se puede cancelar. La recuperación es un proceso que consta de dos pasos: 1. Inicie un trabajo de recuperación utilizando la operación [Inicialización de trabajos (POST trabajos)](#api-initiate-job-post). **importante** Si se utiliza una política de recuperación de datos, puede producirse una excepción `PolicyEnforcedException` en la solicitud de inicio del trabajo de recuperación. Para obtener más información sobre las políticas de recuperación de datos, consulte [Políticas de recuperación de datos de Amazon Glacier](data-retrieval-policy.md). Para obtener más información sobre la excepción `PolicyEnforcedException`, consulte [Respuestas de error](api-error-responses.md). 1. Una vez completado el trabajo, descargue los bytes utilizando la operación [Obtención de la salida del trabajo (GET output)](api-job-output-get.md). La solicitud de recuperación se ejecuta de forma asíncrona. Cuando se inicia un trabajo de recuperación, Amazon Glacier crea un trabajo y devuelve un ID de trabajo en la respuesta. Una vez que Amazon Glacier finaliza el trabajo, se puede obtener la salida del trabajo (los datos del archivo o del inventario). Para obtener más información acerca de cómo obtener la salida de un trabajo, consulte la operación [Obtención de la salida del trabajo (GET output)](api-job-output-get.md). El trabajo debe completarse antes de poder obtener la salida. Para determinar cuándo se ha completado un trabajo, cuenta con las siguientes opciones: + **Puede usar una notificación de Amazon SNS:** puede especificar un tema de Amazon SNS en el que Amazon Glacier puede publicar una notificación cuando se complete el trabajo. Puede especificar un tema de SNS para cada solicitud de trabajo. La notificación se envía solo cuando Amazon Glacier haya completado el trabajo. Además de especificar un tema de SNS para cada solicitud de trabajo, puede configurar las notificaciones en un almacén para que se envíen notificaciones de trabajo en todas las recuperaciones. Para obtener más información, consulte [Establecimiento de la configuración de notificación del almacén (PUT configuración-notificaciones)](api-vault-notifications-put.md). + **Puede obtener información sobre el trabajo:** puede realizar una solicitud [Descripción del trabajo (GET JobID)](api-describe-job-get.md) para obtener información sobre el estado de un trabajo mientras está en curso. Sin embargo, es más eficaz usar las notificaciones de Amazon SNS para determinar cuándo se completa un trabajo. **nota** La información que se obtiene través de las notificaciones es la misma que se obtiene llamando a [Descripción del trabajo (GET JobID)](api-describe-job-get.md). Si en un evento concreto establece la configuración de las notificaciones en el almacén y también especifica un tema de SNS en la solicitud de inicio del trabajo, Amazon Glacier envía ambas notificaciones. Para obtener más información, consulte [Establecimiento de la configuración de notificación del almacén (PUT configuración-notificaciones)](api-vault-notifications-put.md). ### El inventario del almacén A partir del día que se carga por primera vez un archivo en el almacén, Amazon Glacier actualiza el inventario del almacén aproximadamente una vez al día. Si no se han agregando ni eliminado archivos en el almacén desde el último inventario, la fecha del inventario no se actualiza. Al iniciar un trabajo para el inventario de un almacén, Amazon Glacier devuelve el último inventario que generó, que es una point-in-time instantánea y no datos en tiempo real. Una vez que Amazon Glacier crea el primer inventario de almacén, debe transcurrir entre medio día y un día para que el inventario pueda recuperarse. Es posible que no le parezca útil recuperar un inventario del almacén cada vez que carga un archivo. Sin embargo, imagine que tiene una base de datos del cliente asociada con los metadatos de los archivos que se cargan en Amazon Glacier. En ese caso, el inventario del almacén podría resultarle útil para, en función de sus necesidades, conciliar la información de la base de datos con el inventario del almacén real. Para obtener más información acerca de los campos de datos que se devuelven en la salida de un trabajo de inventario, consulte [Cuerpo de respuesta](api-job-output-get.md#api-job-output-get-responses-elements). ### Recuperación del inventario por intervalos Puede limitar el número de elementos del inventario que se van a recuperar utilizando como filtro la fecha de creación del archivo o definiendo un límite. **Filtrado por la fecha de creación del archivo** Puede recuperar los elementos de los archivos creados entre `StartDate` y `EndDate` especificando valores para estos parámetros en la solicitud **Initiate Job**. De ese modo, se devolverán los archivos creados el día de `StartDate` o los que se crearon entre esa fecha y `EndDate`. Si solo se proporciona `StartDate` y no `EndDate`, se recuperará el inventario de todos los archivos que se hayan creado en `StartDate` o con posterioridad a esa fecha. Si solo se proporciona `EndDate` y no `StartDate`, se recuperará el inventario de todos los archivos que se hayan creado antes de `EndDate`. **Limitación de los elementos del inventario de cada recuperación** Puede limitar el número de artículos que se devuelven estableciendo el parámetro `Limit` de la solicitud **Initiate Job**. La salida del trabajo de inventario contendrá los elementos del inventario hasta el límite especificado en `Limit`. Si hay más elementos disponibles en el inventario, el resultado aparecerá paginado. Una vez que se ha completado un trabajo, se puede utilizar la operación [Descripción del trabajo (GET JobID)](api-describe-job-get.md) para obtener un marcador y utilizarlo en otras solicitudes **Initiate Job (Iniciar trabajo)** posteriores. Este marcador indica el punto de partida en la recuperación del próximo conjunto de elementos del inventario. Puede desplazarse por las páginas de todo el inventario realizando reiteradamente solicitudes **Initiate Job (Iniciar trabajo)** con el marcador de la salida de **Describe Job** anterior. Puede realizar esta operación hasta que obtenga de **Describe Job (Describir trabajo)** un marcador que devuelva null, lo que indica que no hay más elementos de inventario disponibles. Puede utilizar el parámetro `Limit` junto con los parámetros de intervalos de fechas. ### Recuperación del archivo por intervalos Puede iniciar una recuperación de todo el archivo o de un intervalo. En el caso de la recuperación de archivos por intervalos, debe especificar el intervalo de bytes que se va a devolver o todo el archivo. El intervalo especificado debe estar alineado en megabytes (MB). En otras palabras, el valor inicial del intervalo debe ser divisible por 1 MB, mientras que el valor final del intervalo más 1 debe ser divisible por 1 MB o igual que el final del archivo. Si la recuperación del archivo por intervalos no está alineada en megabytes, esta operación devuelve una respuesta `400`. Además, para garantizar que se obtienen los valores de la suma de comprobación de los datos descargados con **Get Job Output (Obtener salida de trabajo)** ([Obtención de la salida del trabajo (GET output)](api-job-output-get.md)), el intervalo debe estar alineado con un algoritmo 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). ### Niveles Expedited, Standard y Bulk Al iniciar un trabajo de recuperación de archivo, puede especificar una de las siguientes opciones en el campo `Tier` del cuerpo de la solicitud: + **`Expedited`**: el nivel rápido le permite acceder rápidamente a sus datos cuando es necesario utilizar solicitudes urgentes ocasionales para restaurar archivos. En todos los archivos excepto en los de mayor tamaño (más de 250 MB), los datos a los que se obtiene acceso con el nivel rápido suelen estar disponibles en un plazo comprendido entre 1 y 5 minutos. + **`Standard`**: el nivel estándar permite acceder a los archivos en un plazo de varias horas. Los datos a los que se obtiene acceso con el nivel Standard normalmente están disponibles en un plazo de 3 a 5 horas. Esta es la opción predeterminada para las solicitudes de los trabajos que no especifican el nivel. + **`Bulk`**: el nivel en bloque es el nivel de Amazon Glacier con los costos más bajos, lo que le permite recuperar grandes cantidades de datos, incluso petabytes, de forma económica y en un mismo día. Los datos a los que se obtiene acceso con el nivel Bulk normalmente están disponibles en un plazo de 5 a 12 horas. Para obtener más información sobre las recuperaciones Expedited y Bulk, consulte [Recuperación de archivos de Amazon Glacier](downloading-an-archive-two-steps.md). ## Solicitudes Para iniciar un trabajo, utilice el método HTTP `POST` y establezca el alcance de la solicitud en el subrecurso `jobs` del almacén. Los detalles de la solicitud de trabajo deben especificarse en el documento JSON de la solicitud. El tipo de trabajo se especifica con el campo `Type`. Si lo desea, puede especificar un campo `SNSTopic` para indicar un tema de Amazon SNS en el que Amazon Glacier pueda publicar notificaciones cuando se complete el trabajo. **nota** Para publicar una notificación en Amazon SNS, debe crear el tema si este no existe aún. Amazon Glacier no lo crea automáticamente. El tema debe tener los permisos necesarios para recibir publicaciones de un almacén de Amazon Glacier. Amazon Glacier no comprueba si el almacén tiene permiso para publicar en el tema. Si los permisos no están configurados correctamente, es posible que no reciba ninguna notificación aunque se complete el trabajo. ### Sintaxis A continuación, se muestra la sintaxis de la solicitud para iniciar un trabajo. ``` 1. POST /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 6. 7. { 8. "jobParameters": { 9. "ArchiveId": "string", 10. "Description": "string", 11. "Format": "string", 12. "InventoryRetrievalParameters": { 13. "EndDate": "string", 14. "Limit": "string", 15. "Marker": "string", 16. "StartDate": "string" 17. }, 18. "OutputLocation": { 19. "S3": { 20. "AccessControlList": [ 21. { 22. "Grantee": { 23. "DisplayName": "string", 24. "EmailAddress": "string", 25. "ID": "string", 26. "Type": "string", 27. "URI": "string" 28. }, 29. "Permission": "string" 30. } 31. ], 32. "BucketName": "string", 33. "CannedACL": "string", 34. "Encryption": { 35. "EncryptionType": "string", 36. "KMSContext": "string", 37. "KMSKeyId": "string" 38. }, 39. "Prefix": "string", 40. "StorageClass": "string", 41. "Tagging": { 42. "string" : "string" 43. }, 44. "UserMetadata": { 45. "string" : "string" 46. } 47. } 48. }, 49. "RetrievalByteRange": "string", 50. "SelectParameters": { 51. "Expression": "string", 52. "ExpressionType": "string", 53. "InputSerialization": { 54. "csv": { 55. "Comments": "string", 56. "FieldDelimiter": "string", 57. "FileHeaderInfo": "string", 58. "QuoteCharacter": "string", 59. "QuoteEscapeCharacter": "string", 60. "RecordDelimiter": "string" 61. } 62. }, 63. "OutputSerialization": { 64. "csv": { 65. "FieldDelimiter": "string", 66. "QuoteCharacter": "string", 67. "QuoteEscapeCharacter": "string", 68. "QuoteFields": "string", 69. "RecordDelimiter": "string" 70. } 71. } 72. }, 73. "SNSTopic": "string", 74. "Tier": "string", 75. "Type": "string" 76. } 77. } ``` **nota** El `AccountId` valor es el Cuenta de AWS ID 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. ### Cuerpo de la solicitud El cuerpo de la solicitud admite los siguientes datos en formato JSON. jobParameters Ofrece opciones para especificar la información del trabajo. *Tipo*: [jobParameters](api-jobParameters.md) objeto *Obligatorio*: sí ## Respuestas Amazon Glacier crea el trabajo. En la respuesta, devuelve el URI del trabajo. ### Sintaxis ``` 1. HTTP/1.1 202 Accepted 2. x-amzn-RequestId: x-amzn-RequestId 3. Date: Date 4. Location: location 5. x-amz-job-id: jobId 6. x-amz-job-output-path: jobOutputPath ``` ### Encabezados de respuesta | Encabezado | Description (Descripción) | | --- | --- | | Location | La ruta relativa del URI del trabajo. Puede utilizar esta ruta de URI para buscar el estado del trabajo. Para obtener más información, consulte [Descripción del trabajo (GET JobID)](api-describe-job-get.md). Tipo: cadena Valor predeterminado: None | | x-amz-job-id | ID del trabajo. Este valor también forma parte del encabezado `Location`. Tipo: cadena Valor predeterminado: None | | x-amz-job-output-path | Ruta de la ubicación en la que se almacenan los resultados del trabajo Select. Tipo: cadena Valor predeterminado: None | ### Cuerpo de respuesta Esta operación no devuelve ningún cuerpo de respuesta. ### Errores Esta operación incluye los siguientes errores, además de los posibles errores comunes a todas las operaciones de Amazon Glacier. Para obtener información sobre los errores de Amazon Glacier y una lista de códigos de error, consulte [Respuestas de error](api-error-responses.md). | Código | Description (Descripción) | Código de estado HTTP | Tipo | | --- | --- | --- | --- | | InsufficientCapacityException | Esta excepción se devuelve si no hay capacidad suficiente para procesar la solicitud Expedited. Este error solo se aplica a las recuperaciones Expedited; no se aplica a las recuperaciones estándar ni de tipo Bulk. | 503 Service Unavailable | Server | ## Ejemplos ### Solicitud de ejemplo: inicio de un trabajo de recuperación de un archivo ``` 1. POST /-/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 6. 7. { 8. "Type": "archive-retrieval", 9. "ArchiveId": "NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId", 10. "Description": "My archive description", 11. "SNSTopic": "arn:aws:sns:us-west-2:111111111111:Glacier-ArchiveRetrieval-topic-Example", 12. "Tier" : "Bulk" 13. } ``` A continuación, se muestra un ejemplo del cuerpo de una solicitud donde se especifica el intervalo del archivo que se va a recuperar mediante el campo `RetrievalByteRange`. ``` { "Type": "archive-retrieval", "ArchiveId": "NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId", "Description": "My archive description", "RetrievalByteRange": "2097152-4194303", "SNSTopic": "arn:aws:sns:us-west-2:111111111111:Glacier-ArchiveRetrieval-topic-Example", "Tier" : "Bulk" } ``` ### Respuesta de ejemplo ``` 1. HTTP/1.1 202 Accepted 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Location: /111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 5. x-amz-job-id: HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID ``` ### Solicitud de ejemplo: inicio de un trabajo de recuperación de un inventario En la siguiente solicitud, se inicia un trabajo de recuperación de inventario para obtener una lista de archivos del almacén `examplevault`. `Format` está establecido en `CSV` en el cuerpo de la solicitud, lo que indica que el inventario se devuelve con el formato CSV. ``` 1. POST /-/vaults/examplevault/jobs HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. Content-Type: application/x-www-form-urlencoded 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 7. 8. { 9. "Type": "inventory-retrieval", 10. "Description": "My inventory job", 11. "Format": "CSV", 12. "SNSTopic": "arn:aws:sns:us-west-2:111111111111:Glacier-InventoryRetrieval-topic-Example" 13. } ``` ### Respuesta de ejemplo ``` 1. HTTP/1.1 202 Accepted 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Location: /111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 5. x-amz-job-id: HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID ``` ### Solicitudes de ejemplo: inicie un trabajo de recuperación de inventario utilizando el filtrado de fechas con un límite establecido y una solicitud posterior para recuperar la siguiente página de elementos de inventario. La siguiente solicitud inicia un trabajo de recuperación de un inventario del almacén donde se aplica un filtro de fecha y se establece un límite. ``` 1. { 2. "ArchiveId": null, 3. "Description": null, 4. "Format": "CSV", 5. "RetrievalByteRange": null, 6. "SNSTopic": null, 7. "Type": "inventory-retrieval", 8. "InventoryRetrievalParameters": { 9. "StartDate": "2013-12-04T21:25:42Z", 10. "EndDate": "2013-12-05T21:25:42Z", 11. "Limit" : "10000" 12. }, 13. } ``` La siguiente solicitud es un ejemplo de una solicitud posterior para recuperar la siguiente página de elementos del inventario a través de un marcado obtenido de [Descripción del trabajo (GET JobID)](api-describe-job-get.md). ``` 1. { 2. "ArchiveId": null, 3. "Description": null, 4. "Format": "CSV", 5. "RetrievalByteRange": null, 6. "SNSTopic": null, 7. "Type": "inventory-retrieval", 8. "InventoryRetrievalParameters": { 9. "StartDate": "2013-12-04T21:25:42Z", 10. "EndDate": "2013-12-05T21:25:42Z", 11. "Limit": "10000", 12. "Marker": "vyS0t2jHQe5qbcDggIeD50chS1SXwYMrkVKo0KHiTUjEYxBGCqRLKaiySzdN7QXGVVV5XZpNVG67pCZ_uykQXFMLaxOSu2hO_-5C0AtWMDrfo7LgVOyfnveDRuOSecUo3Ueq7K0" 13. }, 14. } ``` ### Respuesta de ejemplo ``` 1. HTTP/1.1 202 Accepted 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Location: /111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 5. x-amz-job-id: HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 6. x-amz-job-output-path: test/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID/ ``` ## Secciones relacionadas + [Descripción del trabajo (GET JobID)](api-describe-job-get.md) + [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) # 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)