文档

Go获取存储空间的信息

更新时间:

存储空间是对象(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)
    }
}

相关文档

  • 本页导读 (1)