ストレージ オブジェクトのアップロードとダウンロード

このページでは、Google Distributed Cloud(GDC)のエアギャップ アプライアンス ストレージ バケットにオブジェクトをアップロードおよびダウンロードする方法について説明します。

始める前に

プロジェクト名前空間は、Management API サーバーのバケット リソースを管理します。バケットとオブジェクトを操作するには、プロジェクトが必要です。

次のオペレーションを実行するには、適切なバケット権限も必要です。バケットへのアクセス権を付与するをご覧ください。

オブジェクトの命名ガイドライン

オブジェクトの名前を付ける際は、次のガイドラインに従ってください。

  • オブジェクトの命名には UTF-8 文字を使用します。
  • 個人を特定できる情報(PII)は含めないでください。

ストレージ バケットにオブジェクトをアップロードする

オブジェクトをアップロードするには、次のコマンドを実行します。

gdcloud storage cp LOCAL_PATH s3://REMOTE_PATH
gdcloud storage cp s3://REMOTE_SOURCE_PATH s3://REMOTE_MOVE_DESTINATION_PATH
gdcloud storage mv s3://REMOTE_SOURCE_PATH s3://REMOTE_MOVE_DESTINATION_PATH

次のコマンドは、ローカル ディレクトリにあるすべてのテキスト ファイルをバケットにアップロードします。

gdcloud storage cp *.txt s3://BUCKET

次のコマンドは、ローカル ディレクトリからバケットに複数のファイルをアップロードします。

gdcloud storage cp abc1.txt abc2.txt s3://BUCKET

フォルダをバケットにアップロードするには、--recursive オプションを使用してディレクトリ ツリー全体をコピーします。次のコマンドは、ディレクトリ ツリー dir をアップロードします。

gdcloud storage cp dir s3://BUCKET --recursive

サイズの大きいオブジェクトに対してマルチパート アップロードを実行するか、アップロードするファイルが 15 MB を超える場合はマルチパート アップロードを自動的に使用します。その場合、ファイルは複数の部分に分割され、各部分のサイズは 15 MB になります。最後の部分は小さくなります。各部分は個別にアップロードされ、転送が完了すると宛先で再構築されます。

1 つの部分のアップロードが失敗した場合、すでにアップロードされている他の部分に影響を与えることなく、アップロードを再開できます。

マルチパート アップロードに関連するオプションは 2 つあります。

  • --disable-multipart: すべてのファイルのマルチパート アップロードを無効にします。
  • --multipart-chunk-size-mb=SIZE: マルチパート アップロードの各チャンクのサイズを設定します。

SIZE より大きいファイルは、自動的にマルチスレッド マルチパートとしてアップロードされます。サイズの小さいファイルは、従来の方法でアップロードされます。SIZE はメガバイト単位です。デフォルトのチャンクサイズは 15 MB です。許容される最小チャンクサイズは 5 MB で、最大チャンクサイズは 5 GB です。

ストレージ バケットからオブジェクトをダウンロードする

バケットからオブジェクトを取得するには:

gdcloud storage cp s3://BUCKET/OBJECT LOCAL_FILE_TO_SAVE

バケットから現在のディレクトリにすべてのテキスト ファイルをダウンロードするには:

gdcloud storage cp s3://BUCKET/*.txt .

バケットから現在のディレクトリにテキスト ファイル abc.txt をダウンロードするには:

gdcloud storage cp s3://BUCKET/abc.txt .

古いバージョンのファイルをダウンロードするには、まずファイルのすべてのバージョンを一覧表示します。

gdcloud storage ls s3://BUCKET/abc.txt --all-versions

出力例:

s3://my-bucket/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND
s3://my-bucket/abc.txt#ODgzNEYzQ0MtMzEzRS0xMUVFLTk2NEItMjI1MTAwQkJENjND
s3://my-bucket/abc.txt#ODNCNDEzNzgtMzEzRS0xMUVFLTlDOUMtQzRDOTAwQjg3RTg3

次に、バケットから現在のディレクトリにテキスト ファイル abc.txt の特定のバージョンをダウンロードします。

gdcloud storage cp s3://BUCKET/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND .