List Provisioned Capacity (GET provisioned-capacity) - Amazon S3 Glacier
Sintassi della richiestaParametri della richiestaIntestazioni di richiestaCorpo della richiestaRisposteEsempiSezioni 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à.

List Provisioned Capacity (GET provisioned-capacity)

Questa operazione genera un elenco delle unità di capacità con provisioning per l'Account AWS specificato. Per ulteriori informazioni sulla capacità con provisioning, consultare Opzioni di recupero dall'archivio.

Un'unità di capacità assegnata dura per un mese a partire dalla data e l'ora dell'acquisto, che è la data di inizio. L'unità scade in corrispondenza della data di scadenza, che cade esattamente un mese dopo la data di inizio approssimata al secondo più vicino.

Se la data di inizio è il trentunesimo giorno di un mese, la data di scadenza sarà l'ultimo giorno del mese successivo. Ad esempio, se la data di inizio è il 31 agosto, la data di scadenza sarà il 30 settembre. Se la data di inizio è il 31 gennaio, la data di scadenza sarà il 28 febbraio. Puoi vedere questa funzionalità nella Risposta di esempio.

Sintassi della richiesta

Per elencare la capacità di recupero con provisioning di un account, invia una richiesta HTTP GET all'URI della capacità con provisioning come illustrato nella sintassi di esempio seguente.

GET /AccountId/provisioned-capacity 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

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200 OK.

Sintassi della risposta

HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: Length
{
   "ProvisionedCapacityList": 
      {
         "CapacityId" : "string",
         "StartDate" : "string"
         "ExpirationDate" : "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.

CapacityId

L'ID che identifica l'unità di capacità con provisioning.

Tipo: stringa.

StartDate

La data di acquisto (in formato UTC) dell'unità di capacità con provisioning.

Tipo: stringa. Una rappresentazione di stringa nel formato di data ISO 8601, ad esempio 2013-03-20T17:03:43.221Z.

ExpirationDate

La data di scadenza (in formato UTC) dell'unità di capacità con provisioning.

Tipo: stringa. Una rappresentazione di stringa nel formato di data ISO 8601, ad esempio 2013-03-20T17:03:43.221Z.

Errori

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

Esempi

L'esempio seguente elenca le unità di capacità con provisioning per un account.

Richiesta di esempio

In questo esempio, una richiesta GET viene inviata per recuperare un elenco delle unità di capacità con provisioning per l'account specificato.

GET /123456789012/priority-capacity 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

Se la richiesta ha esito positivo, Amazon S3 Glacier (S3 Glacier) restituisce una risposta HTTP 200 OK con un elenco di unità di capacità con provisioning per l'account come mostrato nell'esempio seguente.

L'unità di capacità assegnata elencata per prima è un esempio di unità con data di inizio al 31 gennaio 2017 e data di scadenza al 28 febbraio 2017. Come indicato in precedenza, se la data di inizio è il trentunesimo giorno di un mese, la data di scadenza sarà l'ultimo giorno del mese successivo.

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:02:00 GMT
Content-Type: application/json
Content-Length: length

{
   "ProvisionedCapacityList",
      {
         "CapacityId": "zSaq7NzHFQDANTfQkDen4V7z",
         "StartDate": "2017-01-31T14:26:33.031Z",
         "ExpirationDate": "2017-02-28T14:26:33.000Z",
      },
      {
         "CapacityId": "yXaq7NzHFQNADTfQkDen4V7z",
         "StartDate": "2016-12-13T20:11:51.095Z"",
         "ExpirationDate": "2017-01-13T20:11:51.000Z" ",
      },
      ...
}