Set Vault Notification Configuration (PUT notification-configuration)

Descrizione

In in Amazon S3 Glacier (S3 Glacier), il recupero di un archivio e di un inventario vault sono operazioni asincrone per le quali devi prima avviare un processo e quindi attenderne il completamento prima di poter eseguire il download dell'output. Puoi quindi configurare un 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 di vault in Amazon S3 Glacier.

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 fornisce un argomento di Amazon Simple Notification Service (Amazon SNS) e gli eventi per i quali S3 Glacier deve inviare 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)). 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).

• InventoryRetrievalCompleted – Questo evento si verifica al completamento di un processo avviato per il recupero di un inventario (Initiate Job (POST jobs)). 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).

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

Richieste

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

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, ...] 
}

Nota

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

Parametri della richiesta

Questa operazione non utilizza parametri richiesta.

Intestazioni di richiesta

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.

Corpo della richiesta

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

Eventi

Una matrice di uno o più eventi per i quali S3 Glacier deve inviare una notifica.

Valori validi: ArchiveRetrievalCompleted | InventoryRetrievalCompleted

Obbligatorio: sì

Tipo: matrice

SNSTopic

L'ARN dell'argomento Amazon SNS. Per ulteriori informazioni, consulta Nozioni di base su Amazon SNS nella Guida per gli sviluppatori di Amazon Simple Notification Service.

Obbligatorio: sì

Tipo: stringa

Risposte

In risposta, Amazon S3 Glacier (S3 Glacier) restituisce 204 No Content se la configurazione delle notifiche è accettata.

Sintassi

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

Intestazioni di risposta

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.

Corpo della risposta

Questa operazione non restituisce un corpo della risposta.

Errori

Per informazioni sulle eccezioni e i messaggi di errore di Amazon S3 Glacier, consulta Risposte agli errori.

Esempi

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

Richiesta di esempio

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.

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"       
}

Risposta di esempio

Una risposta corretta restituisce 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

Sezioni correlate

• Get Vault Notifications (GET notification-configuration)

• Delete Vault Notifications (DELETE notification-configuration)

• Identity and Access Management per Amazon S3 Glacier

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli Amazon SDK specifici del linguaggio, consulta quanto segue:

• AWS Command Line Interface