OSS保留策略具有WORM(Write Once Read Many)特性,满足用户以不可删除、不可篡改方式保存和使用数据。如果您希望指定时间内任何用户(包括资源拥有者)均不能修改和删除OSS某个Bucket中的Object,您可以选择为Bucket配置保留策略。在保留策略指定的Object保留时间到期之前,仅支持在Bucket中上传和读取Object。Object保留时间到期后,才可以修改或删除Object。
注意事项
在配置保留策略之前,请确保您已了解该功能。详情请参见保留策略。
新建保留策略
以下代码用于新建保留策略:
package main
import (
"fmt"
"github.com/aliyun/aliyun-oss-go-sdk/oss"
"os"
)
func HandleError(err error) {
fmt.Println("Error:", err)
os.Exit(-1)
}
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)
}
// 填写待配置保留策略的Bucket名称。
bucketname := "<yourBucketName>"
// 指定Object保护天数为60天。
result,err := client.InitiateBucketWorm(bucketname,60)
if err != nil {
HandleError(err)
}
fmt.Println(result)
}
取消未锁定的保留策略
以下代码用于取消未锁定的保留策略:
package main
import (
"fmt"
"github.com/aliyun/aliyun-oss-go-sdk/oss"
"os"
)
func HandleError(err error) {
fmt.Println("Error:", err)
os.Exit(-1)
}
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)
}
// 填写待取消保留策略的Bucket名称。
bucketname := "<yourBucketName>"
err = client.AbortBucketWorm(bucketname)
if err != nil {
HandleError(err)
}
}
锁定保留策略
以下代码用于锁定保留策略:
package main
import (
"fmt"
"github.com/aliyun/aliyun-oss-go-sdk/oss"
"os"
)
func HandleError(err error) {
fmt.Println("Error:", err)
os.Exit(-1)
}
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)
}
// 填写待锁定保留策略的Bucket名称。
bucketname := "<yourBucketName>"
wormConfig,err := client.GetBucketWorm(bucketname)
err = client.CompleteBucketWorm(bucketName,wormConfig.WormId)
if err != nil {
HandleError(err)
}
}
获取保留策略
以下代码用于获取保留策略配置信息:
package main
import (
"fmt"
"github.com/aliyun/aliyun-oss-go-sdk/oss"
"os"
)
func HandleError(err error) {
fmt.Println("Error:", err)
os.Exit(-1)
}
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)
}
// 填写待获取保留策略配置信息的Bucket名称。
bucketname := "<yourBucketName>"
wormConfig,err := client.GetBucketWorm(bucketname)
if err != nil {
HandleError(err)
}
// 查看保留策略ID。
fmt.Println(wormConfig.WormId)
// 查看保留策略的创建时间。
fmt.Println(wormConfig.CreationDate)
// 查看保留策略状态。未锁定状态下为"InProgress", 锁定状态下为"Locked"。
fmt.Println(wormConfig.State)
// 查看Object的保护天数。
fmt.Println(wormConfig.RetentionPeriodInDays)
}
延长Object的保护天数
以下代码用于延长已锁定的保留策略中Object的保护天数:
package main
import (
"fmt"
"github.com/aliyun/aliyun-oss-go-sdk/oss"
"os"
)
func HandleError(err error) {
fmt.Println("Error:", err)
os.Exit(-1)
}
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)
}
// 填写待延长保护天数的Object所属的Bucket名称。
bucketname := "<yourBucketName>"
wormConfig,err := client.GetBucketWorm(bucketname)
// 延长已锁定的保留策略中Object的保护天数为30天。
err = client.ExtendBucketWorm(bucketName,30,wormConfig.WormId)
if err != nil {
HandleError(err)
}
}
相关文档
关于保留策略的完整示例代码,请参见GitHub示例。
关于新建保留策略的更多信息,请参见InitiateBucketWorm。
关于取消未锁定的保留策略的更多信息,请参见AbortBucketWorm。
关于锁定保留策略的更多信息,请参见CompleteBucketWorm。
关于获取保留策略配置的更多信息,请参见GetBucketWorm。
关于延长Object保留天数的更多信息,请参见ExtendBucketWorm。
反馈
- 本页导读 (1)
文档反馈