2.17. 获取存储桶信息
获取有关现有 bucket 子集的信息。如果在没有 bucket 的情况下指定 uid，则返回属于该用户的所有存储桶。如果只指定 存储桶，则会检索该特定存储桶的信息。
功能
`buckets=read`
语法
GET /admin/bucket?format=json HTTP/1.1
Host FULLY_QUALIFIED_DOMAIN_NAME
请求参数
bucket- 描述
- 用于返回信息的存储桶。
- Type
- 字符串
- 示例
-
foo_bucket - 必需
- 否
uid- 描述
- 检索存储桶信息的用户。
- Type
- 字符串
- 示例
-
foo_user - 必需
- 否
stats- 描述
- 返回存储桶统计信息。
- Type
- 布尔值
- 示例
- True [False]
- 必需
- 否
响应实体
stats- 描述
- 每个存储桶信息。
- Type
- Container
- 父
- 不适用
bucket- 描述
- 包含一个或多个 bucket 容器的列表。
- Type
- Container
- 父
-
bucket
bucket- 描述
- 用于单一存储桶信息的容器。
- Type
- Container
- 父
-
bucket
名称- 描述
- bucket 的名称。
- Type
- 字符串
- 父
-
bucket
pool- 描述
- bucket 存储在其中的池。
- Type
- 字符串
- 父
-
bucket
id- 描述
- 唯一的存储桶 ID。
- Type
- 字符串
- 父
-
bucket
marker- 描述
- 内部存储桶标签。
- Type
- 字符串
- 父
-
bucket
owner- 描述
- bucket 所有者的用户 ID。
- Type
- 字符串
- 父
-
bucket
usage- 描述
- 存储使用信息。
- Type
- Container
- 父
-
bucket
index- 描述
- bucket 索引的状态。
- Type
- 字符串
- 父
-
bucket
如果成功，请求会返回带有存储桶信息的 bucket 容器。
特殊错误响应
IndexRepairFailed- 描述
- bucket 索引修复失败。
- 代码
- 409 冲突
