このページでは、ローカル ファイル システムから Cloud Storage バケットにオブジェクトをアップロードする方法について説明します。アップロードされるオブジェクトは、保存するデータとそれに関連するメタデータから構成されます。ファイルサイズに基づいた最適なアップロード方法を選択する方法など、コンセプトの概要については、アップロードとダウンロードをご覧ください。
メモリからアップロードする手順については、メモリからオブジェクトをアップロードするをご覧ください。
必要なロール
バケットにオブジェクトをアップロードするために必要な権限を取得するには、バケットに対する Storage オブジェクト ユーザー(roles/storage.objectUser)IAM ロールを付与するよう管理者に依頼してください。この事前定義ロールには、バケットにオブジェクトをアップロードするために必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。
必要な権限
storage.objects.createstorage.objects.delete- この権限は、既存のオブジェクトを上書きするアップロードにのみ必要です。
storage.objects.get- この権限は、Google Cloud CLI を使用してこのページのタスクを遂行する場合にのみ必要です。
storage.objects.list- この権限は、Google Cloud CLI を使用してこのページのタスクを遂行する場合にのみ必要です。アップロードしたオブジェクトを Google Cloud コンソールで確認する場合も、この権限が必要です。
Google Cloud コンソールを使用してこのページのタスクを遂行する場合は、storage.buckets.list 権限も必要です。この権限は Storage オブジェクト ユーザー(roles/storage.objectUser)ロールには割り当てられていません。この権限を取得するには、プロジェクトのストレージ管理者(roles/storage.admin)ロールの付与を管理者へ依頼します。
これらの権限は、他の事前定義ロールやカスタムロールを使用して取得することもできます。
バケットに対するロールの付与については、バケットでの IAM ポリシーの設定と管理をご覧ください。
バケットにオブジェクトをアップロードする
オブジェクトをバケットにアップロードするには、次の手順を行います。
コンソール
- Google Cloud コンソールで Cloud Storage の [バケット] ページに移動します。
バケットのリストで、オブジェクトをアップロードするバケットの名前をクリックします。
バケットの [オブジェクト] タブで次のいずれかを行います。
デスクトップまたはファイル マネージャーから Google Cloud コンソールのメインペインにファイルをドラッグします。
[アップロード] > [ファイルをアップロード] をクリックし、表示されたダイアログでアップロードするファイルを選択してから、[開く] をクリックします。
失敗した Cloud Storage オペレーションの詳細なエラー情報を Google Cloud コンソールで確認する方法については、トラブルシューティングをご覧ください。
コマンドライン
gcloud storage cp コマンドを使用します。
gcloud storage cp OBJECT_LOCATION gs://DESTINATION_BUCKET_NAME
各変数の意味は次のとおりです。
OBJECT_LOCATIONは、オブジェクトへのローカルパスです。たとえばDesktop/dog.pngです。DESTINATION_BUCKET_NAMEは、オブジェクトをアップロードするバケットの名前です。たとえばmy-bucketです。
成功した場合は、次の例のようなレスポンスになります。
Completed files 1/1 | 164.3kiB/164.3kiB
コマンドフラグを使用すると、アップロードしたオブジェクトの一部として、固定キーとカスタム オブジェクト メタデータを設定できます。
クライアント ライブラリ
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 に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。
次のサンプルでは、個々のオブジェクトをアップロードします。
次のサンプルでは、複数のオブジェクトを同時にアップロードします。