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-namemy-vault
--upload-id19gaRezEXAMPLES6Ry5YYdqthHOC_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 usandoaws 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 AbortMultipartUpload
na Referência de comandos 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-nameMyVaultName
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-namemy-vault
--tagsid=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
--checksum9628195fcdbcbbe76cdde456d4646fa7de5f219fb39823836d81f0cc0e18aa67
--upload-id19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ
-
-account-id - --vault-namemy-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 usandoaws 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.
-
Para obter detalhes da API, consulte CompleteMultipartUpload
na Referência de comandos da AWS 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 comoLocked
. Obtém-se o valor do parâmetrolock-id
quando se executainitiate-lock-process
.aws glacier complete
-
vault-lock \ --account-id - \ --vault-nameMyVaultName
\ --lock-id9QZgEXAMPLEPhvL6xEXAMPLE
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 deexample_vault
.aws glacier delete-archive \ --account-id
111122223333
\ --vault-nameexample_vault
\ --archive-idSc0u9ZP8yaWkmh-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-nameexample_vault
Este comando não produz saída.
-
Para ver detalhes da API, consulte DeleteVaultAccessPolicy
na Referência de comandos da AWS CLI.
-
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-nameexample_vault
Este comando não produz saída.
-
Para obter detalhes da API, consulte DeleteVaultNotifications
na Referência de comandos da AWS CLI.
-
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-namemy-vault
--job-idzbxcm3Z_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
eaws 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.
-
Para ver detalhes da API, consulte GetDataRetrievalPolicy
na Referência de comandos da AWS CLI.
-
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-namemy-vault
--job-idzbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW
output.json
O
job-id
está disponível na saída deaws 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-nameexample_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\"}]}" } }
-
Para ver detalhes da API, consulte GetVaultAccessPolicy
na Referência de comandos da AWS CLI.
-
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-nameMyVaultName
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-namemy-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.
-
Para obter detalhes da API, consulte GetVaultNotifications
na Referência de comandos da AWS CLI.
-
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-namemy-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-namemy-vault
--job-parametersfile://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
eaws 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-size1048576
--vault-namemy-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.-
Para ver detalhes da API, consulte InitiateMultipartUpload
na Referência de comandos 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 comoInProgress
. É preciso concluir o processo chamandocomplete-vault-lock
dentro de 24 horas para definir o estado da trava do cofre comoLocked
.aws glacier initiate
-
vault-lock \ --account-id - \ --vault-nameMyVaultName
\ --policyfile://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-namemy-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-namemy-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.
-
Para obter detalhes da API, consulte ListMultipartUploads
na Referência de comandos 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-namemy-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" } ] }
-
Para ver detalhes da API, consulte ListProvisionedCapacity
na Referência de comandos da AWS CLI.
-
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-namemy-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" }
-
Para ver detalhes da API, consulte PurchaseProvisionedCapacity
na Referência de comandos da AWS CLI.
-
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 chamadomy-vault
:aws glacier remove
-
tags-from-vault --account-id - --vault-namemy-vault
--tag-keysdate
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 - --policyfile://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.
-
Para obter detalhes sobre a API, consulte SetDataRetrievalPolicy
na Referência de comandos da AWS CLI.
-
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-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 não produz saída.
-
Para obter detalhes sobre a API, consulte SetVaultAccessPolicy
na AWS CLI Referência de comando.
-
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-namemy-vault
--vault-notification-configfile://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.
-
Para obter detalhes da API, consulte SetVaultNotifications
na Referência de comandos da AWS CLI.
-
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 chamadomy-vault
:aws glacier upload
-
archive --account-id - --vault-namemy-vault
--bodyarchive.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-namemy-vault
--upload-id19gaRezEXAMPLES6Ry5YYdqthHOC_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 usandoaws 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.
-