获取 Bucket 列表
描述
本接口作 GET 请求用来获取请求者拥有的所有存储空间列表。该接口需要您使用带 Authorization 签名认证的请求,如果使用匿名请求无法获取存储空间列表,且只能获取签名中 AccessKey 所属账户的存储空间列表。
请求
语法
GET /buckets?tagCondition=<Encodedtags> HTTP/1.1
Host: rs.qbox.me
Content-Type: application/x-www-form-urlencoded
Authorization: Qiniu <AccessToken>
请求参数
参数名称 | 必填 | 说明 |
---|---|---|
Encodedtags | 否 | 过滤空间的标签或标签值条件,指定多个标签或标签值时同时满足条件的空间才会返回。参数值必须做URL 安全的 Base64 编码。 按标签名过滤空间时,参数值设置为Encoded(key1=&key2=);按标签值过滤空间时,参数值设置为Encoded(key1=value1&key2=value2) 别人授权的空间,标签属性不传递,因此依据标签列举空间时只会返回自己创建的空间 |
请求头
该请求操作的实现使用了所有操作的公共请求头。有关详细信息,请查阅公共请求头。
请求元素
该请求操作的请求体为空。
响应
响应头
该请求操作的实现使用了所有操作的公共响应头。有关详细信息,请查阅公共响应头。
响应元素
名称 | 说明 |
---|---|
BucketName | 空间名称 类型:字符串 |
特殊错误
该操作的实现不会返回特殊错误。有关错误和错误代码列表的一般信息,请查阅错误响应。
示例
请求示例
GET /buckets?tagCondition=S09ETy1CVUtDRVQtVEFHUy1rZXktWDdPNjZiNkxLdz1LT0RPLUJVS0NFVC1UQUdTLXZhbHVlLWdFOGhIV2VXUGo= HTTP/1.1
Host: rs.qbox.me
User-Agent: Go-http-client/1.1
Authorization: Qiniu HwFOxpYCQU6oXoZXFOTh1mq5ZZig6Yyocgk3BTZZ:8tgafMszuwgd99Ix4eQ2HeVT9B0=
响应示例
HTTP/1.1 200 OK
Content-Length: 75
Connection: keep-alive
Content-Type: application/json
Date: Thu, 14 Nov 2019 02:01:55 GMT
X-Reqid: rWkAACgHbskB5dYV
[
"temp-bucket-xufk1x3r1wa9ayoy7knuz0",
"temp-bucket-pighpwdt7lu88ljltffmz0"
]
文档反馈
(如有产品使用问题,请提交工单)