版本控制应用于存储空间（Bucket）内的所有文件（Object）。通过Object的版本管理，在错误覆盖或者删除Object后，您能够将Bucket中存储的Object恢复至任意时刻的历史版本。

Bucket的版本状态包括非版本化（默认）、开启版本控制及暂停版本控制三种。

版本控制的详情请参见开发指南的版本控制介绍。

设置Bucket版本控制状态

以下代码用于设置Bucket为开启版本控制（Enabled）或暂停版本控制（Suspended）状态。 
// Endpoint以杭州为例，其它Region请按实际情况填写。
String endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
// 阿里云主账号AccessKey拥有所有API的访问权限，风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维，请登录RAM控制台创建RAM用户。
String accessKeyId = "<yourAccessKeyId>";
String accessKeySecret = "<yourAccessKeySecret>";

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

// 设置存储空间版本控制状态为Enabled。
BucketVersioningConfiguration configuration = new BucketVersioningConfiguration();
configuration.setStatus(BucketVersioningConfiguration.ENABLED);
SetBucketVersioningRequest request = new SetBucketVersioningRequest(bucketName, configuration);
ossClient.setBucketVersioning(request);

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

设置Bucket版本控制状态的详情请参见PutBucketVersioning。

获取Bucket版本控制状态信息

以下代码用于获取Bucket的版本控制状态信息。 
// Endpoint以杭州为例，其它Region请按实际情况填写。
String endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
// 阿里云主账号AccessKey拥有所有API的访问权限，风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维，请登录RAM控制台创建RAM用户。
String accessKeyId = "<yourAccessKeyId>";
String accessKeySecret = "<yourAccessKeySecret>";

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

// 获取存储空间版本控制状态信息。
BucketVersioningConfiguration versionConfiguration = ossClient.getBucketVersioning("<yourBucketName>");
System.out.println("bucket versioning status: " + versionConfiguration.getStatus());

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

获取Bucket版本控制状态的详情请参见GetBucketVersioning。