更新时间：2025-11-07 GMT+08:00
获取桶列表 - Getbuckets
功能介绍
本接口用于获取数据转储地址的桶列表。
调用方法
请参见如何调用API。
URI
GET /v1/obs/buckets
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
参数解释： 用户Token，通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。请参见认证鉴权-Token认证。 约束限制： 不涉及 取值范围： 长度为[1-32768]个字符。 默认取值： 不涉及 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
bucketName |
String |
参数解释： 桶名称。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
|
owner |
String |
参数解释： 桶的所有者信息。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
|
creationDate |
Integer |
参数解释： 桶的创建时间，UNIX时间戳格式。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
|
location |
String |
参数解释： 当前局点的regionid。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
displayName |
String |
参数解释： 显示用户名称，一般是桶所属用户的domainname。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
|
id |
String |
参数解释： 用户id，一般是桶所属用户的domainid。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
请求示例
获取桶列表。
GET https://{Endpoint}/v1/obs/buckets
响应示例
状态码：200
正常返回
{
"bucketName" : "dis-test",
"owner" : {
"displayName" : null,
"id" : "b2dbbd927c504f75885b7edc67xxx15e"
},
"creationDate" : 1646829844714,
"location" : "cn-soutxxx-x",
"clustertype" : null,
"storageClass" : null,
"acl" : null,
"bucketStorageClass" : null,
"bucketType" : "OBJECT"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
正常返回 |
错误码
请参见错误码。
父主题： 转储任务管理
