版本控制应用于存储空间(Bucket)内的所有文件(Object)。通过Object的版本管理,在错误覆盖或者删除Object后,您能够将Bucket中存储的Object恢复至任意时刻的历史版本。
注意事项
本文以华东1(杭州)外网Endpoint为例。如果您希望通过与OSS同地域的其他阿里云产品访问OSS,请使用内网Endpoint。关于OSS支持的Region与Endpoint的对应关系,请参见访问域名和数据中心。
本文以从环境变量读取访问凭证为例。如何配置访问凭证,请参见配置访问凭证。
本文以OSS域名新建OSSClient为例。如果您希望通过自定义域名、STS等方式新建OSSClient,请参见初始化。
要设置Bucket版本控制状态,您必须具有
oss:PutBucketVersioning
权限;要获取Bucket版本控制状态信息,您必须具有oss:GetBucketVersioning
权限。具体操作,请参见为RAM用户授权自定义的权限策略。
设置Bucket版本控制状态
以下代码用于设置Bucket为开启版本控制(Enabled)状态。
package main
import (
"fmt"
"os"
"github.com/aliyun/aliyun-oss-go-sdk/oss"
)
func main() {
/// 从环境变量中获取访问凭证。运行本代码示例之前,请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
provider, err := oss.NewEnvironmentVariableCredentialsProvider()
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// 创建OSSClient实例。
// yourEndpoint填写Bucket对应的Endpoint,以华东1(杭州)为例,填写为https://oss-cn-hangzhou.aliyuncs.com。其它Region请按实际情况填写。
client, err := oss.New("yourEndpoint", "", "", oss.SetCredentialsProvider(&provider))
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// 创建一个存储空间。
// yourBucketName填写存储空间名称。
err = client.CreateBucket("yourBucketName")
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// 此处以设置存储空间版本状态为Enabled为例。
config := oss.VersioningConfig{Status: "Enabled"}
err = client.SetBucketVersioning("yourBucketName", config)
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
}
获取Bucket版本控制状态信息
以下代码用于获取Bucket的版本控制状态信息。
package main
import (
"fmt"
"os"
"github.com/aliyun/aliyun-oss-go-sdk/oss"
)
func main() {
/// 从环境变量中获取访问凭证。运行本代码示例之前,请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
provider, err := oss.NewEnvironmentVariableCredentialsProvider()
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// 创建OSSClient实例。
// yourEndpoint填写Bucket对应的Endpoint,以华东1(杭州)为例,填写为https://oss-cn-hangzhou.aliyuncs.com。其它Region请按实际情况填写。
client, err := oss.New("yourEndpoint", "", "", oss.SetCredentialsProvider(&provider))
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// 获取存储空间版本控制状态信息。
// yourBucketName填写存储空间名称。
ret, err := client.GetBucketVersioning("yourBucketName")
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// 打印存储空间版本控制状态信息。
fmt.Println("The bucket Versioning status:", ret.Status)
}
列举Bucket中所有Object的版本信息
以下代码用于列举指定Bucket中包括删除标记(Delete Marker)在内的所有Object的版本信息。
package main
import (
"fmt"
"net/http"
"os"
"strings"
"github.com/aliyun/aliyun-oss-go-sdk/oss"
)
func main() {
/// 从环境变量中获取访问凭证。运行本代码示例之前,请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
provider, err := oss.NewEnvironmentVariableCredentialsProvider()
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// 创建OSSClient实例。
// yourEndpoint填写Bucket对应的Endpoint,以华东1(杭州)为例,填写为https://oss-cn-hangzhou.aliyuncs.com。其它Region请按实际情况填写。
client, err := oss.New("yourEndpoint", "", "", oss.SetCredentialsProvider(&provider))
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// yourBucketName填写存储空间名称。
bucket, err := client.Bucket("yourBucketName")
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// 列举包含指定前缀的文件。
ret, err := bucket.ListObjectVersions(oss.Prefix("yourObjectPrefix"))
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// 打印文件信息。
for _, object := range ret.ObjectVersions {
fmt.Println("Object:", object)
}
// 打印删除标记。
for _, marker := range ret.ObjectDeleteMarkers {
fmt.Println("Delete Markers:", marker)
}
}
相关文档
关于设置Bucket版本控制状态的API接口说明,请参见PutBucketVersioning。
关于获取Bucket版本控制状态的API接口说明,请参见GetBucketVersioning。
关于列举Bucket中所有Object的版本信息的API接口说明,请参见ListObjectVersions(GetBucketVersions)。
反馈
- 本页导读 (1)
文档反馈