View, update, and delete registry books

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

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 claimed scopes for a registry book

You can update a user-managed registry book after you've created it.

gcloud

Use the gcloud alpha number-registry registry-books update command to update a registry book. 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.

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.

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.