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.
If you need to create a v1 regional public delegated prefix with live migration, see About live migration.
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.
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.
If you need to create a v1 regional public delegated prefix with live migration, see use live migration.
Console
In the Google Cloud console, 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.
Select a Prefix length for the public delegated prefix.
Select IP addresses for the public delegated prefix.
Select a Scope for the public delegated prefix.
Select a Project for the public delegated prefix.
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 IP 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_REGIONwith--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. |
|
|
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
In the Google Cloud console, 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_REGIONwith--global.