Excluindo um cofre no Amazon S3 Glacier usando AWS Command Line Interface - Amazon S3 Glacier
(Pré-requisito) Configurar a AWS CLIExemplo: como excluir um cofre vazio usando a AWS CLIExemplo: como excluir um cofre não vazio usando a AWS CLI

Esta página é somente para clientes existentes do serviço S3 Glacier que usam o Vaults e a API REST original de 2012.

Se você estiver procurando por soluções de armazenamento de arquivamento, sugerimos usar as classes de armazenamento S3 Glacier no Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval e S3 Glacier Deep Archive. Para saber mais sobre essas opções de armazenamento, consulte Classes de armazenamento S3 Glacier e Armazenamento de dados de longo prazo usando classes de armazenamento S3 Glacier no Guia do usuário do Amazon S3. Essas classes de armazenamento usam a API do Amazon S3, estão disponíveis em todas as regiões e podem ser gerenciadas no console do Amazon S3. Eles oferecem recursos como análise de custos de armazenamento, lente de armazenamento, recursos de segurança, incluindo várias opções de criptografia e muito mais.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Excluindo um cofre no Amazon S3 Glacier usando AWS Command Line Interface

É possível excluir cofres vazios e não vazios no Amazon S3 Glacier (S3 Glacier) usando AWS Command Line Interface (AWS CLI).

(Pré-requisito) Configurar a AWS CLI

  1. Faça download e configure a AWS CLI. Para obter instruções, consulte os seguintes tópicos no Manual do usuário do AWS Command Line Interface:

    Instalar o AWS Command Line Interface

    Configurar a AWS Command Line Interface

  2. Verifique a configuração AWS CLI digitando os comandos a seguir no prompt de comando. Esses comandos não fornecem as credenciais explicitamente, de modo que as credenciais do perfil padrão são usadas.

    • Tente usar o comando de ajuda.

      aws help

    • Para obter uma lista dos cofres do S3 Glacier na conta configurada, use o comando list-vaults. Substitua 123456789012 pelo ID Conta da AWS.

      aws glacier list-vaults --account-id 123456789012

    • Para obter a configuração atual de dados para AWS CLI, use o comando aws configure list.

      aws configure list

Exemplo: como excluir um cofre vazio usando a AWS CLI

  • Use o comando delete-vault para excluir um cofre que não contém arquivamentos.

    • aws glacier delete-vault --vault-name awsexamplevault --account-id 111122223333

Exemplo: como excluir um cofre não vazio usando a AWS CLI

O S3 Glacier excluirá um cofre somente se não houve arquivamentos nem gravações nesse cofre desde o último inventário computado. Excluir um cofre não vazio é um processo de três etapas: recuperar IDs de arquivamento do relatório de inventário de um cofre, excluir cada arquivamento e excluir o cofre.

  1. Use o comando initiate-job para iniciar um trabalho de recuperação de inventário.

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

    Saída esperada:

    
{
    "location": "/111122223333/vaults/awsexamplevault/jobs/*** jobid ***", 
    "jobId": "*** jobid ***"
}

  2. Use o comando describe-job para verificar o status do trabalho de recuperação anterior.

    aws glacier describe-job --vault-name awsexamplevault --account-id 111122223333 --job-id *** jobid ***

    Saída esperada:

    
{
    "InventoryRetrievalParameters": {
        "Format": "JSON"
    }, 
    "VaultARN": "*** vault arn ***", 
    "Completed": false, 
    "JobId": "*** jobid ***", 
    "Action": "InventoryRetrieval", 
    "CreationDate": "*** job creation date ***", 
    "StatusCode": "InProgress"
}

  3. Aguarde a conclusão do trabalho.

    Você deve aguardar até a saída do trabalho estar pronta para download. Se você definiu uma configuração de notificação no cofre ou especificou um tópico do Amazon Simple Notification Service (Amazon SNS) ao iniciar o trabalho, o S3 Glacier envia uma mensagem para o tópico depois de concluir o trabalho.

    É possível definir a configuração de notificação para eventos específicos no cofre. Para obter mais informações, consulte Configurar notificações de cofre no Amazon S3 Glacier. O S3 Glacier enviará uma mensagem para o tópico do SNS especificado sempre que o evento determinado ocorrer.

  4. Quando estiver concluído, use o comando get-job-output para fazer download do trabalho de recuperação para o arquivo output.json.

    aws glacier get-job-output --vault-name awsexamplevault --account-id 111122223333 --job-id *** jobid *** output.json

    Esse comando produz um arquivo com os campos a seguir.

    
{
"VaultARN":"arn:aws:glacier:region:111122223333:vaults/awsexamplevault",
"InventoryDate":"*** job completion date ***",
"ArchiveList":[
{"ArchiveId":"*** archiveid ***",
"ArchiveDescription":*** archive description (if set) ***,
"CreationDate":"*** archive creation date ***",
"Size":"*** archive size (in bytes) ***",
"SHA256TreeHash":"*** archive hash ***"
}
{"ArchiveId":
...
]}

  5. Use o comando delete-archive para excluir cada arquivamento de um cofre até que não haja mais nenhum.

    aws glacier delete-archive --vault-name awsexamplevault --account-id 111122223333 --archive-id="*** archiveid ***"
    nota

    Se o seu ID de arquivo começar com um hífen ou outro caractere especial, você precisará colocá-lo entre aspas para executar esse comando.

  6. Use o comando initiate-job para iniciar um novo trabalho de recuperação de inventário.

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

  7. Quando estiver concluído, use o comando delete-vault para excluir um cofre sem arquivamentos.

    aws glacier delete-vault --vault-name awsexamplevault --account-id 111122223333