Quota

Set a maximum storage capacity for a Stook Bucket.

Configure a storage quota to limit the amount of data that can be stored in a Stook Bucket.

When the Stook Bucket reaches its configured quota, new uploads are refused. Objects already stored in the bucket remain available and are not removed or modified.

Quota changes may take up to 10 minutes to take effect. After increasing a quota or deleting objects, new uploads may continue to be refused until the updated storage usage is applied.

For complete request parameters, response schemas, and error responses, see Bucket Settings API.

How Quota Works

When Quota is enabled, the configured size defines the maximum storage capacity of the Stook Bucket.

The following behavior applies:

• Uploads that would exceed the quota are refused with the QuotaExceeded error code.

• Existing objects remain available for read and delete operations.

• Deleting stored data frees capacity for new uploads.

• You can configure a quota lower than the bucket's current storage usage. Existing data remains available, but new uploads are refused until usage falls below the configured quota.

• In a versioned Stook Bucket, previous object versions also count toward the quota.

Deleting an object from a versioned bucket adds a delete marker and does not necessarily free storage capacity. Storage is freed when the corresponding object versions are permanently deleted.

Configure Quota

1

Open the Stook Bucket

In the Medianova Control Panel, select Stook Object Storage → Buckets, then select the Stook Bucket you want to configure.

2

Open Quota

On the Bucket configuration page, select Quota.

3

Enable Quota

Turn on Enabled.

4

Set the storage capacity

Enter the maximum storage capacity in Size.

The Control Panel displays the quota size in GB.

5

Save the configuration

Select Save Changes.

Configuration Fields

Field	Description	Default
Enabled	Enables or disables the storage quota for the Stook Bucket.	Off
Size	Maximum storage capacity of the Stook Bucket, in GB. Required when Quota is enabled.	—

Disable Quota

To remove the storage limit:

1

Open Quota

On the Bucket configuration page, select Quota.

2

Disable Quota

Turn off Enabled.

3

Save the configuration

Select Save Changes.

The Stook Bucket no longer has a configured storage quota.

Configure Quota with the API

Use the bucket settings endpoint to configure Quota:

PATCH /api/v2/stook/{organization_uuid}/bucket/{bucket_uuid}/settings

Send:

{
  "is_quota": true,
  "quota_size": 5368709120
}

The request enables Quota and sets the maximum storage capacity.

The quota_size value is specified in bytes. In this example, 5368709120 bytes represents 5 GiB.

To disable Quota, send:

{
  "is_quota": false
}

Troubleshooting

Quota cannot be enabled

A storage size is required when Quota is enabled.

Enter a value in Size, then save the configuration.

Quota size is invalid

The quota must be greater than 0 bytes.

Enter a valid storage size, or disable Quota if the Stook Bucket should not have a storage limit.

Quota exceeds the supported maximum

The maximum supported quota is 8 PB.

Configure a smaller value and save the configuration.

Uploads fail with QuotaExceeded

The Stook Bucket has reached its configured quota.

Delete objects that are no longer required or increase the quota. Allow up to 10 minutes for the updated storage usage or quota to take effect.

If Versioning is enabled, previous object versions also consume storage capacity and may need to be permanently deleted before space becomes available.

Related Topics

• Bucket Configuration

• Rate Limit

• Versioning