Exemplos de S3 Glacier usando o AWS CLI - AWS Command Line Interface

Esta documentação é somente para a versão 1 da AWS CLI. Para obter a documentação relacionada à AWS CLI versão 2, consulte o Guia do usuário da versão 2.

Exemplos de S3 Glacier usando o AWS CLI

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com o S3 Glacier.

Ações são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.

Tópicos

Ações

O código de exemplo a seguir mostra como usar abort-multipart-upload.

AWS CLI

O comando a seguir exclui um upload de várias partes em andamento para um cofre chamado my-vault:

aws glacier abort-multipart-upload --account-id - --vault-name my-vault --upload-id 19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ

Esse comando não produz nenhuma saída. O Amazon Glacier exige um argumento de ID de conta ao realizar operações, mas você pode usar um hífen para especificar a conta em uso. O ID de upload é retornado pelo comando aws glacier initiate-multipart-upload e também pode ser coletado usando aws glacier list-multipart-uploads.

Para ter mais informações sobre uploads fracionados no Amazon Glacier usando a AWS CLI, consulte Using Amazon Glacier no Guia do usuário da AWS CLI.

O código de exemplo a seguir mostra como usar abort-vault-lock.

AWS CLI

Abortar um processo de trava de cofre em andamento

O exemplo abort-vault-lock de a seguir exclui uma política de trava de cofre do cofre específico e redefine o status de bloqueio do cofre para desbloqueado.

aws glacier abort-vault-lock \ --account-id - \ --vault-name MyVaultName

Este comando não produz saída.

Para obter mais informações, consulte Abort Vault Lock (DELETE lock-policy) no Guia do desenvolvedor do Amazon Glacier.

  • Para mais detalhes sobre a API, consulte AbortVaultLock na AWS CLI Referência de comando.

O código de exemplo a seguir mostra como usar add-tags-to-vault.

AWS CLI

O seguinte comando adiciona duas tags ao cofre my-vault:

aws glacier add-tags-to-vault --account-id - --vault-name my-vault --tags id=1234,date=july2015

O Amazon Glacier exige um argumento de ID de conta ao realizar operações, mas você pode usar um hífen para especificar a conta em uso.

  • Para obter detalhes da API, consulte AddTagsToVault na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar complete-multipart-upload.

AWS CLI

O comando a seguir conclui o upload de várias partes para um arquivo 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

O Amazon Glacier exige um argumento de ID de conta ao realizar operações, mas você pode usar um hífen para especificar a conta em uso.

O ID de upload é retornado pelo comando aws glacier initiate-multipart-upload e também pode ser coletado usando aws glacier list-multipart-uploads. O parâmetro de soma de verificação usa um hash de árvore SHA-256 do arquivo em hexadecimal.

Para obter mais informações sobre uploads de várias partes para o Amazon Glacier usando AWS CLI, incluindo instruções sobre como calcular um hash de árvore, consulte Uso do Amazon Glacier no AWS Guia do Usuário de CLI.

O código de exemplo a seguir mostra como usar complete-vault-lock.

AWS CLI

Concluir um processo de trava de cofre em andamento

O exemplo complete-vault-lock a seguir conclui o bloqueio em andamento do cofre específico e define o estado do bloqueio do cofre como Locked. Obtém-se o valor do parâmetro lock-id quando se executa initiate-lock-process.

aws glacier complete-vault-lock \ --account-id - \ --vault-name MyVaultName \ --lock-id 9QZgEXAMPLEPhvL6xEXAMPLE

Este comando não produz saída.

Para obter mais informações, consulte Concluir o bloqueio do cofre (POST lockId) no Guia do Desenvolvedor de API do Amazon Glacier.

  • Para ver detalhes da API, consulte CompleteVaultLock na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar create-vault.

AWS CLI

O seguinte comando cria um cofre chamado my-vault:

aws glacier create-vault --vault-name my-vault --account-id -

O Amazon Glacier exige um argumento de ID de conta ao realizar operações, mas você pode usar um hífen para especificar a conta em uso.

  • Para obter detalhes da API, consulte CreateVault na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar delete-archive.

AWS CLI

