更新时间：2026-02-12 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" : "regionid",
"clustertype" : null,
"storageClass" : null,
"acl" : null,
"bucketStorageClass" : null,
"bucketType" : "OBJECT"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 正常返回 |
错误码
请参见错误码。
父主题： 转储任务管理
