このページでは、バケットにオブジェクトのライフサイクル管理を設定する方法と、バケットの現在のライフサイクル構成を表示する方法について説明します。ライフサイクル構成は、バケット内に現在あるオブジェクトと、今後追加されるすべてのオブジェクトに適用されます。
必要なロール
バケットのオブジェクトのライフサイクル管理の設定と管理に必要な権限を取得するには、バケットに対するストレージ管理者(roles/storage.admin
)ロールを付与するよう管理者に依頼してください。この事前定義ロールには、バケットのオブジェクト ライフサイクル管理の設定と管理に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。
必要な権限
storage.buckets.get
storage.buckets.list
- この権限は、Google Cloud コンソールを使用してこのページの手順を実施する場合にのみ必要です。
storage.buckets.update
カスタムロールを使用して、これらの権限を取得することもできます。
バケットに対するロールの付与については、バケットで IAM を使用するをご覧ください。
バケットのライフサイクル構成を設定する
コンソール
- Google Cloud コンソールで、Cloud Storage の [バケット] ページに移動します。
バケットリストで、有効にするバケットを見つけ、バケットの名前をクリックします。
[ライフサイクル] タブをクリックします。
ライフサイクル ルールのページが表示されます。既存のルールの編集や削除ができます。新しいルールを追加するには:
[ルールを追加] をクリックします。
表示されるページで、構成を指定します。
失敗した Cloud Storage オペレーションの詳細なエラー情報を Google Cloud コンソールで確認する方法については、トラブルシューティングをご覧ください。
コマンドライン
適用するライフサイクル構成ルールを含む JSON ファイルを作成します。サンプルの JSON ファイルについては、構成例をご覧ください。
gcloud storage buckets update
コマンドを使用し、--lifecycle-file
フラグを指定します。gcloud storage buckets update gs://BUCKET_NAME --lifecycle-file=LIFECYCLE_CONFIG_FILE
ここで
BUCKET_NAME
は、関連するバケットの名前です。例:my-bucket
。LIFECYCLE_CONFIG_FILE
は、手順 1 で作成した JSON ファイルのパスです。
クライアント ライブラリ
C++
詳細については、Cloud Storage C++ API のリファレンス ドキュメントをご覧ください。
Cloud Storage に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
次のサンプルでは、バケットにライフサイクル構成を設定しています。
次のサンプルでは、既存のライフサイクル構成をバケットから削除します。
C#
詳細については、Cloud Storage C# API のリファレンス ドキュメントをご覧ください。
Cloud Storage に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
次のサンプルでは、バケットにライフサイクル構成を設定しています。
次のサンプルでは、既存のライフサイクル構成をバケットから削除します。
Go
詳細については、Cloud Storage Go API のリファレンス ドキュメントをご覧ください。
Cloud Storage に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
次のサンプルでは、バケットにライフサイクル構成を設定しています。
次のサンプルでは、既存のライフサイクル構成をバケットから削除します。
Java
詳細については、Cloud Storage Java API のリファレンス ドキュメントをご覧ください。
Cloud Storage に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
次のサンプルでは、バケットにライフサイクル構成を設定しています。
次のサンプルでは、既存のライフサイクル構成をバケットから削除します。
Node.js
詳細については、Cloud Storage Node.js API のリファレンス ドキュメントをご覧ください。
Cloud Storage に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
次のサンプルでは、バケットにライフサイクル構成を設定しています。
次のサンプルでは、既存のライフサイクル構成をバケットから削除します。
PHP
詳細については、Cloud Storage PHP API のリファレンス ドキュメントをご覧ください。
Cloud Storage に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
次のサンプルでは、バケットにライフサイクル構成を設定しています。
次のサンプルでは、既存のライフサイクル構成をバケットから削除します。
Python
詳細については、Cloud Storage Python API のリファレンス ドキュメントをご覧ください。
Cloud Storage に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
次のサンプルでは、バケットにライフサイクル構成を設定しています。
次のサンプルでは、既存のライフサイクル構成をバケットから削除します。
Ruby
詳細については、Cloud Storage Ruby API のリファレンス ドキュメントをご覧ください。
Cloud Storage に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
次のサンプルでは、バケットにライフサイクル構成を設定しています。
次のサンプルでは、既存のライフサイクル構成をバケットから削除します。
Terraform
Terraform リソースを使用して、Terraform によって管理されるバケットのライフサイクル構成を設定できます。Terraform でまだ管理されていない既存のバケットにライフサイクル構成を設定するには、まず既存のバケットをインポートする必要があります。
Terraform でライフサイクル条件がサポートされているかどうかを確認するには、Terraform ドキュメントで condition
ブロックの説明をご覧ください。
REST API
JSON API
gcloud CLI のインストールと初期化を行います。これにより、
Authorization
ヘッダーのアクセス トークンを生成できます。適用するライフサイクル構成ルールを含む JSON ファイルを作成します 。サンプルの JSON ファイルについては、構成例をご覧ください。
cURL
を使用して JSON API を呼び出し、PATCH
Bucket リクエストを行います。curl -X PATCH --data-binary @LIFECYCLE_CONFIG_FILE \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=lifecycle"
ここで
LIFECYCLE_CONFIG_FILE
は、手順 2 で作成した JSON ファイルのパスです。BUCKET_NAME
は、関連するバケットの名前です。例:my-bucket
XML API
gcloud CLI のインストールと初期化を行います。これにより、
Authorization
ヘッダーのアクセス トークンを生成できます。適用するライフサイクル構成ルールを含む XML ファイルを作成します 。サンプルの XML ファイルについては、構成例をご覧ください。
cURL
を使用して、PUT
Bucket リクエストとlifecycle
クエリ文字列パラメータを含めた XML API を呼び出します。curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?lifecycle"
ここで
XML_FILE_NAME
は、手順 2 で作成した XML ファイルのパスです。BUCKET_NAME
は、関連するバケットの名前です。例:my-bucket
バケットのライフサイクル構成を確認する
コンソール
- Google Cloud コンソールで、Cloud Storage の [バケット] ページに移動します。
バケットリストの [ライフサイクル] 列に、各バケットのライフサイクル ステータスが表示されます。
このステータスをクリックして、ルールを追加、表示、編集、および削除できます。
失敗した Cloud Storage オペレーションの詳細なエラー情報を Google Cloud コンソールで確認する方法については、トラブルシューティングをご覧ください。
コマンドライン
gcloud storage buckets describe
コマンドを使用し、--format
フラグを指定します。
gcloud storage buckets describe gs://BUCKET_NAME --format="default(lifecycle_config)"
ここで、BUCKET_NAME
は、ライフサイクル構成を表示するバケットの名前です。例: my-bucket
クライアント ライブラリ
C++
詳細については、Cloud Storage C++ API のリファレンス ドキュメントをご覧ください。
Cloud Storage に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
C#
詳細については、Cloud Storage C# API のリファレンス ドキュメントをご覧ください。
Cloud Storage に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
バケットのライフサイクル ポリシーを表示するには、バケットのメタデータを表示する手順に沿って、レスポンス内のライフサイクル ポリシー フィールドを探します。Go
詳細については、Cloud Storage Go API のリファレンス ドキュメントをご覧ください。
Cloud Storage に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
バケットのライフサイクル ポリシーを表示するには、バケットのメタデータを表示する手順に沿って、レスポンス内のライフサイクル ポリシー フィールドを探します。Java
詳細については、Cloud Storage Java API のリファレンス ドキュメントをご覧ください。
Cloud Storage に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
バケットのライフサイクル ポリシーを表示するには、バケットのメタデータを表示する手順に沿って、レスポンス内のライフサイクル ポリシー フィールドを探します。Node.js
詳細については、Cloud Storage Node.js API のリファレンス ドキュメントをご覧ください。
Cloud Storage に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
バケットのライフサイクル ポリシーを表示するには、バケットのメタデータを表示する手順に沿って、レスポンス内のライフサイクル ポリシー フィールドを探します。PHP
詳細については、Cloud Storage PHP API のリファレンス ドキュメントをご覧ください。
Cloud Storage に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
バケットのライフサイクル ポリシーを表示するには、バケットのメタデータを表示する手順に沿って、レスポンス内のライフサイクル ポリシー フィールドを探します。Python
詳細については、Cloud Storage Python API のリファレンス ドキュメントをご覧ください。
Cloud Storage に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
バケットのライフサイクル ポリシーを表示するには、バケットのメタデータを表示する手順に沿って、レスポンス内のライフサイクル ポリシー フィールドを探します。Ruby
詳細については、Cloud Storage Ruby API のリファレンス ドキュメントをご覧ください。
Cloud Storage に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
バケットのライフサイクル ポリシーを表示するには、バケットのメタデータを表示する手順に沿って、レスポンス内のライフサイクル ポリシー フィールドを探します。REST API
JSON API
gcloud CLI のインストールと初期化を行います。これにより、
Authorization
ヘッダーのアクセス トークンを生成できます。cURL
を使用して、GET
Bucket リクエストで JSON API を呼び出します。curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=lifecycle"
BUCKET_NAME
は、該当するバケットの名前です。例:my-bucket
XML API
gcloud CLI のインストールと初期化を行います。これにより、
Authorization
ヘッダーのアクセス トークンを生成できます。cURL
を使用して、GET
Bucket リクエストとlifecycle
クエリ文字列パラメータを含む XML API を呼び出します。curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?lifecycle"
BUCKET_NAME
は、該当するバケットの名前です。例:my-bucket
次のステップ
- 利用可能なライフサイクル アクションやライフサイクル条件など、オブジェクトのライフサイクル管理について学習する。
- ライフサイクルの構成例を確認する。