Esta página é somente para clientes existentes do serviço S3 Glacier que usam o Vaults e o original de 2012. REST API
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
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á.
Delete Vault (DELETE vault)
Descrição
Essa operação exclui um cofre. O Amazon S3 Glacier (S3 Glacier) excluirá um cofre somente se não houver arquivos no cofre de acordo com último inventário mais recentemente e não houver gravações no cofre desde o inventário mais recente. Se qualquer uma dessas condições não for atendida, a exclusão do cofre falhará (ou seja, o cofre não será removido) e o S3 Glacier retornará um erro.
Você pode usar a operação Describe Vault (GET vault) que fornece informações do cofre, inclusive o número de arquivos no cofre. No entanto, as informações se baseiam no inventário de cofre gerado pelo S3 Glacier mais recentemente.
Essa operação é idempotente.
nota
Quando você exclui um cofre, a política de acesso ao cofre anexada ao cofre também é excluída. Para obter mais informações sobre políticas de acesso ao cofre, consulte Políticas de acesso ao cofre.
Solicitações
Para excluir um cofre, envie uma solicitação DELETE
para o URI do recurso de cofre.
Sintaxe
DELETE /
AccountId
/vaults/VaultName
HTTP/1.1 Host: glacier.Region
.amazonaws.com Date:Date
Authorization:SignatureValue
x-amz-glacier-version: 2012-06-01
nota
O valor de AccountId
é o ID de Conta da AWS da conta proprietária do cofre. Você pode especificar um ID de Conta da AWS ou, de forma opcional, um '-
' (hífen) único; nesse caso, o Amazon S3 Glacier usa o ID de Conta da AWS associado às credenciais usadas para assinar a solicitação. Se você usar um ID de conta, não inclua nenhum hífen ('-') no ID.
Parâmetros de solicitação
Essa operação não usa parâmetros de solicitação.
Cabeçalhos de solicitação
Essa operação usa somente os cabeçalhos de solicitação que são comuns a todas as operações. Para informações sobre os cabeçalhos de solicitação comuns, consulte Cabeçalhos de solicitação comuns.
Corpo da solicitação
Essa operação não tem um corpo de solicitação.
Respostas
Sintaxe
HTTP/1.1 204 No Content x-amzn-RequestId: x-amzn-RequestId Date: Date
Cabeçalhos de resposta
Essa operação usa somente os cabeçalhos de resposta que são comuns a maioria das respostas. Para informações sobre os cabeçalhos de resposta comuns, consulte Cabeçalhos de resposta comuns.
Corpo da resposta
Essa operação não retorna um corpo de resposta.
Erros
Para obter informações sobre exceções e mensagens de erro do Amazon S3 Glacier, consulte Respostas de erro.
Exemplos
Exemplo de solicitação
O exemplo a seguir exclui um cofre chamado examplevault
. A solicitação de exemplo é uma solicitação DELETE
para o URI do recurso (o cofre) para exclusão.
DELETE /-/vaults/examplevault HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-glacier-version: 2012-06-01 Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
Exemplo de resposta
HTTP/1.1 204 No Content x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:02:00 GMT
Seções relacionadas
Consulte também
Para obter mais informações sobre como usar essa API em um dos Amazon SDKs específicos de linguagem, consulte o seguinte: