本文介绍如何在受版本控制的存储空间(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实例。
  client, err := oss.New("<yourEndpoint>", "<yourAccessKeyId>", "<yourAccessKeySecret>")
  if err != nil {
    fmt.Println("Error:", err)
    os.Exit(-1)
  }

  bucketName := "<yourBucketName>"
  // 目标文件。
  objectName := "<yourSymlinkName>"
  // 目标文件的软链接。
  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))
}

创建软链接的详细信息请参见PutSymlink

获取软链接

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实例。
  client, err := oss.New("<yourEndpoint>", "<yourAccessKeyId>", "<yourAccessKeySecret>")
  if err != nil {
    fmt.Println("Error:", err)
    os.Exit(-1)
  }

  bucketName := "<yourBucketName>"
  // 目标文件。
  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))
}

获取软链接的详细信息请参见GetSymlink