結論

Cloud Storage(GCS)は、Google Cloud でファイル(オブジェクト)を「バケット」という入れ物に保存するサービスです。使い始めは、コンソールの「バケット」ページで「作成」を押し、名前・ロケーション・ストレージ クラス・公開アクセスの防止を決めてバケットを作り、「アップロード」でファイルを入れます。コマンドなら gcloud storage buckets create と gcloud storage cp です。

この記事でわかること

  • バケットの作り方・アップロード・削除を、コンソールと gcloud storage の両方で
  • 4つのストレージ クラスの料金を公式の単価で計算した表と、無料枠の範囲
  • gcloud storage と Python クライアントを手元の模擬サーバーで動かした出力とエラー原文

2026年11月18日更新|Cloud Storage の公式ドキュメントで確認・gcloud CLI 570.0.0 と google-cloud-storage 3.17.1 を 127.0.0.1 の模擬サーバーで実行

この記事で実際に動かしたもの:Google Cloud CLI(gcloud storage)と Python のクライアント ライブラリを、認証情報を使わない設定で 127.0.0.1 の模擬サーバーに向けて実行した出力、バケット名の規則の検査、公式の単価での料金の計算、使い捨ての鍵での署名付き URL の生成(Google Cloud にはログインも課金もしていません)。

flowchart TD
    P[プロジェクト] --> B[バケット<br>名前は世界で1つ]
    B -->|作成時に決める| S[ロケーション 例 東京<br>ストレージ クラス]
    S --> O[オブジェクト<br>ファイルそのもの]
    O --> N[名前の / で<br>フォルダのように見える]

よく調べられることの答えを先にまとめます。

知りたいこと 答え 詳しい節
Cloud Storage とは Google Cloud でオブジェクト(ファイル)を保存するサービス Cloud Storage とは
バケットの作成 コンソールの「バケット」→「作成」、または gcloud storage buckets create コンソールでバケットを作成する手順
ファイルのアップロード バケットの「オブジェクト」タブで「アップロード」、または gcloud storage cp アップロードとダウンロード
Cloud Storage の料金 保存量×クラスの単価+操作の回数+取り出し+外への転送 料金と無料枠
無料枠 米国の3リージョンで Standard 5 GB-month・クラス A 5,000 回・クラス B 50,000 回など 料金と無料枠
ストレージ クラスの違い 読む回数が少ないほど安いクラス。ただし取り出し料金と最小保存期間がある ストレージ クラスとロケーション
gsutil と gcloud storage 公式は gcloud storage を推奨。gsutil は最小限の保守 gcloud storage コマンド一覧
S3 との違い 考え方は近い。XML API と HMAC キーで S3 向けのツールも使える Amazon S3 との違い

確認環境:Linux(x86-64)の上で、Google Cloud SDK 570.0.0(gcloud storage)と Python 3.13.18・google-cloud-storage 3.17.1 を使いました。どちらも本物の Google Cloud には接続せず、作業用の空の設定フォルダー(CLOUDSDK_CONFIG)で認証を無効にし(auth/disable_credentials)、Cloud Storage の API の送り先を 127.0.0.1 で動かした模擬サーバー(PyPI の gcp-storage-emulator 2026.7.19。Google の製品ではありません)に向けています。模擬サーバーはロケーションや名前の規則を本物どおりには扱わないため、その部分は公式ドキュメントで書きました。gcloud storage cp でのアップロードは、模擬サーバーがその送り方に対応しておらず失敗したため(原文は本文に載せます)、アップロードは Python クライアントで確かめ、gcloud のアップロードは公式ドキュメントの記載で書いています。別の模擬サーバーを動かす操作はこの環境の権限で止められたため、使っていません。コンソールの画面は操作しておらず、画面の名前は公式ドキュメントに出た語だけを「」で書きました。料金は Cloud Storage の料金ページ(米ドル)の記載です(確認日 2026年11月18日)。

本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。

(記載例)出典:株式会社RJC「Cloud Storageの使い方|バケット作成・アップロード・料金とgcloud」

Cloud Storage とは(バケット・オブジェクト・フォルダの関係)

この節では、Cloud Storage が何をするサービスで、バケット・オブジェクト・プロジェクトがどうつながっているかが分かります。

公式ドキュメントは「Cloud Storage は、Google Cloud で オブジェクト を保存するためのサービスです」と説明しています。オブジェクトは、画像・CSV・動画・バックアップなど、形式を問わないファイルのデータです。Google Cloud Storage を略して GCS と呼ぶこともあります。

用語 意味 決まりごと(公式の記載)
プロジェクト 料金や権限のまとまり すべてのバケットはどれか1つのプロジェクトに属する
バケット オブジェクトを入れる入れ物 名前は全ユーザーで共通の名前空間で一意。作成後に名前は変えられない
オブジェクト 保存したファイル 1つの最大サイズは 5 TiB。名前は UTF-8 で 1,024 バイトまで
フォルダ オブジェクトを整理する見せ方 通常のバケットでは名前の「/」で区切って表示しているだけ

使い方は4通りあります。ブラウザで操作する Google Cloud コンソール、ターミナルの gcloud storage コマンド、Python・Java・Go・Node.js などのクライアント ライブラリ、JSON と XML の REST API です。

フォルダの正体を確かめる

通常の(フラットな名前空間の)バケットには、本当のフォルダはありません。reports/2026/11/sales.csv は1つの長い名前で、コンソールや gcloud が「/」を区切りとして、フォルダのように見せています。手元で reports/… と images/… の3つを入れ、区切り文字を指定して一覧を取ると、次のようになりました。

--- list_blobs(prefix='reports/')
reports/2026/11/memo.txt 5 text/plain
reports/2026/11/sales.csv 43 text/csv
--- list_blobs(delimiter='/')  (folders look)
objects: [] prefixes: ['images/', 'reports/']

最上位には「オブジェクトが0個、接頭辞(prefix)が2つ」と返りました。これがコンソールで見える「フォルダ」です。フォルダ名を変えるときは、中のオブジェクトの名前を全部変えることになります。ファイル システムのようなフォルダを持つ「階層的な名前空間」をバケットで有効にする選択肢もあり、その場合はフォルダ名と名前の本体がそれぞれ 512 バイトまでになります。

