**Esta página destina-se somente a clientes atuais do serviço Amazon Glacier que usam cofres e a API REST original de 2012.**

Se você estiver procurando soluções de armazenamento de arquivos do Amazon Glacier, recomendamos usar as classes de armazenamento do 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 do Amazon Glacier](https://aws.amazon.com/s3/storage-classes/glacier/).

O Amazon Glacier (serviço autônomo original baseado em cofre) não está mais aceitando novos clientes. 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](https://aws.amazon.com/s3/storage-classes/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 nossas [Orientações de soluções da AWS para transferir dados dos cofres do Amazon Glacier para as classes de armazenamento do Amazon S3 Glacier](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/).

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)
<a name="api-vault-notifications-get"></a>

## Description
<a name="api-vault-notifications-get-description"></a>

Essa operação recupera o sub-recurso `notification-configuration` definido no cofre (consulte [Definir configuração de notificação de cofre (PUT notification-configuration)](api-vault-notifications-put.md). 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 do cofre no Amazon Glacier](configuring-notifications.md). 

## Solicitações
<a name="api-vault-notifications-get-requests"></a>

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
<a name="api-vault-notifications-get-requests-syntax"></a>

```
1. GET /AccountId/vaults/VaultName/notification-configuration HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. x-amz-glacier-version: 2012-06-01
```

 

**nota**  
O `AccountId` valor é o Conta da AWS ID da conta proprietária do cofre. Você pode especificar um Conta da AWS ID ou, opcionalmente, um único '`-`' (hífen). Nesse caso, o Amazon Glacier usa Conta da AWS o ID 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 da solicitação
<a name="api-vault-notifications-get-requests-parameters"></a>

Essa operação não usa parâmetros de solicitação.

### Cabeçalhos de solicitação
<a name="api-vault-notifications-get-requests-headers"></a>

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](api-common-request-headers.md).

### Corpo da Solicitação
<a name="api-vault-notifications-get-requests-elements"></a>

Essa operação não tem um corpo de solicitação.

## Respostas
<a name="api-vault-notifications-get-responses"></a>

### Sintaxe
<a name="api-vault-notifications-get-responses-syntax"></a>

```
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
<a name="api-vault-notifications-get-responses-headers"></a>

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](api-common-response-headers.md).

### Corpo da resposta
<a name="api-vault-notifications-get-responses-elements"></a>

O corpo da resposta contém os seguintes campos JSON.

 

**Eventos**  
Uma lista de um ou mais eventos para os quais o Amazon Glacier enviará uma notificação ao tópico do Amazon SNS 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)](api-vault-notifications-put.md).  
*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](https://docs.aws.amazon.com/sns/latest/gsg/Welcome.html) no *Guia de conceitos básicos do Amazon Simple Notification Service*.  
*Tipo:* string

### Erros
<a name="api-vault-notifications-get-responses-errors"></a>

Para obter informações sobre exceções e mensagens de erro do Amazon Glacier, consulte [Respostas de erro](api-error-responses.md).

## Exemplos
<a name="api-vault-notifications-get-examples"></a>

O exemplo a seguir demonstra como recuperar a configuração de notificação de um cofre.

### Exemplo de solicitação
<a name="api-vault-notifications-get-example-request"></a>

Neste exemplo, uma solicitação `GET` é enviada para o sub-recurso `notification-configuration` de um cofre.

```
1. GET /-/vaults/examplevault/notification-configuration HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. 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
<a name="api-vault-notifications-get-example-response"></a>

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

```
 1. HTTP/1.1 200 OK
 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
 3. Date: Wed, 10 Feb 2017 12:00:00 GMT
 4. Content-Type: application/json
 5. Content-Length: 150
 6.   
 7. {
 8.   "Events": [
 9.     "ArchiveRetrievalCompleted",
10.     "InventoryRetrievalCompleted"
11.   ],
12.   "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic"
13. }
```

## Seções relacionadas
<a name="related-sections-vault-notifications-get"></a>

 
+ [Delete Vault Notifications (DELETE notification-configuration)](api-vault-notifications-delete.md)
+ [Definir configuração de notificação de cofre (PUT notification-configuration)](api-vault-notifications-put.md)
+ [Gerenciamento de identidade e acesso para o Amazon Glacier](security-iam.md)

## Consulte também
<a name="api-vault-notifications-get_SeeAlso"></a>

Para obter mais informações sobre o uso dessa API em uma das linguagens específicas da Amazon SDKs, consulte o seguinte:
+  [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/get-vault-notifications.html)