# How to Pause or Resume BYOIP Prefix Advertisement

DigitalOcean Reserved IPs are publicly-accessible static IPv4 and IPv6 addresses. Assign and reassign reserved IP addresses to Droplets as needed, or implement an automated failover mechanism with reserved IPs to build a high availability infrastructure.

You may pause the advertisement of a BYOIP prefix to disable it without deleting it from your team account. You can also resume advertisement to make a paused or newly provisioned prefix accessible from the internet.

**Note**: **Newly provisioned BYOIP prefixes are not advertised by default.** After your prefix is successfully provisioned and shows a status of **Active**, you must resume advertisement (set `advertise: true`) to make it fully usable and accessible from the internet.

## Pause the Advertisement of a BYOIP Prefix

### Using the CLI

To pause the advertisement of a prefix, use the `doctl network byoip-prefix update` command with the ID of your BYOIP prefix and the flag `--advertisement=false`. To find the ID of your prefix, use `doctl network byoip-prefix list` to list all of your prefixes and their IDs.

```shell
doctl network byoip-prefix update <your_prefix_id> --advertise=false
```

Replace `<your_prefix_id>` with the ID of the prefix you are pausing.

### Using the API

Send a `PATCH` request to the `/v2/byoip_prefixes/<your_prefix_id>` endpoint with `{"advertise": false}` as the request body. To find the ID of your prefix send a `GET` request to the `/v2/byoip_prefixes` endpoint to list all of your prefixes and their IDs.

```shell
curl -X PATCH \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
  -d '{"advertise": false}' \
  "https://api.digitalocean.com/v2/byoip_prefixes/<your_prefix_id>"
```

Replace `<your_prefix_id>` with the ID of the prefix you are pausing.

The API sends a `202` response with the current state of the BYOIP prefix on success.

### Using the Control Panel

To pause the advertisement of a BYOIP prefix, go to the [control panel](https://cloud.digitalocean.com/), in the main menu, click **Networking**, and then click the **Reserved IPs** tab.

In the **Bring Your Own IP** section of the page, find the BYOIP prefix you’d like to pause, click its **…** context menu, and then click **Pause advertisement**.

A confirmation window pops up. Type the confirmation text into the text box, and then click **Pause advertisement** to complete the process.

## Resume the Advertisement of a BYOIP Prefix

### Using the CLI

To resume the advertisement of a paused or newly provisioned prefix, use the `doctl network byoip-prefix update` command with the ID of your BYOIP prefix and the flag `--advertise=true`. To find the ID of your prefix, use `doctl network byoip-prefix list` to list all of your prefixes and their IDs.

```shell
doctl network byoip-prefix update <your_prefix_id> --advertise=true
```

Replace `<your_prefix_id>` with the ID of the prefix you are resuming.

### Using the API

Send a `PATCH` request to the `/v2/byoip_prefixes/<your_prefix_id>` endpoint with `{"advertise": true}` as the request body. To find the ID of your prefix send a `GET` request to the `/v2/byoip_prefixes` endpoint to list all of your prefixes and their IDs.

```shell
curl -X PATCH \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
  -d '{"advertise": true}' \
  "https://api.digitalocean.com/v2/byoip_prefixes/<your_prefix_id>"
```

Replace `<your_prefix_id>` with the ID of the prefix you are resuming.

The API sends a `202` response with the current state of the BYOIP prefix on success.

### Using the Control Panel

To resume advertisement of a paused or newly provisioned prefix, go to the [control panel](https://cloud.digitalocean.com/), in the main menu, click **Networking**, and then click the **Reserved IPs** tab.

In the **Bring Your Own IP** section of the page, find the BYOIP prefix you’d like to resume and click **Resume advertisement**.