「クラウドストレージ」との違い

「クラウドストレージ」は、ネット上にデータを置くサービス全般を指す一般の言葉です。この記事の Cloud Storage は Google Cloud の製品名で、アプリやシステムからファイルを置く場所として使うものです。個人のファイルの同期・共有が目的なら、関連記事「OneDrive(ワンドライブ)とは・使い方|料金・同期の止め方・消えた時の戻し方」で扱っています。

Google Cloud 全体の主なサービスや始め方は、関連記事「GCPとは|Google Cloudの主要サービス・料金・無料枠・始め方」で扱っています。

ストレージ クラスとロケーションの選び方(Standard・Nearline・Coldline・Archive)

この節では、4つのストレージ クラスの違いと、東京・大阪などロケーションの選び方が分かります。

ストレージ クラスは「どれくらいの頻度で読むか」で選びます。読む回数が少ないクラスほど保存の単価が安く、代わりに取り出し料金と最小保存期間がかかります。年間の耐久性はどのクラスも 99.999999999%(イレブンナイン)と公式に書かれています。

クラス(API 名) 向いている頻度 最小保存期間 取り出し料金(1 GiB) 例
Standard(STANDARD) よく読む・短期間 なし 0 USD Web の画像、処理中のデータ
Nearline(NEARLINE) 月に1回ほど 30 日 0.01 USD バックアップ
Coldline(COLDLINE) 四半期に1回ほど 90 日 0.02 USD 障害に備えた控え
Archive(ARCHIVE) 年に1回未満 365 日 0.05 USD 長く残す記録
  • バケットを作るときにクラスを指定しないと Standard になります。オブジェクトは、指定しない限りバケットの既定のクラスを引き継ぎます。
  • バケットの既定のクラスを変えても、すでにあるオブジェクトのクラスは変わりません。
  • コンソールでは、クラスを自分で選ぶ代わりに Autoclass(アクセスに応じてクラスを移す機能)も選べます。料金ページには、Autoclass のバケットのデータには取り出し料金と早期削除の料金がかからないと書かれています。
  1. 1毎日・毎週読む、すぐ消すかもしれない → Standard最小保存期間も取り出し料金もない
  2. 2月に1回ほど読む・30日以上置く → Nearline月の読み出しが保存量に近づくと Standard より高くなる
  3. 3四半期に1回ほど・90日以上置く → Coldline取り出しは 1 GiB あたり 0.02 USD
  4. 4ほぼ読まない・1年以上置く → Archive読み取りの操作の単価も高い。回数が多いと逆に高くつく
  5. 5読む頻度が読めない → Autoclassコンソールの作成画面で選べる

ロケーション(リージョン・デュアルリージョン・マルチリージョン)

ロケーションはデータを置く場所で、作成時に決めます。日本から使う場合の主な選択肢は次のとおりです。

種類 名前の例 公式の説明
リージョン asia-northeast1(東京)・asia-northeast2(大阪) 特定の1つの地域。大阪は、まれな災害に備えてデュアルリージョンやバックアップを検討するよう注意書きがある
デュアルリージョン ASIA1(東京と大阪) リージョンの特定のペア。リージョン間の冗長性がある
マルチリージョン ASIA 2つ以上のリージョンを含む広い地域(香港とインドネシアを除くアジア)

可用性の SLA(Standard)は、マルチリージョンとデュアルリージョンで 99.95%、リージョンで 99.9% と公式に書かれています。作成後にロケーションを変えたいときは、データを別のロケーションのバケットへ移すのが基本です(バケットの再配置は Storage Intelligence を構成している場合に限られます)。

Cloud Storage の料金と無料枠(公式の単価で計算した例)

この節では、料金が何で決まるかと、無料枠の範囲、クラスごとの金額の差を実際に計算した結果が分かります。

料金は「保存量×クラスの単価」「操作の回数」「取り出し(Standard 以外)」「外へのデータ転送」の合計です。アップロード(外から入るデータ転送)は無料です。料金ページの値は米ドルで、米ドル以外で支払う場合は Cloud Platform SKUs の各通貨の価格が使われる、と書かれています(2026年11月18日時点)。

無料枠(Always Free)

毎月の無料の範囲

Standard の保存 5 GB-month

クラス A の操作 5,000 回・クラス B の操作 50,000 回

北米から各 Google Cloud の宛先(オーストラリアと中国を除く)へのデータ転送 100 GB

気をつける点

対象は US-WEST1・US-CENTRAL1・US-EAST1 の合計

東京(asia-northeast1)は対象として書かれていない

Rapid Storage には無料枠がない

単価(料金ページの単一リージョンの表)

料金ページの保存の単価は「1 GiB を1時間保存する」単位で書かれています。リージョンごとの値はページでリージョンを選んで表示する形で、ここでは最初に表示される単一リージョンの表の値を使いました。東京の単価は、料金ページで Tokyo(asia-northeast1)を選んで確かめます。

クラス 保存(1 GiB・1時間) 1か月に直すと(×730時間) クラス A/B(1,000 回)
Standard 0.000027397 USD 約 0.020 USD 0.005 / 0.0004 USD
Nearline 0.000013699 USD 約 0.010 USD 0.01 / 0.001 USD
Coldline 0.000005479 USD 約 0.004 USD 0.02 / 0.01 USD
Archive 0.000001644 USD 約 0.0012 USD 0.05 / 0.05 USD

クラス A はアップロード(insert)・コピー・一覧の取得など、クラス B はオブジェクトの取得(get)などの操作です。削除の操作は無料です。インターネットへのデータ転送は、アジア宛ての場合、最初の 10 TiB まで 1 GiB あたり 0.12 USD と書かれていました。

100 GiB を置いたときの月額を計算する

上の単価で、100 GiB を1か月置き、書き込み 1万回・読み取り 10万回、読み出し量を 0・10・100 GiB と変えたときの金額を Python で計算しました(外へのデータ転送は含めていません)。

