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

Se você estiver procurando por soluções de armazenamento de arquivos, recomendamos usar as classes de armazenamento Amazon 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 as classes de armazenamento do Amazon Glacier.

O Amazon Glacier (serviço autônomo original baseado em cofre) não aceitará mais novos clientes a partir de 15 de dezembro de 2025, sem impacto para os clientes existentes. O Amazon Glacier é um serviço independente APIs que armazena dados em cofres e é diferente das classes de armazenamento Amazon S3 e Amazon S3 Glacier. Seus dados existentes permanecerão seguros e acessíveis no Amazon Glacier indefinidamente. Nenhuma migração é necessária. Para armazenamento de arquivamento de baixo custo e longo prazo, AWS recomenda as classes de armazenamento Amazon S3 Glacier, que oferecem uma experiência superior ao cliente com APIs base em buckets S3, disponibilidade Região da AWS total, custos mais baixos e integração de serviços. AWS Se você quiser recursos aprimorados, considere migrar para as classes de armazenamento do Amazon S3 Glacier usando AWS nossa orientação de soluções para transferir dados dos cofres do Amazon Glacier para as classes de armazenamento do Amazon S3 Glacier.

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á.

Definir configuração de notificação de cofre (PUT notification-configuration)

Descrição

Recuperar um arquivo e um inventário do cofre são operações assíncronas no Amazon Glacier (Amazon Glacier) para as quais você deve primeiro iniciar um trabalho e aguardar a conclusão do trabalho antes de fazer o download da saída do trabalho. Você pode configurar um cofre para publicar uma mensagem em um tópico do Amazon Simple Notification Service (Amazon SNS) quando esses trabalhos forem concluídos. Você pode usar essa operação para definir a configuração de notificação no cofre. Para obter mais informações, consulte Configurando notificações do Vault no Amazon Glacier.

Para configurar notificações de cofre, envie uma solicitação PUT para o sub-recurso notification-configuration do cofre. Uma configuração de notificação é específica de um cofre; por isso, ela também é conhecida como um sub-recurso de cofre. A solicitação deve incluir um documento JSON que forneça um tópico do Amazon Simple Notification Service (Amazon SNS) e os eventos para os quais você deseja que o Amazon Glacier envie notificações sobre o tópico.

Você pode configurar um cofre a fim de publicar uma notificação para os seguintes eventos de cofre:

Os tópicos do Amazon SNS devem conceder permissão ao cofre para poder publicar notificações no tópico.

Solicitações

Para definir a configuração de notificação no cofre, envie uma solicitação PUT para o URI do sub-recurso notification-configuration do cofre. Você especifica a configuração no corpo da solicitação. A configuração inclui o nome do tópico do Amazon SNS e um conjunto de eventos que disparam uma notificação para cada tópico.

Sintaxe

PUT /AccountId/vaults/VaultName/notification-configuration HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
x-amz-glacier-version: 2012-06-01

{
   "SNSTopic": String,
   "Events":[String, ...] 
}

Parâmetros da 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

O JSON no corpo da solicitação contém os campos a seguir.

Respostas

Em resposta, o Amazon Glacier (Amazon Glacier) 204 No Content retorna se a configuração da notificação for aceita.

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 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 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 Glacier, consulte. Respostas de erro

Exemplos

O exemplo a seguir demonstra como configurar uma notificação de cofre.

Exemplo de solicitação

A solicitação a seguir define a configuração de notificação examplevault, de maneira que notificações para dois eventos (ArchiveRetrievalCompleted e InventoryRetrievalCompleted) são enviadas para o tópico arn:aws:sns:us-west-2:012345678901:mytopic do Amazon SNS.

PUT /-/vaults/examplevault/notification-policy 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

{ 
   "Events": ["ArchiveRetrievalCompleted", "InventoryRetrievalCompleted"],
   "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic"       
}

Exemplo de resposta

Uma resposta bem-sucedida retorna um 204 No Content.

HTTP/1.1 204 No Content
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT

Seções relacionadas

Consulte também

Para obter mais informações sobre o uso dessa API em uma das linguagens específicas da Amazon SDKs, consulte o seguinte: