Esecuzione di 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.

Mostra l'utilizzo degli indirizzi IP

Puoi visualizzare l'utilizzo degli indirizzi IP per gli intervalli rilevati o personalizzati.

Mostra l'utilizzo di un intervallo rilevato

gcloud

Mostra l'utilizzo di un intervallo rilevato utilizzando il comando gcloud alpha number-registry discovered-ranges show-utilization.

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

Sostituisci quanto segue:

• DISCOVERED_RANGE_NAME: il nome dell'intervallo rilevato.

Mostra l'utilizzo di un intervallo personalizzato

gcloud

Mostra l'utilizzo di un intervallo personalizzato utilizzando il comando gcloud alpha number-registry custom-ranges show-utilization.

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

Sostituisci quanto segue:

• CUSTOM_RANGE_NAME: il nome dell'intervallo personalizzato.

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 effimeri assegnati alle istanze arrestate.

gcloud

Trova intervalli IP liberi negli intervalli rilevati utilizzando il comando gcloud alpha number-registry discovered-ranges find-free-ip-ranges.

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.

gcloud

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

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.

Cerca risorse IP

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

Puoi utilizzare i seguenti filtri nelle query:

• realm: il nome del realm in cui eseguire la ricerca, ad esempio prod-realm-5.
• parent_range: l'URI dell'intervallo principale in cui vuoi eseguire la ricerca, ad esempio projects/project3/locations/global/customRanges/range7.
• ip_address: l'indirizzo IP da cercare, ad esempio 10.10.10.46.
• ip_version: la versione IP per cui filtrare.
• attribute_text: il testo dell'attributo da cercare negli intervalli, ad esempio production.
• attribute: la chiave e il valore dell'attributo per cui filtrare, ad esempio, attribute:(environment=production).

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

Cerca risorse IP utilizzando il 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

Sostituisci quanto segue:

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