默认情况下,在受版本控制的存储空间(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  | 
  | 下载Object。  | 
  | 下载Object时,如果通过versionId指定了Object的版本,则需要授予此操作的权限。  | |
  | 下载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();相关文档
关于下载文件的API接口说明,请参见GetObject。
该文章对您有帮助吗?