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.
Temas
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-namemy-vault
--upload-id19gaRezEXAMPLES6Ry5YYdqthHOC_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 medianteaws 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-nameMyVaultName
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-namemy-vault
--tagsid=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
--checksum9628195fcdbcbbe76cdde456d4646fa7de5f219fb39823836d81f0cc0e18aa67
--upload-id19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ
-
-account-id - --vault-namemy-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 medianteaws 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 enLocked
. Obtiene el valor del parámetrolock-id
al ejecutarinitiate-lock-process
.aws glacier complete
-
vault-lock \ --account-id - \ --vault-nameMyVaultName
\ --lock-id9QZgEXAMPLEPhvL6xEXAMPLE
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 deexample_vault
.aws glacier delete-archive \ --account-id
111122223333
\ --vault-nameexample_vault
\ --archive-idSc0u9ZP8yaWkmh-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-nameexample_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-nameexample_vault
Este comando no genera ninguna salida.
-
Para obtener información sobre la API, consulte DeleteVaultNotifications
en la Referencia de comandos de la AWS CLI.
-
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-namemy-vault
--job-idzbxcm3Z_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
yaws 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-namemy-vault
--job-idzbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW
output.json
El
job-id
está disponible en la salida deaws 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-nameexample_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-nameMyVaultName
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-namemy-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-namemy-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-namemy-vault
--job-parametersfile://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
yaws 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-size1048576
--vault-namemy-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 enInProgress
. Llame acomplete-vault-lock
en un plazo de 24 horas para completar el proceso con el fin de establecer el estado del bloqueo de almacén enLocked
.aws glacier initiate
-
vault-lock \ --account-id - \ --vault-nameMyVaultName
\ --policyfile://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-namemy-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-namemy-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-namemy-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-namemy-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" }
-
Para obtener información sobre la API, consulte PurchaseProvisionedCapacity
en la Referencia de comandos de la AWS CLI.
-
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 llamadomy-vault
.aws glacier remove
-
tags-from-vault --account-id - --vault-namemy-vault
--tag-keysdate
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 - --policyfile://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-nameexample_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-namemy-vault
--vault-notification-configfile://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 denominadomy-vault
:aws glacier upload
-
archive --account-id - --vault-namemy-vault
--bodyarchive.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-namemy-vault
--upload-id19gaRezEXAMPLES6Ry5YYdqthHOC_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 medianteaws 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.
-