Eseguire query su Cloud Number Registry

Anteprima

Questo prodotto è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini specifici dei servizi. I prodotti pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Questa pagina spiega come eseguire query sulle informazioni archiviate in Cloud Number Registry.

Prima di iniziare

1. Configura Cloud Number Registry.
2. Seleziona il progetto nella tua organizzazione configurato per fornire l'accesso a Cloud Number Registry.
3. Verifica di disporre delle autorizzazioni necessarie per completare questa guida.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per visualizzare le informazioni archiviate in Cloud Number Registry, chiedi all'amministratore di concederti il ruolo IAM Visualizzatore IPAM di Cloud Number Registry (roles/cloudnumberregistry.ipamViewer) nel tuo 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.

Trova intervalli IP liberi

Puoi trovare intervalli di indirizzi IP disponibili all'interno di intervalli rilevati o personalizzati.

Trova intervalli IP liberi negli intervalli rilevati

Quando trovi intervalli IP liberi negli intervalli rilevati, si applicano le seguenti limitazioni:

• I risultati potrebbero includere indirizzi inutilizzabili negli intervalli di subnet IPv4 e indirizzi inutilizzabili negli intervalli di subnet IPv6.

• I risultati potrebbero includere indirizzi IP temporanei assegnati a istanze arrestate.

Console

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

   Vai a Cloud Number Registry

2. Fai clic sulla scheda Registry book.

3. Fai clic su un registry book.

4. Fai clic sulla scheda Discovered realms.

5. Fai clic su un realm rilevato e poi su un intervallo rilevato all'interno di quel realm.

6. Fai clic su Trova intervalli IP liberi.

7. In Lunghezza prefisso, seleziona la dimensione dell'intervallo che vuoi trovare.

   Vengono elencati gli intervalli disponibili della dimensione specificata.

gcloud

Trova gli intervalli IP liberi negli intervalli rilevati utilizzando il 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

Sostituisci quanto segue:

• DISCOVERED_RANGE_NAME: il nome dell'intervallo rilevato.
• PREFIX_LENGTH: la lunghezza del prefisso CIDR degli intervalli da trovare. Utilizza 32 per trovare singoli indirizzi IPv4.
• RANGE_COUNT: il numero di intervalli liberi da trovare.

Trova intervalli IP liberi negli intervalli personalizzati

Se non esiste un intervallo personalizzato per un determinato intervallo di indirizzi IP, l'intervallo viene considerato un intervallo IP libero. Se vuoi utilizzare Cloud Number Registry per trovare intervalli IP liberi all'interno di intervalli personalizzati, assicurati che tutti gli indirizzi IP e gli intervalli di indirizzi IP in uso abbiano un intervallo personalizzato corrispondente.

Console

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

   Vai a Cloud Number Registry

2. Fai clic sulla scheda Registry book.

3. Fai clic su un registry book.

4. Fai clic sulla scheda Custom realms.

5. Fai clic su un realm personalizzato e poi su un intervallo personalizzato all'interno di quel realm.

6. Fai clic su Trova intervalli IP liberi.

7. In Lunghezza prefisso, seleziona la dimensione dell'intervallo che vuoi trovare.

   Vengono elencati gli intervalli disponibili della dimensione specificata.

gcloud

Trova gli intervalli IP liberi negli intervalli personalizzati utilizzando il 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

Sostituisci quanto segue:

• CUSTOM_RANGE_NAME: il nome dell'intervallo personalizzato.
• PREFIX_LENGTH: la lunghezza del prefisso CIDR degli intervalli da trovare. Utilizza 32 per trovare singoli indirizzi IPv4.
• RANGE_COUNT: il numero di intervalli liberi da trovare.

Cercare risorse di indirizzi IP

Puoi cercare risorse di indirizzi IP all'interno di un registry book.

Puoi utilizzare i seguenti filtri nelle query:

• Indirizzo IP: l'indirizzo IP da cercare, ad esempio 10.10.10.46.
• Realm: il nome del realm in cui eseguire la ricerca, ad esempio, vpc-global-123456789.
• Intervallo principale: l'URI dell'intervallo principale in cui vuoi eseguire la ricerca , ad esempio, projects/project3/locations/global/customRanges/range7.
• Versione IP: la versione IP da filtrare.

• Attributi: puoi filtrare in base al testo dell'attributo oppure in base a chiavi e valori, ma non puoi includere entrambi nella stessa query.

  • Filtra per testo: il testo dell'attributo da cercare negli intervalli, ad esempio europe-west1.
  • Filtra per chiavi e valori: la chiave e il valore dell'attributo da filtrare, ad esempio la chiave addressType con il valore INTERNAL.

Console

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

   Vai a Cloud Number Registry

2. Fai clic sulla scheda Registry book.

3. Fai clic su un registry book.

4. Fai clic sulla scheda Ricerca IP.

5. Inserisci la query di ricerca utilizzando il campo Indirizzo IP e la sezione Filtri, quindi fai clic su Cerca.

   • Per cercare un indirizzo IP specifico, inseriscilo nel campo Indirizzo IP.
   • Per filtrare la ricerca in base a versione IP, realm, intervallo principale o attributi, inserisci la query di ricerca nella sezione Filtri.

gcloud

Cerca le risorse IP utilizzando il gcloud alpha number-registry registry-books search-ip-resources comando.

Puoi combinare i filtri nei seguenti modi:

• Puoi combinare due o più filtri nella stessa query utilizzando AND.
• Puoi utilizzare AND NOT solo in combinazione con il attribute:(KEY=VALUE) filtro.
• Puoi utilizzare attribute o attribute_text in una determinata query, ma non entrambi.

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

Sostituisci quanto segue:

• REGISTRY_BOOK: il nome del registry book in cui eseguire la ricerca.
• QUERY: la query per la ricerca, ad esempio:
  • "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)"