per GiB-month: {'Standard': 0.02, 'Nearline': 0.01, 'Coldline': 0.004, 'Archive': 0.0012}

100 GiB 保存, 月の読み出し量を変える (書き込み1万回・読み取り10万回)
read   0 GiB/月 -> Standard:2.09  Nearline:1.20  Coldline:1.60  Archive:5.62
read  10 GiB/月 -> Standard:2.09  Nearline:1.30  Coldline:1.80  Archive:6.12
read 100 GiB/月 -> Standard:2.09  Nearline:2.20  Coldline:3.60  Archive:10.62
100 GiB: Nearline の保存の差額が取り出し料金で消える月の読み出し量 = 100.0 GiB
100 GiB: Coldline の保存の差額が取り出し料金で消える月の読み出し量 = 80.0 GiB
100 GiB: Archive の保存の差額が取り出し料金で消える月の読み出し量 = 37.6 GiB

1保存だけなら Archive が最安

100 GiB の保存は Standard 2.00 USD に対し Archive 0.12 USD。ただし今回の条件では、読み取り10万回の操作料金(5 USD)で Archive が最も高くなった。

2読み出し量で順位が入れ替わる

月に 100 GiB 読むと、Nearline(2.20 USD)が Standard(2.09 USD)を上回った。

3損益の分かれ目は計算できる

100 GiB なら、月の読み出しが Nearline は 100 GiB、Coldline は 80 GiB、Archive は 37.6 GiB を超えると、保存で浮いた分が取り出し料金で消える。

早期削除と「削除(復元可能)」の料金

最小保存期間より前に消したり置き換えたりしたオブジェクトは、最小期間まで保存したものとして課金されます。また、新しいバケットには既定で7日間の削除(復元可能)ポリシーが付き、消したデータも保持期間が終わるまで保存料金がかかります。10 GiB を10日で消した場合と、Standard の 500 GiB を消した場合を計算しました(1時間の単価×24×日数)。

10 GiB を保存して10日で削除したとき
Standard 課金される日数  10 日 -> 0.0658 USD
Nearline 課金される日数  30 日 -> 0.0986 USD
Coldline 課金される日数  90 日 -> 0.1183 USD
Archive  課金される日数 365 日 -> 0.1440 USD
Standard 500 GiB を削除 -> 削除(復元可能)7日の間の保存料金 2.30 USD
Standard 500 GiB を削除 -> 削除(復元可能)30日の間の保存料金 9.86 USD
Standard 500 GiB を削除 -> 削除(復元可能)90日の間の保存料金 29.59 USD

一時ファイルを大量に書いては消す用途では、削除(復元可能)の保持期間の分も費用に入れて見積もります。保持期間は 7〜90 日で設定でき、0 にすると無効にできます(公式の記載)。

コンソールでバケットを作成する手順

この節では、Google Cloud コンソールでバケットを作る手順と、各段階で決めることが分かります。

「バケット」ページの「作成」から、5つの段階で設定して「作成」を押します。コンソールで作るには、プロジェクトでストレージ管理者(roles/storage.admin)のロールが要る、と公式に書かれています。

1

「バケット」ページで「作成」をクリック

Cloud Storage の「バケット」ページを開き、「作成」をクリックする。

入口

2

「始める」で名前を入れる

世界で一意の名前を入れる。必要なら「ラベル」を開いて「ラベルを追加」。「続行」で次へ。

名前は後から変えられない

3

「データの保存場所の選択」でロケーションを選ぶ

ロケーション タイプ(リージョン・デュアルリージョン・マルチリージョン)と場所を選ぶ。「続行」で次へ。

東京なら asia-northeast1

4

ストレージ クラスを選ぶ

既定のストレージ クラスか「Autoclass」を選ぶ。階層的な名前空間などの選択肢もこの段階にある。「続行」で次へ。

迷ったら Standard

5

「オブジェクトへのアクセスを制御する方法を選択する」

公開アクセスの防止と、アクセス制御のモデルを選ぶ。公開する目的がなければ、公開アクセスの防止を外さない。「続行」で次へ。

安全の設定

6

「オブジェクト データを保護する方法を選択する」→「作成」

「削除(復元可能)ポリシー」の保持日数や「データ暗号化」を選び、「作成」をクリックする。

既定は7日間

暗号化は、何もしなくてもサーバー側で常に行われます(公式の記載)。自分で鍵を管理したい場合は、顧客管理の暗号鍵(CMEK)などを選べます。

バケット名の規則を手元で検査する

名前は英小文字・数字・ハイフン・アンダースコア・ドットで 3〜63 文字、先頭と末尾は英数字、IP アドレスの形・「goog」で始まる名前・「google」やそれに似た表記を含む名前は使えません。公式の規則を Python の関数にして、例をかけた結果です。

rjc-sales-reports-2026       -> OK
My-Travel-Maps               -> 使えない文字(大文字・空白など)
test bucket                  -> 使えない文字(大文字・空白など)
ab                           -> 3〜63文字でない
my_google_bucket             -> google(または似た表記)を含む
googdata                     -> goog で始まる
192.168.5.4                  -> IPアドレスの形
-start-with-hyphen           -> 先頭か末尾が英数字でない
logs.example.com             -> OK
aaaaaaaaaaaaaaaaaaaaaaaaaaaa -> 3〜63文字でない

手元の gcloud は、gs://Upper_Case_Bucket や gs://ab でも送る前に止めず、模擬サーバーがそのまま作成しました。名前の規則は送り先(本物の Cloud Storage)で判定されるため、自動化のスクリプトでは送る前に自分で検査しておくと、失敗の原因を早く見つけられます。ドットを含む名前(logs.example.com など)は、ドメインの所有権の確認が要ります。バケット名は誰でも確かめられるため、メールアドレスや個人の情報を入れないよう公式に案内されています。

ファイルのアップロードとダウンロード(コンソール・gcloud storage cp)

この節では、コンソールと gcloud でファイルを入れる・取り出す方法と、必要なロールが分かります。

