Tüm Ürünler
Search
Belge Merkezi

Object Storage Service:Streaming download (Node.js SDK)

Son Güncelleme:Oct 01, 2026

Akışlı indirme, bir nesneyi parçalar halinde akış olarak indirmenizi sağlar. Büyük boyutlu bir nesne indiriyorsanız veya indirme işlemi uzun sürüyorsa nesneyi parçalar halinde indirmek için bu yöntemi kullanabilirsiniz.

Örnek kod

Aşağıdaki örnek kod, examplebucket adlı bir paketten exampleobject.txt adlı bir nesneyi yerel diskinizdeki D:\localpath yoluna akışlı olarak nasıl indireceğinizi gösterir.

Not

Bir dosyayı getStream kullanarak indirirken döndürülen Readable Stream sayesinde dosya içeriğini bir akış olarak işleyebilirsiniz.

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

const client = new OSS({
  // Set region to the region where your bucket is located. For example, if your bucket is in the China (Hangzhou) region, set region to oss-cn-hangzhou.
  region: 'yourRegion',
  // Obtain access credentials from environment variables. Before running this code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are set.
  accessKeyId: process.env.OSS_ACCESS_KEY_ID,
  accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
  authorizationV4: true,
  // Specify the bucket name.
  bucket: 'examplebucket',
});

async function getStream () {
  try {
    // Specify the full path of the object. The full path cannot include the bucket name.
    const result = await client.getStream('exampleobject.txt');
    console.log(result);
    // Specify the full path of the local file. If the file exists, it is overwritten. If the file does not exist, it is created.
    // If a local path is not specified, the file is saved to the project's local directory by default.
    const writeStream = fs.createWriteStream('D:\\localpath\\examplefile.txt'); 
    result.stream.pipe(writeStream);
  } catch (e) {
    console.log(e);
  }
}

getStream()

İlgili konular

  • Akışlı indirme işlemine yönelik eksiksiz örnek kod için GitHub adresini ziyaret edin.

  • Akışlı indirme yapmak için çağırabileceğiniz API işlemi hakkında daha fazla bilgi edinmek için bkz. GetObject.