このページでは、Cloud Storage のバケットに設定されている Autoclass 機能の有効化、無効化、ステータス確認を行う方法について説明します。
前提条件
Cloud Storage でこの機能を使用する前に、以下の準備が必要です。
Cloud Storage のバケットを表示および更新するための十分な権限がある。
バケットを含むプロジェクトを所有している場合は、必要な権限があると考えられます。
IAM を使用する場合は、関連するバケットに対する
storage.buckets.update
権限とstorage.buckets.get
権限が必要です。これらの権限を持つロール(ストレージ管理者など)を取得する手順については、IAM 権限の使用をご覧ください。
バケットに Autoclass を設定する
バケットに Autoclass を設定するには、次の手順を完了します。
コンソール
- Google Cloud コンソールで、Cloud Storage の [バケット] ページに移動します。
バケットのリストで、目的のバケットの名前をクリックします。
[バケットの詳細] ページで、[構成] タブをクリックします。
[デフォルトのストレージ クラス] の編集アイコン edit をクリックします。
オーバーレイ ウィンドウで、[Autoclass] を選択して Autoclass を有効にします。Autoclass を無効にするには、[デフォルトのクラスを設定する] を選択して、バケットに必要なデフォルトのストレージ クラスを選択します。
[確認] をクリックします。
Autoclass が有効になっているバケットのターミナル ストレージ クラスを切り替えるには、[含まれるクラス] の [編集] アイコン(edit)をクリックして、表示されるオーバーレイ ウィンドウで [確認] をクリックします。
コマンドライン
適切なフラグを指定して、gcloud storage buckets update
コマンドを使用します。
gcloud storage buckets update gs://BUCKET_NAME FLAG
ここで
BUCKET_NAME
は、関連するバケットの名前です。例:my-bucket
FLAG
は、次のいずれかです。--enable-autoclass
: Autoclass を有効にします。--no-enable-autoclass
: Autoclass を無効にします。--autoclass-terminal-storage-class=CLASS
: Autoclass のターミナル ストレージ クラスを設定します。CLASS は、NEARLINE
またはARCHIVE
のいずれかになります。
正常に終了すると、レスポンスは次の例のようになります。
Updating gs://my-bucket/... Completed 1
クライアント ライブラリ
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
- OAuth 2.0 Playground から認可アクセス トークンを取得します。固有の OAuth 認証情報を使用するように Playground を構成します。手順については、API 認証をご覧ください。
次の情報が含まれる JSON ファイルを作成します。
{ "storageClass": "DEFAULT_CLASS", "autoclass": { "enabled": BOOLEAN, "terminalStorageClass":TERMINAL_CLASS } }
ここで
DEFAULT_CLASS
は、バケットのストレージ クラス メタデータを設定します。Autoclass を有効にする場合、STANDARD
が唯一の有効な値であり、バケットで現在別のストレージ クラスを使用している場合は必須です。BOOLEAN
がtrue
の場合、Autoclass は有効になります。false
の場合は無効になります。TERMINAL_CLASS
は、Autoclass が有効な場合に使用するターミナルのストレージ クラスです。
cURL
を使用して JSON API を呼び出し、PATCH
Bucket リクエストを行います。curl -X PATCH --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer OAUTH2_TOKEN" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=autoclass"
ここで
JSON_FILE_NAME
は、手順 2 で作成した JSON ファイルのパスです。OAUTH2_TOKEN
は、手順 1 で生成したアクセス トークンです。BUCKET_NAME
は、関連するバケットの名前です。例:my-bucket
XML API
この機能は XML API では管理できません。Google Cloud コンソールまたは別のツールを使用してください。
バケットの Autoclass のステータスを表示する
個々のバケットの Autoclass のステータスを表示するには:
コンソール
- Google Cloud コンソールで、Cloud Storage の [バケット] ページに移動します。
ステータスを確認するバケットの名前をクリックします。
[構成] タブをクリックします。
[デフォルトのストレージ クラス] フィールドに Autoclass のステータスが表示されます。
Autoclass が有効になっている場合、フィールドには「Autoclass で管理」と表示され、[含まれるクラス] フィールドには、オブジェクトが移動できるストレージ クラスが表示されます。
コマンドライン
gcloud storage buckets describe
コマンドを使用し、--format
フラグを指定します。
gcloud storage buckets describe gs://BUCKET_NAME --format="default(autoclass)"
ここで、BUCKET_NAME
はステータスを表示するバケットの名前です。例: my-bucket
。
正常に終了すると、レスポンスは次の例のようになります。
autoclass: enabled: true terminalStorageClass: ARCHIVE terminalStorageClassUpdateTime: '2023-02-10T16:11:02.384000+00:00' toggleTime: '2022-11-09T16:01:40.775000+00:00'
クライアント ライブラリ
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
- OAuth 2.0 Playground から認可アクセス トークンを取得します。固有の OAuth 認証情報を使用するように Playground を構成します。手順については、API 認証をご覧ください。
cURL
を使用して、autoclass
フィールドを含むGET
Bucket リクエストで JSON API を呼び出します。curl -X GET -H "Authorization: Bearer OAUTH2_TOKEN" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=autoclass"
ここで
OAUTH2_TOKEN
は、手順 1 で生成したアクセス トークンの名前です。BUCKET_NAME
は、関連するバケットの名前です。例:my-bucket
。
バケットで Autoclass が有効になっている場合、レスポンスは次のようになります。
{ "autoclass": { "enabled": "BOOLEAN", "toggleTime": "DATETIME", "terminalStorageClass": "STORAGE_CLASS", "terminalStorageClassUpdateTime": "DATETIME" }, }
XML API
この機能は XML API では管理できません。Google Cloud コンソールまたは別のツールを使用してください。
次のステップ
- Autoclass の詳細を確認する。
- オブジェクトのライフサイクル管理について学習する。ライフサイクルの管理では、指定した条件を満たしたときに、オブジェクトのストレージ クラスが自動的に変更されます。