Consulta, actualiza y borra reinos
En esta página, se explica cómo ver, actualizar y borrar reinos en Cloud Number Registry. Un dominio es un conjunto de rangos de direcciones IP administrados que representan un dominio de enrutamiento de red. Para obtener más información sobre los dominios detectados, consulta Recursos detectados.
Antes de comenzar
- Configura Cloud Number Registry.
- Selecciona el proyecto de tu organización que se configuró para proporcionar acceso a Cloud Number Registry.
- Verifica que tengas los permisos necesarios para completar esta guía.
Roles obligatorios
Para obtener los permisos que necesitas
para administrar Cloud Number Registry,
pídele a tu administrador que te otorgue el rol de IAM
Administrador de IPAM de Cloud Number Registry (roles/cloudnumberregistry.ipamAdmin) en tu proyecto.
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.
Enumera y visualiza reinos
En la consola de Google Cloud , puedes enumerar todos los realms de un libro de registro determinado. En gcloud CLI, puedes enumerar todos los reinos en tu alcance de administrador de IPAM.
Console
En la consola de Google Cloud , ve a la página Cloud Number Registry.
Haz clic en la pestaña Registry books.
Haz clic en un libro de registro. Se muestran los ámbitos asociados con el libro de registro.
Para filtrar la lista de dominios, haz clic en la pestaña Dominios detectados o Dominios personalizados.
Haz clic en el dominio que quieres ver. Se muestran los detalles sobre el dominio.
- Si el dominio está administrado por Cloud Number Registry, se muestran los rangos descubiertos asociados.
- Si el dominio es administrado por el usuario, se muestran los rangos personalizados asociados.
gcloud
Enumera los dominios con el comando
gcloud alpha number-registry realms list.gcloud alpha number-registry realms list \ --location=globalConsulta los detalles de un dominio con el comando
gcloud alpha number-registry realms describe.gcloud alpha number-registry realms describe REALM \ --location=globalReemplaza lo siguiente:
REALM: Es el nombre del dominio que deseas ver.
Actualiza un dominio personalizado
Puedes actualizar los dominios personalizados, es decir, los dominios administrados por el usuario. No puedes actualizar los reinos descubiertos, es decir, los reinos que administra Cloud Number Registry. El tipo de administración se muestra cuando ves los detalles de un dominio.
Puedes modificar los siguientes campos en un dominio personalizado:
- Libro de registro
Tipo de tráfico
Console
En la consola de Google Cloud , ve a la página Cloud Number Registry.
Haz clic en la pestaña Registry books.
Haz clic en el libro de registro que contiene el dominio que deseas actualizar.
Haz clic en la pestaña Reinos personalizados.
Haz clic en el dominio que quieres actualizar.
Haz clic en Editar en el campo que deseas actualizar.
En el diálogo que aparece, realiza los cambios.
Haz clic en Guardar.
gcloud
En el siguiente ejemplo, se muestra cómo cambiar el tipo de tráfico de un dominio personalizado. Para obtener información sobre todos los parámetros de configuración editables, consulta la documentación de referencia de gcloud alpha number-registry realms update.
gcloud alpha number-registry realms update REALM \
--traffic-type=TRAFFIC_TYPE \
--location=global
Reemplaza lo siguiente:
REALM: Es el nombre del dominio que se actualizará.TRAFFIC_TYPE: Es el tipo de tráfico actualizado para el dominio.
Borra un dominio personalizado
Puedes borrar los dominios administrados por el usuario. No puedes borrar un dominio si lo administra Cloud Number Registry. El tipo de administración se muestra cuando consultas los detalles de un dominio.
Console
En la consola de Google Cloud , ve a la página Cloud Number Registry.
Haz clic en la pestaña Registry books.
Haz clic en el libro de registro que contiene el dominio que deseas borrar.
Para filtrar la lista de dominios, haz clic en la pestaña Dominios detectados o Dominios personalizados.
Haz clic en el dominio que deseas borrar.
Haz clic en Borrar dominio.
gcloud
Borra un dominio con el comando gcloud alpha number-registry realms delete.
gcloud alpha number-registry realms delete REALM \
--location=global
Reemplaza REALM por el nombre del dominio que deseas borrar.