Create public delegated prefixes

You can create public delegated prefixes before the public advertised prefix creation is complete.

The public advertised prefix type determines the configuration of the public delegated prefix. For more information, see Bring your own IP configurations.

We recommend that you use v2 public advertised prefixes to create regional public delegated prefixes. You must use v2 public advertised prefixes to import IPv6 prefixes to Google Cloud.

Before you begin

  • Create a public advertised prefix.
  • If you're creating a global public delegated prefix, the parent public advertised prefix must meet these requirements:
    • The public advertised prefix is used for global public delegated prefixes only.
    • The public advertised prefix is in a project that has been added to the allowlist for global prefixes. For more information, see Global public delegated prefixes.

Roles

To get the permissions that you need to complete the tasks in this guide, ask your administrator to grant you the Compute Public IP Admin (roles/compute.publicIpAdmin) IAM role on your project. For more information about granting roles, see Manage access to projects, folders, and organizations.

You might also be able to get the required permissions through custom roles or other predefined roles.

Create public delegated prefixes

A public delegated prefix name can't be changed without deleting and recreating the resource. For this reason, we recommend that you create generic names that won't need to change—for example, pdp-203-0-113-0-25, where pdp denotes the resource type and 203-0-113-0-25 denotes the specific prefix and prefix length.

To create a global public delegated prefix, you must use a public advertised prefix that is used for global public delegated prefixes only, and is in a project that has been added to the allowlist for global prefixes. For more information, see Global public delegated prefixes.

Console

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

Go to Bring your own IP

  1. Click the public advertised prefix that you want to delegate.
  2. Click Create PDP.
  3. For Name, enter a name for the public delegated prefix.
  4. For Description, enter an optional description for the public delegated prefix.
  5. If you're creating a public delegated prefix for an IPv4 address range, do the following:
    1. Select a prefix length from the Prefix length list.
    2. Select a range of IP addresses from the IP addresses list.
    3. Select a Scope for the public delegated prefix.
    4. If you selected Regional for the scope, select a Region.
  6. If you're creating a public delegated prefix for an IPv6 address range, do the following:
    1. Select a prefix length from the IPv6 prefix length list.
    2. Enter an IPv6 address range in IPv6 range.
    3. Select a region from the Region list.
  7. Select a Project for the public delegated prefix.
  8. Click Create.

gcloud

To create a public delegated prefix, use the public-delegated-prefixes create command.

gcloud compute public-delegated-prefixes create PDP_NAME \
    --public-advertised-prefix=PAP_NAME \
    --range=PDP_IP_RANGE \
    --region=PDP_REGION

Replace the following:

  • PDP_NAME: the name to use for the public delegated prefix that you are creating.

  • PAP_NAME: the name of the public advertised prefix to use to create the public delegated prefix.

  • PDP_IP_RANGE: the IPv4 or IPv6 address range to use to create the public delegated prefix.

  • PDP_DESCRIPTION: an optional description for the public delegated prefix.

  • PDP_REGION: the region where you want to use the public delegated prefix addresses. If you want a global public delegated prefix instead, replace --region=PDP_REGION with --global.

Check the status of a public delegated prefix

You can check the status of a public delegated prefix. The available statuses for both v2 and v1 public delegated prefixes are described in the following table.

Status Description v2 v1
INITIALIZING The public delegated prefix is being initialized and addresses can't be created yet.
READY_TO_ANNOUNCE The public delegated prefix is withdrawn, and is ready to be announced.

Manage announcement

ANNOUNCED The public delegated prefix is active and is announced.
ANNOUNCED_TO_GOOGLE The prefix is announced within Google's network.
ANNOUNCED_TO_INTERNET The prefix is announced to the internet and within Google's network.
DELETING The public delegated prefix is being deprovisioned.

Console

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

    Go to Bring your own IP

  2. The Status column displays the status for all public delegated prefixes.

gcloud

To describe the public delegated prefix and get its status, use the public-delegated-prefixes describe command.

gcloud compute public-delegated-prefixes describe PDP_NAME \
    --region=PDP_REGION \
    --format='value(status)'

Replace the following:

  • PDP_NAME: the public delegated prefix or sub-prefix that you want to get information for.

  • PDP_REGION: the region of the public delegated prefix or sub-prefix.

  • PDP_REGION: the region where you want to use the public delegated prefix addresses. If you want a global public delegated prefix instead, replace --region=PDP_REGION with --global.

What's next