コンソールでは、バケット名をクリックして「オブジェクト」タブを開き、ファイルをドラッグするか「アップロード」から入れます。Chrome を使っている場合はフォルダごとのアップロードもできます。

# ファイルを1つアップロード
gcloud storage cp Desktop/dog.png gs://my-bucket

# フォルダの中身をまとめてアップロード(サブフォルダも)
gcloud storage cp --recursive my-folder gs://my-bucket

# ダウンロード(バケット → 手元)
gcloud storage cp gs://my-bucket/dog.png ./dog.png

アップロードには、バケットに対する Storage オブジェクト ユーザー(roles/storage.objectUser)のロールが要ります。コンソールから操作する場合は、このロールに含まれない storage.buckets.list 権限も要るため、公式ドキュメントはストレージ管理者のロールを管理者に頼むよう案内しています。

手元では、gcloud storage cp のダウンロードは模擬サーバーから正しく取り出せました。アップロードは、模擬サーバーが gcloud の送り方に対応しておらず、次のように失敗しました(本物の Cloud Storage での結果ではありません)。

$ gcloud storage cp up/a.txt gs://rjc-cli-demo-t618
Copying file://up/a.txt to gs://rjc-cli-demo-t618/a.txt
ERROR: Task 'gs://rjc-cli-demo-t618/a.txt' failed: ConnectionError(ProtocolError('Connection aborted.', RemoteDisconnected('Remote end closed connection without response')))

$ gcloud storage cp gs://rjc-cli-demo-t618/backup/up/b.txt /srv/s4/r17/t618/dl_b.txt
Copying gs://rjc-cli-demo-t618/backup/up/b.txt to file:///srv/s4/r17/t618/dl_b.txt
(exit 0)

本物の環境で Connection aborted が出たときは、社内のプロキシや回線の状態を先に確かめます。大きなファイルを複数送るときは、Python の upload_many_blobs_with_transfer_manager のように同時に送る方法も公式のサンプルにあります。

gcloud storage コマンド一覧(ls・du・cat・rm・rsync の実行結果)

この節では、よく使う gcloud storage コマンドの書き方と、実際の出力が分かります。

Cloud Storage のコマンドは gcloud storage を使います。公式ドキュメントは「gsutil は、Cloud Storage の推奨の CLI ではありません」と明記し、gsutil は最小限の保守で、削除(復元可能)などの新しい機能に対応していないと説明しています。

やりたいこと コマンド
バケットを作る gcloud storage buckets create gs://NAME --location=asia-northeast1
バケットの一覧 gcloud storage buckets list
中身の一覧(-r で全部、-l で大きさと日時) gcloud storage ls gs://NAME
容量(-s で合計) gcloud storage du -s gs://NAME
中身を表示 gcloud storage cat gs://NAME/file.txt
オブジェクトを消す gcloud storage rm gs://NAME/file.txt
フォルダを同期(先に --dry-run) gcloud storage rsync dir gs://NAME/dir --recursive
手元のファイルのハッシュ gcloud storage hash file.txt

オプションを付けた作成の例は、公式ドキュメントでは次の形です。

gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_ID \
  --default-storage-class=STANDARD --location=asia-northeast1 \
  --uniform-bucket-level-access --soft-delete-duration=7d

実行した出力

模擬サーバーに Python でオブジェクトを入れてから、gcloud storage で一覧・容量・中身を出しました。

$ gcloud storage ls gs://rjc-cli-demo-t618
gs://rjc-cli-demo-t618/a.txt
gs://rjc-cli-demo-t618/backup/

$ gcloud storage ls -l gs://rjc-cli-demo-t618/backup/up/
         2  2026-11-18T01:05:46Z  gs://rjc-cli-demo-t618/backup/up/a.txt
         3  2026-11-18T01:05:46Z  gs://rjc-cli-demo-t618/backup/up/b.txt
         2  2026-11-18T01:05:46Z  gs://rjc-cli-demo-t618/backup/up/old.txt
                                  gs://rjc-cli-demo-t618/backup/up/sub/
TOTAL: 3 objects, 7 bytes (7.00B)

$ gcloud storage du -s gs://rjc-cli-demo-t618
13           gs://rjc-cli-demo-t618

$ gcloud storage cat gs://rjc-cli-demo-t618/backup/up/b.txt
bb

ls は1階層だけを表示し、backup/ はフォルダのように末尾に「/」が付きました。ls -l の TOTAL には、その階層のオブジェクトだけ(sub/ の中は含まない)が数えられています。

rsync は --dry-run で先に見る

手元のフォルダ(a.txt は同じ中身、b.txt は変更、d.txt は新規)と、バケット側(old.txt は手元に無い)を同期する前に、--dry-run で何が起きるかを出しました。

$ gcloud storage rsync up gs://rjc-cli-demo-t618/backup/up --recursive --delete-unmatched-destination-objects --dry-run
Would copy file:///srv/s4/r17/t618/up/a.txt to gs://rjc-cli-demo-t618/backup/up/a.txt#1794963946635411940
Would copy file:///srv/s4/r17/t618/up/b.txt to gs://rjc-cli-demo-t618/backup/up/b.txt#1794963946637114094
Would copy file:///srv/s4/r17/t618/up/d.txt to gs://rjc-cli-demo-t618/backup/up/d.txt
Would remove gs://rjc-cli-demo-t618/backup/up/old.txt#1794963946640187075
Would copy file:///srv/s4/r17/t618/up/sub/c.txt to gs://rjc-cli-demo-t618/backup/up/sub/c.txt#1794963946638691782

