文档中心

恢复对象（Go SDK）

最近更新时间：2024.02.04 18:31:06

首次发布时间：2023.08.03 16:36:18

对冷归档对象进行恢复，恢复之后可以通过下载对象接口获取到对象。通过参数可以指定不同的取回方式。

注意事项

第一次调用 RestoreObject 接口，返回 202。如果文件正在恢复中，再次调用 RestoreObject 接口，会返回 409 错误。如果对象已完成恢复，再次调用 RestoreObject 接口返回 200 OK。
对于开启多版本的桶，可以通过指定 VersionId 恢复指定版本的对象，如果未指定 VersionId，默认恢复当前对象。

示例代码

以下代码用于恢复对象。

package main

import (
    "context"
    "fmt"
    "github.com/volcengine/ve-tos-golang-sdk/v2/tos"
    "github.com/volcengine/ve-tos-golang-sdk/v2/tos/enum"
)

func checkErr(err error) {
    if err != nil {
       if serverErr, ok := err.(*tos.TosServerError); ok {
          fmt.Println("Error:", serverErr.Error())
          fmt.Println("Request ID:", serverErr.RequestID)
          fmt.Println("Response Status Code:", serverErr.StatusCode)
          fmt.Println("Response Header:", serverErr.Header)
          fmt.Println("Response Err Code:", serverErr.Code)
          fmt.Println("Response Err Msg:", serverErr.Message)
       } else {
          fmt.Println("Error:", err)
       }
       panic(err)
    }
}

func main() {
    var (
       accessKey = os.Getenv("TOS_ACCESS_KEY")
       secretKey = os.Getenv("TOS_SECRET_KEY")
       // Bucket 对于的 Endpoint，以华北2（北京）为例：https://tos-cn-beijing.volces.com
       endpoint = "https://tos-cn-beijing.volces.com"
       region   = "cn-beijing"
       // 填写 BucketName
       bucketName = "*** Provide your bucket name ***"
       key        = "restore-key"
       versionId  = "restore-version-id"
       ctx        = context.Background()
    )
    // 初始化客户端
    client, err := tos.NewClientV2(endpoint, tos.WithRegion(region), tos.WithCredentials(tos.NewStaticCredentials(accessKey, secretKey)))
    checkErr(err)
    // 恢复对象
    output, err := client.RestoreObject(ctx, &tos.RestoreObjectInput{
       Bucket:    bucketName,
       Key:       key,
       VersionID: versionId,
       Days:      1,
       RestoreJobParameters: &tos.RestoreJobParameters{
          Tier: enum.TierStandard,
       },
    })
    checkErr(err)
    fmt.Println("RestoreObject Request ID:", output.RequestID)
}

对象存储

恢复对象（Go SDK）

注意事项

示例代码

相关文档