存储空间是对象(Object)的容器。您可以通过OSS Go SDK获取访问跟踪状态信息、地域、创建日期、读写权限、拥有者的名称和ID、存储类型、数据容灾类型、外网域名、内网域名、跨区域复制状态、版本控制状态、加密方式等内容,以便进行相应操作。例如,获取外网域名后结合Object名称,即可访问Object。
注意事项
本文以华东1(杭州)外网Endpoint为例。如果您希望通过与OSS同地域的其他阿里云产品访问OSS,请使用内网Endpoint。关于OSS支持的Region与Endpoint的对应关系,请参见访问域名和数据中心。
本文以从环境变量读取访问凭证为例。如何配置访问凭证,请参见配置访问凭证。
本文以OSS域名新建OSSClient为例。如果您希望通过自定义域名、STS等方式新建OSSClient,请参见初始化。
要获取存储空间的信息,您必须具有
oss:GetBucketInfo
权限。具体操作,请参见为RAM用户授权自定义的权限策略。
示例代码
以下代码用于获取Bucket信息。
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)
}
// 填写Bucket名称,例如examplebucket。
res, err := client.GetBucketInfo("examplebucket")
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
fmt.Println("Bucket Info Name: ", res.BucketInfo.Name)
// 查看Bucket访问跟踪状态信息。
fmt.Println("Bucket Info AccessMonitor: ", res.BucketInfo.AccessMonitor)
// 查看Bucket所在地域。
fmt.Println("Bucket Info Location: ", res.BucketInfo.Location)
// 查看Bucket创建日期。
fmt.Println("Bucket Info CreationDate: ", res.BucketInfo.CreationDate)
// 查看Bucket读写权限。
fmt.Println("Bucket Info ACL: ", res.BucketInfo.ACL)
// 查看Bucket拥有者的用户ID。
fmt.Println("Bucket Info Owner Id: ", res.BucketInfo.Owner.ID)
// 查看Bucket拥有者名称,与用户ID一致。
fmt.Println("Bucket Info Owner DisplayName: ", res.BucketInfo.Owner.DisplayName)
// 查看Bucket的存储类型。
fmt.Println("Bucket Info StorageClass: ", res.BucketInfo.StorageClass)
// 查看Bucket的数据容灾类型。
fmt.Println("Bucket Info RedundancyType: ", res.BucketInfo.RedundancyType)
// 查看Bucket的外网域名。
fmt.Println("Bucket Info ExtranetEndpoint: ", res.BucketInfo.ExtranetEndpoint)
// 查看同地域ECS访问Bucket的内网域名。
fmt.Println("Bucket Info IntranetEndpoint: ", res.BucketInfo.IntranetEndpoint)
// 查看Bucket的跨区域复制状态。
fmt.Println("Bucket Info CrossRegionReplication: ", res.BucketInfo.CrossRegionReplication)
if res.BucketInfo.Versioning !="" {
// 查看Bucket的版本控制状态。
fmt.Println("Bucket Info Versioning: ", res.BucketInfo.Versioning)
}
if res.BucketInfo.SseRule.KMSDataEncryption !="" {
// 查看Bucket是否使用KMS加密。
fmt.Println("Bucket Info SseRule KMSDataEncryption: ", res.BucketInfo.SseRule.KMSDataEncryption)
}
if res.BucketInfo.SseRule.KMSMasterKeyID !="" {
// 查看Bucket当前使用的KMS密钥ID。
fmt.Println("Bucket Info SseRule KMSMasterKeyID: ", res.BucketInfo.SseRule.KMSMasterKeyID)
}
if res.BucketInfo.SseRule.SSEAlgorithm !="" {
// 查看Bucket服务器端默认加密方式。
fmt.Println("Bucket Info SseRule SSEAlgorithm: ", res.BucketInfo.SseRule.SSEAlgorithm)
}
}
相关文档
关于存储空间的更多信息,请参见存储空间概述。
关于获取Bucket信息的API接口说明,请参见GetBucketInfo。