默认情况下,在受版本控制的存储空间(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。
以下代码用于下载文件:
// Endpoint以杭州为例,其它Region请按实际情况填写。
String endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
// 阿里云主账号AccessKey拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM账号进行API访问或日常运维,请登录RAM控制台创建RAM账号。
String accessKeyId = "<yourAccessKeyId>";
String accessKeySecret = "<yourAccessKeySecret>";
String bucketName = "<yourBucketName>";
String objectName = "<yourObjectName>";
String versionid = "<yourObjectVersionid>";

// 创建OSSClient实例。
OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);

// 封装GetObject请求。
GetObjectRequest getObjectRequest = new GetObjectRequest(bucketName, objectName);
// 指定object版本id。
getObjectRequest.setVersionId(versionid);
// ossObject包含文件所在的存储空间名称、文件名称、文件元信息以及一个输入流。
OSSObject ossObject = ossClient.getObject(getObjectRequest);

// 查看下载文件的版本id。
System.out.println("Get Object versionid:" +  ossObject.getObjectMetadata().getVersionId());
// 读取文件内容。
System.out.println("Object content:");
BufferedReader reader = new BufferedReader(new InputStreamReader(ossObject.getObjectContent()));
while (true) {
    String line = reader.readLine();
    if (line == null) break;
    System.out.println("\n" + line);
}

// 关闭OSSClient。
ossClient.shutdown();

下载文件的详细信息请参见GetObject