Get Data Retrieval Policy (GET policy) - Amazon S3 Glacier
DescrizioneRichiesteRisposteEsempiSezioni correlate

Questa pagina è riservata ai clienti esistenti del servizio S3 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 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 l'API Amazon S3, 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 sicurezza tra cui diverse opzioni di crittografia 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 Data Retrieval Policy (GET policy)

Descrizione

Questa operazione restituisce la policy sul recupero dati corrente per l'Account AWS e la regione AWS specificati nella richiesta GET. Per ulteriori informazioni sulle policy sul recupero dati, consulta Policy sul recupero dati di S3 Glacier.

Richieste

Per restituire la policy di recupero dati corrente, invia una richiesta HTTP GET all'URI della policy di recupero dati come illustrato nell'esempio di sintassi seguente.

Sintassi

GET /AccountId/policies/data-retrieval HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
x-amz-glacier-version: 2012-06-01

Nota

Il valore di AccountId è l'ID dell'Account AWS. Questo valore deve corrispondere all'ID dell'Account AWS associato alle credenziali utilizzate per firmare la richiesta. 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 specifichi l'ID del tuo account, non devi includere trattini ("-") 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
{
  "Policy":
    {
      "Rules":[
         {
            "BytesPerHour": Number,
            "Strategy": 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.

BytesPerHour

Il numero massimo di byte che possono essere recuperati in un'ora.

Questo campo è disponibile solo se il valore del campo Strategy è BytesPerHour.

Tipo: numero

Regole

La regola di policy. Sebbene si tratti di un tipo di elenco, deve esserci al momento una sola regola, che contiene un campo Strategy ed eventualmente un campo BytesPerHour.

Tipo: matrice

Strategia

Il tipo di policy di recupero dati.

Tipo: stringa

Valori validi: BytesPerHour|FreeTier|None. BytesPerHour equivale alla selezione di Max Retrieval Rate (Tasso di recupero massimo) nella console. FreeTier equivale alla selezione di Free Tier Only (Solo piano gratuito) nella console. None equivale alla selezione di No Retrieval Policy (Nessuna policy sul recupero) nella console. Per ulteriori informazioni sulla selezione di policy sul recupero dati nella console, consulta Policy sul recupero dati di S3 Glacier.

Errori

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

Esempi

L'esempio seguente mostra come ottenere una policy di recupero dati.

Richiesta di esempio

In questo esempio, una richiesta GET è inviata all'URI della posizione di una policy.

GET /-/policies/data-retrieval 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 la policy di recupero dati è visualizzata nel corpo della risposta in formato JSON. 

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: 85
 
{
  "Policy":
    {
      "Rules":[
         {
           "BytesPerHour":10737418240,
           "Strategy":"BytesPerHour"
          }
       ]
    }
}