Go管理存儲(chǔ)空間的讀寫權(quán)限
存儲(chǔ)空間（Bucket）是存儲(chǔ)對(duì)象（Object）的容器。對(duì)象都隸屬于存儲(chǔ)空間。本文介紹如何設(shè)置和獲取存儲(chǔ)空間讀寫權(quán)限（ACL）。
注意事項(xiàng)
本文以華東1（杭州）外網(wǎng)Endpoint為例。如果您希望通過與OSS同地域的其他阿里云產(chǎn)品訪問OSS，請(qǐng)使用內(nèi)網(wǎng)Endpoint。關(guān)于OSS支持的Region與Endpoint的對(duì)應(yīng)關(guān)系，請(qǐng)參見訪問域名和數(shù)據(jù)中心。
本文以從環(huán)境變量讀取訪問憑證為例。如何配置訪問憑證，請(qǐng)參見配置訪問憑證。
本文以O(shè)SS域名新建OSSClient為例。如果您希望通過自定義域名、STS等方式新建OSSClient，請(qǐng)參見初始化。
要設(shè)置存儲(chǔ)空間讀寫權(quán)限，您必須有
oss:PutBucketAcl權(quán)限；要獲取存儲(chǔ)空間讀寫權(quán)限，您必須有oss:GetBucketAcl權(quán)限。具體操作，請(qǐng)參見為RAM用戶授權(quán)自定義的權(quán)限策略。
存儲(chǔ)空間的讀寫權(quán)限類型
存儲(chǔ)空間的讀寫權(quán)限（ACL）有以下三類：
讀寫權(quán)限 | 描述 | 方法 |
私有 | 存儲(chǔ)空間的擁有者和授權(quán)用戶有文件的讀寫權(quán)限，其他用戶沒有權(quán)限操作文件。 | oss.ACLPrivate |
公共讀 | 存儲(chǔ)空間的擁有者和授權(quán)用戶有文件的讀寫權(quán)限，其他用戶只有讀權(quán)限。請(qǐng)謹(jǐn)慎使用該權(quán)限。 | oss.ACLPublicRead |
公共讀寫 | 所有用戶都有文件的讀寫權(quán)限。請(qǐng)謹(jǐn)慎使用該權(quán)限。 | oss.ACLPublicReadWrite |
示例代碼
以下代碼用于設(shè)置并獲取存儲(chǔ)空間的讀寫權(quán)限：
package main
import (
"log"
"github.com/aliyun/aliyun-oss-go-sdk/oss"
)
func main() {
// 從環(huán)境變量中獲取訪問憑證。運(yùn)行本代碼示例之前，請(qǐng)確保已設(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實(shí)例。
// yourEndpoint填寫B(tài)ucket對(duì)應(yīng)的Endpoint，以華東1（杭州）為例，填寫為https://oss-cn-hangzhou.aliyuncs.com。其它Region請(qǐng)按實(shí)際情況填寫。
endpoint := "yourEndpoint"
client, err := oss.New(endpoint, "", "", oss.SetCredentialsProvider(&provider))
if err != nil {
log.Fatalf("Failed to create OSS client: %v", err)
}
// yourBucketName填寫存儲(chǔ)空間名稱。
bucketName := "yourBucketName"
// 設(shè)置存儲(chǔ)空間的讀寫權(quán)限為公共讀。
err = client.SetBucketACL(bucketName, oss.ACLPublicRead)
if err != nil {
log.Fatalf("Failed to set bucket ACL for '%s': %v", bucketName, err)
}
// 獲取存儲(chǔ)空間的讀寫權(quán)限。
aclRes, err := client.GetBucketACL(bucketName)
if err != nil {
log.Fatalf("Failed to get bucket ACL for '%s': %v", bucketName, err)
}
log.Printf("Bucket ACL for '%s': %s", bucketName, aclRes.ACL)
}
相關(guān)文檔
關(guān)于Object訪問權(quán)限的完整示例代碼，請(qǐng)參見GitHub示例。
關(guān)于設(shè)置存儲(chǔ)空間讀寫權(quán)限的API接口說明，請(qǐng)參見SetBucketACL。
關(guān)于獲取存儲(chǔ)空間讀寫權(quán)限的API接口說明，請(qǐng)參見GetBucketACL。