このページでは、バケットにオブジェクトのライフサイクル管理を設定する方法と、バケットの現在のライフサイクル構成を表示する方法について説明します。ライフサイクル構成は、バケット内に現在あるオブジェクトと、今後追加されるすべてのオブジェクトに適用されます。
前提条件
前提条件は使用するツールによって異なります。
コンソール
Google Cloud Console を使用してこのガイドを完了するには、適切な IAM 権限が必要です。アクセス対象のバケットが、他のユーザーが作成したプロジェクトに存在する場合は、そのプロジェクトのオーナーから必要な権限を持つロールを付与してもらう必要があります。
特定のアクションに必要な権限の一覧については、Google Cloud Console に適用される IAM 権限をご覧ください。
関連するロールのリストについては、Cloud Storage のロールをご覧ください。また、特定の制限された権限を持つカスタムロールを作成することもできます。
コマンドライン
コマンドライン ユーティリティを使用してこのガイドを完了するには、適切な IAM 権限が必要です。アクセス対象のバケットが、他のユーザーが作成したプロジェクトに存在する場合は、そのプロジェクトのオーナーから必要な権限を持つロールを付与してもらう必要があります。
特定の操作に必要な権限の一覧については、gsutil コマンドの IAM 権限をご覧ください。
関連するロールのリストについては、Cloud Storage のロールをご覧ください。また、特定の制限された権限を持つカスタムロールを作成することもできます。
コードサンプル
Cloud Storage クライアント ライブラリを使用してこのガイドを完了するには、適切な IAM 権限が必要です。アクセス対象のバケットが、他のユーザーが作成したプロジェクトに存在する場合は、そのプロジェクトのオーナーから必要な権限を持つロールを付与してもらう必要があります。特に断りのない限り、クライアント ライブラリのリクエストは JSON API を介して行われます。
特定のアクションに必要な権限の一覧については、JSON メソッドの IAM 権限をご覧ください。
関連するロールのリストについては、Cloud Storage のロールをご覧ください。また、特定の制限された権限を持つカスタムロールを作成することもできます。
REST API
JSON API
JSON API を使用してこのガイドを完了するには、適切な IAM 権限が付与されている必要があります。アクセス対象のバケットが、他のユーザーが作成したプロジェクトに存在する場合は、そのプロジェクトのオーナーから必要な権限を持つロールを付与してもらう必要があります。
特定のアクションに必要な権限の一覧については、JSON メソッドの IAM 権限をご覧ください。
関連するロールのリストについては、Cloud Storage のロールをご覧ください。また、特定の制限された権限を持つカスタムロールを作成することもできます。
バケットのライフサイクル構成を設定する
コンソール
- Google Cloud コンソールで、Cloud Storage ブラウザページに移動します。
バケットリストで、有効にするバケットを見つけ、バケットの名前をクリックします。
[ライフサイクル] タブをクリックします。
ライフサイクル ルールのページが表示されます。既存のルールの編集や削除ができます。新しいルールを追加するには:
[ルールを追加] をクリックします。
表示されるページで、構成を指定します。
失敗したオペレーションに関する詳細なエラー情報を Cloud Storage ブラウザで確認する方法については、トラブルシューティングをご覧ください。
コマンドライン
適用するライフサイクル構成ルールを含む JSON ファイルを作成します。サンプルの JSON ファイルについては、構成例をご覧ください。
gsutil lifecycle set
コマンドを使用して、構成を適用します。gsutil lifecycle set LIFECYCLE_CONFIG_FILE gs://BUCKET_NAME
ここで
LIFECYCLE_CONFIG_FILE
は、手順 1 で作成した JSON ファイルのパスです。BUCKET_NAME
は、関連するバケットの名前です。例:my-bucket
コードサンプル
C++
詳細については、Cloud Storage C++ API のリファレンス ドキュメントをご覧ください。
次のサンプルでは、バケットにライフサイクル構成を設定しています。
次のサンプルでは、既存のライフサイクル構成をバケットから削除します。
C#
詳細については、Cloud Storage C# API のリファレンス ドキュメントをご覧ください。
次のサンプルでは、バケットにライフサイクル構成を設定しています。
次のサンプルでは、既存のライフサイクル構成をバケットから削除します。
Go
詳細については、Cloud Storage Go API のリファレンス ドキュメントをご覧ください。
次のサンプルでは、バケットにライフサイクル構成を設定しています。
次のサンプルでは、既存のライフサイクル構成をバケットから削除します。
Java
詳細については、Cloud Storage Java API のリファレンス ドキュメントをご覧ください。
次のサンプルでは、バケットにライフサイクル構成を設定しています。
次のサンプルでは、既存のライフサイクル構成をバケットから削除します。
Node.js
詳細については、Cloud Storage Node.js API のリファレンス ドキュメントをご覧ください。
次のサンプルでは、バケットにライフサイクル構成を設定しています。
次のサンプルでは、既存のライフサイクル構成をバケットから削除します。
PHP
詳細については、Cloud Storage PHP API のリファレンス ドキュメントをご覧ください。
次のサンプルでは、バケットにライフサイクル構成を設定しています。
次のサンプルでは、既存のライフサイクル構成をバケットから削除します。
Python
詳細については、Cloud Storage Python API のリファレンス ドキュメントをご覧ください。
次のサンプルでは、バケットにライフサイクル構成を設定しています。
次のサンプルでは、既存のライフサイクル構成をバケットから削除します。
Ruby
詳細については、Cloud Storage Ruby API のリファレンス ドキュメントをご覧ください。
次のサンプルでは、バケットにライフサイクル構成を設定しています。
次のサンプルでは、既存のライフサイクル構成をバケットから削除します。
REST API
JSON API
- OAuth 2.0 Playground から認証アクセス トークンを取得します。固有の OAuth 認証情報を使用するように Playground を構成します。手順については、API 認証をご覧ください。
適用するライフサイクル構成ルールを含む JSON ファイルを作成します。サンプルの JSON ファイルについては、構成例をご覧ください。
cURL
を使用して JSON API を呼び出し、PATCH
Bucket リクエストを行います。curl -X PATCH --data-binary @LIFECYCLE_CONFIG_FILE \ -H "Authorization: Bearer OAUTH2_TOKEN" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=lifecycle"
ここで
LIFECYCLE_CONFIG_FILE
は、手順 2 で作成した JSON ファイルのパスです。OAUTH2_TOKEN
は、手順 1 で生成したアクセス トークンです。BUCKET_NAME
は、関連するバケットの名前です。例:my-bucket
XML API
- OAuth 2.0 Playground から認証アクセス トークンを取得します。固有の OAuth 認証情報を使用するように Playground を構成します。手順については、API 認証をご覧ください。
適用するライフサイクル構成ルールを含む XML ファイルを作成します。サンプルの XML ファイルについては、構成例をご覧ください。
cURL
を使用して XML API を呼び出し、PUT
Bucket リクエストを行います。curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/BUCKET_NAME?lifecycle"
ここで
XML_FILE_NAME
は、手順 2 で作成した XML ファイルのパスです。OAUTH2_TOKEN
は、手順 1 で生成したアクセス トークンです。BUCKET_NAME
は、関連するバケットの名前です。例:my-bucket
バケットのライフサイクル構成を確認する
コンソール
- Google Cloud コンソールで、Cloud Storage ブラウザページに移動します。
バケットリストの [ライフサイクル] 列に、各バケットのライフサイクル ステータスが表示されます。
このステータスをクリックして、ルールを追加、表示、編集、および削除できます。
失敗したオペレーションに関する詳細なエラー情報を Cloud Storage ブラウザで確認する方法については、トラブルシューティングをご覧ください。
コマンドライン
gsutil lifecycle get
コマンドを使用します。gsutil lifecycle get gs://BUCKET_NAME
BUCKET_NAME
は、該当するバケットの名前です。例:my-bucket
コードサンプル
C++
詳細については、Cloud Storage C++ API のリファレンス ドキュメントをご覧ください。
C#
詳細については、Cloud Storage C# API のリファレンス ドキュメントをご覧ください。
バケットのライフサイクル ポリシーを表示するには、バケットのメタデータを表示する手順に沿って、レスポンス内のライフサイクル ポリシー フィールドを探します。Go
詳細については、Cloud Storage Go API のリファレンス ドキュメントをご覧ください。
バケットのライフサイクル ポリシーを表示するには、バケットのメタデータを表示する手順に沿って、レスポンス内のライフサイクル ポリシー フィールドを探します。Java
詳細については、Cloud Storage Java API のリファレンス ドキュメントをご覧ください。
バケットのライフサイクル ポリシーを表示するには、バケットのメタデータを表示する手順に沿って、レスポンス内のライフサイクル ポリシー フィールドを探します。Node.js
詳細については、Cloud Storage Node.js API のリファレンス ドキュメントをご覧ください。
バケットのライフサイクル ポリシーを表示するには、バケットのメタデータを表示する手順に沿って、レスポンス内のライフサイクル ポリシー フィールドを探します。PHP
詳細については、Cloud Storage PHP API のリファレンス ドキュメントをご覧ください。
バケットのライフサイクル ポリシーを表示するには、バケットのメタデータを表示する手順に沿って、レスポンス内のライフサイクル ポリシー フィールドを探します。Python
詳細については、Cloud Storage Python API のリファレンス ドキュメントをご覧ください。
バケットのライフサイクル ポリシーを表示するには、バケットのメタデータを表示する手順に沿って、レスポンス内のライフサイクル ポリシー フィールドを探します。Ruby
詳細については、Cloud Storage Ruby API のリファレンス ドキュメントをご覧ください。
バケットのライフサイクル ポリシーを表示するには、バケットのメタデータを表示する手順に沿って、レスポンス内のライフサイクル ポリシー フィールドを探します。REST API
JSON API
- OAuth 2.0 Playground から認証アクセス トークンを取得します。固有の OAuth 認証情報を使用するように Playground を構成します。手順については、API 認証をご覧ください。
cURL
を使用して JSON API を呼び出し、GET
Bucket リクエストを行います。curl -X GET \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=lifecycle"
ここで
OAUTH2_TOKEN
は、手順 1 で生成したアクセス トークンです。BUCKET_NAME
は、関連するバケットの名前です。例:my-bucket
XML API
- OAuth 2.0 Playground から認証アクセス トークンを取得します。固有の OAuth 認証情報を使用するように Playground を構成します。手順については、API 認証をご覧ください。
cURL
を使用して XML API を呼び出し、GET
Bucket リクエストを行います。curl -X GET \ -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/BUCKET_NAME?lifecycle"
ここで
OAUTH2_TOKEN
は、手順 1 で生成したアクセス トークンです。BUCKET_NAME
は、関連するバケットの名前です。例:my-bucket
次のステップ
- 利用可能なライフサイクル アクションやライフサイクル条件など、オブジェクトのライフサイクル管理について学習する。
- ライフサイクルの構成例を確認する。