Consultar o Cloud Number Registry

Visualizar

Este produto está sujeito aos Termos das Soluções Pré-GA na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os produtos pré-GA estão disponíveis "no estado em que se encontra" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

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 com papéis personalizados ou outros papéis predefinidos.

Encontrar intervalos de IP disponíveis

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

Encontrar intervalos de IP disponíveis em intervalos descobertos

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

• Os resultados podem incluir endereços inutilizáveis em intervalos de sub-rede IPv4 e endereços inutilizáveis em intervalos de sub-rede IPv6.

• Os resultados podem incluir endereços IP efêmeros atribuídos a instâncias desativadas.

Console

1. No Google Cloud console, acesse a página Cloud Number Registry.

   Acessar o Cloud Number Registry

2. Clique na guia Livros de registros.

3. Clique em um livro de registros.

4. Clique na guia Domínios descobertos.

5. Clique em um domínio descoberto e em um intervalo descoberto dentro desse domínio.

6. Clique em Encontrar intervalos de IP disponíveis.

7. Em Comprimento do prefixo, selecione o tamanho do intervalo que você quer encontrar.

   Os intervalos disponíveis do tamanho especificado são listados.

gcloud

Encontre intervalos de IP disponíveis 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 disponíveis a serem encontrados.

Encontrar intervalos de IP disponíveis 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 disponível. Se você quiser usar o Cloud Number Registry para encontrar intervalos de IP disponíveis em intervalos personalizados, verifique se todos os endereços IP e intervalos de endereços IP em uso têm um intervalo personalizado correspondente.

Console

1. No Google Cloud console, acesse a página Cloud Number Registry.

   Acessar o Cloud Number Registry

2. Clique na guia Livros de registros.

3. Clique em um livro de registros.

4. Clique na guia Domínios personalizados.

5. Clique em um domínio personalizado e em um intervalo personalizado dentro desse domínio.

6. Clique em Encontrar intervalos de IP disponíveis.

7. Em Comprimento do prefixo, selecione o tamanho do intervalo que você quer encontrar.

   Os intervalos disponíveis do tamanho especificado são listados.

gcloud

Encontre intervalos de IP disponíveis 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 disponíveis a serem encontrados.

Pesquisar recursos de endereço IP

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

É possível usar os seguintes filtros em consultas:

• Endereço IP: o endereço IP a ser pesquisado, por exemplo, 10.10.10.46.
• Domínio: o nome do domínio em que você quer pesquisar, por exemplo, vpc-global-123456789.
• Intervalo pai: o URI do intervalo pai em que você quer pesquisar por exemplo, projects/project3/locations/global/customRanges/range7.
• Versão do IP: a versão do IP a ser filtrada.

• Atributos: é possível filtrar por texto de atributo ou por chaves e valores, mas não é possível incluir os dois na mesma consulta.

  • Filtrar por texto: o texto do atributo a ser pesquisado nos intervalos, por exemplo, europe-west1.
  • Filtrar por chaves e valores: a chave e o valor do atributo a serem filtrados por — por exemplo, a chave addressType com o valor INTERNAL.

Console

1. No Google Cloud console, acesse a página Cloud Number Registry.

   Acessar o Cloud Number Registry

2. Clique na guia Livros de registros.

3. Clique em um livro de registros.

4. Clique na guia Pesquisa de IP.

5. Insira sua consulta de pesquisa usando o campo Endereço IP e a seção Filtros e clique em Pesquisar.

   • Para pesquisar um endereço IP específico, insira o endereço IP no campo Endereço IP.
   • Para filtrar a pesquisa por versão do IP, domínio, intervalo pai ou atributos, insira a consulta de pesquisa na seção Filtros.

gcloud

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

É possível combinar filtros das seguintes maneiras:

• É possível combinar dois ou mais filtros na mesma consulta usando AND.
• É possível usar AND NOT apenas em combinação com o attribute:(KEY=VALUE) filtro.
• É possível usar attribute ou attribute_text em uma determinada consulta, mas não os dois.

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:
  • "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)"