本文介绍如何在受版本控制的存储空间(Bucket)中管理软链接。

创建软链接

您可以通过创建软链接指向TargetObject的当前版本。
说明 在受版本控制的Bucket中,无法为删除标记(Delete Marker)创建软链接。

软链接本身也可以有多个版本,每个不同的版本可以指向不同的TargetObject,版本ID由OSS自动生成,在响应header中返回x-oss-version-id。

以下代码用于创建软链接:
package main

import (
  "fmt"
  "os"
  "strings"
  "github.com/aliyun/aliyun-oss-go-sdk/oss"
)

func main() {
    // 创建OSSClient实例。
    // yourEndpoint填写Bucket对应的Endpoint,以华东1(杭州)为例,填写为https://oss-cn-hangzhou.aliyuncs.com。其它Region请按实际情况填写。
    // 阿里云账号AccessKey拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维,请登录RAM控制台创建RAM用户。
    client, err := oss.New("yourEndpoint", "yourAccessKeyId", "yourAccessKeySecret")
    if err != nil {
       fmt.Println("Error:", err)
       os.Exit(-1)
  }
  // yourBucketName填写存储空间名称。
  bucketName := "yourBucketName"
  // yourSymlinkName填写目标文件名称。
  objectName := "yourSymlinkName"
  // yourSymlinkTargetName填写目标文件的软链接。
  targetObjectName := "yourSymlinkTargetName"
  bucket, err := client.Bucket(bucketName)
  if err != nil {
    fmt.Println("Error:", err)
    os.Exit(-1)
  }

  // 上传文件到目标文件。
  err = bucket.PutObject(targetObjectName, strings.NewReader("target"))
  if err != nil {
    fmt.Println("Error:", err)
    os.Exit(-1)
  }

  // 创建软链接,并获取版本信息。
  var retHeader http.Header
  err = bucket.PutSymlink(objectName, targetObjectName, oss.GetResponseHeader(&retHeader))
  if err != nil {
    fmt.Println("Error:", err)
    os.Exit(-1)
  }
  // 打印x-oss-version-id。
  fmt.Println("x-oss-version-id:", oss.GetVersionId(retHeader))
}

获取软链接

GetSymlink接口默认获取软链接的当前版本。允许通过指定versionId来获取指定版本。如果软链接的当前版本为删除标记,OSS会返回404 Not Found,在响应header中返回x-oss-delete-marker = true以及版本ID : x-oss-version-id。
说明 获取软链接操作需要您对该软链接有读权限。
以下代码用于获取软链接:
package main

import (
  "fmt"
  "os"
  "strings"
  "github.com/aliyun/aliyun-oss-go-sdk/oss"
)

func main() {
    // 创建OSSClient实例。
    // yourEndpoint填写Bucket对应的Endpoint,以华东1(杭州)为例,填写为https://oss-cn-hangzhou.aliyuncs.com。其它Region请按实际情况填写。
    // 阿里云账号AccessKey拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维,请登录RAM控制台创建RAM用户。
    client, err := oss.New("yourEndpoint", "yourAccessKeyId", "yourAccessKeySecret")
    if err != nil {
       fmt.Println("Error:", err)
       os.Exit(-1)
  }
  // yourBucketName填写存储空间名称。
  bucketName := "yourBucketName"
  // yourSymlinkName填写目标文件。
  objectName := "yourSymlinkName"

  bucket, err := client.Bucket(bucketName)
  if err != nil {
    fmt.Println("Error:", err)
    os.Exit(-1)
  }

  // 获取指定版本软链接指向的文件内容。
  meta, err := bucket.GetSymlink(objectName,oss.VersionId("youObjectVersionId"))
  if err != nil {
    fmt.Println("Error:", err)
    os.Exit(-1)
  }

  // 打印软链接。
  fmt.Println(meta.Get(oss.HTTPHeaderOssSymlinkTarget))
}

相关文档

  • 关于创建软链接的API接口说明,请参见PutSymlink
  • 关于获取软链接的API接口说明,请参见GetSymlink