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.
If you're creating a top-level public delegated prefix for Standard Tier IP addresses (Preview), and if you followed the recommended approach of creating a ROA for the parent public advertised prefix, make sure you have a valid ROA for the public delegated prefix.

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.

The public delegated prefixes per public advertised prefix limit restricts the number of public delegated prefixes that you can create from a single public advertised prefix. To avoid reaching this limit, create a small number of large top-level public delegated prefixes, and then sub-delegate those prefixes into smaller sub-prefixes.

Console

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

Go to Bring your own IP

Click the public advertised prefix that you want to delegate.
Click Create PDP.
For Name, enter a name for the public delegated prefix.
For Description, enter an optional description for the public delegated prefix.
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.
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.
Select a Project for the public delegated prefix.
Click Create.

gcloud

Use the public-delegated-prefixes create command.

To create an IPv4 PDP, use the following 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.

To create an IPv6 PDP, use the following commamd:

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

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
`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 Cloud's network.
`ANNOUNCED_TO_INTERNET`	The prefix is announced to the internet and within Google Cloud's network.
`DELETING`	The public delegated prefix is being deprovisioned.

Console

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

Go to Bring your own IP
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.

Check enhanced IP address allocation

To check if an IPv4 public delegated prefix supports enhanced IP address allocation, do the following.

Console

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

Go to Bring your own IP
The Enhanced IP allocation column displays whether each IPv4 public delegated prefix uses enhanced IP address allocation.

gcloud

Use the following command.

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

Replace the following:

PDP_NAME: the name of the public delegated prefix to describe.
PDP_REGION: the region of the public delegated prefix.

Create public delegated prefixes

Before you begin

Roles

Create public delegated prefixes

Console

gcloud

Check the status of a public delegated prefix

Console

gcloud

Check enhanced IP address allocation

Console

gcloud

What's next

Products and pricing

Support

Resources

Engage