# Exemplos do Amazon 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 Amazon 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.
**Topics**
+ [Ações](#actions)
## Ações
### `abort-multipart-upload`
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*.
+ Consulte detalhes da API em [AbortMultipartUpload](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/abort-multipart-upload.html) na *Referência de comandos da AWS CLI*.
### `abort-vault-lock`
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)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-AbortVaultLock.html) no *Guia do desenvolvedor do Amazon Glacier*.
+ Para mais detalhes sobre a API, consulte [AbortVaultLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/abort-vault-lock.html) na *AWS CLI Referência de comando*.
### `add-tags-to-vault`
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.
+ Consulte detalhes da API em [AddTagsToVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/add-tags-to-vault.html) na *Referência de comandos da AWS CLI*.
### `complete-multipart-upload`
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*.
+ Consulte detalhes da API em [CompleteMultipartUpload](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/complete-multipart-upload.html) na *Referência de comandos da AWS CLI*.
### `complete-vault-lock`
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)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-CompleteVaultLock.html) no *Guia do Desenvolvedor de API do Amazon Glacier*.
+ Para ver detalhes da API, consulte [CompleteVaultLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/complete-vault-lock.html) na *Referência de comandos da AWS CLI*.
### `create-vault`
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.
+ Consulte detalhes da API em [CreateVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/create-vault.html) na *Referência de comandos da AWS CLI*.
### `delete-archive`
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.
+ Consulte detalhes da API em [DeleteArchive](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-archive.html) na *Referência de comandos da AWS CLI*.
### `delete-vault-access-policy`
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.
+ Para ver detalhes da API, consulte [DeleteVaultAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-vault-access-policy.html) na *Referência de comandos da AWS CLI*.
### `delete-vault-notifications`
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.
+ Consulte detalhes da API em [DeleteVaultNotifications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-vault-notifications.html) na *Referência de comandos da AWS CLI*.
### `delete-vault`
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.
+ Consulte detalhes da API em [DeleteVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/delete-vault.html) na *Referência de comandos da AWS CLI*.
### `describe-job`
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
```
Resultado:
```
{
"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.
+ Consulte detalhes da API em [DescribeJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/describe-job.html) na *Referência de comandos da AWS CLI*.
### `describe-vault`
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.
+ Consulte detalhes da API em [DescribeVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/describe-vault.html) na *Referência de comandos da AWS CLI*.
### `get-data-retrieval-policy`
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 -
```
Resultado:
```
{
"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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-data-retrieval-policy.html) na *Referência de comandos da AWS CLI*.
### `get-job-output`
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.
Resultado:
```
{
"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"}]}
```
+ Consulte detalhes da API em [GetJobOutput](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-job-output.html) na *Referência de comandos da AWS CLI*.
### `get-vault-access-policy`
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
```
Resultado:
```
{
"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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-vault-access-policy.html) na *Referência de comandos da AWS CLI*.
### `get-vault-lock`
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
```
Resultado:
```
{
"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)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-GetVaultLock.html) no Guia do desenvolvedor da API do *Amazon Glacier*.
+ Para ver detalhes da API, consulte [GetVaultLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-vault-lock.html) na *Referência de comandos da AWS CLI*.
### `get-vault-notifications`
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
```
Resultado:
```
{
"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.
+ Consulte detalhes da API em [GetVaultNotifications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/get-vault-notifications.html) na *Referência de comandos da AWS CLI*.
### `initiate-job`
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"}'
```
Resultado:
```
{
"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`.
Resultado:
```
{
"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 ver detalhes sobre o formato dos parâmetros da tarefa.
+ Para ver detalhes da API, consulte [InitiateJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/initiate-job.html) na *Referência de comandos da AWS CLI*.
### `initiate-multipart-upload`
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*.
+ Para ver detalhes da API, consulte [InitiateMultipartUpload](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/initiate-multipart-upload.html) na *Referência de comandos da AWS CLI*.
### `initiate-vault-lock`
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)](https://docs.aws.amazon.com/amazonglacier/latest/dev/api-InitiateVaultLock.html) no *Guia do Desenvolvedor de API do Amazon Glacier*.
+ Para ver detalhes da API, consulte [InitiateVaultLock](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/initiate-vault-lock.html) na *Referência de comandos da AWS CLI*.
### `list-jobs`
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
```
Resultado:
```
{
"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.
+ Consulte detalhes da API em [ListJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-jobs.html) na *Referência de comandos da AWS CLI*.
### `list-multipart-uploads`
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*.
+ Consulte detalhes da API em [ListMultipartUploads](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-multipart-uploads.html) na *Referência de comandos da AWS CLI*.
### `list-parts`
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"
```
Resultado:
```
{
"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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-parts.html) na *Referência de comandos da AWS CLI*.
### `list-provisioned-capacity`
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
```
Resultado:
```
{
"ProvisionedCapacityList": [
{
"CapacityId": "HpASAuvfRFiVDbOjMfEIcr8K",
"ExpirationDate": "2020-03-18T19:59:24.000Z",
"StartDate": "2020-02-18T19:59:24.912Z"
}
]
}
```
+ Para ver detalhes da API, consulte [ListProvisionedCapacity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-provisioned-capacity.html) na *Referência de comandos da AWS CLI*.
### `list-tags-for-vault`
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
```
Resultado:
```
{
"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.
+ Consulte detalhes da API em [ListTagsForVault](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-tags-for-vault.html) na *Referência de comandos da AWS CLI*.
### `list-vaults`
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 -
```
Resultado:
```
{
"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.
+ Consulte detalhes da API em [ListVaults](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/list-vaults.html) na *Referência de comandos da AWS CLI*.
### `purchase-provisioned-capacity`
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
```
Resultado:
```
{
"capacityId": "HpASAuvfRFiVDbOjMfEIcr8K"
}
```
+ Para ver detalhes da API, consulte [PurchaseProvisionedCapacity](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/purchase-provisioned-capacity.html) na *Referência de comandos da AWS CLI*.
### `remove-tags-from-vault`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/remove-tags-from-vault.html) na *Referência de comandos da AWS CLI*.
### `set-data-retrieval-policy`
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.
+ Para obter detalhes sobre a API, consulte [SetDataRetrievalPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/set-data-retrieval-policy.html) na *Referência de comandos da AWS CLI*.
### `set-vault-access-policy`
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.
+ Para obter detalhes sobre a API, consulte [SetVaultAccessPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/set-vault-access-policy.html) na *AWS CLI Referência de comando*.
### `set-vault-notifications`
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.
+ Consulte detalhes da API em [SetVaultNotifications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/set-vault-notifications.html) na *Referência de comandos da AWS CLI*.
### `upload-archive`
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
```
Resultado:
```
{
"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.
+ Consulte detalhes da API em [UploadArchive](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/upload-archive.html) na *Referência de comandos da AWS CLI*.
### `upload-multipart-part`
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*.
+ Consulte detalhes da API em [UploadMultipartPart](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/glacier/upload-multipart-part.html) na *Referência de comandos da AWS CLI*.