Consulta Cloud Number Registry

Vista previa

Este producto se encuentra sujeto a las "Condiciones de la Oferta de la Fase previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Los productos de la fase previa a la DG están disponibles tal como están y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

En esta página, se explica cómo consultar la información almacenada en Cloud Number Registry.

Antes de comenzar

1. Configura Cloud Number Registry.
2. Selecciona el proyecto de tu organización que se configuró para proporcionar acceso a Cloud Number Registry.
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 de 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 mediante roles personalizados o cualquier otro rol predefinido.

Buscar rangos de IP disponibles

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

Buscar rangos de IP disponibles en rangos descubiertos

Cuando encuentras rangos de IP disponibles en rangos descubiertos, se aplican las siguientes limitaciones:

• Los resultados pueden incluir direcciones inutilizables en rangos de subred IPv4 y direcciones inutilizables en rangos de subred IPv6.

• Los resultados pueden incluir direcciones IP efímeras que se asignan a instancias que se cierran.

Console

1. En la Google Cloud consola, ve a la página de Cloud Number Registry.

   Ir a Cloud Number Registry

2. Haz clic en la pestaña Registry books.

3. Haz clic en un libro de registro.

4. Haz clic en la pestaña Discovered realms.

5. Haz clic en un reino descubierto y, luego, en un rango descubierto dentro de ese reino.

6. Haz clic en Find free IP ranges.

7. En Prefix length, selecciona el tamaño del rango que deseas encontrar.

   Se enumeran los rangos disponibles del tamaño especificado.

gcloud

Para buscar rangos de IP disponibles en rangos descubiertos, usa el gcloud alpha number-registry discovered-ranges find-free-ip-ranges comando.

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 encontrarán. Usa 32 para encontrar direcciones IPv4 individuales.
• RANGE_COUNT: Es la cantidad de rangos disponibles que se encontrarán.

Buscar rangos de IP disponibles 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 disponible. Si deseas usar Cloud Number Registry para encontrar rangos de IP disponibles 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.

Console

1. En la Google Cloud consola, ve a la página de Cloud Number Registry.

   Ir a Cloud Number Registry

2. Haz clic en la pestaña Registry books.

3. Haz clic en un libro de registro.

4. Haz clic en la pestaña Custom realms.

5. Haz clic en un reino personalizado y, luego, en un rango personalizado dentro de ese reino.

6. Haz clic en Find free IP ranges.

7. En Prefix length, selecciona el tamaño del rango que deseas encontrar.

   Se enumeran los rangos disponibles del tamaño especificado.

gcloud

Para buscar rangos de IP disponibles en rangos personalizados, usa el gcloud alpha number-registry custom-ranges find-free-ip-ranges comando.

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 encontrarán. Usa 32 para encontrar direcciones IPv4 individuales.
• RANGE_COUNT: Es la cantidad de rangos disponibles que se encontrarán.

Buscar recursos de direcciones IP

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

Puedes usar los siguientes filtros en las consultas:

• Dirección IP: Es la dirección IP que se buscará, por ejemplo, 10.10.10.46.
• Dominio: Es el nombre del dominio en el que se buscará, por ejemplo, vpc-global-123456789.
• Rango superior: Es el URI del rango superior en el que deseas buscar , por ejemplo, projects/project3/locations/global/customRanges/range7.
• Versión de IP: Es la versión de IP que se filtrará.

• Atributos: Puedes filtrar por texto de atributo o por claves y valores, pero no puedes incluir ambos en la misma consulta.

  • Filtrar por texto: Es el texto del atributo que se buscará dentro de los rangos, por ejemplo, europe-west1.
  • Filtrar por claves y valores: Es la clave y el valor del atributo que se filtrarán , por ejemplo, la clave addressType con el valor INTERNAL.

Console

1. En la Google Cloud consola, ve a la página de Cloud Number Registry.

   Ir a Cloud Number Registry

2. Haz clic en la pestaña Registry books.

3. Haz clic en un libro de registro.

4. Haz clic en la pestaña IP search.

5. Ingresa tu consulta de búsqueda con el campo Dirección IP y la sección Filtros y, luego, haz clic en Buscar.

   • Para buscar una dirección IP específica, ingrésala en el campo Dirección IP.
   • Para filtrar tu búsqueda por versión de IP, dominio, rango superior o atributos, ingresa tu consulta de búsqueda en la sección Filtros.

gcloud

Para buscar recursos de IP, usa el gcloud alpha number-registry registry-books search-ip-resources comando.

Puedes combinar filtros de las siguientes maneras:

• Puedes combinar dos o más filtros en la misma consulta con AND.
• Solo puedes usar AND NOT en combinación con el attribute:(KEY=VALUE) filtro solamente.
• Puedes usar attribute o attribute_text en una consulta determinada, pero no ambos.

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 buscará.
• QUERY: Es la consulta de tu búsqueda, por ejemplo:
  • "ip_address=\"2001:db8::/64\""
  • "attribute_text=europe-west1"
  • "attribute:(resourceName=projects/project123/regions/us-east1/subnetworks/subnet1)"
  • "realm=vpc-global-123456789"
  • "realm=vpc-global-123456789 AND ip_address=10.10.10.46"
  • "realm=vpc-global-123456789 AND ip_version=IPV6"
  • "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"
  • "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)"