对象存储

    • 对象存储 > API 文档 > Service 接口 >获取 Bucket 列表

    获取 Bucket 列表

    最近更新时间: 2024-05-21 14:10:26

    描述

    本接口作 GET 请求用来获取请求者拥有的所有存储空间列表。该接口需要您使用带 Authorization 签名认证的请求，如果使用匿名请求无法获取存储空间列表，且只能获取签名中 AccessKey 所属账户的存储空间列表。


    请求

    请求语法

    GET /buckets?tagCondition=<Encodedtags> HTTP/1.1
Host: uc.qiniuapi.com
Content-Type: application/x-www-form-urlencoded
X-Qiniu-Date: 20060102T150405Z
Authorization: Qiniu <AccessToken>

    请求参数

    参数名称 必填 说明
    Encodedtags 否 过滤空间的标签或标签值条件，指定多个标签或标签值时同时满足条件的空间才会返回。参数值必须做URL 安全的 Base64 编码。
    按标签名过滤空间时，参数值设置为Encoded(key=key1;key=key2)；按标签值过滤空间时，参数值设置为Encoded(key=key1&value=value1;key=key2&value=value2)
    别人授权的空间，标签属性不传递，因此依据标签列举空间时只会返回自己创建的空间

    请求头

    该请求操作的实现使用了所有操作的公共请求头。有关详细信息，请查阅公共请求头。


    请求内容

    该请求操作的请求体为空。


    响应

    响应语法

    HTTP/1.1 200 OK
Content-Type: application/json
[
BucketName
]

    响应头

    该请求操作的实现使用了所有操作的公共响应头。有关详细信息，请查阅公共响应头。


    响应内容

    名称 说明
    BucketName 空间名称

    类型：字符串

    响应状态码

    该操作的实现不会返回特殊错误。有关错误和错误代码列表的一般信息，请查阅错误响应。


    示例

    请求示例

    GET /buckets?tagCondition=S09ETy1CVUtDRVQtVEFHUy1rZXktWDdPNjZiNkxLdz1LT0RPLUJVS0NFVC1UQUdTLXZhbHVlLWdFOGhIV2VXUGo= HTTP/1.1
Host: uc.qiniuapi.com
User-Agent: Go-http-client/1.1
X-Qiniu-Date: 20060102T150405Z
Authorization: Qiniu HwFOxpYCQU6oXoZXFOTh1mq5ZZig6Yyocgk3BTZZ:8tgafMszuwgd99Ix4eQ2HeVT9B0=

    注：要在 Authorization 头部的 <AccessToken> 前添加 Qiniu 和半角空格。


    响应示例

    HTTP/1.1 200 OK
Content-Length: 75
Connection: keep-alive
Content-Type: application/json
Date: Mon, 02 Jan 2006 15:04:05 GMT
X-Reqid: rWkAACgHbskB5dYV

[
  "temp-bucket-xufk1x3r1wa9ayoy7knuz0", 
  "temp-bucket-pighpwdt7lu88ljltffmz0"
]
    以上内容是否对您有帮助？
    • Qvm free helper
    Close