Ejemplos de S3 Glacier que utilizan la AWS CLI - AWS Command Line Interface

Esta documentación es para la versión 1 de AWS CLI. Para obtener documentación relacionada con la versión 2 de AWS CLI, consulte la Guía del usuario de la versión 2.

Ejemplos de S3 Glacier que utilizan la AWS CLI

En el siguiente ejemplo de código se muestra cómo realizar acciones e implementar escenarios comunes usando AWS Command Line Interface con S3 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.

Acciones

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 CLI de AWS, consulte Uso de Amazon Glacier en la Guía del usuario de la CLI de AWS.

  • Para obtener información sobre la API, consulte AbortMultipartUploads en la Referencia de comandos de la AWS CLI.

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) en la Guía para desarrolladores de API de Amazon Glacier.

  • Para obtener más información sobre la API, consulte AbortVaultLock en la Referencia de comandos de la AWS CLI.

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 información sobre la API, consulte AddTagsToVault en la Referencia de comandos de la AWS CLI.

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 CLI de AWS, como las instrucciones sobre el cálculo de un hash en árbol, consulte Uso de Amazon Glacier en la Guía del usuario de la CLI de AWS.

  • Para obtener información sobre la API, consulte CompleteMultipartUpload en la Referencia de comandos de la AWS CLI.

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) en la Guía para desarrolladores de la API de Amazon Glacier.

  • Para obtener información sobre la API, consulte CompleteVaultLock en la Referencia de comandos de la AWS CLI.

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 información sobre la API, consulte CreateVault en la Referencia de comandos de la AWS CLI.

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 información sobre la API, consulte DeleteArchive en la Referencia de comandos de la AWS CLI.

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 información sobre la API, consulte DeleteVaultAccessPolicy en la Referencia de comandos de la AWS CLI.

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.

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 información sobre la API, consulte DeleteVault en la Referencia de comandos de la AWS CLI.

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 información sobre la API, consulte DescribeJob en la Referencia de comandos de AWS CLI.

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 información de la API, consulte DescribeVault en la Referencia de comandos de AWS CLI.

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 información sobre la APl, consulte GetDataRetrievalPolicy en la Referencia de comandos de la AWS CLI.

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 información sobre la API, consulte GetJobOutput en la Referencia de comandos de la AWS CLI.

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 información sobre la API, consulte GetVaultAccessPolicy en la Referencia de comandos de la AWS CLI.

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) en la Guía para desarrolladores de la API de Amazon Glacier.

  • Para obtener información sobre la API, consulte GetVaultLock en la Referencia de comandos de la AWS CLI.

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 información sobre la API, consulte GetVaultNotifications en la Referencia de comandos de la AWS CLI.

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" }

Los ID de archivo 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 información sobre la API, consulte InitiateJob en Referencia de comandos de la AWS CLI.

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 CLI de AWS, consulte Uso de Amazon Glacier en la Guía del usuario de la CLI de AWS.

  • Para obtener información sobre la API, consulte InitiateMultipartUpload en la Referencia de comandos de la AWS CLI.

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) en la Guía para desarrolladores de la API de Amazon Glacier.

  • Para obtener detalles de la API, consulte InitiateVaultLock en la Referencia de comandos de la AWS CLI.

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 información sobre la API, consulte ListJobs en la Referencia de comandos de la AWS CLI.

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 CLI de AWS, consulte Uso de Amazon Glacier en la Guía del usuario de la CLI de AWS.

  • Para obtener información sobre la API, consulte ListMultipartUploads en la Referencia de comandos de la AWS CLI.

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 CLI de AWS, consulte Uso de Amazon Glacier en la Guía del usuario de la CLI de AWS.

  • Para obtener información sobre la API, consulte ListParts en la Referencia de comandos de la AWS CLI.

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 información sobre la API, consulte ListProvisionedCapacity en la Referencia de comandos de la AWS CLI.

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 información sobre la API, consulte ListTagsForVault en la Referencia de comandos de la AWS CLI.

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 información sobre la API, consulte ListVaults en la Referencia de comandos de la AWS CLI.

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" }

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 información sobre la API, consulte RemoveTagsFromVault en la Referencia de comandos de la AWS CLI.

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 información sobre la API, consulte SetDataRetrievalPolicy en la Referencia de comandos de la AWS CLI.

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 información sobre la API, consulte SetVaultAccessPolicy en la Referencia de comandos de la AWS CLI.

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 información sobre la API, consulte SetVaultNotifications en la Referencia de comandos de la AWS CLI.

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 información sobre la API, consulte UploadArchive en la Referencia de comandos de la AWS CLI.

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 CLI de AWS, consulte Uso de Amazon Glacier en la Guía del usuario de la CLI de AWS.

  • Para obtener información sobre la API, consulte UploadMultipartPart en Referencia de comandos de la AWS CLI.