Como excluir um arquivo de um cofre

O exemplo de delete-archive a seguir remove o arquivamento especificado de example_vault.

aws glacier delete-archive \ --account-id 111122223333 \ --vault-name example_vault \ --archive-id Sc0u9ZP8yaWkmh-XGlIvAVprtLhaLCGnNwNl5I5x9HqPIkX5mjc0DrId3Ln-Gi_k2HzmlIDZUz117KSdVMdMXLuFWi9PJUitxWO73edQ43eTlMWkH0pd9zVSAuV_XXZBVhKhyGhJ7w

Este comando não produz saída.

  • Para obter detalhes da API, consulte DeleteArchive na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar delete-vault-access-policy.

AWS CLI

Remover a política de acesso de um cofre

O exemplo delete-vault-access-policy a seguir remove a política de acesso do cofre específico.

aws glacier delete-vault-access-policy \ --account-id 111122223333 \ --vault-name example_vault

Este comando não produz saída.

O código de exemplo a seguir mostra como usar delete-vault-notifications.

AWS CLI

Como remover as notificações do SNS de um cofre

O comando de delete-vault-notifications a seguir remove as notificações enviadas pelo Amazon Simple Notification Service (Amazon SNS) do cofre especificado.

aws glacier delete-vault-notifications \ --account-id 111122223333 \ --vault-name example_vault

Este comando não produz saída.

O código de exemplo a seguir mostra como usar delete-vault.

AWS CLI

O seguinte comando cria um cofre chamado my-vault:

aws glacier delete-vault --vault-name my-vault --account-id -

Esse comando não produz nenhuma saída. O Amazon Glacier exige um argumento de ID de conta ao realizar operações, mas você pode usar um hífen para especificar a conta em uso.

  • Para obter detalhes da API, consulte DeleteVault na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar describe-job.

AWS CLI

O seguinte comando recupera informações sobre um trabalho de recuperação de inventário no cofre my-vault:

aws glacier describe-job --account-id - --vault-name my-vault --job-id zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW

Saída:

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

O ID do trabalho pode ser encontrado na saída de aws glacier initiate-job e aws glacier list-jobs. O Amazon Glacier exige um argumento de ID de conta ao realizar operações, mas você pode usar um hífen para especificar a conta em uso.

  • Para obter detalhes da API, consulte DescribeJob na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar describe-vault.

AWS CLI

O seguinte comando recupera dados sobre o cofre my-vault:

aws glacier describe-vault --vault-name my-vault --account-id -

O Amazon Glacier exige um argumento de ID de conta ao realizar operações, mas você pode usar um hífen para especificar a conta em uso.

  • Para obter detalhes da API, consulte DescribeVault na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar get-data-retrieval-policy.

AWS CLI

O comando a seguir obtém a política de recuperação de dados para a conta em uso:

aws glacier get-data-retrieval-policy --account-id -

Saída:

{ "Policy": { "Rules": [ { "BytesPerHour": 10737418240, "Strategy": "BytesPerHour" } ] } }

O Amazon Glacier exige um argumento de ID de conta ao realizar operações, mas você pode usar um hífen para especificar a conta em uso.

O código de exemplo a seguir mostra como usar get-job-output.

AWS CLI

O seguinte comando salva a saída de um trabalho de inventário do cofre em um arquivo no diretório atual chamado output.json:

aws glacier get-job-output --account-id - --vault-name my-vault --job-id zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW output.json

O job-id está disponível na saída de aws glacier list-jobs. Observe que o nome do arquivo de saída é um argumento posicional que não é prefixado por um nome de opção. O Amazon Glacier exige um argumento de ID de conta ao realizar operações, mas você pode usar um hífen para especificar a conta em uso.

Saída:

{ "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 obter detalhes da API, consulte GetJobOutput na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar get-vault-access-policy.

AWS CLI

Recuperar a política de acesso de um cofre

O exemplo get-vault-access-policy a seguir recupera a política de acesso para o cofre específico.

aws glacier get-vault-access-policy \ --account-id 111122223333 \ --vault-name example_vault

Saída:

{ "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\"}]}" } }

O código de exemplo a seguir mostra como usar get-vault-lock.

