**Questa pagina è riservata ai clienti esistenti del servizio Amazon 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 Amazon 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 di [Amazon Glacier](https://aws.amazon.com/s3/storage-classes/glacier/).

Amazon Glacier (servizio autonomo originale basato su vault) non accetta più nuovi clienti. Amazon Glacier è un servizio APIs autonomo che archivia i dati in vault ed è distinto dalle classi di storage Amazon S3 e Amazon S3 Glacier. I dati esistenti rimarranno sicuri e accessibili in Amazon Glacier a tempo indeterminato. Non è richiesta alcuna migrazione. Per uno storage di archiviazione a lungo termine a basso costo, AWS consiglia le classi di storage [Amazon S3 Glacier](https://aws.amazon.com/s3/storage-classes/glacier/), che offrono un'esperienza cliente superiore con disponibilità Regione AWS completa, costi inferiori e integrazione dei servizi APIs basata su bucket S3. AWS Se desideri funzionalità avanzate, prendi in considerazione la migrazione alle classi di storage Amazon S3 Glacier utilizzando la [AWS nostra Solutions Guidance per il trasferimento di dati dai vault Amazon Glacier alle classi di storage Amazon S3 Glacier](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/).

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)
<a name="api-PurchaseProvisionedCapacity"></a>

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 la possibilità di eseguire almeno tre recuperi rapidi ogni cinque minuti e fornisce fino al 150% di velocità MB/s di recupero. Per ulteriori informazioni sulla capacità con provisioning, consultare [Opzioni di recupero dall'archivio](downloading-an-archive-two-steps.md#api-downloading-an-archive-two-steps-retrieval-options). 

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

## Richieste
<a name="api-PurchaseProvisionedCapacity-requests"></a>

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

### Sintassi
<a name="api-PurchaseProvisionedCapacity-requests-syntax"></a>

```
1. POST /AccountId/provisioned-capacity HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. Content-Length: Length
6. 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 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
<a name="api-PurchaseProvisionedCapacity-requestParameters"></a>

#### Intestazioni di richiesta
<a name="api-PurchaseProvisionedCapacity-requests-headers"></a>

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](api-common-request-headers.md).

#### Corpo della richiesta
<a name="api-PurchaseProvisionedCapacity-requests-elements"></a>

Questa operazione non ha un corpo della richiesta.

## Risposte
<a name="api-PurchaseProvisionedCapacity-responses"></a>

Se la richiesta riesce, il servizio restituisce una risposta HTTP `201 Created`.

### Sintassi
<a name="api-PurchaseProvisionedCapacity-response-syntax"></a>

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

### Intestazioni di risposta
<a name="api-PurchaseProvisionedCapacity-responses-headers"></a>

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](api-common-response-headers.md).


|  Nome  |  Description | 
| --- | --- | 
|  `x-amz-capacity-id`   |  L'ID che identifica l'unità di capacità con provisioning. Tipo: String  | 

### Corpo della risposta
<a name="api-PurchaseProvisionedCapacity-responses-elements"></a>

Questa operazione non restituisce un corpo della risposta.

### Errori
<a name="api-PurchaseProvisionedCapacity-responses-errors"></a>

Questa operazione include l'errore o gli errori seguenti, oltre ai possibili errori comuni a tutte le operazioni di Amazon Glacier. Per informazioni sugli errori di Amazon Glacier e un elenco di codici di errore, consulta. [Risposte agli errori](api-error-responses.md)


| Codice | Description | 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
<a name="api-PurchaseProvisionedCapacity-examples"></a>

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

### Richiesta di esempio
<a name="api-PurchaseProvisionedCapacity-example-request"></a>

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

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

### Risposta di esempio
<a name="api-PurchaseProvisionedCapacity-example-response"></a>

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

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

## Sezioni correlate
<a name="api-PurchaseProvisionedCapacity-related-sections"></a>

 
+ [List Provisioned Capacity (GET provisioned-capacity)](api-ListProvisionedCapacity.md)