**Questa pagina è riservata ai clienti esistenti del servizio Amazon Glacier che utilizzano Vaults e l'API REST originale del 2012.**

Se stai cercando soluzioni di archiviazione, ti consigliamo di utilizzare le classi di storage Amazon Glacier in Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval e S3 Glacier Deep Archive. Per ulteriori informazioni su queste opzioni di storage, consulta le classi di storage di [Amazon Glacier](https://aws.amazon.com/s3/storage-classes/glacier/).

Amazon Glacier (servizio autonomo originale basato su vault) non accetta più nuovi clienti. Amazon Glacier è un servizio APIs autonomo che archivia i dati in vault ed è distinto dalle classi di storage Amazon S3 e Amazon S3 Glacier. I dati esistenti rimarranno sicuri e accessibili in Amazon Glacier a tempo indeterminato. Non è richiesta alcuna migrazione. Per uno storage di archiviazione a lungo termine a basso costo, AWS consiglia le classi di storage [Amazon S3 Glacier](https://aws.amazon.com/s3/storage-classes/glacier/), che offrono un'esperienza cliente superiore con disponibilità Regione AWS completa, costi inferiori e integrazione dei servizi APIs basata su bucket S3. AWS Se desideri funzionalità avanzate, prendi in considerazione la migrazione alle classi di storage Amazon S3 Glacier utilizzando la [AWS nostra Solutions Guidance per il trasferimento di dati dai vault Amazon Glacier alle classi di storage Amazon S3 Glacier](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/).

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Set Vault Notification Configuration (PUT notification-configuration)
<a name="api-vault-notifications-put"></a>

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

Il recupero di un archivio e di un inventario del vault sono operazioni asincrone in Amazon Glacier (Amazon Glacier), per le quali è necessario innanzitutto avviare un processo e attendere il completamento del processo prima di poter scaricare l'output del lavoro. Puoi quindi configurare una vault per pubblicare un messaggio su un argomento di Amazon Simple Notification Service (Amazon SNS) quando i processi sono completati. Questa operazione ti consente di impostare la configurazione delle notifiche per il vault. Per ulteriori informazioni, consulta [Configurazione delle notifiche Vault in Amazon Glacier](configuring-notifications.md). 

Per configurare le notifiche per il vault, invia una richiesta PUT alla sottorisorsa `notification-configuration` del vault. Una configurazione delle notifiche è specifica di un vault, di conseguenza è definita anche sottorisorsa di vault. La richiesta deve includere un documento JSON che fornisca un argomento di Amazon Simple Notification Service (Amazon SNS) e gli eventi per i quali desideri che Amazon Glacier invii notifiche all'argomento.

Puoi configurare un vault affinché pubblichi una notifica per i seguenti eventi di vault:

 
+ **`ArchiveRetrievalCompleted`:** questo evento si verifica al completamento di un processo avviato per il recupero di un archivio ([Initiate Job (POST jobs)](api-initiate-job-post.md)). Lo stato del processo completato può essere `Succeeded` o `Failed`. La notifica inviata all'argomento di SNS è identica all'output restituito da [Describe Job (GET JobID)](api-describe-job-get.md).
+ **`InventoryRetrievalCompleted` – **Questo evento si verifica al completamento di un processo avviato per il recupero di un inventario ([Initiate Job (POST jobs)](api-initiate-job-post.md)). Lo stato del processo completato può essere `Succeeded` o `Failed`. La notifica inviata all'argomento di SNS è identica all'output restituito da [Describe Job (GET JobID)](api-describe-job-get.md).

Gli argomenti di Amazon SNS devono concedere alla vault l'autorizzazione per pubblicare notifiche nell'argomento.

## Richieste
<a name="api-vault-notifications-put-requests"></a>

Per impostare la configurazione delle notifiche per il vault, invia una richiesta PUT all'URI della sottorisorsa `notification-configuration` del vault. La configurazione deve essere specificata nel corpo della richiesta. La configurazione include il nome dell'argomento di Amazon SNS e una matrice di eventi che attivano l'invio della notifica a ogni argomento.

### Sintassi
<a name="api-vault-notifications-put-requests-syntax"></a>

```
 1. PUT /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
 6. 
 7. {
 8.    "SNSTopic": String,
 9.    "Events":[String, ...] 
10. }
```

 

**Nota**  
Il `AccountId` valore è l' Account AWS ID dell'account proprietario del vault. Puoi specificare un Account AWS ID o, facoltativamente, un singolo '`-`' (trattino), nel qual caso Amazon Glacier utilizza Account AWS l'ID associato alle credenziali utilizzate per firmare la richiesta. Se utilizzi un ID account, non includere alcun trattino ("-") nell'ID.

### Parametri della richiesta
<a name="api-vault-notifications-put-requests-parameters"></a>

Questa operazione non utilizza parametri richiesta.

### Intestazioni di richiesta
<a name="api-vault-notifications-put-requests-headers"></a>

Questa operazione utilizza solo le intestazioni richiesta che sono comuni a tutte le operazioni. Per informazioni sulle intestazioni richiesta comuni, consulta [Intestazioni di richiesta comuni](api-common-request-headers.md).

### Corpo della richiesta
<a name="api-vault-notifications-put-requests-elements"></a>

 Il codice JSON nel corpo della richiesta contiene i campi descritti di seguito. 

**Eventi**  
Una serie di uno o più eventi per i quali desideri che Amazon Glacier invii una notifica.  
*Valori validi*: `ArchiveRetrievalCompleted` \$1 `InventoryRetrievalCompleted`   
*Obbligatorio*: sì  
*Tipo*: matrice

**SNSTopic**  
L'ARN dell'argomento Amazon SNS. Per ulteriori informazioni, consulta [Nozioni di base su Amazon SNS](https://docs.aws.amazon.com/sns/latest/gsg/Welcome.html) nella *Guida per gli sviluppatori di Amazon Simple Notification Service*.  
*Obbligatorio*: sì  
▬*Tipo:* stringa

## Risposte
<a name="api-vault-notifications-put-responses"></a>

In risposta, Amazon Glacier (Amazon Glacier) `204 No Content` restituisce se la configurazione di notifica è stata accettata.

### Sintassi
<a name="api-vault-notifications-put-responses-elements"></a>

```
HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
```

### Intestazioni di risposta
<a name="api-vault-notifications-put-responses-headers"></a>

Questa operazione utilizza solo le intestazioni richiesta che sono comuni a tutte le operazioni. Per informazioni sulle intestazioni richiesta comuni, consulta [Intestazioni di richiesta comuni](api-common-request-headers.md).

### Corpo della risposta
<a name="api-vault-notifications-put-responses-body"></a>

Questa operazione non restituisce un corpo della risposta.

### Errori
<a name="api-vault-notifications-put-responses-errors"></a>

Per informazioni sulle eccezioni e sui messaggi di errore di Amazon Glacier, consulta. [Risposte agli errori](api-error-responses.md)

## Esempi
<a name="api-vault-notifications-put-examples"></a>

L'esempio seguente mostra come configurare una notifica di vault.

### Richiesta di esempio
<a name="api-vault-notifications-put-example-request"></a>

La richiesta seguente imposta la configurazione delle notifiche `examplevault` di modo che le notifiche per due eventi (`ArchiveRetrievalCompleted` e `InventoryRetrievalCompleted`) siano inviate all'argomento `arn:aws:sns:us-west-2:012345678901:mytopic` di Amazon SNS.

```
 1. PUT /-/vaults/examplevault/notification-policy 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
 6. 
 7. { 
 8.    "Events": ["ArchiveRetrievalCompleted", "InventoryRetrievalCompleted"],
 9.    "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic"       
10. }
```

### Risposta di esempio
<a name="api-vault-notifications-put-example-response"></a>

Una risposta corretta restituisce `204 No Content`.

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

## Sezioni correlate
<a name="related-sections-vault-notifications-put"></a>

 
+ [Get Vault Notifications (GET notification-configuration)](api-vault-notifications-get.md)
+ [Delete Vault Notifications (DELETE notification-configuration)](api-vault-notifications-delete.md)
+ [Identity and Access Management per Amazon Glacier](security-iam.md)

## Vedi anche
<a name="api-vault-notifications-put_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue SDKs Amazon specifiche per lingua, consulta quanto segue:
+  [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/set-vault-notifications.html)