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á.
Get Vault Notifications (GET notification-configuration)
Descrição
Essa operação recupera o sub-recurso notification-configuration
definido no cofre (consulte Definir configuração de notificação de cofre (PUT notification-configuration). Se a configuração de notificação de um cofre não estiver definida, a operação retornará um erro 404 Not Found
. Para obter mais informações sobre notificações de cofre, consulte Configurar notificações de cofre no Amazon S3 Glacier.
Solicitações
Para recuperar as informações de configuração de notificação, envie uma solicitação GET
para o URI do sub-recurso notification-configuration
de um cofre.
Sintaxe
GET /
AccountId
/vaults/VaultName
/notification-configuration 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 200 OK x-amzn-RequestId: x-amzn-RequestId Date: Date Content-Type: application/json Content-Length: length { "Events": [ String, ... ], "SNSTopic": String }
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
O corpo da resposta contém os seguintes campos JSON.
- Eventos
-
Uma lista de um ou mais eventos para os quais o Amazon S3 Glacier (S3 Glacier) enviará uma notificação ao tópico do especificado. Para obter mais informações sobre eventos de cofre para os quais você possa configurar um cofre a fim de publicar notificações, consulte Definir configuração de notificação de cofre (PUT notification-configuration).
Tipo: matriz
- SNSTopic
-
O tópico nome do recurso da Amazon (ARN) do Amazon Simple Notification Service (Amazon SNS). Para obter mais informações, consulte Conceitos básicos do Amazon SNS no Guia de conceitos básicos do Amazon Simple Notification Service.
Tipo: string
Erros
Para obter informações sobre exceções e mensagens de erro do Amazon S3 Glacier, consulte Respostas de erro.
Exemplos
O exemplo a seguir demonstra como recuperar a configuração de notificação de um cofre.
Exemplo de solicitação
Neste exemplo, uma solicitação GET
é enviada para o sub-recurso notification-configuration
de um cofre.
GET /-/vaults/examplevault/notification-configuration 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
Uma resposta bem-sucedida mostra o documento de configuração de registro em log da auditoria no corpo da resposta em formato JSON. Neste exemplo, a configuração mostra que as notificações de dois eventos (ArchiveRetrievalCompleted
e InventoryRetrievalCompleted
) são enviadas para o tópico do Amazon SNS arn:aws:sns:us-west-2:012345678901:mytopic
.
HTTP/1.1 200 OK x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:00:00 GMT Content-Type: application/json Content-Length: 150 { "Events": [ "ArchiveRetrievalCompleted", "InventoryRetrievalCompleted" ], "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic" }
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: