Manage BGP announcement (v2)
When you create v2 public advertised prefixes and v2 public delegated prefixes, they are not automatically announced. You choose when to announce or withdraw the prefixes.
Specifications
- Announcing a public advertised prefix announces the whole public advertised prefix to the internet.
- Announcing a public delegated prefix announces that public delegated prefix within Google Cloud.
- You can announce a public delegated prefix without announcing the parent public advertised prefix. In this configuration, the public delegated prefix is announced within Google Cloud, and isn't announced to the internet.
- You must announce at least one public delegated prefix before you can announce the parent public advertised prefix.
- You can't withdraw announcement for a public delegated prefix if it is the only public delegated prefix being announced for the parent public advertised prefix. First withdraw the parent public advertised prefix, then withdraw the public delegated prefix.
- Announce and withdraw requests are rate limited. For more information, see quotas for bring your own IP.
Before you begin
Verify that your public delegated prefix uses v2.
Run this command to verify which version you are using:
gcloud compute public-delegated-prefixes describe PDP_NAME \ --region=REGION | grep byoipApiVersion
Announce BGP advertisement for a prefix
Console
In the Google Cloud console, go to Bring your own IP.
Select the prefix that you want to announce.
Click Announce.
A dialog is displayed to confirm announcing the public advertised prefix.
Click Announce to confirm.
gcloud
To announce a public delegated prefix, use the
public-delegated-prefixes update
command.gcloud compute public-delegated-prefixes update PDP_NAME \ --region=PDP_REGION \ --announce-prefix
Replace the following:
PDP_NAME
: the public delegated prefix that you want to announce.PDP_REGION
: the region of the public delegated prefix.
To announce a public advertised prefix, use the
public-advertised-prefixes update
command.gcloud compute public-advertised-prefixes update PAP_NAME \ --announce-prefix
Replace
PAP_NAME
with the name of the public advertised prefix that you want to announce.
Withdraw advertisement of a prefix
Console
In the Google Cloud console, go to Bring your own IP.
Select the prefix that you want to withdraw.
Click Withdraw.
A dialog is displayed to confirm withdrawing the public advertised prefix.
Click Withdraw to confirm.
gcloud
To withdraw a public delegated prefix, use the
public-delegated-prefixes update
command.gcloud compute public-delegated-prefixes update PDP_NAME \ --region=PDP_REGION \ --withdraw-prefix
Replace the following:
PDP_NAME
: the public delegated prefix that you want to withdraw.PDP_REGION
: the region of the public delegated prefix.
To withdraw a public advertised prefix, use the
public-advertised-prefixes update
command.gcloud compute public-advertised-prefixes update PAP_NAME \ --withdraw-prefix
Replace
PAP_NAME
with the name of the public advertised prefix that you want to withdraw.