AWS CLI

Obter detalhes de uma trava de cofre

O exemplo get-vault-lock a seguir recuperou os detalhes sobre a trava do cofre específico.

aws glacier get-vault-lock \ --account-id - \ --vault-name MyVaultName

Saída:

{ "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 obter mais informações, consulte Obter Trava do Cofre (GET lock-policy) no Guia do desenvolvedor da API do Amazon Glacier.

  • Para ver detalhes da API, consulte GetVaultLock na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar get-vault-notifications.

AWS CLI

O seguinte comando captura uma descrição da configuração de notificação do cofre my-vault:

aws glacier get-vault-notifications --account-id - --vault-name my-vault

Saída:

{ "vaultNotificationConfig": { "Events": [ "InventoryRetrievalCompleted", "ArchiveRetrievalCompleted" ], "SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-vault" } }

Se nenhuma notificação tiver sido configurada para o cofre, será retornado um erro. O Amazon Glacier exige um argumento de ID de conta ao realizar operações, mas você pode usar um hífen para especificar a conta em uso.

O código de exemplo a seguir mostra como usar initiate-job.

AWS CLI

O comando a seguir inicia um trabalho para obter um inventário de cofre my-vault:

aws glacier initiate-job --account-id - --vault-name my-vault --job-parameters '{"Type": "inventory-retrieval"}'

Saída:

{ "location": "/0123456789012/vaults/my-vault/jobs/zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW", "jobId": "zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW" }

O Amazon Glacier exige um argumento de ID de conta ao realizar operações, mas você pode usar um hífen para especificar a conta em uso.

O comando a seguir inicia um trabalho para recuperar um arquivo do cofre my-vault:

aws glacier initiate-job --account-id - --vault-name my-vault --job-parameters file://job-archive-retrieval.json

job-archive-retrieval.json é um arquivo JSON na pasta local que especifica o tipo de trabalho, a ID do arquivo e alguns parâmetros opcionais:

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

As IDs de arquivo estão disponíveis na saída de aws glacier upload-archive e aws glacier get-job-output.

Saída:

{ "location": "/011685312445/vaults/mwunderl/jobs/l7IL5-EkXyEY9Ws95fClzIbk2O5uLYaFdAYOi-azsX_Z8V6NH4yERHzars8wTKYQMX6nBDI9cMNHzyZJO59-8N9aHWav", "jobId": "l7IL5-EkXy2O5uLYaFdAYOiEY9Ws95fClzIbk-azsX_Z8V6NH4yERHzars8wTKYQMX6nBDI9cMNHzyZJO59-8N9aHWav" }

Consulte Iniciar Tarefa na Referência de API do Amazon Glacier para obter detalhes sobre o formato dos parâmetros da tarefa.

  • Para ver detalhes da API, consulte InitiateJob na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar initiate-multipart-upload.

AWS CLI

O comando a seguir inicia um upload de várias partes para um cofre chamado my-vault com uma parte de 1 MiB (1024 x 1024 bytes) por arquivo:

aws glacier initiate-multipart-upload --account-id - --part-size 1048576 --vault-name my-vault --archive-description "multipart upload test"

O parâmetro de descrição do arquivo é opcional. O Amazon Glacier exige um argumento de ID de conta ao realizar operações, mas você pode usar um hífen para especificar a conta em uso.

Esse comando gera uma ID de upload quando bem-sucedido. Use a ID de upload ao fazer o upload de cada parte de seu arquivo com aws glacier upload-multipart-part. Para ter mais informações sobre uploads fracionados no Amazon Glacier usando a AWS CLI, consulte Using Amazon Glacier no Guia do usuário da AWS CLI.

O código de exemplo a seguir mostra como usar initiate-vault-lock.

AWS CLI

Iniciar o processo de travamento do cofre

O exemplo initiate-vault-lock a seguir instala uma política de trava de cofre no cofre específico e define o estado de trava do cofre como InProgress. É preciso concluir o processo chamando complete-vault-lock dentro de 24 horas para definir o estado da trava do cofre como Locked.

aws glacier initiate-vault-lock \ --account-id - \ --vault-name MyVaultName \ --policy file://vault_lock_policy.json

Conteúdo 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\"}}}]}"}

