View, update, and delete realms

This page explains how to view, update, and delete realms 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 realms

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

Use the gcloud alpha number-registry realms update command to update a realm. The following example shows you how to update a realm to change the traffic type.

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.

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.