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

注意事项

  • 本文以华东1（杭州）外网Endpoint为例。如果您希望通过与OSS同地域的其他阿里云产品访问OSS，请使用内网Endpoint。关于OSS支持的Region与Endpoint的对应关系，请参见访问域名和数据中心。
  • 本文以OSS域名新建OSSClient为例。如果您希望通过自定义域名、STS等方式新建OSSClient，请参见Go初始化。
  • 要创建软链接，您必须具有oss:PutObject权限；要获取软链接，您必须具有oss:GetObject权限。具体操作，请参见为RAM用户授权自定义的权限策略。

创建软链接

您可以通过创建软链接指向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。