$ gcloud storage rsync up gs://rjc-cli-demo-t618/backup/up --recursive --checksums-only --dry-run
Would set mtime for gs://rjc-cli-demo-t618/backup/up/a.txt#1794963946635411940
Would copy file:///srv/s4/r17/t618/up/b.txt to gs://rjc-cli-demo-t618/backup/up/b.txt#1794963946637114094
Would copy file:///srv/s4/r17/t618/up/d.txt to gs://rjc-cli-demo-t618/backup/up/d.txt
Would set mtime for gs://rjc-cli-demo-t618/backup/up/sub/c.txt#1794963946638691782
  • --delete-unmatched-destination-objects を付けると、手元に無い old.txt が「Would remove」になりました。公式ドキュメントも、送り元と送り先の組み合わせを間違えるとデータがすぐ消える、と注意しています。
  • Python で入れたオブジェクト(更新日時の情報が無い)に対し、既定の比べ方では中身が同じ a.txt もコピーの対象になりました。--checksums-only でハッシュで比べると、同じ中身のものは「Would set mtime」(日時の情報を付けるだけ)に変わりました(模擬サーバーでの結果)。

AWS の aws s3 cp・aws s3 sync と並べて覚えたい場合は、関連記事「aws s3コマンド一覧|cp・sync・ls実行例とオプション早見表」で扱っています。

バケットを消す

gcloud storage buckets delete は空のバケットだけを消し、中身が残っていると失敗します(誤って中身を消さないため)。中身ごと消すときは gcloud storage rm --recursive gs://BUCKET_NAME です。模擬サーバーでも、中身があるバケットの削除は次のように失敗しました。

$ gcloud storage buckets delete gs://rjc-cli-demo-t618
Removing gs://rjc-cli-demo-t618/...
ERROR: Task 'gs://rjc-cli-demo-t618/' failed: GcsConflictError('')

Python クライアント(google-cloud-storage)で操作する

この節では、Python からバケットを作り、アップロード・一覧・ダウンロード・削除する書き方と、そのときのエラーが分かります。

インストールは pip install --upgrade google-cloud-storage、手元の開発では gcloud auth application-default login で認証情報(ADC)を用意します。ADC を用意すると、コードの中に鍵を書かずに storage.Client() だけで使えます。

from google.cloud import storage

client = storage.Client()  # ADC の認証情報とプロジェクトを使う
bucket = client.create_bucket("rjc-demo-bucket-t618", location="ASIA-NORTHEAST1")

blob = bucket.blob("reports/2026/11/sales.csv")
blob.upload_from_string("date,amount\n2026-11-01,1200\n", content_type="text/csv")
# 手元のファイルなら blob.upload_from_filename("sales.csv")

for b in client.list_blobs("rjc-demo-bucket-t618", prefix="reports/"):
    print(b.name, b.size, b.content_type)

print(bucket.blob("reports/2026/11/sales.csv").download_as_text())

公式ドキュメントのサンプルは、location を指定しないと US のマルチリージョン・Standard でバケットを作る、と説明しています。日本のリージョンに置きたいときは、上のように location を書きます。

模擬サーバーで動かした出力とエラー

同じコードを、認証なし(AnonymousCredentials)で api_endpoint を 127.0.0.1 の模擬サーバーに向けて動かしました。

google-cloud-storage 3.17.1 Python 3.13.18
--- list_blobs(prefix='reports/')
reports/2026/11/memo.txt 5 text/plain
reports/2026/11/sales.csv 43 text/csv
--- download
'date,amount\n2026-11-01,1200\n2026-11-02,980\n'
--- missing object
NotFound 404 GET http://127.0.0.1:9023/download/storage/v1/b/rjc-demo-bucket-t618/o/nothing.txt?alt=media: ('Request failed with status code', 404, 'Expected one of', <H
--- duplicate bucket
Conflict 409 POST http://127.0.0.1:9023/storage/v1/b?project=demo-project&prettyPrint=false: You already own this bucket. Please select another name.
--- delete non-empty bucket
Conflict 409 DELETE http://127.0.0.1:9023/storage/v1/b/rjc-demo-bucket-t618?prettyPrint=false: unknown error
deleted; buckets now: []
  • 無いオブジェクトを読むと google.api_core.exceptions.NotFound(404)、同じ名前のバケットは Conflict(409)になりました。try / except NotFound で分けて扱えます。
  • 中身のあるバケットは bucket.delete() で 409 になり、オブジェクトを先に消すと削除できました。bucket.delete(force=True) で中身ごと消す方法もありますが、消えたものは保持期間を過ぎると戻せません。
  • 模擬サーバーは location を無視して US と返しました。ロケーションの扱いは公式ドキュメントで確かめています。

同じことを AWS の SDK でする書き方は、関連記事「boto3でS3を操作する方法|アップロード・ダウンロード・一覧取得」で扱っています。

公開アクセスの防止と IAM の考え方

この節では、意図せずファイルが誰でも見られる状態になるのを防ぐ設定と、権限(IAM ロール)の選び方が分かります。

公開アクセスの防止は、allUsers(誰でも)や allAuthenticatedUsers に権限を与えることを止める設定です。有効なバケットでこれらに権限を付けようとすると 412 Precondition Failed、公開のつもりの URL を開くと 401 か 403 になります。署名付き URL は影響を受けません。

# 状態の確認(公式ドキュメントの書き方)
gcloud storage buckets describe gs://BUCKET_NAME --format="default(public_access_prevention)"

# 有効にする
gcloud storage buckets update gs://BUCKET_NAME --public-access-prevention

コンソールでは、バケット名→「権限」タブ→「公開アクセス」カードで状態を確かめられます。有効にすると、すでにある公開の設定は残ったまま上書きされて公開でなくなり、反映には最大で約10分かかります。組織のポリシーで上の階層から適用されている場合は、状態が inherited と表示されます。

ファイルを社外の人に渡したいとき

避けるバケット全体を allUsers に公開して、URL を伝える。ほかのファイルまで誰でも見られる状態になる
↔
代わりに公開アクセスの防止は有効のまま、そのファイルだけ期限つきの署名付き URL を作って渡す

見分ける問い:「期限が過ぎても見られてよいファイルか」

主な IAM ロール

ロール ID できること(公式の説明の要約)
roles/storage.objectViewer オブジェクトとメタデータの閲覧、一覧の表示
roles/storage.objectCreator オブジェクトの作成だけ(閲覧・削除・上書きはできない)
roles/storage.objectUser オブジェクトの作成・読み取り・更新・削除
roles/storage.objectAdmin オブジェクトの完全な管理
roles/storage.admin バケットとオブジェクトの完全な管理

