对象存储 OSS：Go获取存储空间的信息

注意事项

• 本文以华东1（杭州）外网Endpoint为例。如果您希望通过与OSS同地域的其他阿里云产品访问OSS，请使用内网Endpoint。关于OSS支持的Region与Endpoint的对应关系，请参见访问域名和数据中心。
• 本文以OSS域名新建OSSClient为例。如果您希望通过自定义域名、STS等方式新建OSSClient，请参见Go初始化。
• 要获取存储空间的信息，您必须具有oss:GetBucketInfo权限。具体操作，请参见为RAM用户授权自定义的权限策略。

示例代码

以下代码用于获取Bucket信息。

package main

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

func main() {
    // 创建OSSClient实例。
    // yourEndpoint填写Bucket对应的Endpoint，以华东1（杭州）为例，填写为https://oss-cn-hangzhou.aliyuncs.com。其它Region请按实际情况填写。
    // 阿里云账号AccessKey拥有所有API的访问权限，风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维，请登录RAM控制台创建RAM用户。
    client, err := oss.New("yourEndpoint", "yourAccessKeyId", "yourAccessKeySecret")
    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。