# Pause or resume a check

Stop a check from running without deleting it, and start it again.

A paused check sends no requests and notifies nobody. Pausing closes an open outage without a
notification. Resuming starts the check over as `pending`; it runs within a minute. A paused check
still counts toward the **Uptime checks** quota. Replace _check-id_ with the check's id.

## Prerequisites

- Permission for `monitoring:PauseChecks` to pause, and `monitoring:ResumeChecks` to resume, on the
  check, `rn:ews::<organization id>:monitoring:check/<check id>`. Without it, the console's
  **Pause** or **Resume** is unavailable, with the note "Needs monitoring:PauseChecks on this
  check." (or `ResumeChecks`).
- In the console, also `monitoring:DescribeChecks` to open **Uptime**.

## Pause or resume

**Console**
1. Open **Monitoring**, then **Uptime**.
2. Open the check's action menu and choose **Pause**, or **Resume** for a paused check. On the
   check's own page, the same button is next to its state.

**CLI**
```sh
dcloud monitoring checks pause check-id
dcloud monitoring checks resume check-id
```

**API**
```http
POST /monitoring/api/checks/check-id/pause
```

```http
POST /monitoring/api/checks/check-id/resume
```

**Terraform**
Set `enabled = false` on the `dcloud_uptime_check` to pause it, and `true` to resume it.

## Result

A paused check is `paused`, with the reason "Paused: the check does not run and notifies nobody.".
A resumed check is `pending`. Pausing a paused check, or resuming a running one, changes nothing.

## When resuming is refused

`409` "… is already checked … times a minute by …; at most 6 a minute across all checks. Choose a
longer interval." when other checks took the host's requests while this one was paused.

## Related

- [How uptime checks work](how-uptime-checks-work.md)
- [Delete an uptime check](delete-an-uptime-check.md)
- `monitoring.checks.pause` · `monitoring.checks.resume`