ロールはプロジェクト全体にも、個別のバケットにも付けられます。プロジェクト全体の基本ロール(閲覧者・編集者・オーナー)は Cloud Storage 以外の権限も含むため、公式ドキュメントは本番環境での使用を最小限にするよう勧めています。アップロードだけするプログラムには objectCreator のように、目的に合う最小のロールを選び、付与は管理者に頼みます。

署名付き URL の考え方(有効期限と作り方)

この節では、署名付き URL が何で、どこまで有効にできるかと、作ったときの URL の中身が分かります。

署名付き URL は、期限つきで特定のオブジェクトの読み書きを許す URL です。URL を持っている人なら、Google アカウントの有無にかかわらず使えるため、渡す相手と期限を絞ります。V4 の署名の有効期限は最大 604,800 秒(7日間)です。

この環境で作った使い捨ての鍵(実在のアカウントではありません)で、Python から 15 分有効な URL を作り、中身を分解しました(送信はしていません)。

host: storage.googleapis.com path: /rjc-demo-bucket-t618/reports/2026/11/sales.csv
  X-Goog-Algorithm = GOOG4-RSA-SHA256
  X-Goog-Credential = signer@demo-project.iam.gserviceaccount.com/20261118/auto/storage/goog4_request
  X-Goog-Date = 20261118T010913Z
  X-Goog-Expires = 900
  X-Goog-SignedHeaders = host
  X-Goog-Signature = 25acf972269254e3...(512 hex chars)
PUT url has X-Goog-SignedHeaders: content-type;host
7 days: OK
8 days: ValueError: Max allowed expiration interval is seven days 604800
  • X-Goog-Expires=900 が 15 分、X-Goog-Credential に署名した主体と日付が入ります。
  • アップロード用(PUT)で content_type を指定すると、署名に content-type が含まれました。受け取る側は同じ Content-Type で送らないと署名が合いません。
  • 8日を指定すると、ライブラリが送る前に ValueError で止めました。

gcloud では gcloud storage sign-url gs://BUCKET/OBJECT --duration=10m の形です。公式のリファレンスでは、既定の期間は1時間、システム管理の鍵で署名するときは最大12時間、秘密鍵のファイルやサービス アカウントで認証したアカウントでは最大7日間と書かれています。秘密鍵のファイルは安全に保管するよう注意書きがあります。

アップロードされたファイルを DB とストレージのどちらに置くかの考え方は、関連記事「ファイルアップロードの保存先設計|DBかストレージかの判断表と命名規則」で扱っています。

ライフサイクル・バージョニング・削除(復元可能)

この節では、時間がたったデータを自動で安いクラスに移す・消す設定と、消したデータを戻す仕組みが分かります。

ライフサイクル管理は、条件に合うオブジェクトに「削除」「クラスの変更」「未完了のマルチパート アップロードの中止」を自動で行う設定です。条件には経過日数(age)・名前の接頭辞(matchesPrefix)・接尾辞・現在のクラスなどを使えます。設定の変更が反映されるまで最大24時間かかることがあります。

{
  "lifecycle": {
    "rule": [
      {
        "action": {"type": "SetStorageClass", "storageClass": "NEARLINE"},
        "condition": {"age": 30, "matchesStorageClass": ["STANDARD"], "matchesPrefix": ["logs/"]}
      },
      {
        "action": {"type": "Delete"},
        "condition": {"age": 365, "matchesPrefix": ["logs/"]}
      },
      {
        "action": {"type": "AbortIncompleteMultipartUpload"},
        "condition": {"age": 7}
      }
    ]
  }
}

このファイルを gcloud storage buckets update gs://BUCKET_NAME --lifecycle-file=lifecycle.json で設定し、describe で読み戻した結果です(模擬サーバー)。

$ gcloud storage buckets describe gs://rjc-cli-demo-t618 --format="default(lifecycle_config)"
lifecycle_config:
  rule:
  - action:
      storageClass: NEARLINE
      type: SetStorageClass
    condition:
      age: 30
      matchesPrefix:
      - logs/
      matchesStorageClass:
      - STANDARD
  - action:
      type: Delete
    condition:
      age: 365
      matchesPrefix:
      - logs/

手元の gcloud は、action の type をわざと Remove(存在しない名前)にしたファイルも送る前に止めず、模擬サーバーが受け付けました。綴りの誤りは送り先で判定されるため、設定後は describe で読み戻して確かめます。ライフサイクルでのクラスの変更は Standard→Nearline→Coldline→Archive の向き(読む頻度が少ないクラスへ)だけです。ライフサイクルを外すときは --clear-lifecycle です。

バージョニングと削除(復元可能)

仕組み 何を守るか コマンド・既定 費用の注意
オブジェクトのバージョニング 上書き・削除の前の版 buckets update --versioning(既定は無効) 前の版も同じ単価で課金。版の数の上限は既定で無い
削除(復元可能) 消したオブジェクト・バケット 既定で7日間。7〜90日、0で無効 保持期間中も保存料金がかかる
ライフサイクル 費用(自動で移す・消す) buckets update --lifecycle-file ライフサイクルによるクラスの変更には早期削除の料金がかからない

バージョニングを有効にするなら、前の版を一定日数で消すライフサイクルの規則(daysSinceNoncurrentTime など)を一緒に置く例が、公式の構成例にあります。消したオブジェクトは、保持期間内なら gcloud storage restore などで戻せます。

Amazon S3 との違い(対応表)

この節では、AWS の S3 を使ったことがある人向けに、言葉とコマンドの対応が分かります。

どちらも「バケットにオブジェクトを入れる」オブジェクト ストレージで、考え方は近いサービスです。違いは、名前の一意の範囲・CLI・クラスの名前などにあります(どちらが優れているかではなく、事実の対応です)。

