Purchase Provisioned Capacity (POST provisioned-capacity) - Amazon S3 Glacier
RichiesteRisposteEsempiSezioni 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 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à.

Purchase Provisioned Capacity (POST provisioned-capacity)

Questa operazione consente di acquistare un'unità di capacità con provisioning per un Account AWS.

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.

La capacità assegnata assicura che la capacità di recupero per effettuare recuperi di tipo Expedited sia disponibile al bisogno. Ogni unità di capacità garantisce che sia possibile effettuare almeno tre recuperi Expedited ogni cinque minuti e fornisce fino a 150 MB/s di throughput di recupero. Per ulteriori informazioni sulla capacità con provisioning, consultare Opzioni di recupero dall'archivio.

Nota

È previsto un limite di due unità di capacità predisposte per. Account AWS

Richieste

Per acquistare un'unità di capacità assegnata e Account AWS inviare una POST richiesta HTTP all'URI di capacità fornita.

Sintassi

POST /AccountId/provisioned-capacity HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
Content-Length: Length
x-amz-glacier-version: 2012-06-01

Nota

Il AccountId valore è l'ID. Account AWS Questo valore deve corrispondere all' Account AWS ID associato alle credenziali utilizzate per firmare la richiesta. Puoi specificare un Account AWS ID o facoltativamente un singolo '-' (trattino), nel qual caso Amazon S3 Glacier utilizza Account AWS l'ID associato alle credenziali utilizzate per firmare la richiesta. Se specifichi l'ID del tuo account, non devi includere trattini ("-") nell'ID.

Parametri della 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 la richiesta riesce, il servizio restituisce una risposta HTTP 201 Created.

Sintassi

HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
x-amz-capacity-id: CapacityId

Intestazioni di risposta

Una risposta corretta include le seguenti intestazioni di risposta, oltre alle intestazioni di risposta comuni a tutte le operazioni. Per informazioni sulle intestazioni di risposta comuni, consulta Intestazioni di risposta comuni.

Nome Descrizione

x-amz-capacity-id

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

Tipo: stringa

Corpo della risposta

Questa operazione non restituisce un corpo della risposta.

Errori

Questa operazione include l'errore o gli errori seguenti, oltre ai possibili errori comuni a tutte le operazioni di Amazon S3 Glacier. Per informazioni sugli errori di Amazon S3 Glacier e un elenco di codici di errore, consulta Risposte agli errori.

Codice Descrizione Codice di stato HTTP Tipo
LimitExceededException Restituito se la richiesta supera il limite di unità di capacità con provisioning dell'account. 400 Bad Request Client

Esempi

L'esempio seguente acquista la capacità con provisioning per un account.

Richiesta di esempio

L'esempio seguente invia una richiesta HTTP POST per l'acquisto di un'unità di capacità con provisioning. 

POST /123456789012/provisioned-capacity HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
Content-Length: length
x-amz-glacier-version: 2012-06-01

Risposta di esempio

Se la richiesta ha esito positivo, Amazon S3 Glacier (S3 Glacier) restituisce una risposta HTTP 201 Created, come mostrato nell'esempio seguente.

HTTP/1.1 201 Created
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:02:00 GMT
x-amz-capacity-id: zSaq7NzHFQDANTfQkDen4V7z