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 orwithdraw the prefixes.

Specifications

  • Announcing a public advertised prefix announces the whole public advertisedprefix to the internet.
  • Announcing a public delegated prefix announces that public delegated prefixwithin Google Cloud.
  • You can announce a public delegated prefix without announcing the parentpublic advertised prefix. In this configuration, the public delegated prefixis announced within Google Cloud, and isn't announced to the internet.
  • You must announce at least one public delegated prefix before you canannounce the parent public advertised prefix.
  • You can't withdraw announcement for a public delegated prefix if it is theonly public delegated prefix being announced for the parent publicadvertised prefix. First withdraw the parent public advertised prefix, thenwithdraw the public delegated prefix.
  • Announce and withdraw requests are rate limited. For more information, seequotas 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 describePDP_NAME \    --region=REGION | grep byoipApiVersion

Announce BGP advertisement for a prefix

Console

  1. In the Google Cloud console, go toBring your own IP.

    Go to Bring your own IP

  2. Select the prefix that you want to announce.

  3. ClickAnnounce.

    A dialog is displayed to confirm announcing the public advertisedprefix.

  4. ClickAnnounce to confirm.

gcloud

  • To announce a public delegated prefix, use thepublic-delegated-prefixes updatecommand.

    gcloud compute public-delegated-prefixes updatePDP_NAME \    --region=PDP_REGION \    --announce-prefix

    Replace the following:

    • PDP_NAME: the public delegated prefix that you wantto announce.

    • PDP_REGION: the region of the public delegatedprefix.

  • To announce a public advertised prefix, use thepublic-advertised-prefixes updatecommand.

    gcloud compute public-advertised-prefixes updatePAP_NAME \    --announce-prefix

    ReplacePAP_NAME with the name of the public advertisedprefix that you want to announce.

Withdraw advertisement of a prefix

Console

  1. In the Google Cloud console, go toBring your own IP.

    Go to Bring your own IP

  2. Select the prefix that you want to withdraw.

  3. ClickWithdraw.

    A dialog is displayed to confirm withdrawing the public advertisedprefix.

  4. ClickWithdraw to confirm.

gcloud

  • To withdraw a public delegated prefix, use thepublic-delegated-prefixes updatecommand.

    gcloud compute public-delegated-prefixes updatePDP_NAME \    --region=PDP_REGION \    --withdraw-prefix

    Replace the following:

    • PDP_NAME: the public delegated prefix that you wantto withdraw.

    • PDP_REGION: the region of the public delegatedprefix.

  • To withdraw a public advertised prefix, use thepublic-advertised-prefixes updatecommand.

    gcloud compute public-advertised-prefixes updatePAP_NAME \    --withdraw-prefix

    ReplacePAP_NAME with the name of the public advertisedprefix that you want to withdraw.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-02-19 UTC.