存储空间(Bucket)是用来存储对象(Object)的容器。对象都隶属于存储空间。存储空间按照字母顺序排列。您可以列举所有存储空间、列举资源组下的所有存储空间以及符合指定条件的存储空间。
列举所有存储空间
以下代码用于列举所有存储空间。
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)
}
// 列举当前账号下的所有存储空间。
marker := ""
for {
lsRes, err := client.ListBuckets(oss.Marker(marker))
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// 默认情况下一次返回100条记录。
for _, bucket := range lsRes.Buckets {
fmt.Println("Bucket: ", bucket.Name)
}
if lsRes.IsTruncated {
marker = lsRes.NextMarker
} else {
break
}
}
}
列举指定前缀的存储空间
以下代码用于列举指定前缀(prefix)的存储空间。
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)
}
// 指定prefix,用于列举与指定prefix匹配的存储空间。
lsRes, err = client.ListBuckets(oss.Prefix("yourBucketPrefix"))
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// 打印存储空间列表。
fmt.Println("Buckets with prefix: ", lsRes.Buckets)
for _, bucket := range lsRes.Buckets {
fmt.Println("Bucket with prefix: ", bucket.Name)
}
列举指定marker之后的存储空间
以下代码用于列举指定marker之后的存储空间。
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)
}
// 指定marker名称,用于列举指定marker之后的存储空间。
lsRes, err = client.ListBuckets(oss.Marker("yourBucketMarker"))
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// 打印存储空间列表。
fmt.Println("My buckets with marker :", lsRes.Buckets)
for _, bucket := range lsRes.Buckets {
fmt.Println("Bucket with marker: ", bucket.Name)
}
列举指定个数的存储空间
以下代码用于列举指定个数的存储空间。
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)
}
// 限定此次列举存储空间的个数为500。默认值为100,最大值为1000。
lsRes, err = client.ListBuckets(oss.MaxKeys(500))
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// 打印存储空间列表。
fmt.Println("My buckets max num:", lsRes.Buckets)
for _, bucket := range lsRes.Buckets {
fmt.Println("Bucket with maxKeys: ", bucket.Name)
}
相关文档
- 关于列举存储空间的完整示例代码,请参见GitHub示例。
- 关于列举存储空间的API接口说明,请参见GetService (ListBuckets)。