View, update, and delete ranges

This page explains how to view discovered and custom ranges, and how to update and delete custom ranges.

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 details for discovered ranges

In the console, you can list all discovered ranges in a given realm. Only realms that are managed by Cloud Number Registry contain discovered ranges. In the gcloud CLI, you can list all discovered ranges 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. Click a realm that is managed by Cloud Number Registry.

    To view only realms that are managed by Cloud Number Registry, in the filter for All Realms, select Management type, and then select CNR.

  5. The discovered ranges that are associated with the realm are displayed.

  6. Click a discovered range to see details for that range.

gcloud

List and view custom ranges

In the console, you can list all custom ranges in a given user-managed realm. In the gcloud CLI, you can list all custom ranges 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. Click a user-managed realm.

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

  5. The custom ranges that are associated with the realm are displayed.

  6. Click a custom range to see details for that range.

gcloud

Update a custom range

You can update a custom range. You can't update discovered ranges.

gcloud

You can update a range to change various settings. The following example shows you how to add attributes to a custom range. If you set attributes on a range, you can use those attributes when you search for IP addresses resources.

For information about all editable settings, see the gcloud alpha number-registry custom-ranges update reference documentation.

gcloud alpha number-registry custom-ranges update CUSTOM_RANGE \
    --attributes=key=KEY,value=VALUE \
    --location=global

Replace the following:

  • CUSTOM_RANGE: the name of the custom range.
  • KEY: the key of the attribute.
  • VALUE: the value of the attribute.

Delete a custom range

You can delete a custom range. You can't delete discovered ranges. You can't delete custom ranges that contain child ranges—you must delete the child ranges first.

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 and user-managed realm that contains the custom range that you want to delete.

  4. Click the range that you want to delete.

  5. Click Delete custom range.

gcloud

To delete a custom range, use the gcloud alpha number-registry custom-ranges delete command.

gcloud alpha number-registry custom-ranges delete CUSTOM_RANGE \
    --location=global

Replace CUSTOM_RANGE with the name of the custom range to delete.