A saída é a ID de trava do cofre que pode ser usada para concluir o processo de trava do cofre.

{ "lockId": "9QZgEXAMPLEPhvL6xEXAMPLE" }

Para maiores informações, consulte Iniciar Bloqueio do Cofre (POST lock-policy) no Guia do Desenvolvedor de API do Amazon Glacier.

  • Para ver detalhes da API, consulte InitiateVaultLock na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar list-jobs.

AWS CLI

O seguinte comando lista trabalhos em andamento e concluídos recentemente no cofre my-vault:

aws glacier list-jobs --account-id - --vault-name my-vault

Saída:

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

O Amazon Glacier exige um argumento de ID de conta ao realizar operações, mas você pode usar um hífen para especificar a conta em uso.

  • Para obter detalhes da API, consulte ListJobs na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar list-multipart-uploads.

AWS CLI

O comando a seguir mostra todos os uploads de várias partes em andamento para um cofre chamado my-vault:

aws glacier list-multipart-uploads --account-id - --vault-name my-vault

O Amazon Glacier exige um argumento de ID de conta ao realizar operações, mas você pode usar um hífen para especificar a conta em uso.

Para ter mais informações sobre uploads fracionados no Amazon Glacier usando a AWS CLI, consulte Using Amazon Glacier no Guia do usuário da AWS CLI.

O código de exemplo a seguir mostra como usar list-parts.

AWS CLI

O comando a seguir lista as partes transferidas para um upload de várias partes em um cofre chamado my-vault:

aws glacier list-parts --account-id - --vault-name my-vault --upload-id "SYZi7qnL-YGqGwAm8Kn3BLP2ElNCvnB-5961R09CSaPmPwkYGHOqeN_nX3-Vhnd2yF0KfB5FkmbnBU9GubbdrCs8ut-D"

Saída:

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

O Amazon Glacier exige um argumento de ID de conta ao realizar operações, mas você pode usar um hífen para especificar a conta em uso.

Para ter mais informações sobre uploads fracionados no Amazon Glacier usando a AWS CLI, consulte Using Amazon Glacier no Guia do usuário da AWS CLI.

  • Para ver detalhes da API, consulte ListParts na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar list-provisioned-capacity.

AWS CLI

Recuperar as unidades de capacidade provisionadas

O exemplo list-provisioned-capacity a seguir recupera detalhes de qualquer unidade de capacidade provisionada para a conta específica.

aws glacier list-provisioned-capacity \ --account-id 111122223333

Saída:

{ "ProvisionedCapacityList": [ { "CapacityId": "HpASAuvfRFiVDbOjMfEIcr8K", "ExpirationDate": "2020-03-18T19:59:24.000Z", "StartDate": "2020-02-18T19:59:24.912Z" } ] }

O código de exemplo a seguir mostra como usar list-tags-for-vault.

AWS CLI

O seguinte comando lista as tags aplicadas ao cofre my-vault:

aws glacier list-tags-for-vault --account-id - --vault-name my-vault

Saída:

{ "Tags": { "date": "july2015", "id": "1234" } }

O Amazon Glacier exige um argumento de ID de conta ao realizar operações, mas você pode usar um hífen para especificar a conta em uso.

  • Para obter detalhes da API, consulte ListTagsForVault na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar list-vaults.

AWS CLI

O seguinte comando lista os cofres na conta e na região padrão:

aws glacier list-vaults --account-id -

Saída:

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

O Amazon Glacier exige um argumento de ID de conta ao realizar operações, mas você pode usar um hífen para especificar a conta em uso.

  • Para obter detalhes da API, consulte ListVaults na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar purchase-provisioned-capacity.

AWS CLI

Comprar uma unidade de capacidade provisionada

O exemplo purchase-provisioned-capacity a seguir compra uma unidade de capacidade provisionada.

aws glacier purchase-provisioned-capacity \ --account-id 111122223333

Saída:

{ "capacityId": "HpASAuvfRFiVDbOjMfEIcr8K" }

O código de exemplo a seguir mostra como usar remove-tags-from-vault.

