View, update, and delete realms

Preview

This product is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products are available "as is" and might have limited support. For more information, see the launch stage descriptions.

This page explains how to view, update, and delete realms in Cloud Number Registry.

Before you begin

1. Set up Cloud Number Registry.
2. Select the project in your organization that has been configured to provide Cloud Number Registry access.
3. Verify that you have the permissions required to complete this guide.

Required roles

To get the permissions that you need to manage Cloud Number Registry, ask your administrator to grant you the Cloud Number Registry IPAM Admin (roles/cloudnumberregistry.ipamAdmin) 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.

List and view realms

In the console, you can list all realms in a given registry book. In the gcloud CLI, you can list all realms in your IPAM admin scope.

Console

1. In the Google Cloud console, go to the Cloud Number Registry page.

   Go to Cloud Number Registry

2. Click the Registry books tab.

3. Click a registry book.

4. The realms associated with the registry book are displayed.

5. Click the realm that you'd like to view.

6. Details about the realm are displayed.

   • If the realm is managed by Cloud Number Registry, the associated discovered ranges are displayed.
   • If the realm is user-managed, the associated custom ranges are displayed.

gcloud

• List realms by using the gcloud alpha number-registry realms list command.

  gcloud alpha number-registry realms list \
      --location=global
  

• View details about a realm by using the gcloud alpha number-registry realms describe command.

  gcloud alpha number-registry realms describe REALM \
      --location=global
  

  Replace the following:

  • REALM: the name of the realm that you want to view.

Update a realm

You can update realms that are user-managed. You can't update a realm if it is managed by Cloud Number Registry. The management type is displayed when you view details about a realm.

gcloud

You can update a realm to change various settings. The following example shows you how to change the traffic type. For information about all editable settings, see the gcloud alpha number-registry realms update reference documentation.

gcloud alpha number-registry realms update REALM \
    --traffic-type=TRAFFIC_TYPE \
    --location=global

Replace the following:

• REALM: the name of the realm to update.
• TRAFFIC_TYPE: the updated traffic type for the realm.

Delete a realm

You can delete realms that are user-managed. You can't delete a realm if it is managed by Cloud Number Registry. The management type is displayed when you view details about a realm.

Console

1. In the Google Cloud console, go to the Cloud Number Registry page.

   Go to Cloud Number Registry

2. Click the Registry books tab.

3. Click the registry book that contains the realm you want to delete.

   To view only user-managed realms, in the filter for All Realms, select Management type, and then select USER.

4. Click the realm that you'd like to delete.

5. Click Delete realm.

gcloud

Delete a realm by using the gcloud alpha number-registry realms delete command.

gcloud alpha number-registry realms delete REALM \
    --location=global

Replace REALM with the name of the realm to delete.