バケットでの割り当て量の設定

ハードクォータは、バケットで利用可能なストレージの最大量(バイト単位)を設定します。 この制限に達すると、スペースを解放するために既存のオブジェクトが移動または削除されるか、割り当て量が増やされるまで、バケットにオブジェクトを追加できなくなります。

使用割り当て量には、上記の「ハード」割り当て量と、使用量がしきい値を超えたことをユーザーに警告する「ソフト」割り当て量の 2 つのタイプがありますが、これ以上のオブジェクト書き込みは防止されません。 ソフト割り当て量を構成するには、 IBM Cloud® Object Storage を使用して 使用量アラート を設定します。

コンソールの使用

コンソールを使用して、作成時にハード割り当て量をバケットに追加したり、既存のバケットに追加したりすることができます。

割り当て量を使用した新規バケットの作成

  1. オブジェクト・ストレージ・インスタンスにナビゲートした後、 「バケットの作成 (Create bucket)」 をクリックします。
  2. _「拡張構成 (Advanced configurations)」_の下で、 「割り当て量制約 (Quota enforcement)」 を探し、セレクターを 「有効 (Enabled)」 に切り替えます。
  3. ここで、値を大きくするか小さくして、適切なストレージ・ユニットを選択します。 続いて、**「保存」**をクリックします。
  4. 新規バケットの他のルール、設定、またはポリシーの構成を続行します。

既存のバケットへの割り当て量の追加

最初に、バケットがあることを確認します。 ない場合は、入門チュートリアルの手順に従って、コンソールについて理解してください。

  1. オブジェクトのリストを表示するには、バケットにナビゲートします。 ナビゲーショナルメニューから Configurationを選択する。
  2. _「拡張構成 (Advanced configurations)」_の下で、 「割り当て量制約 (Quota enforcement)」 を探し、セレクターを 「有効 (Enabled)」 に切り替えます。
  3. ここで、値を大きくするか小さくして、適切なストレージ・ユニットを選択します。 続いて、**「保存」**をクリックします。

割り当て量の無効化または編集

  1. オブジェクトのリストを表示するために、割り当て量を変更したいバケットにナビゲートします。 ナビゲーショナルメニューから Configurationを選択する。
  2. _「拡張構成 (Advanced configurations)」_で、 「割り当て量制約 (Quota enforcement)」 を探します。
  3. 割り当て量制約を無効にする場合は、セレクターを 「無効化」 に切り替えます。 あるいは、割り当て量制約を有効のままにしますが、必要に応じて値を編集します。
  4. 保存 をクリックします。

API の使用

バケット割り当て量は、 COS リソース構成 API を使用して管理されます。

割り当て量を追加するには、バケットのメタデータを編集するための PATCH 要求を送信します。

curl -X PATCH https://config.cloud-object-storage.cloud.ibm.com/v1/b/my-bucket \
     -H 'authorization: bearer $IAM_TOKEN' \
     -d '{"hard_quota": 10000000000}'

割り当て量を無効にするには、ゼロに設定します。

curl -X PATCH https://config.cloud-object-storage.cloud.ibm.com/v1/b/my-bucket \
     -H 'authorization: bearer $IAM_TOKEN' \
     -d '{"hard_quota": 0}'

バケットへの新規データの書き込みを一時的に無効にするには、割り当て量を非常に短い整数に設定します。

curl -X PATCH https://config.cloud-object-storage.cloud.ibm.com/v1/b/my-bucket \
     -H 'authorization: bearer $IAM_TOKEN' \
     -d '{"hard_quota": 1}'

バケットの割り当て量を確認するには、GET 要求を送信して、バケットのメタデータ内の hard_quota フィールドを表示します。

curl https://config.cloud-object-storage.cloud.ibm.com/v1/b/my-bucket \
     -H 'authorization: bearer $IAM_TOKEN'