Consultar o Cloud Number Registry

Nesta página, explicamos como consultar informações armazenadas no Cloud Number Registry.

Antes de começar

  1. Configure o Cloud Number Registry.
  2. Selecione o projeto na sua organização que foi configurado para fornecer acesso ao Cloud Number Registry.
  3. Verifique se você tem as permissões necessárias para concluir este guia.

Funções exigidas

Para receber as permissões necessárias para visualizar informações armazenadas no Cloud Number Registry, peça ao administrador para conceder a você opapel do IAM de Leitor do IPAM do Cloud Number Registry (roles/cloudnumberregistry.ipamViewer) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando personalizados papéis ou outros predefinidos papéis.

Mostrar o uso do endereço IP

É possível visualizar o uso do endereço IP para intervalos descobertos ou personalizados.

Mostrar o uso de um intervalo descoberto

gcloud

Mostre o uso de um intervalo descoberto usando o gcloud alpha number-registry discovered-ranges show-utilization comando.

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

Substitua:

  • DISCOVERED_RANGE_NAME: o nome do intervalo descoberto.

Mostrar o uso de um intervalo personalizado

gcloud

Mostre o uso de um intervalo personalizado usando o gcloud alpha number-registry custom-ranges show-utilization comando.

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

Substitua:

  • CUSTOM_RANGE_NAME: o nome do intervalo personalizado.

Encontrar intervalos de IP livres

É possível encontrar intervalos de endereços IP disponíveis em intervalos descobertos ou personalizados.

Encontrar intervalos de IP livres em intervalos descobertos

Ao encontrar intervalos de IP livres em intervalos descobertos, as seguintes limitações se aplicam:

gcloud

Encontre intervalos de IP livres em intervalos descobertos usando o 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

Substitua:

  • DISCOVERED_RANGE_NAME: o nome do intervalo descoberto.
  • PREFIX_LENGTH: o comprimento do prefixo CIDR dos intervalos a serem encontrados. Use 32 para encontrar endereços IPv4 individuais.
  • RANGE_COUNT: o número de intervalos livres a serem encontrados.

Encontrar intervalos de IP livres em intervalos personalizados

Se um intervalo personalizado não existir para um determinado intervalo de endereços IP, ele será considerado um intervalo de IP livre. Se você quiser usar o Cloud Number Registry para encontrar intervalos de IP livres em intervalos personalizados, verifique se todos os endereços IP e intervalos de endereços IP em uso têm um intervalo personalizado correspondente.

gcloud

Encontre intervalos de IP livres em intervalos personalizados usando o 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

Substitua:

  • CUSTOM_RANGE_NAME: o nome do intervalo personalizado.
  • PREFIX_LENGTH: o comprimento do prefixo CIDR dos intervalos a serem encontrados. Use 32 para encontrar endereços IPv4 individuais.
  • RANGE_COUNT: o número de intervalos livres a serem encontrados.

Pesquisar recursos de endereço IP

É possível pesquisar recursos de endereço IP em um livro de registros.

Você pode usar os seguintes filtros em consultas:

  • realm: o nome do domínio em que você quer pesquisar, por exemplo, prod-realm-5.
  • parent_range: o URI do intervalo pai em que você quer pesquisar, por exemplo, projects/project3/locations/global/customRanges/range7.
  • ip_address: o endereço IP que você quer pesquisar, por exemplo, 10.10.10.46.
  • ip_version: a versão do IP que você quer filtrar.
  • attribute_text: o texto do atributo que você quer pesquisar em intervalos, por exemplo, production.
  • attribute: a chave e o valor do atributo que você quer filtrar, por exemplo, attribute:(environment=production).

É possível combinar filtros das seguintes maneiras:

  • Você pode combinar dois ou mais filtros na mesma consulta usando AND.
  • Você só pode usar AND NOT em combinação com o attribute:(KEY=VALUE) filtro.

  • Você pode usar attribute ou attribute_text em uma determinada consulta, mas não ambos.

gcloud

Pesquise recursos de IP usando o gcloud alpha number-registry registry-books search-ip-resources comando.

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

Substitua:

  • REGISTRY_BOOK: o nome do livro de registros em que você quer pesquisar.
  • QUERY: a consulta da pesquisa, por exemplo:
    • "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)"