# What is Object Storage?

Object Storage keeps files, backups and static assets in S3-compatible buckets that any S3 client reads and writes.

You create buckets and access keys in the Deutsche Cloud Console, with the CLI, the API or Terraform, then use
any S3 client (the AWS CLI, an AWS SDK, rclone, Cyberduck) against the S3 endpoint. A bucket is
private and encrypted at rest from the start. You find it under **Object Storage** in the
Deutsche Cloud Console.

## When to use it

- An application stores uploads, exports or generated files and reads them back by key.
- Backups and archives that must survive the loss of a zone: replicate a bucket into the other zone,
  and lock objects against deletion with object lock.
- A static website or assets served straight from a bucket, on its own address or your domain.

## Concepts

| Term                    | Meaning                                                                                                                              |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| **Bucket**              | A named container for objects. Names are unique across the platform, because each is also a hostname.                                |
| **Object**              | A file stored under a key, such as `images/logo.png`. Keys are case-sensitive.                                                       |
| **Zone**                | Where a bucket's objects are stored: `de1a` (Falkenstein), `de1b` (Nuremberg), or `fi1a` (Helsinki) when allowed. Fixed at creation. |
| **Access key**          | An access key ID and secret that S3 clients sign with. It acts as an IAM user, optionally limited to one bucket.                     |
| **Endpoint**            | `https://s3.<domain>`; each bucket also at `https://<bucket>.s3.<domain>`.                                                           |
| **Bucket policy**       | A policy in AWS's grammar on the bucket, to make objects public or share them with another organization.                             |
| **Block public access** | On for every new bucket: no policy can make it public until you turn it off.                                                         |
| **Versioning**          | Keeps the earlier version on every overwrite and delete.                                                                             |
| **Replication**         | Copies every object into another bucket of your organization, usually in the other zone.                                             |

More in [Buckets and objects](buckets-and-objects.md) and
[Storage locations](storage-locations.md).

## Pricing

- **Stored data**: per GB-month, every version counted, measured daily. Requests and uploads are
  free. Charging for object storage is switched on by Deutsche Cloud; until it is, the cost explorer
  shows what the stored data would cost.
- **Own storage**: a bucket on your organization's own storage (a storage cluster or own hosts) is
  billed per GB-month, every version counted, at the price set for that storage; without a price it
  is counted, not billed.
- Access keys and temporary credentials are free.

## Interfaces

- The Deutsche Cloud Console, under **Object Storage**; access keys under **Identity** → **Access keys**.
- Any S3 client against the S3 endpoint; see [S3 compatibility](s3-compatibility.md).
- The CLI: `dcloud s3 …`; see the _CLI Command Reference_.
- The HTTP API under `/s3/api`; see the _API Reference_.
- Terraform: `dcloud_bucket`, `dcloud_bucket_versioning`, `dcloud_bucket_lifecycle`,
  `dcloud_bucket_replication`, `dcloud_bucket_encryption`, `dcloud_bucket_public_access_block`,
  `dcloud_bucket_policy`, `dcloud_bucket_cors`, `dcloud_bucket_website`, `dcloud_bucket_domain`,
  `dcloud_s3_access_key`, and `dcloud_iam_access_key` for keys.

## Next steps

- [Get started](getting-started.md): create a bucket, upload a file, and clean up.
- [Create a bucket](create-a-bucket.md)
- [Make objects public](make-objects-public.md)
