> For the complete documentation index, see [llms.txt](https://docs.ionos.com/terraform-provider/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ionos.com/terraform-provider/resources/user_object_storage_bucket.md).

# ionoscloud\_user\_object\_storage\_bucket

Manages user-owned IONOS Object Storage Buckets on IONOS CLOUD.

> ⚠️ **Deprecation notice:** User-owned buckets are a legacy bucket type. IONOS recommends using **contract-owned buckets** ([`ionoscloud_s3_bucket`](/terraform-provider/resources/s3_bucket.md)) for all new workloads. Contract-owned buckets offer broader regional availability, full Terraform sub-resource support (versioning, lifecycle, CORS, SSE, etc.), and are the actively developed offering. Migrate existing user-owned buckets to contract-owned buckets where possible.

## Example Usage

```hcl
resource "ionoscloud_user_object_storage_bucket" "example" {
  name   = "example-user-bucket"
  region = "de"

  force_destroy = true

  tags = {
    environment = "production"
    team        = "platform"
  }

  timeouts {
    create = "10m"
    delete = "10m"
  }
}
```

## Argument Reference

The following arguments are supported:

* `name` - (Required)\[string] The bucket name. Must be between 3 and 63 characters.
* `region` - (Required)\[string] The region where the bucket is created. Available regions:
  * `de` — Frankfurt, Germany (`https://s3.eu-central-1.ionoscloud.com`)
  * `eu-central-2` — Berlin, Germany (`https://s3.eu-central-2.ionoscloud.com`)
  * `eu-south-2` — Logroño, Spain (`https://s3.eu-south-2.ionoscloud.com`)
* `object_lock_enabled` - (Optional)\[bool] Whether Object Lock is enabled for the bucket. Defaults to `false`. **Cannot be changed after creation** — changing this value forces a new resource.
* `tags` - (Optional) A mapping of tags to assign to the bucket.
* `force_destroy` - (Optional)\[bool] Defaults to `false`. When set to `true`, all objects in the bucket are deleted before the bucket itself is destroyed, allowing Terraform to remove a non-empty bucket. **Use with caution** — this irreversibly deletes all bucket contents.
* `timeouts` - (Optional) Timeouts for this resource.
  * `create` - (Optional)\[string] Time to wait for the bucket to be created. Default is `10m`.
  * `read` - (Optional)\[string] Time to wait for the bucket read operations. Default is `10m`.
  * `delete` - (Optional)\[string] Time to wait for the bucket to be deleted. Default is `60m`.

## Attributes Reference

* `id` - (Computed) Same value as `name`.

> ⚠️ **Note:** The bucket name must be unique. Follow IONOS [bucket naming conventions](https://docs.ionos.com/cloud/storage-and-backup/ionos-object-storage/concepts/buckets#naming-conventions).

## Limitations

* **Region cannot be read back from the API** after import due to a known SDK generator issue with the `GetBucketLocation` response XML model. The region defaults to `de` when importing by bucket name alone. Use the `region:name` import format to specify the correct region explicitly.
* Tags and sub-resources (versioning, lifecycle, CORS, SSE, website, policy) are not currently supported for user-owned buckets. Use `ionoscloud_s3_bucket` and its associated resources for full feature coverage.

## Import

A bucket must be imported using `region:bucket_name`:

```shell
terraform import ionoscloud_user_object_storage_bucket.example de:my-bucket
terraform import ionoscloud_user_object_storage_bucket.example eu-central-2:my-bucket
```