> For the complete documentation index, see [llms.txt](https://clients.medianova.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://clients.medianova.com/products/object-storage-stook/bucket-configuration.md).

# Bucket Configuration

Configure access, traffic, capacity, and data protection settings for a Stook Bucket.

Bucket configuration settings apply only to the selected Stook Bucket. You can manage these settings from the [Medianova Control Panel](https://cloud.medianova.com) or through [the Stook API](/api-documentation/object-storage-stook.md).

{% hint style="warning" %}
Some bucket settings cannot be fully reversed:

* **Versioning** cannot return to **Off** after it has been enabled. You can suspend versioning to stop creating new versions, but existing versions remain.
* **Object Lock** cannot be disabled after it has been enabled. Existing objects remain protected according to their configured retention periods.

Review these settings before applying changes.
{% endhint %}

### Configure Bucket Settings with the API

Bucket settings can also be configured through the Stook API.

{% hint style="info" %}
For complete request parameters, response schemas, and error responses, see [Bucket Settings API](/api-documentation/object-storage-stook/buckets/settings.md).
{% endhint %}

## Configure a Stook Bucket

{% stepper %}
{% step %}

### **Open the Stook Bucket**

In the [Medianova Control Panel](https://cloud.medianova.com), select **Stook Object Storage → Buckets**, then select the Stook Bucket you want to configure.
{% endstep %}

{% step %}

### **Open Bucket configuration**

Open the **Bucket configuration** page to view the settings available for the selected Stook Bucket.

<figure><img src="https://542970813-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtK7oIwmhUHdEJcaH4Hx8%2Fuploads%2FU8cr3jpidWpiqfYBXP7U%2Fimage%20(4).png?alt=media&amp;token=55a35680-632b-495e-a35e-f74632b01cd3" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

### **Configure a setting**

Select a setting to expand its configuration options. See Available settings for details.
{% endstep %}

{% step %}

### **Save the configuration**

Select **Save Changes** to apply your changes.
{% endstep %}
{% endstepper %}

## Available Settings

<table><thead><tr><th width="222">Setting</th><th>Description</th></tr></thead><tbody><tr><td><a href="/products/object-storage-stook/bucket-configuration/public-access-block.md">Public Access Block</a></td><td>Control whether objects can be accessed without credentials and prevent the Stook Bucket from being made public.</td></tr><tr><td><a href="/products/object-storage-stook/bucket-configuration/cors-headers.md">CORS Headers</a></td><td>Control which browser origins can send cross-origin requests to the Stook Bucket.</td></tr><tr><td><a href="/products/object-storage-stook/bucket-configuration/rate-limit.md">Rate Limit</a></td><td>Limit the number of read and write requests served per minute.</td></tr><tr><td><a href="/products/object-storage-stook/bucket-configuration/quota.md">Quota</a></td><td>Set a maximum storage capacity for the Stook Bucket.</td></tr><tr><td><a href="/products/object-storage-stook/bucket-configuration/server-side-encryption.md">Server-Side Encryption</a></td><td>Encrypt new objects at rest with AES-256.</td></tr><tr><td><a href="/products/object-storage-stook/bucket-configuration/versioning.md">Versioning</a></td><td>Preserve previous versions of objects when they are overwritten or deleted.</td></tr><tr><td><a href="/products/object-storage-stook/bucket-configuration/mfa-delete.md">MFA Delete</a></td><td>Require an authenticator code to permanently delete object versions or disable protected versioning operations.</td></tr><tr><td><a href="/products/object-storage-stook/bucket-configuration/object-lock.md">Object Lock</a></td><td>Prevent object versions from being deleted until their retention periods expire.</td></tr><tr><td><a href="/products/object-storage-stook/bucket-configuration/event-notifications.md">Event Notifications</a></td><td>Send object creation and removal events to configured HTTPS, Kafka, or AMQP destinations.</td></tr><tr><td><a href="/products/object-storage-stook/bucket-configuration/ip-restriction.md">IP Restriction</a></td><td>Allow or block access to the Stook Bucket by client IP address.</td></tr></tbody></table>

{% hint style="info" %}
Some bucket settings may not be available for every Stook Bucket. If a setting does not appear on the **Bucket configuration** page, it cannot be configured for that bucket.
{% endhint %}

## Configuration Dependencies

Some settings depend on other Stook Bucket settings.

* **MFA Delete** requires Versioning to be **On**.
* **Object Lock** requires Versioning to be **On**.
* Versioning cannot be suspended while MFA Delete or Object Lock is enabled.
* A Stook Bucket with **Block public access** enabled cannot be made public.
* A Stook Bucket connected to a CDN Resource must remain publicly accessible.

For configuration requirements and limitations specific to a setting, see the corresponding configuration page.

## Save or Discard Changes

You can modify multiple bucket settings before applying the configuration.

* Select **Save Changes** to validate and apply the pending changes.
* Select **Discard** to revert changes that have not been saved.

If validation fails, the configuration is not applied. The affected setting is marked in the [Medianova Control Panel](https://cloud.medianova.com) with information about the required correction.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://clients.medianova.com/products/object-storage-stook/bucket-configuration.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
