Get Vault Notifications (GET notification-configuration) - Amazon S3 Glacier
DescrizioneRichiesteRisposteEsempiSezioni correlateVedi anche

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

Se stai cercando soluzioni di archiviazione, ti consigliamo di utilizzare le classi di storage S3 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 S3 Glacier e lo storage dei dati a lungo termine con le classi di storage S3 Glacier nella Amazon S3 User Guide. Queste classi di storage utilizzano Amazon S3API, sono disponibili in tutte le regioni e possono essere gestite all'interno della console Amazon S3. Offrono funzionalità come Storage Cost Analysis, Storage Lens, funzionalità di crittografia opzionali avanzate e altro ancora.

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

Get Vault Notifications (GET notification-configuration)

Descrizione

Questa operazione recupera la sottorisorsa notification-configuration impostata nel vault (vedi Set Vault Notification Configuration (PUT notification-configuration)). Se la configurazione delle notifiche per un vault non è impostata, l'operazione restituisce un errore 404 Not Found. Per ulteriori informazioni sulle notifiche di vault, consulta Configurazione delle notifiche di vault in Amazon S3 Glacier.

Richieste

Per recuperare le informazioni sulla configurazione delle notifiche, invia una richiesta GET all'URI della sottorisorsa notification-configuration di un vault.

Sintassi

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

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

Questa operazione non ha un corpo della richiesta.

Risposte

Sintassi

HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: length
{
  "Events": [
    String,
    ...
  ],
  "SNSTopic": String
}

Intestazioni di risposta

Questa operazione utilizza solo le intestazioni di risposta che sono comuni alla maggior parte delle risposte. Per informazioni sulle intestazioni di risposta comuni, consulta Intestazioni di risposta comuni.

Corpo della risposta

Il corpo della risposta contiene i campi JSON descritti di seguito.

Eventi

Un elenco di uno o più eventi per i quali Amazon S3 Glacier (S3 Glacier) invierà una notifica all'argomento di Amazon SNS specificato. Per informazioni sugli eventi di vault per i quali è possibile configurare la pubblicazione di notifiche in un vault, consulta Set Vault Notification Configuration (PUT notification-configuration).

Tipo: matrice

SNSTopic

Il nome della risorsa Amazon (ARN) dell'argomento Amazon Simple Notification Service (Amazon SNS). Per ulteriori informazioni, consulta Nozioni di base su Amazon SNS nella Guida per gli sviluppatori di Amazon Simple Notification Service.

Tipo: stringa

Errori

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

Esempi

L'esempio seguente mostra come recuperare la configurazione delle notifiche per un vault.

Richiesta di esempio

In questo esempio, una richiesta GET è inviata alla sottorisorsa notification-configuration di un vault.

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

Risposta di esempio

In una risposta corretta, il documento di configurazione della registrazione di controllo nel corpo della risposta è in formato JSON. In questo esempio, la configurazione mostra che le notifiche per due eventi (ArchiveRetrievalCompleted e InventoryRetrievalCompleted) sono inviate all'argomento arn:aws:sns:us-west-2:012345678901:mytopic di Amazon SNS.

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

Vedi anche

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