全部產品
Search
文件中心

Object Storage Service:管理軟連結(Go SDK V1)

更新時間:Nov 28, 2025

本文介紹如何在受版本控制的儲存空間(Bucket)中管理軟連結。

注意事項

  • 本文以華東1(杭州)外網Endpoint為例。如果您希望通過與OSS同地區的其他阿里雲產品訪問OSS,請使用內網Endpoint。關於OSS支援的Region與Endpoint的對應關係,請參見地區和Endpoint

  • 本文以從環境變數讀取存取憑證為例。如何配置訪問憑證,請參見配置訪問憑證(Go SDK V1)

  • 本文以OSS網域名稱建立OSSClient為例。如果您希望通過自訂網域名、STS等方式建立OSSClient,請參見配置用戶端(Go SDK V1)

  • 要建立軟連結,您必須具有oss:PutObject許可權;要擷取軟連結,您必須具有oss:GetObject許可權。具體操作,請參見為RAM使用者授予自訂的權限原則

範例程式碼

建立軟連結

您可以通過建立軟連結指向TargetObject的目前的版本。

說明

在受版本控制的Bucket中,無法為刪除標記(Delete Marker)建立軟連結。

軟連結本身也可以有多個版本,每個不同的版本可以指向不同的TargetObject,版本ID由OSS自動產生,在響應header中返回x-oss-version-id。

以下代碼用於建立軟連結:

package main

import (
	"log"
	"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 {
		log.Fatalf("Failed to create credentials provider: %v", err)
	}

	// 建立OSSClient執行個體。
	// yourEndpoint填寫Bucket對應的Endpoint,以華東1(杭州)為例,填寫為https://oss-cn-hangzhou.aliyuncs.com。其它Region請按實際情況填寫。
	// yourRegion填寫Bucket所在地區,以華東1(杭州)為例,填寫為cn-hangzhou。其它Region請按實際情況填寫。
	clientOptions := []oss.ClientOption{oss.SetCredentialsProvider(&provider)}
	clientOptions = append(clientOptions, oss.Region("yourRegion"))
	// 設定簽名版本
	clientOptions = append(clientOptions, oss.AuthVersion(oss.AuthV4))
	client, err := oss.New("yourEndpoint", "", "", clientOptions...)
	if err != nil {
		log.Fatalf("Failed to create OSS client: %v", err)
	}

	// 填寫儲存空間名稱。
	bucketName := "yourBucketName"
	// 填寫軟連結名稱。
	objectName := "yourSymlinkName"
	// 填寫目標Object名稱。
	targetObjectName := "yourObjectName"

	// 建立Bucket執行個體。
	bucket, err := client.Bucket(bucketName)
	if err != nil {
		log.Fatalf("Failed to get bucket '%s': %v", bucketName, err)
	}

	// 上傳檔案到目標檔案。
	err = bucket.PutObject(targetObjectName, strings.NewReader("target"))
	if err != nil {
		log.Fatalf("Failed to put object '%s': %v", targetObjectName, err)
	}

	// 建立軟連結,並擷取版本資訊。
	var retHeader http.Header
	err = bucket.PutSymlink(objectName, targetObjectName, oss.GetResponseHeader(&retHeader))
	if err != nil {
		log.Fatalf("Failed to create symlink '%s' to '%s': %v", objectName, targetObjectName, err)
	}

	// 列印x-oss-version-id。
	versionId := oss.GetVersionId(retHeader)
	log.Printf("x-oss-version-id: %s", versionId)
}

擷取軟連結

GetSymlink介面預設擷取軟連結的目前的版本。允許通過指定versionId來擷取指定版本。如果軟連結的目前的版本為刪除標記,OSS會返回404 Not Found,在響應header中返回x-oss-delete-marker = true以及版本ID:x-oss-version-id。

說明

擷取軟連結操作需要您對該軟連結有讀許可權。

以下代碼用於擷取軟連結:

package main

import (
	"log"

	"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 {
		log.Fatalf("Failed to create credentials provider: %v", err)
	}

	// 建立OSSClient執行個體。
	// yourEndpoint填寫Bucket對應的Endpoint,以華東1(杭州)為例,填寫為https://oss-cn-hangzhou.aliyuncs.com。其它Region請按實際情況填寫。
	// yourRegion填寫Bucket所在地區,以華東1(杭州)為例,填寫為cn-hangzhou。其它Region請按實際情況填寫。
	clientOptions := []oss.ClientOption{oss.SetCredentialsProvider(&provider)}
	clientOptions = append(clientOptions, oss.Region("yourRegion"))
	// 設定簽名版本
	clientOptions = append(clientOptions, oss.AuthVersion(oss.AuthV4))
	client, err := oss.New("yourEndpoint", "", "", clientOptions...)
	if err != nil {
		log.Fatalf("Failed to create OSS client: %v", err)
	}

	// 填寫儲存空間名稱。
	bucketName := "yourBucketName"
	// 填寫軟連結名稱。
	objectName := "yourSymlinkName"
	// 填寫軟連結的版本ID。
	versionId := "youObjectVersionId"

	// 建立Bucket執行個體。
	bucket, err := client.Bucket(bucketName)
	if err != nil {
		log.Fatalf("Failed to get bucket '%s': %v", bucketName, err)
	}

	// 擷取指定版本軟連結指向的檔案內容。
	meta, err := bucket.GetSymlink(objectName, oss.VersionId(versionId))
	if err != nil {
		log.Fatalf("Failed to get symlink '%s' with version ID '%s': %v", objectName, versionId, err)
	}

	// 列印軟連結指向的目標檔案。
	symlinkTarget := meta.Get(oss.HTTPHeaderOssSymlinkTarget)
	log.Printf("Symlink Target: %s", symlinkTarget)
}

相關文檔

  • 關於建立軟連結的API介面說明,請參見PutSymlink

  • 關於擷取軟連結的API介面說明,請參見GetSymlink