このページでは、Cloud Storage バケットの作成方法について説明します。バケットの概要については、主な用語をご覧ください。リクエストで指定されていない限り、バケットは、US
マルチリージョンで作成され、デフォルトのストレージ クラスは Standard Storage になります。
新しいストレージ バケットを作成するには:
Console
- Google Cloud Console で Cloud Storage ブラウザを開きます。
Cloud Storage ブラウザを開く - [バケットを作成] をクリックして、バケット作成フォームを開きます。
- バケット情報を入力し、[続行] をクリックして各ステップを完了します。
- バケット名の要件に従って、名前を指定します。
- バケットデータを永続的に保存するロケーション タイプとロケーションを選択します。
- バケットのデフォルトのストレージ クラスを選択します。デフォルトのストレージ クラスは、デフォルトでバケットにアップロードされたすべてのオブジェクトに割り当てられます。
注: 右側の [毎月の費用の見積もり] パネルでは、選択したストレージ クラスとロケーション、予想されるデータサイズとオペレーションに基づいてバケットの毎月のコストを見積もります。
- [アクセス制御モデル] を選択して、バケットのオブジェクトに対するアクセスの制御方法を決定します。
- 必要に応じて、バケットラベルの追加、保持ポリシーの設定、暗号化方式の選択を行えます。
- [作成] をクリックします。
Cloud Storage ブラウザで失敗したオペレーションに関する詳細なエラー情報を確認する方法については、トラブルシューティングをご覧ください。
gsutil
gsutil mb
コマンドを使用します。
gsutil mb gs://BUCKET_NAME
ここで
BUCKET_NAME
は、バケットに付ける名前で、命名要件の対象となります。例:my-bucket
リクエストが成功すると、コマンドから次のメッセージが返されます。
Creating gs://BUCKET_NAME/...
次のオプション フラグを設定すると、バケットの作成をより詳細に管理できます。
-p
: バケットが関連するプロジェクトを指定します。例:my-project
-c
: バケットのデフォルトのストレージ クラスを指定します。例:NEARLINE
-l
: バケットのロケーションを指定します。例:US-EAST1
-b
: バケットの均一なバケットレベルのアクセスを有効にします。
例:
gsutil mb -p PROJECT_ID -c STORAGE_CLASS -l BUCKET_LOCATION -b on gs://BUCKET_NAME
コードサンプル
の JSON API リファレンスをご覧ください。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 を構成します。
- バケットの設定を含む .json ファイルを作成します。この設定には、バケットの
name
を含める必要があります。設定の一覧については、Buckets:Insert のドキュメントをご覧ください。一般的な設定は次のとおりです。 BUCKET_NAME
は、バケットに付ける名前で、命名要件の対象となります。例:my-bucket
BUCKET_LOCATION
は、バケットのオブジェクト データを保存するロケーションです。例:US-EAST1
STORAGE_CLASS
はバケットのデフォルトのストレージ クラスです。例:NEARLINE
cURL
を使用して JSON API を呼び出します。curl -X POST --data-binary @JSON_FILE_NAME.json \ -H "Authorization: Bearer OAUTH2_TOKEN" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b?project=PROJECT_ID"
ここで
JSON_FILE_NAME
は手順 2 で作成した JSON ファイルの名前です。OAUTH2_TOKEN
は、ステップ 1 で生成したアクセス トークンです。PROJECT_ID
は、バケットが関連付けられるプロジェクトの ID です。例:my-project
{ "name": "BUCKET_NAME", "location": "BUCKET_LOCATION", "storageClass": "STORAGE_CLASS", "iamConfiguration": { "uniformBucketLevelAccess": { "enabled": true }, } }
ここで
XML API
- OAuth 2.0 Playground から承認アクセス トークンを取得します。固有の OAuth 認証情報を使用するように Playground を構成します。
- 次の情報を含む .xml ファイルを作成します。
BUCKET_LOCATION
は、バケットのオブジェクト データを保存するロケーションです。例:US-EAST1
STORAGE_CLASS
はバケットのデフォルトのストレージ クラスです。例:NEARLINE
cURL
を使用して、XML API を呼び出します。curl -X PUT --data-binary @XML_FILE_NAME.xml \ -H "Authorization: Bearer OAUTH2_TOKEN" \ -H "x-goog-project-id: PROJECT_ID" \ "https://storage.googleapis.com/BUCKET_NAME"
ここで
XML_FILE_NAME
は手順 2 で作成した XML ファイルの名前です。OAUTH2_TOKEN
は、ステップ 1 で生成したアクセス トークンです。PROJECT_ID
は、バケットが関連付けられるプロジェクトの ID です。例:my-project
BUCKET_NAME
は、バケットに付ける名前で、命名要件の対象となります。例:my-bucket
<CreateBucketConfiguration> <LocationConstraint>BUCKET_LOCATION</LocationConstraint> <StorageClass>STORAGE_CLASS</StorageClass> </CreateBucketConfiguration>
ここで
次のステップ
- プロジェクト内のバケットを一覧表示する。
- バケット情報を取得する。
- バケットを移動または名前を変更する。
- バケットを削除する。
- バケットにオブジェクトをアップロードする。
- Google Cloud Console と Cloud Storage の使い方の基本を学ぶ。
使ってみる
Google Cloud を初めて使用する場合は、アカウントを作成して、実際のシナリオでの Cloud Storage のパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。
Cloud Storage 無料トライアル