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 冲突