Configura Cloud Number Registry

En esta página, se explica cómo configurar el Registro de números en la nube en tu organización.

Antes de comenzar

  1. Designa un proyecto para usar Cloud Number Registry en esta organización.
  2. Selecciona el proyecto designado para realizar los pasos de esta guía.
  3. Verifica que tengas los permisos necesarios para completar esta guía.

Roles obligatorios

Para obtener los permisos que necesitas para configurar y 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.

Crea un permiso de administrador de IPAM

Cuando creas el permiso de administrador de IPAM, Cloud Number Registry realiza tareas de configuración, identifica los recursos de Compute Engine admitidos en tu organización y los agrega a un registro predeterminado.

Es posible que se tarden hasta 24 horas en descubrir todos los recursos de la organización. Puedes ver el estado del alcance del administrador de IPAM para verificar si se completó el descubrimiento de recursos.

Puedes administrar el Registro de números de Cloud a través de este libro de registro predeterminado o, de manera opcional, crear libros de registro adicionales para organizar tus recursos.

Si recibes un error cuando intentas crear un alcance de administrador de IPAM, consulta Solución de problemas.

Console

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

    Ir al Registro de números de Cloud

  2. Haz clic en la pestaña Administrar.

  3. En el panel Administrar el permiso de administrador de IPAM, haz clic en Crear permiso de administrador de IPAM.

Comienza el proceso de creación del permiso de administrador de IPAM. Para verificar el progreso de la configuración, consulta el estado del alcance del administrador de IPAM.

gcloud

Crea el permiso de administrador de IPAM con el comando gcloud alpha number-registry ipam-admin-scopes create.

Para verificar el progreso de la configuración de Cloud Number Registry, consulta el estado del permiso de administrador de IPAM.

gcloud alpha number-registry ipam-admin-scopes create SCOPE_NAME \
    --enabled-addon-platforms=COMPUTE_ENGINE \
    --scopes=organizations/ORGANIZATION_ID \
    --location=global

Reemplaza lo siguiente:

  • SCOPE_NAME: Es el nombre del permiso de administrador de IPAM.
  • ORGANIZATION_ID: Es el número de ID de la organización que deseas administrar.

Consulta el estado del permiso de administrador de IPAM

El alcance de administrador puede tener los siguientes estados durante la configuración:

  • SETUP_IN_PROGRESS: La configuración se inició, pero el proceso de detección no se completó. La detección de todos los recursos existentes en la organización puede tardar hasta 24 horas. Sin embargo, los recursos nuevos que se creen en la organización se detectarán en unos minutos.
  • READY_TO_USE: El proceso de detección se completó y el Registro de números de Cloud está listo para usarse.

Console

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

    Ir al Registro de números de Cloud

  2. Haz clic en la pestaña Administrar.

  3. En el panel Administrar el permiso de administrador de IPAM, consulta el campo Estado.

gcloud

Consulta los detalles sobre el alcance del administrador de IPAM con el comando gcloud alpha number-registry ipam-admin-scopes describe.

gcloud alpha number-registry ipam-admin-scopes describe SCOPE_NAME \
    --location=global

Reemplaza SCOPE_NAME por el nombre del alcance de administrador de IPAM.

Soluciona problemas

En las siguientes secciones, se explica cómo resolver los problemas que podrías encontrar cuando configures Cloud Number Registry.

La creación del permiso de administrador de IPAM falla con el error ALREADY_EXISTS o INVALID_ARGUMENT

Si la creación del permiso de administrador de IPAM falla debido a alguno de estos errores, es porque ya existe un permiso de administrador de IPAM en el proyecto.

  • Ya existe un alcance de administrador de IPAM con el mismo nombre en este proyecto:

    ALREADY_EXISTS: Resource 'projects/PROJECT_ID/locations/global/ipamAdminScopes/SCOPE_NAME'
    already exists.
    
  • Ya existe un alcance de administrador de IPAM con un nombre diferente en este proyecto:

    INVALID_ARGUMENT: Violation in ipam_admin_scope.scopes: Scope
    organizations/ORGANIZATION_ID is already administered by another ipam admin scope
    'projects/PROJECT_ID/locations/global/ipamAdminScopes/EXISTING_SCOPE_NAME'
    

La creación del permiso de administrador de IPAM falla con el error FAILED_PRECONDITION

Si la creación de un alcance de administrador de IPAM falla con el siguiente mensaje de error, significa que este proyecto no se designó para usar Cloud Number Registry para esta organización.

FAILED_PRECONDITION: There is no existing registry for 'projects/PROJECT_ID in scope
organizations/ORGANIZATION_ID'

Para solucionar este problema, haz lo siguiente:

  1. Verifica si Cloud Number Registry ya está configurado para esta organización en otro proyecto.

  2. Si Cloud Number Registry no está configurado para esta organización, verifica si ya se designó un proyecto para Cloud Number Registry en esta organización.

  3. Si no se designó ningún proyecto, pídele al administrador de tu organización que designe un proyecto para usarlo con Cloud Number Registry o que te otorgue acceso para hacerlo.

¿Qué sigue?