Configura Cloud Number Registry

Questa pagina spiega come configurare Cloud Number Registry nella tua organizzazione.

Prima di iniziare

  1. Crea o seleziona un progetto da utilizzare per gestire il Cloud Number Registry per l'organizzazione principale. Ti consigliamo vivamente di creare un progetto dedicato a questo scopo. Per ulteriori informazioni, vedi Limitazioni.

    1. Nella console Google Cloud , vai alla pagina di selezione del progetto.

      Vai al selettore di progetti

    2. Seleziona o crea un Google Cloud progetto.

      Ruoli richiesti per selezionare o creare un progetto

      • Seleziona un progetto: la selezione di un progetto non richiede un ruolo IAM specifico. Puoi selezionare qualsiasi progetto per il quale ti è stato concesso un ruolo.
      • Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator), che contiene l'autorizzazione resourcemanager.projects.create. Scopri come concedere i ruoli.

  2. Abilita l'API Cloud Number Registry.

    Ruoli richiesti per abilitare le API

    Per abilitare le API, devi disporre del ruolo IAM Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin), che include l'autorizzazione serviceusage.services.enable. Scopri come concedere i ruoli.

    Abilitare l'API

  3. Verifica di disporre delle autorizzazioni necessarie per completare questa guida.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per configurare e gestire Cloud Number Registry, chiedi all'amministratore di concederti il ruolo IAM Cloud Number Registry IPAM Admin (roles/cloudnumberregistry.ipamAdmin) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

(Facoltativo) Controlla se Cloud Number Registry è configurato

Solo un progetto in ogni organizzazione può configurare Cloud Number Registry. Puoi verificare se Cloud Number Registry è già configurato nella tua organizzazione da qualsiasi progetto dell'organizzazione.

Console

  1. Nella console Google Cloud , vai alla pagina Cloud Number Registry.

    Vai a Cloud Number Registry

    • Se Cloud Number Registry è già configurato in questa organizzazione, viene visualizzato il progetto che gestisce Cloud Number Registry.
    • Se Cloud Number Registry non è configurato per questa organizzazione, viene visualizzato un pulsante Crea ambito amministratore.

gcloud

Controlla se Cloud Number Registry è già configurato nella tua organizzazione utilizzando il comando gcloud alpha number-registry ipam-admin-scopes check-availability.

  • Se Cloud Number Registry è già configurato, la risposta è UNAVAILABLE.
  • Se non esiste una configurazione, la risposta è AVAILABLE.
gcloud alpha number-registry ipam-admin-scopes check-availability \
    --scopes=SCOPE \
    --location=global

Sostituisci SCOPE con l'organizzazione che vuoi gestire, ad esempio organizations/12345678.

Crea un ambito amministratore IPAM

Quando crei l'ambito amministratore IPAM, Cloud Number Registry esegue le attività di configurazione, identifica le risorse Compute Engine supportate nella tua organizzazione e le aggiunge a un registro predefinito. Puoi visualizzare lo stato dell'ambito amministrativo IPAM per verificare se la configurazione è completa.

Puoi gestire Cloud Number Registry tramite questo registry book predefinito oppure, facoltativamente, creare registry book aggiuntivi per organizzare le tue risorse.

Console

  1. Nella console Google Cloud , vai alla pagina Cloud Number Registry.

Vai a Cloud Number Registry

  1. Fai clic su Crea ambito amministratore IPAM.

Viene avviato il processo di creazione dell'ambito amministratore IPAM. Per controllare l'avanzamento della configurazione, visualizza lo stato dell'ambito amministrativo IPAM.

gcloud

Crea l'ambito amministratore IPAM utilizzando il comando gcloud alpha number-registry ipam-admin-scopes create.

Per controllare l'avanzamento della configurazione di Cloud Number Registry, visualizza lo stato dell'ambito di amministrazione IPAM.

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

Sostituisci quanto segue:

  • SCOPE_NAME: un nome per l'ambito amministrativo IPAM
  • SCOPE: l'organizzazione che vuoi gestire, ad esempio organizations/12345678.

Visualizzare lo stato dell'ambito amministratore IPAM

Durante la configurazione, l'ambito amministratore può avere i seguenti stati:

  • SETUP_IN_PROGRESS: la configurazione è iniziata, ma la sincronizzazione non è completa.

  • READY_TO_USE: la sincronizzazione è completata e Cloud Number Registry è pronto per l'uso.

Console

  1. Nella console Google Cloud , vai alla pagina Cloud Number Registry.

    Vai a Cloud Number Registry

  2. Fai clic su Gestisci Cloud Number Registry.

  3. Lo stato viene visualizzato nel campo Stato dell'ambito amministratore.

gcloud

Visualizza i dettagli dell'ambito amministrativo IPAM utilizzando il comando gcloud alpha number-registry ipam-admin-scopes describe.

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

Sostituisci SCOPE_NAME con il nome dell'ambito amministrativo IPAM.

Passaggi successivi