2.27. 获取存储桶配额
获取有关现有 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
- 描述
- 用于单一存储桶信息的容器。
- 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 冲突