Node.js下载文件_对象存储(OSS)-阿里云帮助中心

默认情况下，在受版本控制的存储空间（Bucket）中调用GetObject接口仅返回文件（Object）的当前版本。

背景信息

对某个Bucket执行GetObject操作时，分以下三种情况：

如果该Bucket中Object的当前版本是删除标记（Delete Marker），则返回404 Not Found。
如果在查询参数中指定Object的versionId，则返回指定的Object版本。当versionId指定为“null”时，则返回versionId为“null”的Object版本。
通过指定versionId的方式来获取删除标记时，则返回405 Method Not Allowed。

权限说明

阿里云账号默认拥有全部权限。阿里云账号下的RAM用户或RAM角色默认没有任何权限，需要阿里云账号或账号管理员通过RAM Policy或Bucket Policy授予操作权限。

API	Action	说明
GetObject	`oss:GetObject`	下载Object。
	`oss:GetObjectVersion`	下载Object时，如果通过versionId指定了Object的版本，则需要授予此操作的权限。
	`kms:Decrypt`	下载Object时，如果Object的元数据包含X-Oss-Server-Side-Encryption: KMS，则需要此操作的权限。

示例代码

以下代码用于下载文件：

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

const client = new OSS({
  // yourregion填写Bucket所在地域。以华东1（杭州）为例，Region填写为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,
  // yourbucketname填写存储空间名称。
  bucket: 'yourbucketname'
});

async function get() {
  // 文件名称。
  const result = await client.get('filename', {    
      // 查看下载文件的版本ID。
      versionId: 'versionid',
  });
  console.log(result.content);
}
get();

背景信息

权限说明

示例代码

相关文档