項目 Cloud Storage Amazon S3
入れ物と中身 バケット・オブジェクト バケット・オブジェクト
バケット名の一意の範囲 全ユーザー共通の名前空間 パーティション(aws など)の中で一意
バケット名の変更 できない(新しく作って移す) できない
CLI gcloud storage cp・rsync aws s3 cp・sync
Python の SDK google-cloud-storage boto3
期限つきの URL 署名付き URL(V4 は最大7日) 署名付き URL(CLI・SDK で最大7日)
公開を止める設定 公開アクセスの防止 S3 Block Public Access

Cloud Storage には S3 互換の XML API があり、エンドポイントを https://storage.googleapis.com、リージョンを auto、認証を Cloud Storage の HMAC キー(アクセス ID は GOOG で始まる)に変えると、boto3 などの S3 向けのツールからも使える、と公式の移行ガイドに書かれています。

Cloud Storage がうまくいかないときの症状表

この節では、作成・アップロード・削除・公開でつまずいたときの原因と確かめ方が分かります。

まず、出ている数字(403・404・409・412)と、どの操作で出たかを見ます。原文は手元の模擬サーバーと gcloud で出たもの、または公式ドキュメントの記載です。

症状・原文 原因 確かめ方・直し方
HTTPError 409: You already own this bucket. Please select another name. 同じ名前のバケットがすでにある(名前は世界で一意) 別の名前にする。会社名・用途・日付などを組み合わせる
バケットの作成で名前が通らない 大文字・空白・google を含む・3文字未満など 命名規則を送る前に検査する(上の Python の例)
One or more URLs matched no objects. オブジェクト名の綴り・フォルダ(接頭辞)の違い gcloud storage ls -r で実際の名前を見る
NotFound 404 GET …(Python) 無いオブジェクトを読んだ blob.exists() で確かめるか except NotFound
GcsConflictError・409(バケットの削除) 中身が残っている 中身ごと消すなら gcloud storage rm --recursive
412 Precondition Failed(公開の設定) 公開アクセスの防止が有効 公開せず、署名付き URL で渡す
403(アップロード・一覧) ロールが足りない 必要なロール(objectUser など)を管理者に頼む
Max allowed expiration interval is seven days 604800 署名付き URL の期限が7日を超えた 7日以内にする
東京に作ったつもりが US になった location を指定しなかった(Python の既定は US) --location・location= を必ず書く
消したのに料金が減らない 削除(復元可能)の保持期間・最小保存期間・前の版 保持期間とバージョニングの設定を確かめる
  • 1ロケーションを決めて書いた東京は asia-northeast1。作成後の変更は、データを別のバケットへ移す形になる
  • 2公開アクセスの防止を外していない外部に渡すファイルは署名付き URL で
  • 3削除(復元可能)とバージョニングの費用を見積もった一時ファイルを多く書き換える用途では保持期間の分も入れる
  • 4rsync の削除つきは --dry-run を先にWould remove の行を必ず読む

どのクラス・どの方法を選ぶか(判断表)

この節では、用途ごとに、ストレージ クラス・ロケーション・操作の方法をどう決めるかが分かります。

迷ったら「東京の Standard、公開アクセスの防止は有効、操作は gcloud storage」から始め、使い方が見えてからクラスとライフサイクルを足します。

用途 クラス ロケーション 操作の方法
Web アプリのアップロード画像 Standard アプリと同じリージョン クライアント ライブラリ+署名付き URL
毎日のバックアップ(月1回ほど見る) Nearline+ライフサイクルで削除 東京、または ASIA1 gcloud storage rsync(--dry-run で確認)
年に1回も読まない記録 Archive 要件に合わせる ライフサイクルで Archive へ移す
読む頻度が読めないデータ Autoclass 要件に合わせる コンソールで作成時に選ぶ
分析用の大きなデータ Standard 処理するサービスと同じ場所 gcloud storage cp --recursive
無料枠の範囲で試す Standard US-WEST1・US-CENTRAL1・US-EAST1 コンソールで少量を試し、終わったら消す
S3 向けのツールをそのまま使う 用途による 用途による XML API+HMAC キー

機密情報や個人情報を置く前には、提供元の最新の規約・データの扱いの説明と、所属先の決まりを確かめます。

Cloud Storage の使い方に関するよくある質問

Q. Cloud Storage とは何ですか?
Google Cloud でファイル(オブジェクト)を保存するサービスです。バケットという入れ物を作り、その中にオブジェクトを入れます。GCS と略されることもあります。

Q. Cloud Storage は無料で使えますか?
Always Free の範囲(US-WEST1・US-CENTRAL1・US-EAST1 の合計で Standard 5 GB-month、クラス A 5,000 回、クラス B 50,000 回など)は毎月無料です。東京のリージョンは対象として書かれていません(2026年11月18日時点の料金ページ)。

Q. バケットの名前は後から変えられますか?
変えられません。新しい名前でバケットを作り、中身を移します。

Q. gsutil と gcloud storage はどちらを使えばよいですか?
公式ドキュメントは gcloud storage を推奨しています。gsutil は最小限の保守で、削除(復元可能)などの新しい機能に対応していません。

Q. フォルダはどうやって作りますか?
通常のバケットでは、オブジェクト名に「reports/2026/」のような接頭辞を付けるとフォルダのように表示されます。コンソールで空のフォルダを作ると、0 バイトの目印のオブジェクトが作られます。

Q. ファイルを誰でも見られるように公開できますか?
公開アクセスの防止を外し、allUsers に閲覧の権限を与えると公開になりますが、バケットの中のほかのファイルまで見られる状態になりやすいため、この記事では手順を載せていません。相手を限るなら署名付き URL が向いています。

Q. 1つのファイルの大きさに上限はありますか?
1つのオブジェクトの最大サイズは 5 TiB です。同じ名前のオブジェクトへの書き込みは1秒に1回まで、という目安もあります。

Q. Nearline や Archive に入れたファイルはすぐ読めますか?
読めます。公式ドキュメントは Archive も低いレイテンシでアクセスできると説明しています。ただし取り出し料金がかかり、最小保存期間より前に消すと期間の残りの分も課金されます。

Q. 消したファイルは戻せますか?
削除(復元可能)が有効なら、保持期間(既定は7日間)の間は戻せます。バージョニングを有効にしていれば、上書きの前の版も残ります。

