如何在受版本控制的Bucket管理软链接_对象存储(OSS)-阿里云帮助中心

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

注意事项

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

创建软链接

您可以通过创建软链接指向TargetObject的当前版本。

说明

在受版本控制的Bucket中，无法为删除标记（Delete Marker）创建软链接。

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

以下代码用于创建软链接：

package main

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

func main() {
    // 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
    provider, err := oss.NewEnvironmentVariableCredentialsProvider()
    if err != nil {
        fmt.Println("Error:", err)
        os.Exit(-1)
    }

    // 创建OSSClient实例。
    // yourEndpoint填写Bucket对应的Endpoint，以华东1（杭州）为例，填写为https://oss-cn-hangzhou.aliyuncs.com。其它Region请按实际情况填写。
    client, err := oss.New("yourEndpoint", "", "", oss.SetCredentialsProvider(&provider))
    if err != nil {
       fmt.Println("Error:", err)
       os.Exit(-1)
  }
  // yourBucketName填写存储空间名称。
  bucketName := "yourBucketName"
  // yourSymlinkName填写软链接名称。
  objectName := "yourSymlinkName"
  // yourObjectName填写Object名称。
  targetObjectName := "yourObjectName"
  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"
  "github.com/aliyun/aliyun-oss-go-sdk/oss"
)

func main() {
    // 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
    provider, err := oss.NewEnvironmentVariableCredentialsProvider()
    if err != nil {
        fmt.Println("Error:", err)
        os.Exit(-1)
    }

    // 创建OSSClient实例。
    // yourEndpoint填写Bucket对应的Endpoint，以华东1（杭州）为例，填写为https://oss-cn-hangzhou.aliyuncs.com。其它Region请按实际情况填写。
    client, err := oss.New("yourEndpoint", "", "", oss.SetCredentialsProvider(&provider))
    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))
}

Go管理软链接

注意事项

创建软链接

获取软链接

相关文档