Consulta Cloud Number Registry

En esta página, se explica cómo consultar la información almacenada en el Registro de números de Cloud.

Antes de comenzar

  1. Configura Cloud Number Registry.
  2. Selecciona el proyecto de tu organización que se configuró para proporcionar acceso al Registro de números de Cloud.
  3. Verifica que tengas los permisos necesarios para completar esta guía.

Roles obligatorios

Para obtener los permisos que necesitas para ver la información almacenada en Cloud Number Registry, pídele a tu administrador que te otorgue el rol de IAM Visualizador de IPAM de Cloud Number Registry (roles/cloudnumberregistry.ipamViewer) 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.

Mostrar el uso de direcciones IP

Puedes consultar el uso de direcciones IP para los rangos detectados o los rangos personalizados.

Mostrar la utilización de un rango descubierto

gcloud

Muestra la utilización de un rango descubierto con el comando gcloud alpha number-registry discovered-ranges show-utilization.

gcloud alpha number-registry discovered-ranges show-utilization DISCOVERED_RANGE_NAME \
    --location=global

Reemplaza lo siguiente:

  • DISCOVERED_RANGE_NAME: Es el nombre del rango descubierto.

Cómo mostrar la utilización de un período personalizado

gcloud

Muestra la utilización de un rango personalizado con el comando gcloud alpha number-registry custom-ranges show-utilization.

gcloud alpha number-registry custom-ranges show-utilization CUSTOM_RANGE_NAME \
    --location=global

Reemplaza lo siguiente:

  • CUSTOM_RANGE_NAME: Es el nombre del rango personalizado.

Cómo encontrar rangos de IP libres

Puedes encontrar rangos de direcciones IP disponibles dentro de los rangos descubiertos o los rangos personalizados.

Cómo encontrar rangos de IP libres en los rangos descubiertos

Cuando encuentres rangos de IP libres en los rangos descubiertos, se aplicarán las siguientes limitaciones:

gcloud

Usa el comando gcloud alpha number-registry discovered-ranges find-free-ip-ranges para encontrar rangos de IP libres en los rangos descubiertos.

gcloud alpha number-registry discovered-ranges find-free-ip-ranges DISCOVERED_RANGE_NAME \
    --cidr-prefix-length=PREFIX_LENGTH \
    --range-count=RANGE_COUNT \
    --location=global

Reemplaza lo siguiente:

  • DISCOVERED_RANGE_NAME: Es el nombre del rango descubierto.
  • PREFIX_LENGTH: Es la longitud del prefijo CIDR de los rangos que se buscarán. Usa 32 para encontrar direcciones IPv4 individuales.
  • RANGE_COUNT: Es la cantidad de rangos libres que se deben encontrar.

Cómo encontrar rangos de IP libres en rangos personalizados

Si no existe un rango personalizado para un rango de direcciones IP determinado, se considera que el rango es un rango de IP libre. Si deseas usar Cloud Number Registry para encontrar rangos de IP libres dentro de rangos personalizados, asegúrate de que todas las direcciones IP y los rangos de direcciones IP en uso tengan un rango personalizado correspondiente.

gcloud

Busca rangos de IP libres en rangos personalizados con el comando gcloud alpha number-registry custom-ranges find-free-ip-ranges.

gcloud alpha number-registry custom-ranges find-free-ip-ranges CUSTOM_RANGE_NAME \
    --cidr-prefix-length=PREFIX_LENGTH \
    --range-count=RANGE_COUNT \
    --location=global

Reemplaza lo siguiente:

  • CUSTOM_RANGE_NAME: Es el nombre del rango personalizado.
  • PREFIX_LENGTH: Es la longitud del prefijo CIDR de los rangos que se buscarán. Usa 32 para encontrar direcciones IPv4 individuales.
  • RANGE_COUNT: Es la cantidad de rangos libres que se deben encontrar.

Busca recursos de direcciones IP

Puedes buscar recursos de direcciones IP en un libro de registro.

Puedes usar los siguientes filtros en las consultas:

  • realm: Es el nombre del dominio en el que se realizará la búsqueda, por ejemplo, prod-realm-5.
  • parent_range: Es el URI del rango principal en el que deseas buscar, por ejemplo, projects/project3/locations/global/customRanges/range7.
  • ip_address: Es la dirección IP que se buscará, por ejemplo, 10.10.10.46.
  • ip_version: Es la versión de IP por la que se filtrará.
  • attribute_text: Es el texto del atributo que se buscará dentro de los rangos, por ejemplo, production.
  • attribute: Es la clave y el valor del atributo por el que se filtrará, por ejemplo, attribute:(environment=production).

Puedes combinar filtros de las siguientes maneras:

  • Puedes combinar dos o más filtros en la misma búsqueda con AND.
  • Solo puedes usar AND NOT en combinación con el filtro attribute:(KEY=VALUE).

  • Puedes usar attribute o attribute_text en una consulta determinada, pero no ambos.

gcloud

Busca recursos de IP con el comando gcloud alpha number-registry registry-books search-ip-resources.

gcloud alpha number-registry registry-books search-ip-resources REGISTRY_BOOK \
    --query=QUERY \
    --show-utilization \
    --location=global

Reemplaza lo siguiente:

  • REGISTRY_BOOK: Es el nombre del libro de registro en el que se realizará la búsqueda.
  • QUERY: La búsqueda, por ejemplo:
    • "attribute:(resourceName=projects/project123/regions/us-east1/subnetworks/subnet1)"
    • "realm=vpc-global-123456789 AND ip_address=10.10.10.46"
    • "realm=vpc-global-123456789 AND ip_version=IPV6"
    • "ip_address=\"2001:db8::/64\""
    • "realm=vpc-global-123456789 AND attribute_text=production"
    • "realm=vpc-global-123456789 AND attribute:(team=\"Sales Europe\")"
    • "parent_range=projects/project3/locations/global/customRanges/range7 AND attribute:(team=marketing)"
    • "parent_range=projects/project3/locations/global/customRanges/range7 AND NOT attribute:(environment=production)"