Go管理軟鏈接
本文介紹如何在受版本控制的存儲空間(Bucket)中管理軟鏈接。
注意事項
本文以華東1(杭州)外網(wǎng)Endpoint為例。如果您希望通過與OSS同地域的其他阿里云產(chǎn)品訪問OSS,請使用內(nèi)網(wǎng)Endpoint。關(guān)于OSS支持的Region與Endpoint的對應(yīng)關(guān)系,請參見OSS訪問域名、數(shù)據(jù)中心、開放端口。
本文以從環(huán)境變量讀取訪問憑證為例。如何配置訪問憑證,請參見配置訪問憑證。
本文以OSS域名新建OSSClient為例。如果您希望通過自定義域名、STS等方式新建OSSClient,請參見初始化。
要創(chuàng)建軟鏈接,您必須具有
oss:PutObject
權(quán)限;要獲取軟鏈接,您必須具有oss:GetObject
權(quán)限。具體操作,請參見為RAM用戶授權(quán)自定義的權(quán)限策略。
示例代碼
創(chuàng)建軟鏈接
您可以通過創(chuàng)建軟鏈接指向TargetObject的當(dāng)前版本。
在受版本控制的Bucket中,無法為刪除標(biāo)記(Delete Marker)創(chuàng)建軟鏈接。
軟鏈接本身也可以有多個版本,每個不同的版本可以指向不同的TargetObject,版本ID由OSS自動生成,在響應(yīng)header中返回x-oss-version-id。
以下代碼用于創(chuàng)建軟鏈接:
package main
import (
"log"
"net/http"
"strings"
"github.com/aliyun/aliyun-oss-go-sdk/oss"
)
func main() {
// 從環(huán)境變量中獲取訪問憑證。運(yùn)行本代碼示例之前,請確保已設(shè)置環(huán)境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
provider, err := oss.NewEnvironmentVariableCredentialsProvider()
if err != nil {
log.Fatalf("Failed to create credentials provider: %v", err)
}
// 創(chuàng)建OSSClient實例。
// yourEndpoint填寫B(tài)ucket對應(yīng)的Endpoint,以華東1(杭州)為例,填寫為https://oss-cn-hangzhou.aliyuncs.com。其它Region請按實際情況填寫。
// yourRegion填寫B(tài)ucket所在地域,以華東1(杭州)為例,填寫為cn-hangzhou。其它Region請按實際情況填寫。
clientOptions := []oss.ClientOption{oss.SetCredentialsProvider(&provider)}
clientOptions = append(clientOptions, oss.Region("yourRegion"))
// 設(shè)置簽名版本
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"
// 填寫目標(biāo)Object名稱。
targetObjectName := "yourObjectName"
// 創(chuàng)建Bucket實例。
bucket, err := client.Bucket(bucketName)
if err != nil {
log.Fatalf("Failed to get bucket '%s': %v", bucketName, err)
}
// 上傳文件到目標(biāo)文件。
err = bucket.PutObject(targetObjectName, strings.NewReader("target"))
if err != nil {
log.Fatalf("Failed to put object '%s': %v", targetObjectName, err)
}
// 創(chuàng)建軟鏈接,并獲取版本信息。
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接口默認(rèn)獲取軟鏈接的當(dāng)前版本。允許通過指定versionId來獲取指定版本。如果軟鏈接的當(dāng)前版本為刪除標(biāo)記,OSS會返回404 Not Found,在響應(yīng)header中返回x-oss-delete-marker = true以及版本ID:x-oss-version-id。
獲取軟鏈接操作需要您對該軟鏈接有讀權(quán)限。
以下代碼用于獲取軟鏈接:
package main
import (
"log"
"github.com/aliyun/aliyun-oss-go-sdk/oss"
)
func main() {
// 從環(huán)境變量中獲取訪問憑證。運(yùn)行本代碼示例之前,請確保已設(shè)置環(huán)境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
provider, err := oss.NewEnvironmentVariableCredentialsProvider()
if err != nil {
log.Fatalf("Failed to create credentials provider: %v", err)
}
// 創(chuàng)建OSSClient實例。
// yourEndpoint填寫B(tài)ucket對應(yīng)的Endpoint,以華東1(杭州)為例,填寫為https://oss-cn-hangzhou.aliyuncs.com。其它Region請按實際情況填寫。
// yourRegion填寫B(tài)ucket所在地域,以華東1(杭州)為例,填寫為cn-hangzhou。其它Region請按實際情況填寫。
clientOptions := []oss.ClientOption{oss.SetCredentialsProvider(&provider)}
clientOptions = append(clientOptions, oss.Region("yourRegion"))
// 設(shè)置簽名版本
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"
// 創(chuàng)建Bucket實例。
bucket, err := client.Bucket(bucketName)
if err != nil {
log.Fatalf("Failed to get bucket '%s': %v", bucketName, err)
}
// 獲取指定版本軟鏈接指向的文件內(nèi)容。
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)
}
// 打印軟鏈接指向的目標(biāo)文件。
symlinkTarget := meta.Get(oss.HTTPHeaderOssSymlinkTarget)
log.Printf("Symlink Target: %s", symlinkTarget)
}
相關(guān)文檔
關(guān)于創(chuàng)建軟鏈接的API接口說明,請參見PutSymlink。
關(guān)于獲取軟鏈接的API接口說明,請參見GetSymlink。