# Create a status page

Publish a public page at {slug}.status.<domain> that tells your users whether your service works.

A status page is public, needs no sign-in, and is served by Deutsche Cloud at
`https://<slug>.status.<domain>`, where _domain_ is the domain of your Deutsche Cloud installation. It shows its
components (see [Add components to a status page](add-components.md)), the open incidents and those
resolved in the last 14 days, a form where visitors subscribe by email, and the same data as JSON at
`/summary.json`.

**Important:**
The page is public as soon as it is created, and its address is unique across Deutsche Cloud.

## Prerequisites

- Permission for `monitoring:CreateStatusPage` on `rn:ews::<organization id>:monitoring:*`.
  Without it, the console's **Create status page** does nothing and says "Needs
  monitoring:CreateStatusPage."
- In the console, also `monitoring:DescribeStatusPages` to open **Status pages** (without it the
  page shows an access-denied notice).
- Room in the **Status pages** quota (see [Quotas](quotas.md)).

## Create the page

**Console**
1. Open **Monitoring**, then **Status pages**.
2. Under **Create a status page**, for **Address**, enter acme.
3. For **Title**, enter Acme status.
4. Choose **Create status page**.

The console opens the new page's settings. It creates the page without a description; set one with
the CLI, the API or Terraform.

**CLI**
```sh
dcloud monitoring status-pages create --slug acme --title "Acme status"
```

**API**
```http
POST /monitoring/api/status-pages
{ "slug": "acme", "title": "Acme status", "description": "Our shop and its API." }
```

**Terraform**
```hcl
resource "dcloud_status_page" "acme" {
  slug  = "acme"
  title = "Acme status"
}
```

## Result

The answer is `201` with the page's `id` and `url`. Until it has components or an open incident,
the page's overall state is operational.

## When the page is refused

- `409` "The address "acme" is taken": another page on Deutsche Cloud has it.
- `400` "… is reserved; choose another address", with the word in quotes, for a reserved word: `ews`, `www`,
  `status`, `api`, `console`, `admin`, `mail`, `support`, `help`, `login`, `auth`, `security`.
- `400` when the address is not 3 to 63 lower-case letters, digits and dashes, starting and ending
  with a letter or digit.
- `409` with code `QuotaExceeded` past the **Status pages** quota.

## Related

- [Add components to a status page](add-components.md)
- [Post an incident](post-an-incident.md)
- `monitoring.status-pages.create` · `dcloud monitoring status-pages create` · `dcloud_status_page`
