Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de [ejemplos de AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples).
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.
# Ejemplos de Amazon Glacier que utilizan AWS CLI
Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes AWS Command Line Interface con Amazon Glacier.
Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.
En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.
**Topics**
+ [Acciones](#actions)
## Acciones
### `abort-multipart-upload`
En el siguiente ejemplo de código, se muestra cómo utilizar `abort-multipart-upload`.
**AWS CLI**
El siguiente comando elimina una carga multiparte en curso en un almacén llamado `my-vault`:
```
aws glacier abort-multipart-upload --account-id - --vault-name my-vault --upload-id 19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ
```
Este comando no produce ninguna salida. Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso. El comando `aws glacier initiate-multipart-upload` devuelve el ID de carga y también se puede obtener mediante `aws glacier list-multipart-uploads`.
Para obtener más información sobre las cargas de varias partes a Amazon Glacier mediante la AWS CLI, consulte Uso de Amazon Glacier en la Guía *del usuario de AWS CLI*.
+ Para obtener más información sobre la API, consulte la Referencia [AbortMultipartUpload](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/abort-multipart-upload.html)de *AWS CLI comandos*.
### `abort-vault-lock`
En el siguiente ejemplo de código, se muestra cómo utilizar `abort-vault-lock`.
**AWS CLI**
**Para anular un proceso de bloqueo de almacén en curso**
En el siguiente ejemplo de `abort-vault-lock`, se elimina una política de bloqueo de almacenes del almacén especificado y se restablece el estado de bloqueo del almacén que se desbloqueará.
```
aws glacier abort-vault-lock \
--account-id - \
--vault-name MyVaultName
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Abort Vault Lock (DELETE lock-policy)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-AbortVaultLock.html) en la *Guía para desarrolladores de API de Amazon Glacier*.
+ Para obtener más información sobre la API, consulte [AbortVaultLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/abort-vault-lock.html)la *Referencia de AWS CLI comandos*.
### `add-tags-to-vault`
En el siguiente ejemplo de código, se muestra cómo utilizar `add-tags-to-vault`.
**AWS CLI**
El siguiente comando añade dos etiquetas a un almacén denominado `my-vault`:
```
aws glacier add-tags-to-vault --account-id - --vault-name my-vault --tags id=1234,date=july2015
```
Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.
+ Para obtener más información sobre la API, consulte [AddTagsToVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/add-tags-to-vault.html)la *Referencia de AWS CLI comandos*.
### `complete-multipart-upload`
En el siguiente ejemplo de código, se muestra cómo utilizar `complete-multipart-upload`.
**AWS CLI**
El siguiente comando completa la carga multiparte de un archivo de 3 MiB:
```
aws glacier complete-multipart-upload --archive-size 3145728 --checksum 9628195fcdbcbbe76cdde456d4646fa7de5f219fb39823836d81f0cc0e18aa67 --upload-id 19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ --account-id - --vault-name my-vault
```
Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.
El comando `aws glacier initiate-multipart-upload` devuelve el ID de carga y también se puede obtener mediante `aws glacier list-multipart-uploads`. El parámetro checksum toma un hash en árbol SHA-256 del archivo en hexadecimal.
Para obtener más información sobre las cargas de varias partes a Amazon Glacier mediante la AWS CLI, incluidas las instrucciones sobre el cálculo de un hash de árbol, consulte Uso de Amazon Glacier en la Guía *del usuario de AWS CLI*.
+ Para obtener más información sobre la API, consulte la Referencia [CompleteMultipartUpload](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/complete-multipart-upload.html)de *AWS CLI comandos*.
### `complete-vault-lock`
En el siguiente ejemplo de código, se muestra cómo utilizar `complete-vault-lock`.
**AWS CLI**
**Para completar un proceso de bloqueo de almacén en curso**
En el siguiente ejemplo de `complete-vault-lock`, se completa el progreso de bloqueo en curso del almacén especificado y se establece el estado de bloqueo del almacén en `Locked`. Obtiene el valor del parámetro `lock-id` al ejecutar `initiate-lock-process`.
```
aws glacier complete-vault-lock \
--account-id - \
--vault-name MyVaultName \
--lock-id 9QZgEXAMPLEPhvL6xEXAMPLE
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Complete Vault Lock (POST lockId)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-CompleteVaultLock.html) en la *Guía para desarrolladores de la API de Amazon Glacier*.
+ Para obtener más información sobre la API, consulte [CompleteVaultLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/complete-vault-lock.html)la *Referencia de AWS CLI comandos*.
### `create-vault`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-vault`.
**AWS CLI**
El comando siguiente crea un nuevo almacén llamado `my-vault`.
```
aws glacier create-vault --vault-name my-vault --account-id -
```
Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.
+ Para obtener más información sobre la API, consulte [CreateVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/create-vault.html)la *Referencia de AWS CLI comandos*.
### `delete-archive`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-archive`.
**AWS CLI**
**Eliminación de un archivo desde un almacén**
En el siguiente ejemplo de `delete-archive` se elimina el archivo especificado de `example_vault`.
```
aws glacier delete-archive \
--account-id 111122223333 \
--vault-name example_vault \
--archive-id Sc0u9ZP8yaWkmh-XGlIvAVprtLhaLCGnNwNl5I5x9HqPIkX5mjc0DrId3Ln-Gi_k2HzmlIDZUz117KSdVMdMXLuFWi9PJUitxWO73edQ43eTlMWkH0pd9zVSAuV_XXZBVhKhyGhJ7w
```
Este comando no genera ninguna salida.
+ Para obtener más información sobre la API, consulte [DeleteArchive](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-archive.html)la *Referencia de AWS CLI comandos*.
### `delete-vault-access-policy`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-vault-access-policy`.
**AWS CLI**
**Para eliminar la política de acceso de un almacén**
En el siguiente ejemplo de `delete-vault-access-policy`, se elimina la política de acceso del almacén especificado.
```
aws glacier delete-vault-access-policy \
--account-id 111122223333 \
--vault-name example_vault
```
Este comando no genera ninguna salida.
+ Para obtener más información sobre la API, consulte [DeleteVaultAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-vault-access-policy.html)la *Referencia de AWS CLI comandos*.
### `delete-vault-notifications`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-vault-notifications`.
**AWS CLI**
**Para eliminar las notificaciones de SNS para un almacén**
El siguiente ejemplo de `delete-vault-notifications` muestra las notificaciones enviadas por Amazon Simple Notification Service (Amazon SNS) para el almacén especificado.
```
aws glacier delete-vault-notifications \
--account-id 111122223333 \
--vault-name example_vault
```
Este comando no genera ninguna salida.
+ Para obtener más información sobre la API, consulte [DeleteVaultNotifications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-vault-notifications.html)la *Referencia de AWS CLI comandos*.
### `delete-vault`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-vault`.
**AWS CLI**
El comando siguiente elimina un almacén llamado `my-vault`.
```
aws glacier delete-vault --vault-name my-vault --account-id -
```
Este comando no produce ninguna salida. Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.
+ Para obtener más información sobre la API, consulte [DeleteVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-vault.html)la *Referencia de AWS CLI comandos*.
### `describe-job`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-job`.
**AWS CLI**
El siguiente comando recupera información sobre un trabajo de recuperación de inventario en un almacén denominado `my-vault`:
```
aws glacier describe-job --account-id - --vault-name my-vault --job-id zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW
```
Salida:
```
{
"InventoryRetrievalParameters": {
"Format": "JSON"
},
"VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault",
"Completed": false,
"JobId": "zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW",
"Action": "InventoryRetrieval",
"CreationDate": "2015-07-17T20:23:41.616Z",
"StatusCode": "InProgress"
}
```
El ID del trabajo se encuentra en la salida de `aws glacier initiate-job` y `aws glacier list-jobs`. Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.
+ Para obtener más información sobre la API, consulte [DescribeJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/describe-job.html)la *Referencia de AWS CLI comandos*.
### `describe-vault`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-vault`.
**AWS CLI**
El siguiente comando recupera datos sobre un almacén denominado `my-vault`:
```
aws glacier describe-vault --vault-name my-vault --account-id -
```
Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.
+ Para obtener más información sobre la API, consulte [DescribeVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/describe-vault.html)la *Referencia de AWS CLI comandos*.
### `get-data-retrieval-policy`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-data-retrieval-policy`.
**AWS CLI**
El siguiente comando obtiene la política de recuperación de datos de la cuenta en uso:
```
aws glacier get-data-retrieval-policy --account-id -
```
Salida:
```
{
"Policy": {
"Rules": [
{
"BytesPerHour": 10737418240,
"Strategy": "BytesPerHour"
}
]
}
}
```
Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.
+ Para obtener más información sobre la API, consulte [GetDataRetrievalPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-data-retrieval-policy.html)la *Referencia de AWS CLI comandos*.
### `get-job-output`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-job-output`.
**AWS CLI**
El siguiente comando guarda el resultado de un trabajo de inventario de almacén en un archivo del directorio actual denominado `output.json`:
```
aws glacier get-job-output --account-id - --vault-name my-vault --job-id zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW output.json
```
El `job-id` está disponible en la salida de `aws glacier list-jobs`. Tenga en cuenta que el nombre de archivo de salida es un argumento posicional que no va precedido de un nombre de opción. Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.
Salida:
```
{
"status": 200,
"acceptRanges": "bytes",
"contentType": "application/json"
}
```
`output.json`:
```
{"VaultARN":"arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault","InventoryDate":"2015-04-07T00:26:18Z","ArchiveList":[{"ArchiveId":"kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw","ArchiveDescription":"multipart upload test","CreationDate":"2015-04-06T22:24:34Z","Size":3145728,"SHA256TreeHash":"9628195fcdbcbbe76cdde932d4646fa7de5f219fb39823836d81f0cc0e18aa67"}]}
```
+ Para obtener más información sobre la API, consulte [GetJobOutput](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-job-output.html)la *Referencia de AWS CLI comandos*.
### `get-vault-access-policy`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-vault-access-policy`.
**AWS CLI**
**Para recuperar la política de acceso de un almacén**
En el siguiente ejemplo de `get-vault-access-policy`, se recupera la política de acceso para el almacén especificado.
```
aws glacier get-vault-access-policy \
--account-id 111122223333 \
--vault-name example_vault
```
Salida:
```
{
"policy": {
"Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::444455556666:root\"},\"Action\":\"glacier:ListJobs\",\"Resource\":\"arn:aws:glacier:us-east-1:111122223333:vaults/example_vault\"},{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::444455556666:root\"},\"Action\":\"glacier:UploadArchive\",\"Resource\":\"arn:aws:glacier:us-east-1:111122223333:vaults/example_vault\"}]}"
}
}
```
+ Para obtener más información sobre la API, consulte [GetVaultAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-vault-access-policy.html)la *Referencia de AWS CLI comandos*.
### `get-vault-lock`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-vault-lock`.
**AWS CLI**
**Para obtener los detalles de un bloque de almacén**
En el siguiente ejemplo de `get-vault-lock`, se recuperan los detalles sobre el almacén especificado.
```
aws glacier get-vault-lock \
--account-id - \
--vault-name MyVaultName
```
Salida:
```
{
"Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"Define-vault-lock\",\"Effect\":\"Deny\",\"Principal\":{\"AWS\":\"arn:aws:iam::999999999999:root\"},\"Action\":\"glacier:DeleteArchive\",\"Resource\":\"arn:aws:glacier:us-west-2:99999999999:vaults/MyVaultName\",\"Condition\":{\"NumericLessThanEquals\":{\"glacier:ArchiveAgeinDays\":\"365\"}}}]}",
"State": "Locked",
"CreationDate": "2019-07-29T22:25:28.640Z"
}
```
Para obtener más información, consulte [Get Vault Lock (GET lock-policy)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-GetVaultLock.html) en la *Guía para desarrolladores de la API de Amazon Glacier*.
+ Para obtener más información sobre la API, consulte [GetVaultLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-vault-lock.html)la *Referencia de AWS CLI comandos*.
### `get-vault-notifications`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-vault-notifications`.
**AWS CLI**
El siguiente comando obtiene una descripción de la configuración de notificaciones de un almacén denominado `my-vault`:
```
aws glacier get-vault-notifications --account-id - --vault-name my-vault
```
Salida:
```
{
"vaultNotificationConfig": {
"Events": [
"InventoryRetrievalCompleted",
"ArchiveRetrievalCompleted"
],
"SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-vault"
}
}
```
Si no se ha configurado ninguna notificación para el almacén, se devuelve un error. Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.
+ Para obtener más información sobre la API, consulte [GetVaultNotifications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-vault-notifications.html)la *Referencia de AWS CLI comandos*.
### `initiate-job`
En el siguiente ejemplo de código, se muestra cómo utilizar `initiate-job`.
**AWS CLI**
El siguiente comando inicia un trabajo para obtener un inventario del almacén `my-vault`:
```
aws glacier initiate-job --account-id - --vault-name my-vault --job-parameters '{"Type": "inventory-retrieval"}'
```
Salida:
```
{
"location": "/0123456789012/vaults/my-vault/jobs/zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW",
"jobId": "zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW"
}
```
Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.
El siguiente comando inicia un trabajo para recuperar un archivo del almacén `my-vault`:
```
aws glacier initiate-job --account-id - --vault-name my-vault --job-parameters file://job-archive-retrieval.json
```
`job-archive-retrieval.json` es un archivo JSON de la carpeta local que especifica el tipo de trabajo, el ID del archivo y algunos parámetros opcionales:
```
{
"Type": "archive-retrieval",
"ArchiveId": "kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw",
"Description": "Retrieve archive on 2015-07-17",
"SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-topic"
}
```
IDs Los archivos están disponibles en la salida de `aws glacier upload-archive` y`aws glacier get-job-output`.
Salida:
```
{
"location": "/011685312445/vaults/mwunderl/jobs/l7IL5-EkXyEY9Ws95fClzIbk2O5uLYaFdAYOi-azsX_Z8V6NH4yERHzars8wTKYQMX6nBDI9cMNHzyZJO59-8N9aHWav",
"jobId": "l7IL5-EkXy2O5uLYaFdAYOiEY9Ws95fClzIbk-azsX_Z8V6NH4yERHzars8wTKYQMX6nBDI9cMNHzyZJO59-8N9aHWav"
}
```
Consulte Initiate Job en la *referencia de la API de Amazon Glacier* para obtener más información sobre el formato de los parámetros del trabajo.
+ Para obtener más información sobre la API, consulte [InitiateJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/initiate-job.html)la *Referencia de AWS CLI comandos*.
### `initiate-multipart-upload`
En el siguiente ejemplo de código, se muestra cómo utilizar `initiate-multipart-upload`.
**AWS CLI**
El siguiente comando inicia una carga multiparte en un almacén llamado `my-vault` con un tamaño de parte de 1 MiB (1024 x 1024 bytes) por archivo:
```
aws glacier initiate-multipart-upload --account-id - --part-size 1048576 --vault-name my-vault --archive-description "multipart upload test"
```
El parámetro de descripción del archivo es opcional. Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.
Este comando genera un ID de carga si se realiza correctamente. Use el ID de carga al cargar cada parte de su archivo con `aws glacier upload-multipart-part`. Para obtener más información sobre las cargas de varias partes a Amazon Glacier mediante la AWS CLI, consulte Uso de Amazon Glacier en la Guía *del usuario de AWS CLI*.
+ Para obtener más información sobre la API, consulte la Referencia [InitiateMultipartUpload](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/initiate-multipart-upload.html)de *AWS CLI comandos*.
### `initiate-vault-lock`
En el siguiente ejemplo de código, se muestra cómo utilizar `initiate-vault-lock`.
**AWS CLI**
**Para iniciar el proceso de bloqueo de almacenes**
En el siguiente ejemplo de `initiate-vault-lock`, se instala una política de bloqueo de almacenes en el almacén especificado y se establece el estado de bloqueo del almacén en `InProgress`. Llame a `complete-vault-lock` en un plazo de 24 horas para completar el proceso con el fin de establecer el estado del bloqueo de almacén en `Locked`.
```
aws glacier initiate-vault-lock \
--account-id - \
--vault-name MyVaultName \
--policy file://vault_lock_policy.json
```
Contenido de `vault_lock_policy.json`:
```
{"Policy":"{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"Define-vault-lock\",\"Effect\":\"Deny\",\"Principal\":{\"AWS\":\"arn:aws:iam::999999999999:root\"},\"Action\":\"glacier:DeleteArchive\",\"Resource\":\"arn:aws:glacier:us-west-2:999999999999:vaults/examplevault\",\"Condition\":{\"NumericLessThanEquals\":{\"glacier:ArchiveAgeinDays\":\"365\"}}}]}"}
```
La salida es el ID de bloqueo de almacén que puede utilizar para completar el proceso de bloqueo de almacenes.
```
{
"lockId": "9QZgEXAMPLEPhvL6xEXAMPLE"
}
```
Para obtener más información, consulte [Initiate Vault Lock (POST lock-policy)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-InitiateVaultLock.html) en la *Guía para desarrolladores de la API de Amazon Glacier*.
+ Para obtener más información sobre la API, consulte [InitiateVaultLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/initiate-vault-lock.html)la *Referencia de AWS CLI comandos*.
### `list-jobs`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-jobs`.
**AWS CLI**
El siguiente comando muestra los trabajos en curso y los que se han completado recientemente para un almacén denominado `my-vault`:
```
aws glacier list-jobs --account-id - --vault-name my-vault
```
Salida:
```
{
"JobList": [
{
"VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault",
"RetrievalByteRange": "0-3145727",
"SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-vault",
"Completed": false,
"SHA256TreeHash": "9628195fcdbcbbe76cdde932d4646fa7de5f219fb39823836d81f0cc0e18aa67",
"JobId": "l7IL5-EkXyEY9Ws95fClzIbk2O5uLYaFdAYOi-azsX_Z8V6NH4yERHzars8wTKYQMX6nBDI9cMNHzyZJO59-8N9aHWav",
"ArchiveId": "kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw",
"JobDescription": "Retrieve archive on 2015-07-17",
"ArchiveSizeInBytes": 3145728,
"Action": "ArchiveRetrieval",
"ArchiveSHA256TreeHash": "9628195fcdbcbbe76cdde932d4646fa7de5f219fb39823836d81f0cc0e18aa67",
"CreationDate": "2015-07-17T21:16:13.840Z",
"StatusCode": "InProgress"
},
{
"InventoryRetrievalParameters": {
"Format": "JSON"
},
"VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault",
"Completed": false,
"JobId": "zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW",
"Action": "InventoryRetrieval",
"CreationDate": "2015-07-17T20:23:41.616Z",
"StatusCode": ""InProgress""
}
]
}
```
Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.
+ Para obtener más información sobre la API, consulte [ListJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-jobs.html)la *Referencia de AWS CLI comandos*.
### `list-multipart-uploads`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-multipart-uploads`.
**AWS CLI**
El siguiente comando muestra todas las cargas multiparte en curso para un almacén llamado `my-vault`.
```
aws glacier list-multipart-uploads --account-id - --vault-name my-vault
```
Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.
Para obtener más información sobre las cargas de varias partes a Amazon Glacier mediante la AWS CLI, consulte Uso de Amazon Glacier en la Guía *del usuario de AWS CLI*.
+ Para obtener más información sobre la API, consulte la Referencia [ListMultipartUploads](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-multipart-uploads.html)de *AWS CLI comandos*.
### `list-parts`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-parts`.
**AWS CLI**
El siguiente comando muestra las partes cargadas para una carga multiparte a un almacén llamado `my-vault`.
```
aws glacier list-parts --account-id - --vault-name my-vault --upload-id "SYZi7qnL-YGqGwAm8Kn3BLP2ElNCvnB-5961R09CSaPmPwkYGHOqeN_nX3-Vhnd2yF0KfB5FkmbnBU9GubbdrCs8ut-D"
```
Salida:
```
{
"MultipartUploadId": "SYZi7qnL-YGqGwAm8Kn3BLP2ElNCvnB-5961R09CSaPmPwkYGHOqeN_nX3-Vhnd2yF0KfB5FkmbnBU9GubbdrCs8ut-D",
"Parts": [
{
"RangeInBytes": "0-1048575",
"SHA256TreeHash": "e1f2a7cd6e047350f69b9f8cfa60fa606fe2f02802097a9a026360a7edc1f553"
},
{
"RangeInBytes": "1048576-2097151",
"SHA256TreeHash": "43cf3061fb95796aed99a11a6aa3cd8f839eed15e655ab0a597126210636aee6"
}
],
"VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault",
"CreationDate": "2015-07-18T00:05:23.830Z",
"PartSizeInBytes": 1048576
}
```
Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.
Para obtener más información sobre las cargas de varias partes a Amazon Glacier mediante la AWS CLI, consulte Uso de Amazon Glacier en la Guía *del usuario de AWS CLI*.
+ Para obtener más información sobre la API, consulte la Referencia [ListParts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-parts.html)de *AWS CLI comandos*.
### `list-provisioned-capacity`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-provisioned-capacity`.
**AWS CLI**
**Para recuperar las unidades de capacidad aprovisionadas**
En el siguiente ejemplo de `list-provisioned-capacity`, se recuperan detalles de cualquier unidad de capacidad aprovisionada para la cuenta especificada.
```
aws glacier list-provisioned-capacity \
--account-id 111122223333
```
Salida:
```
{
"ProvisionedCapacityList": [
{
"CapacityId": "HpASAuvfRFiVDbOjMfEIcr8K",
"ExpirationDate": "2020-03-18T19:59:24.000Z",
"StartDate": "2020-02-18T19:59:24.912Z"
}
]
}
```
+ Para obtener más información sobre la API, consulte [ListProvisionedCapacity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-provisioned-capacity.html)la *Referencia de AWS CLI comandos*.
### `list-tags-for-vault`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-tags-for-vault`.
**AWS CLI**
El siguiente comando muestra las etiquetas aplicadas a un almacén denominado `my-vault`:
```
aws glacier list-tags-for-vault --account-id - --vault-name my-vault
```
Salida:
```
{
"Tags": {
"date": "july2015",
"id": "1234"
}
}
```
Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.
+ Para obtener más información sobre la API, consulte [ListTagsForVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-tags-for-vault.html)la *Referencia de AWS CLI comandos*.
### `list-vaults`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-vaults`.
**AWS CLI**
El siguiente comando muestra los almacenes de la cuenta y región predeterminadas:
```
aws glacier list-vaults --account-id -
```
Salida:
```
{
"VaultList": [
{
"SizeInBytes": 3178496,
"VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault",
"LastInventoryDate": "2015-04-07T00:26:19.028Z",
"VaultName": "my-vault",
"NumberOfArchives": 1,
"CreationDate": "2015-04-06T21:23:45.708Z"
}
]
}
```
Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.
+ Para obtener más información sobre la API, consulte [ListVaults](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-vaults.html)la *Referencia de AWS CLI comandos*.
### `purchase-provisioned-capacity`
En el siguiente ejemplo de código, se muestra cómo utilizar `purchase-provisioned-capacity`.
**AWS CLI**
**Para comprar una unidad de capacidad aprovisionada**
En el siguiente ejemplo de `purchase-provisioned-capacity`, se compra una unidad de capacidad aprovisionada.
```
aws glacier purchase-provisioned-capacity \
--account-id 111122223333
```
Salida:
```
{
"capacityId": "HpASAuvfRFiVDbOjMfEIcr8K"
}
```
+ Para obtener más información sobre la API, consulte [PurchaseProvisionedCapacity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/purchase-provisioned-capacity.html)la *Referencia de AWS CLI comandos*.
### `remove-tags-from-vault`
En el siguiente ejemplo de código, se muestra cómo utilizar `remove-tags-from-vault`.
**AWS CLI**
El siguiente comando elimina una etiqueta con la clave `date` de un almacén llamado `my-vault`.
```
aws glacier remove-tags-from-vault --account-id - --vault-name my-vault --tag-keys date
```
Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.
+ Para obtener más información sobre la API, consulte [RemoveTagsFromVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/remove-tags-from-vault.html)la *Referencia de AWS CLI comandos*.
### `set-data-retrieval-policy`
En el siguiente ejemplo de código, se muestra cómo utilizar `set-data-retrieval-policy`.
**AWS CLI**
El siguiente comando configura una política de recuperación de datos para la cuenta en uso:
```
aws glacier set-data-retrieval-policy --account-id - --policy file://data-retrieval-policy.json
```
`data-retrieval-policy.json` es un archivo JSON en la carpeta actual que especifica una política de recuperación de datos:
```
{
"Rules":[
{
"Strategy":"BytesPerHour",
"BytesPerHour":10737418240
}
]
}
```
Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.
El siguiente comando establece la política de recuperación de datos para que `FreeTier` utilice JSON en línea:
```
aws glacier set-data-retrieval-policy --account-id - --policy '{"Rules":[{"Strategy":"FreeTier"}]}'
```
Consulte Configuración de la política de recuperación de datos en la *Referencia de la API de Amazon Glacier* para obtener más información sobre el formato de la política.
+ Para obtener más información sobre la API, consulte [SetDataRetrievalPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/set-data-retrieval-policy.html)la *Referencia de AWS CLI comandos*.
### `set-vault-access-policy`
En el siguiente ejemplo de código, se muestra cómo utilizar `set-vault-access-policy`.
**AWS CLI**
**Para establecer la política de acceso de un almacén**
En el siguiente ejemplo de `set-vault-access-policy`, se asocia una política de permisos al almacén especificado.
```
aws glacier set-vault-access-policy \
--account-id 111122223333 \
--vault-name example_vault
--policy '{"Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::444455556666:root\"},\"Action\":\"glacier:ListJobs\",\"Resource\":\"arn:aws:glacier:us-east-1:111122223333:vaults/example_vault\"},{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::444455556666:root\"},\"Action\":\"glacier:UploadArchive\",\"Resource\":\"arn:aws:glacier:us-east-1:111122223333:vaults/example_vault\"}]}"}'
```
Este comando no genera ninguna salida.
+ Para obtener más información sobre la API, consulte [SetVaultAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/set-vault-access-policy.html)la *Referencia de AWS CLI comandos*.
### `set-vault-notifications`
En el siguiente ejemplo de código, se muestra cómo utilizar `set-vault-notifications`.
**AWS CLI**
El siguiente comando configura las notificaciones de SNS para un almacén denominado `my-vault`:
```
aws glacier set-vault-notifications --account-id - --vault-name my-vault --vault-notification-config file://notificationconfig.json
```
`notificationconfig.json` es un archivo JSON de la carpeta actual que especifica un tema de SNS y los eventos que se van a publicar:
```
{
"SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-vault",
"Events": ["ArchiveRetrievalCompleted", "InventoryRetrievalCompleted"]
}
```
Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.
+ Para obtener más información sobre la API, consulte [SetVaultNotifications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/set-vault-notifications.html)la *Referencia de AWS CLI comandos*.
### `upload-archive`
En el siguiente ejemplo de código, se muestra cómo utilizar `upload-archive`.
**AWS CLI**
El siguiente comando carga un archivo de la carpeta actual denominado `archive.zip` en un almacén denominado `my-vault`:
```
aws glacier upload-archive --account-id - --vault-name my-vault --body archive.zip
```
Salida:
```
{
"archiveId": "kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw",
"checksum": "969fb39823836d81f0cc028195fcdbcbbe76cdde932d4646fa7de5f21e18aa67",
"location": "/0123456789012/vaults/my-vault/archives/kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw"
}
```
Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.
Para recuperar un archivo cargado, inicie un trabajo de recuperación con el comando aws glacier initiate-job.
+ Para obtener más información sobre la API, consulte [UploadArchive](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/upload-archive.html)la *Referencia de AWS CLI comandos*.
### `upload-multipart-part`
En el siguiente ejemplo de código, se muestra cómo utilizar `upload-multipart-part`.
**AWS CLI**
El siguiente comando carga la primera parte de 1 MiB (1024 x 1024 bytes) de un archivo:
```
aws glacier upload-multipart-part --body part1 --range 'bytes 0-1048575/*' --account-id - --vault-name my-vault --upload-id 19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ
```
Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.
El parámetro body toma una ruta a un archivo de parte del sistema de archivos local. El parámetro range toma un rango de contenido HTTP que indica los bytes que ocupa la parte en el archivo completado. El comando `aws glacier initiate-multipart-upload` devuelve el ID de carga y también se puede obtener mediante `aws glacier list-multipart-uploads`.
Para obtener más información sobre las cargas de varias partes a Amazon Glacier mediante la AWS CLI, consulte Uso de Amazon Glacier en la Guía *del usuario de AWS CLI*.
+ Para obtener más información sobre la API, consulte la Referencia [UploadMultipartPart](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/upload-multipart-part.html)de *AWS CLI comandos*.