View, update, and delete registry books

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

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 registry books

Console

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

Go to Cloud Number Registry
Click the Registry books tab.
All registry books are displayed.
Click the registry book that you'd like to view.
Details about the registry book are displayed, including the associated realms.

gcloud

List all registry books by using the gcloud alpha number-registry registry-books list command.
```
gcloud alpha number-registry registry-books list \
    --location=global
```
View details about a registry book by using the gcloud alpha number-registry registry-books describe command.
```
gcloud alpha number-registry registry-books describe REGISTRY_BOOK \
    --location=global
```
Replace the following:
- REGISTRY_BOOK: the name of the registry book that you want to view.

Update a registry book

You can update a the claimed scopes that are associated with a user-managed registry book.

gcloud

The following example shows you how to add projects to the claimed scope of the registry book. You can also use the --clear-claimed-scopes flag to clear all projects, or use the --remove-claimed-scopes flag to remove specific projects.

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

gcloud alpha number-registry registry-books update REGISTRY_BOOK \
    --add-claimed-scopes=PROJECT_LIST \
    --location=global

Replace the following:

REGISTRY_BOOK: the name of the registry book.
PROJECT_LIST: a comma-separated list of projects that you want to add to this registry book—for example projects/12345678,projects/staging-project.

Delete a registry book

You can delete user-managed registry books. You can't delete the default registry book.

Console

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

Go to Cloud Number Registry
Click the Registry books tab.
Select the registry book that you want to delete and click Delete.

gcloud

Delete a registry book by using the gcloud alpha number-registry registry-books delete command.

gcloud alpha number-registry registry-books delete REGISTRY_BOOK \
    --location=global

Replace REGISTRY_BOOK with the name of the registry book to delete.