Q. ロケーションは作成後に変えられますか?
データを別のロケーションのバケットへ移す方法が基本です。バケットの再配置という機能もありますが、Storage Intelligence を構成している場合に限られます。

まとめ

  • Cloud Storage は、バケットにオブジェクト(ファイル)を保存する Google Cloud のサービス。フォルダは名前の「/」で見せているだけ。
  • 作成時に決めるのは、名前(世界で一意・変更不可)・ロケーション(東京は asia-northeast1)・ストレージ クラス・公開アクセスの防止・削除(復元可能)。
  • 料金は保存・操作・取り出し・外への転送の合計。100 GiB の計算では、読み取りの回数や量しだいで Archive や Nearline が Standard より高くなった。
  • コマンドは gcloud storage(cp・ls・du・rm・rsync)。rsync の削除つきは --dry-run で「Would remove」を先に読む。
  • 外部に渡すファイルは公開せず、期限つきの署名付き URL(V4 は最大7日)で。権限は目的に合う最小のロールに絞る。

参考・出典

確認日:2026年11月18日

  • Google Cloud「Cloud Storage のプロダクト概要」:https://docs.cloud.google.com/storage/docs/introduction?hl=ja
  • Google Cloud「ストレージ クラス」:https://docs.cloud.google.com/storage/docs/storage-classes?hl=ja
  • Google Cloud「バケットについて」(命名規則):https://docs.cloud.google.com/storage/docs/buckets?hl=ja
  • Google Cloud「バケットを作成する」:https://docs.cloud.google.com/storage/docs/creating-buckets?hl=ja
  • Google Cloud「オブジェクトをアップロードする」:https://docs.cloud.google.com/storage/docs/uploading-objects?hl=ja
  • Google Cloud「バケットのロケーション」:https://docs.cloud.google.com/storage/docs/locations?hl=ja
  • Google Cloud「Cloud Storage の料金」:https://cloud.google.com/storage/pricing?hl=ja
  • Google Cloud「割り当てと上限」:https://docs.cloud.google.com/storage/quotas?hl=ja
  • Google Cloud「フォルダ」:https://docs.cloud.google.com/storage/docs/folders?hl=ja
  • Google Cloud「gsutil ツール」:https://docs.cloud.google.com/storage/docs/gsutil?hl=ja
  • Google Cloud「gcloud storage rsync」:https://docs.cloud.google.com/sdk/gcloud/reference/storage/rsync
  • Google Cloud「gcloud storage sign-url」:https://docs.cloud.google.com/sdk/gcloud/reference/storage/sign-url
  • Google Cloud「バケットを削除する」:https://docs.cloud.google.com/storage/docs/deleting-buckets?hl=ja
  • Google Cloud「Cloud Storage クライアント ライブラリ」:https://docs.cloud.google.com/storage/docs/reference/libraries?hl=ja
  • Google Cloud「公開アクセスの防止」:https://docs.cloud.google.com/storage/docs/public-access-prevention?hl=ja
  • Google Cloud「公開アクセスの防止を使用する」:https://docs.cloud.google.com/storage/docs/using-public-access-prevention?hl=ja
  • Google Cloud「Cloud Storage の IAM ロール」:https://docs.cloud.google.com/storage/docs/access-control/iam-roles?hl=ja
  • Google Cloud「署名付き URL」:https://docs.cloud.google.com/storage/docs/access-control/signed-urls?hl=ja
  • Google Cloud「オブジェクトのライフサイクル管理」:https://docs.cloud.google.com/storage/docs/lifecycle?hl=ja
  • Google Cloud「オブジェクトのライフサイクル管理を使用する」:https://docs.cloud.google.com/storage/docs/managing-lifecycles?hl=ja
  • Google Cloud「ライフサイクル構成の例」:https://docs.cloud.google.com/storage/docs/lifecycle-configurations?hl=ja
  • Google Cloud「オブジェクトのバージョニングを使用する」:https://docs.cloud.google.com/storage/docs/using-object-versioning?hl=ja
  • Google Cloud「削除(復元可能)」:https://docs.cloud.google.com/storage/docs/soft-delete?hl=ja
  • Google Cloud「デフォルトの暗号化」:https://docs.cloud.google.com/storage/docs/encryption/default-keys?hl=ja
  • Google Cloud「Amazon S3 からの簡単な移行」:https://docs.cloud.google.com/storage/docs/aws-simple-migration?hl=ja
  • AWS「General purpose bucket naming rules」:https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html
  • AWS「Download and upload objects with presigned URLs」:https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-presigned-url.html
  • AWS「Blocking public access to your Amazon S3 storage」:https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-control-block-public-access.html

本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。

(記載例)出典:株式会社RJC「Cloud Storageの使い方|バケット作成・アップロード・料金とgcloud」

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。

WE ARE HIRING

RJCで一緒に開発しながら、
成長を楽しみませんか?

RJCは、Web・モバイル・AIを活用した開発プロジェクトで、テックリードやPM・PMOも活躍するシステム開発会社です。会社を知る、待遇を確かめる、話を聞いてみる。気になるところ見てみてください!

  • 127日年間休日
  • 12時間平均残業時間
  • 毎日ガチャ遊びココロも大切にする福利厚生。アマギフなどの賞品ラインナップ!

ほかにも、チケットレストラン、書籍読み放題、2年ごとの慰労報奨(休暇 or 金一封)、11期連続の黒字決算。

ABOUT RJC RJCがどんな会社か知る 考え方、研修、働き方、福利厚生、社員の前職まで。RJCのことが丸わかり! RJC丸わかりページへ JOB DESCRIPTION 仕事内容・待遇を見てみる 仕事内容、給与・待遇、選考の流れ。経験者も未経験も!応募前に知りたいこと、まとめました! 募集要項を見る ENTRY エントリーする エントリーは1〜2分・履歴書不要です。まずは話を聞いてみたい、という方でも歓迎です! エントリーフォームへ

成長のヒミツ、 ぜんぶ丸わかり