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

Set up Cloud Number Registry.
Select the project in your organization that has been configured to provide Cloud Number Registry access.
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 registry book. In the gcloud CLI, you can list all discovered ranges in your IPAM admin scope.

gcloud

To list all discovered ranges, use the gcloud alpha number-registry discovered-ranges list command.
```
gcloud alpha number-registry discovered-ranges list \
    --location=global
```

To view details for a specific discovered range, use the gcloud alpha number-registry discovered-ranges describe command.
```
gcloud alpha number-registry discovered-ranges describe DISCOVERED_RANGE \
    --location=global
```
Replace DISCOVERED_RANGE with the name of the discovered range that you want to view.

List and view custom ranges

gcloud

To list all custom ranges, use the gcloud alpha number-registry custom-ranges list command.
```
gcloud alpha number-registry custom-ranges list \
    --location=global
```

To view details for a specific custom range, use the gcloud alpha number-registry custom-ranges describe command.
```
gcloud alpha number-registry custom-ranges describe CUSTOM_RANGE \
    --location=global
```
Replace CUSTOM_RANGE with the name of the custom range that you want to view.

Update a custom range

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

gcloud

Use the gcloud alpha number-registry custom-ranges update command to update a custom range—for example, to add attributes.

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.

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.