Quota & Limits¶

Each RGW user has a storage quota that caps total used space. Quota is enforced by the Ceph RGW admin API and applied at the user level (not per-bucket).

Quota fields¶

Field	Type	Description
`max_size_kb`	integer	Maximum total storage in KB. `-1` means unlimited.
`enabled`	boolean	Whether the quota is actively enforced.

No object count limit

The API does not expose max_objects. Only storage capacity (max_size_kb) is configurable through this interface.

View current quota¶

Quota is included in the RGW user show response:

GET /rgw/users/{id}
Authorization: Bearer <token>

{
  "id": "...",
  "quota": {
    "max_size_kb": 524288000,
    "enabled": true
  },
  "buckets_total_size_kb": 1024000,
  ...
}

buckets_total_size_kb is the current total usage across all buckets owned by this user.

Update quota (admin only)¶

Quota changes require platform-admin privileges. A member-level token that sends the quota field receives 403 Forbidden.

PATCH /rgw/users/{id}
Authorization: Bearer <admin-token>
Content-Type: application/json

{
  "quota": {
    "max_size_kb": 1073741824,
    "enabled": true
  }
}

Value	Effect
`max_size_kb: -1`	Removes the size limit (unlimited storage).
`enabled: false`	Quota is stored but not enforced.
`enabled: true`	Quota is actively enforced. Writes that would exceed `max_size_kb` are rejected by RGW.

Default quota¶

New RGW users are provisioned with a default quota of 500 GB (max_size_kb: 524288000, enabled: true). Contact your b'nerd account manager to increase the quota for a specific user.

Requesting a quota increase¶

Quota increases above the default require a platform-admin to apply them via the API or dashboard. If you do not have admin access, open a support ticket or contact your account manager with:

The RGW user ID (UUID from GET /rgw/users/{id})
The requested max_size_kb value
The project the user belongs to