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

Object Storage Service:オブジェクトをローカルファイルにダウンロードする (Node.js SDK)

最終更新日:Nov 30, 2025

このトピックでは、バケットからコンピューターにオブジェクトをダウンロードする方法について説明します。

サンプルコード

次のサンプルコードは、`examplebucket` という名前のバケット内の `exampleobject.txt` という名前のオブジェクトを、ローカルディスクの D:\localpath パスにダウンロードする方法の例を示しています。

const OSS = require('ali-oss');

const client = new OSS({
  // バケットが配置されているリージョンに yourRegion を設定します。 たとえば、バケットが中国 (杭州) リージョンにある場合は、リージョンを oss-cn-hangzhou に設定します。
  region: 'yourRegion',
  // 環境変数からアクセス認証情報を取得します。 このコードを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
  accessKeyId: process.env.OSS_ACCESS_KEY_ID,
  accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
  authorizationV4: true,
  // バケット名を指定します。
  bucket: 'examplebucket'
});

async function get () {
  try {
    // オブジェクトの完全なパスとローカルファイルの完全なパスを指定します。 オブジェクトの完全なパスにバケット名を含めることはできません。
    // 指定したローカルファイルが存在する場合は上書きされます。 ファイルが存在しない場合は作成されます。
    // ローカルパスが指定されていない場合、ダウンロードされたファイルはデフォルトでプロジェクトのローカルパスに保存されます。
    const result = await client.get('exampleobject.txt', 'D:\\localpath\\examplefile.txt');
    console.log(result);
  } catch (e) {
    console.log(e);
  }
}

get(); 

リファレンス

  • オブジェクトをコンピューターにダウンロードするための完全なサンプルコードについては、GitHub をご参照ください。

  • オブジェクトをローカルファイルとしてダウンロードする API 操作の詳細については、GetObject をご参照ください。