すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:OSS でディレクトリをアップロードおよびダウンロードする方法

最終更新日:Jun 24, 2026

従来のファイルシステムの階層構造とは異なり、Object Storage Service (OSS) はフラット構造を使用してデータを保存します。すべてのデータはバケット内にオブジェクトとして保存されます。データ管理を簡素化するため、OSS コンソールでは、名前の末尾がフォワードスラッシュ (/) で終わるオブジェクトをディレクトリとして扱います。これにより、ファイルシステムと同様のユーザーエクスペリエンスが提供されます。このトピックでは、ディレクトリをアップロードおよびダウンロードするいくつかの方法について説明します。

OSS コンソール

  • ディレクトリのアップロード:ディレクトリをアップロードするには、アップロード領域にドラッグアンドドロップします。ディレクトリ構造は保持されます。詳細については、「オブジェクトのアップロード」をご参照ください。

  • ディレクトリのダウンロード:OSS コンソールでは、ディレクトリを直接ダウンロードすることはできません。代わりに、ローカルディレクトリを作成してから、バケット内のオブジェクトを一括でダウンロードできます。詳細については、「オブジェクトのダウンロード」をご参照ください。

OSS SDK

  • ディレクトリのアップロード:OSS SDK では、ディレクトリを直接アップロードすることはできません。ただし、オブジェクト名に同じプレフィックスとフォワードスラッシュ (/) を設定することで、複数のオブジェクトを同じ論理ディレクトリにアップロードできます。たとえば、'example1.txt'、'example2.txt'、'example3.txt' というファイルを 'dir' という名前のディレクトリにアップロードするには、OSS SDK for Java を使用して各オブジェクトの objectName を dir/example1.txtdir/example2.txtdir/example3.txt に設定します。

  • ディレクトリのダウンロード:OSS SDK では、ディレクトリを直接ダウンロードすることはできません。ディレクトリ内の個々のオブジェクトを、完全なオブジェクト名を指定してダウンロードすることしかできません。たとえば、バケット内の 'folder' という名前のディレクトリからすべてのオブジェクトを 'local' という名前のローカルディレクトリにダウンロードするには、次のようにします。

    • 'folder' ディレクトリ内のオブジェクト名が分かっている場合

      たとえば、'folder' ディレクトリに 'example1.jpg' と 'example2.jpg' が含まれている場合、OSS SDK for Java を使用してダウンロードできます。objectName の値を folder/example1.jpgfolder/example2.jpg に設定し、対応するローカルダウンロードパス (pathName) を local/folder/example1.jpglocal/folder/example2.jpg に設定します。

    • 'folder' ディレクトリ内のオブジェクト名が分からない場合

      1. GetBucket (ListObjects) API を呼び出して、ディレクトリ内のすべてのオブジェクトをリストします。

      2. オブジェクトのリストを反復処理し、前述のように objectName と pathName を設定して各オブジェクトをダウンロードします。

さまざまなプログラミング言語の OSS SDK を使用したオブジェクトのアップロードおよびダウンロードのサンプルコードについては、「OSS SDK の概要」をご参照ください。

ossbrowser GUI

  • ディレクトリのアップロード: バケットまたはディレクトリで、[フォルダー] をクリックし、アップロードするディレクトリを選択します。また、ディレクトリを ossbrowser に直接ドラッグアンドドロップすることもできます。詳細については、「ディレクトリのアップロード」をご参照ください。

  • ディレクトリのダウンロード:ダウンロードするディレクトリの行で、[ダウンロード] をクリックします。詳細については、「ディレクトリのダウンロード」をご参照ください。

ossutil CLI