AWS CLI

O comando a seguir remove uma tag com a chave date de um cofre chamado my-vault:

aws glacier remove-tags-from-vault --account-id - --vault-name my-vault --tag-keys date

O Amazon Glacier exige um argumento de ID de conta ao realizar operações, mas você pode usar um hífen para especificar a conta em uso.

  • Para ver detalhes da API, consulte RemoveTagsFromVault na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar set-data-retrieval-policy.

AWS CLI

O comando a seguir configura uma política de recuperação de dados para a conta em uso:

aws glacier set-data-retrieval-policy --account-id - --policy file://data-retrieval-policy.json

data-retrieval-policy.json é um arquivo JSON na pasta atual que especifica uma política de recuperação de dados:

{ "Rules":[ { "Strategy":"BytesPerHour", "BytesPerHour":10737418240 } ] }

O Amazon Glacier exige um argumento de ID de conta ao realizar operações, mas você pode usar um hífen para especificar a conta em uso.

O comando a seguir define a política de recuperação de dados para FreeTier a partir de um JSON embutido:

aws glacier set-data-retrieval-policy --account-id - --policy '{"Rules":[{"Strategy":"FreeTier"}]}'

Consulte Definir Política de Recuperação de Dados na Referência de API do Amazon Glacier para obter detalhes sobre o padrão da política.

O código de exemplo a seguir mostra como usar set-vault-access-policy.

AWS CLI

Definir a política de acesso de um cofre

O exemplo set-vault-access-policy a seguir anexa uma política de permissão ao cofre específico.

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 não produz saída.

O código de exemplo a seguir mostra como usar set-vault-notifications.

AWS CLI

O seguinte comando configura as notificações do SNS para o cofre my-vault:

aws glacier set-vault-notifications --account-id - --vault-name my-vault --vault-notification-config file://notificationconfig.json

notificationconfig.json é um arquivo JSON na pasta atual que especifica um tópico do SNS e os eventos a serem publicados:

{ "SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-vault", "Events": ["ArchiveRetrievalCompleted", "InventoryRetrievalCompleted"] }

O Amazon Glacier exige um argumento de ID de conta ao realizar operações, mas você pode usar um hífen para especificar a conta em uso.

O código de exemplo a seguir mostra como usar upload-archive.

AWS CLI

O seguinte comando faz upload um arquivo na pasta atual com o nome archive.zip para um cofre chamado my-vault:

aws glacier upload-archive --account-id - --vault-name my-vault --body archive.zip

Saída:

{ "archiveId": "kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw", "checksum": "969fb39823836d81f0cc028195fcdbcbbe76cdde932d4646fa7de5f21e18aa67", "location": "/0123456789012/vaults/my-vault/archives/kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw" }

O Amazon Glacier exige um argumento de ID de conta ao realizar operações, mas você pode usar um hífen para especificar a conta em uso.

Para recuperar um arquivamento carregado, inicie um trabalho de recuperação com o comando aws glacier initiate-job.

  • Para obter detalhes da API, consulte UploadArchive na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar upload-multipart-part.

AWS CLI

O comando a seguir carrega a primeira parte de 1 MiB (1024 x 1024 bytes) de um arquivamento:

aws glacier upload-multipart-part --body part1 --range 'bytes 0-1048575/*' --account-id - --vault-name my-vault --upload-id 19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ

O Amazon Glacier exige um argumento de ID de conta ao realizar operações, mas você pode usar um hífen para especificar a conta em uso.

O parâmetro de corpo segue um caminho para um arquivo da parte no sistema de arquivos local. O parâmetro de intervalo usa um intervalo de conteúdo HTTP indicando os bytes que a peça ocupa no arquivamento concluído. O ID de upload é retornado pelo comando aws glacier initiate-multipart-upload e também pode ser coletado usando aws glacier list-multipart-uploads.

Para ter mais informações sobre uploads fracionados no Amazon Glacier usando a AWS CLI, consulte Using Amazon Glacier no Guia do usuário da AWS CLI.

  • Para obter detalhes da API, consulte UploadMultipartPart na Referência de comandos da AWS CLI.