tencent cloud

Overview

This document provides an overview of APIs and SDK code samples for restoring an archived object.

Restoring Archived Object

Feature description

This API is used to restore an ARCHIVE object.

Method prototype

func (s *ObjectService) PostRestore(ctx context.Context, key string, opt *ObjectRestoreOptions) (*Response, error) 

Sample request

package main                                                                                                                                                                                   
import (
   "context"
   "github.com/tencentyun/cos-go-sdk-v5"
   "net/http"
   "net/url"
   "os"
)
func main() {
   // Bucket name in the format of `bucketname-appid` (`appid` is required), which can be viewed in the COS console at https://console.intl.cloud.tencent.com/cos5/bucket.
   // Replace it with your `region`, which can be viewed in the COS console at https://console.intl.cloud.tencent.com/. For more information on regions, visit https://intl.cloud.tencent.com/document/product/436/6224.
   u, _ := url.Parse("https://examplebucket-1250000000.cos.ap-guangzhou.myqcloud.com")
   b := &cos.BaseURL{BucketURL: u}
   client := cos.NewClient(b, &http.Client{
       Transport: &cos.AuthorizationTransport{
           // Get the key from environment variables.
           // Environment variable `SECRETID` refers to the user's `SecretId`, which can be viewed in the CAM console at https://console.intl.cloud.tencent.com/cam/capi.
           SecretID: os.Getenv("SECRETID"),
           // Environment variable `SECRETKEY` refers to the user's `SecretKey`, which can be viewed in the CAM console at https://console.intl.cloud.tencent.com/cam/capi.
           SecretKey: os.Getenv("SECRETKEY"),
       },
   })
   key := "example_restore"
   f, err := os.Open("/test")
   if err != nil {
       panic(err)
   }
   opt := &cos.ObjectPutOptions{
       ObjectPutHeaderOptions: &cos.ObjectPutHeaderOptions{
           ContentType:      "text/html",
           XCosStorageClass: "ARCHIVE", //ARCHIVE storage class
       },
       ACLHeaderOptions: &cos.ACLHeaderOptions{
           // Considering the ACL limit, we recommend you not set an object ACL when uploading an object unless required. The object will then inherit the bucket ACL by default.
           XCosACL: "private",
       },
   }
   // Upload an object directly to ARCHIVE storage class.
   _, err = client.Object.Put(context.Background(), key, f, opt)
   if err != nil {
       panic(err)
   }
    opts := &cos.ObjectRestoreOptions{
       Days: 2,
       Tier: &cos.CASJobParameters{
           // Standard, Exepdited and Bulk
           Tier: "Expedited",
       },
   }
   // Restore an archived object.
   _, err = client.Object.PostRestore(context.Background(), key, opts)
   if err != nil {
       panic(err)
   }
}

Parameter description

type ObjectRestoreOptions struct {        
  Days    int               
  Tier    *CASJobParameters 
}
type CASJobParameters struct {
  Tier    string 
}