ストレージ バケットの保持期間を設定する

このページでは、Google Distributed Cloud（GDC）エアギャップ環境内のストレージ バケットの保持期間を設定する方法について説明します。このドキュメントでは、GDC コンソールとコマンドライン インターフェース（CLI）の両方を使用して、ストレージ バケット内にデータを保持する必要がある期間を定義するための前提条件と手順について説明します。この情報は、規制要件とデータ管理要件を満たすうえで役立ちます。

このページは、インフラストラクチャ オペレーター グループの IT 管理者や、アプリケーション オペレーター グループのデベロッパーなど、GDC のエアギャップ環境でストレージ バケットの設定と管理を担当するユーザーを対象としています。詳細については、GDC エアギャップの対象読者に関するドキュメントをご覧ください。

始める前に

プロジェクト名前空間は、Management API サーバーのバケット リソースを管理します。バケットとオブジェクトを操作するには、プロジェクトが必要です。

次のオペレーションを実行するには、適切なバケット権限も必要です。バケットへのアクセス権を付与するをご覧ください。

バケットの保持期間を設定する

コンソール

  1. ナビゲーション メニューで、[オブジェクト ストレージ] をクリックします。
  2. 更新するバケットの名前をクリックします。
  3. [構成] タブをクリックします。
  4. [セキュリティ] セクションで、[保持ポリシー] フィールドの横にある [編集] をクリックします。
  5. 日数を既存の日数より大きい値に編集し、[保存] をクリックします。

CLI

デフォルトでは、オブジェクトはいつでも削除できます。保持期間を指定してオブジェクト ロックを有効にすると、バケット内のすべてのオブジェクトが指定された日数だけ削除されなくなります。保持期間後にすべてのオブジェクトを削除するまで、バケットを削除することはできません。

バケットの作成時にオブジェクト ロックを有効にする必要があります。バケットの作成後にオブジェクト ロックを有効または無効にすることはできません。ただし、デフォルトのオブジェクト保持期間は変更できます。

オブジェクト ロックを有効にするかどうかに関係なく、バケットを作成できます。オブジェクト ロックを有効にしている場合、デフォルトの保持期間の指定は省略可能です。

保持期間を変更するには、バケット リソースの Bucket.spec.buckePolicy.lockingPolicy.defaultObjectRetentionDays フィールドを更新します。

次に、バケット リソースのフィールドを更新する例を示します。

apiVersion: object.gdc.goog/v1
kind: Bucket
metadata:
  name: BUCKET_NAME
  namespace: NAMESPACE_NAME
spec:
  description: "This bucket has a default retention period specified."
  storageClass: Standard
  bucketPolicy:
    lockingPolicy:
      defaultObjectRetentionDays: RETENTION_DAY_COUNT
----------
apiVersion: object.gdc.goog/v1
kind: Bucket
metadata:
  name: BUCKET_NAME
  namespace: NAMESPACE_NAME
spec:
  description: "This would enable object locking but not specify a default retention period."
  storageClass: Standard
  bucketPolicy:
    lockingPolicy:
----------
apiVersion: object.gdc.goog/v1
kind: Bucket
metadata:
  name: BUCKET_NAME
  namespace: NAMESPACE_NAME
spec:
  description: "This bucket does not have locking or retention enabled."
  storageClass: Standard

保持期間の更新は、更新後にバケットに作成されたオブジェクトに適用されます。既存のオブジェクトの場合、保持期間は変更されません。

オブジェクトのロックを有効にしている場合、オブジェクトを上書きしようとすると、オブジェクトの新しいバージョンが追加されます。両方のオブジェクト バージョンを取得できます。オブジェクトのバージョンを取得するには、ストレージ オブジェクトを一覧表示するをご覧ください。

WORM（1 回限りの書き込みと複数回の読み取り）バケットを作成するには、WORM バケットのセクションをご覧ください。