**このページは、ボールトと 2012 年リリース当時の REST API を使用する、Amazon Glacier サービスの既存のお客様のみを対象としています。**

アーカイブストレージソリューションをお探しの場合は、Amazon S3 の Amazon Glacier ストレージクラス (S3 Glacier Instant Retrieval、S3 Glacier Flexible Retrieval、S3 Glacier Deep Archive) を使用することをお勧めします。これらのストレージオプションの詳細については、「[Amazon Glacier ストレージクラス](https://aws.amazon.com/s3/storage-classes/glacier/)」を参照してください。

Amazon Glacier (元のスタンドアロンボールトベースのサービス) は、新規顧客を受け入れなくなりました。Amazon Glacier は、ボールトにデータを保存する独自の API を備えたスタンドアロンサービスであり、Amazon S3 および Amazon S3 Glacier ストレージクラスとは異なります。既存のデータは Amazon Glacier で無期限に安全性が確保され、引き続きアクセス可能です。移行は必要ありません。低コストの長期アーカイブストレージの場合、 は [Amazon S3 Glacier ストレージクラス](https://aws.amazon.com/s3/storage-classes/glacier/) AWS を推奨します。これにより、S3 バケットベースの APIs、低コスト、 AWS サービス統合で優れたカスタマーエクスペリエンスを実現できます。 AWS リージョン 拡張機能が必要な場合は、[Amazon Glacier ボールトから Amazon S3 Glacier ストレージクラスにデータを転送するためのAWS ソリューションガイダンス](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/)を使用して、Amazon S3 Glacier ストレージクラスへの移行を検討してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# プロビジョニングされた容量の購入 (POST provisioned-capacity)
<a name="api-PurchaseProvisionedCapacity"></a>

このオペレーションでは、 AWS アカウントのプロビジョニングされた容量単位を購入します。

プロビジョニングされた容量単位は、購入日時 (開始日) から 1 か月間有効です。単位に有効期限に失効します。これは開始日から正確に 1 か月後であり、1 秒単位で四捨五入されます。

開始日が 31 日の場合、有効期限は翌月の最終日となります。たとえば、開始日が 8 月 31 日の場合、有効期限は 9 月 30 日です。開始日が 1 月 31 日の場合、有効期限は 2 月 28 日です。

プロビジョンドキャパシティーは、迅速取り出しの取得容量を必要なときに利用できることを保証します。容量の各単位について 5 分ごとに 3 回以上の迅速取り出しを保証し、最大 150 MB/秒の取り出しスループットを提供します。プロビジョンドキャパシティーの詳細については、「[アーカイブの取り出しオプション](downloading-an-archive-two-steps.md#api-downloading-an-archive-two-steps-retrieval-options)」を参照してください。

**注記**  
あたり 2 つのプロビジョンドキャパシティーユニットに制限があります AWS アカウント。

## リクエスト
<a name="api-PurchaseProvisionedCapacity-requests"></a>

のプロビジョンドキャパシティユニットを購入するには、プロビジョンドキャパシティ URI に HTTP `POST`リクエスト AWS アカウント を送信します。

### 構文
<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
```

 

**注記**  
`AccountId` 値は AWS アカウント ID です。この値は、リクエストの署名に使用される認証情報に関連付けられた AWS アカウント ID と一致する必要があります。 AWS アカウント ID またはオプションで単一の '`-`' (ハイフン) を指定できます。この場合、Amazon Glacier はリクエストの署名に使用される認証情報に関連付けられた AWS アカウント ID を使用します。お客様のアカウント ID を指定する場合は、ハイフン(`-`)を含めないでください。

### リクエストパラメーター
<a name="api-PurchaseProvisionedCapacity-requestParameters"></a>

#### リクエストヘッダー
<a name="api-PurchaseProvisionedCapacity-requests-headers"></a>

このオペレーションは、すべてのオペレーションに共通のリクエストヘッダーのみを使用します。共通のリクエストヘッダーの詳細については、「[一般的なリクエストヘッダー](api-common-request-headers.md)」を参照してください。

#### リクエスト本文
<a name="api-PurchaseProvisionedCapacity-requests-elements"></a>

この操作にリクエストボディはありません。

## レスポンス
<a name="api-PurchaseProvisionedCapacity-responses"></a>

オペレーションリクエストが成功した場合、サービスは HTTP 応答 `201 Created` を返します。

### 構文
<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
```

### レスポンスヘッダー
<a name="api-PurchaseProvisionedCapacity-responses-headers"></a>

成功したレスポンスには、すべての操作に共通のレスポンスヘッダーに加えて、次のレスポンスヘッダーが含まれます。共通のレスポンスヘッダーの詳細については、「[共通のレスポンスヘッダー](api-common-response-headers.md)」を参照してください。


|  名前  |  説明 | 
| --- | --- | 
|  `x-amz-capacity-id`   |  プロビジョニングされた容量単位を識別する ID。 タイプ: 文字列  | 

### レスポンス本文
<a name="api-PurchaseProvisionedCapacity-responses-elements"></a>

このオペレーションはレスポンス本文を返しません。

### エラー
<a name="api-PurchaseProvisionedCapacity-responses-errors"></a>

この操作には、すべての Amazon Glacier オペレーションで共通して発生し得るエラーに加えて、次のエラーが含まれます。Amazon Glacier のエラーとエラーコードのリストについては、「[エラーレスポンス](api-error-responses.md)」を参照してください。


| コード | 説明 | HTTP ステータスコード | タイプ | 
| --- | --- | --- | --- | 
| LimitExceededException | リクエストした容量が、アカウントでプロビジョニングされた容量単位に設定している上限を超えると、返されます。 | 400 Bad Request | クライアント | 

## 例
<a name="api-PurchaseProvisionedCapacity-examples"></a>

次の例では、アカウントのプロビジョニングされた容量を購入します。

### リクエストの例
<a name="api-PurchaseProvisionedCapacity-example-request"></a>

次の例では、HTTP POST リクエストを送信して、プロビジョニングされた容量単位を購入します。

```
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
```

### レスポンスの例
<a name="api-PurchaseProvisionedCapacity-example-response"></a>

リクエストが成功した場合、次の例に示すように、Amazon Glacier は `HTTP 201 Created` レスポンスを返します。

```
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
```

## 関連するセクション
<a name="api-PurchaseProvisionedCapacity-related-sections"></a>

 
+ [プロビジョニングされた容量を表示する (GET provisioned-capacity)](api-ListProvisionedCapacity.md)