Todos os produtos
Search
Central de documentação

Object Storage Service:Download objects as files using OSS SDK for Node.js

Última atualização: Jul 03, 2026

Este tópico descreve como baixar um objeto de um bucket para o seu computador.

Código de exemplo

O código de exemplo a seguir mostra como baixar um objeto chamado exampleobject.txt, armazenado em um bucket chamado examplebucket, para o caminho D:\localpath em um disco local:

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

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

async function get () {
  try {
    // Specify the full paths of the object and the local file. Do not include the bucket name in the full path of the object. 
    // If a file that has the same name already exists, the downloaded object overwrites the file. Otherwise, the downloaded object is saved as a local file. 
    // If you do not specify a path for the downloaded object, the downloaded object is saved to the path of the project to which the sample program belongs. 
    const result = await client.get('exampleobject.txt', 'D:\\localpath\\examplefile.txt');
    console.log(result);
  } catch (e) {
    console.log(e);
  }
}

get(); 

Referências

  • Para obter o código de exemplo completo de download de objetos para o seu computador, visite o GitHub.

  • Para mais informações sobre a operação de API usada para baixar um objeto como arquivo local, consulte GetObject.