このページでは、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 .