查询 Cloud Number Registry

本页面介绍了如何查询存储在 Cloud Number Registry中的信息。

准备工作

  1. 设置 Cloud Number Registry。
  2. 在您的组织中，选择已配置为提供 Cloud Number Registry 访问权限的项目。
  3. 验证您是否拥有完成本 指南所需的权限。

所需角色

如需获得查看存储在 Cloud Number Registry 中的信息所需的权限，请让您的管理员为您授予项目的Cloud Number Registry IPAM Viewer (roles/cloudnumberregistry.ipamViewer) IAM 角色。如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

您也可以通过自定义 角色或其他预定义 角色来获取所需的权限。

查找可用 IP 范围

您可以在发现的范围或自定义范围内查找可用的 IP 地址范围。

在发现的范围内查找可用 IP 范围

在发现的范围内查找可用 IP 范围时，适用以下限制：

控制台

  1. 在 Google Cloud 控制台中，前往 Cloud Number Registry 页面。

    前往 Cloud Number Registry

  2. 点击注册表簿 标签页。

  3. 点击注册表簿。

  4. 点击发现的网域 标签页。

  5. 点击发现的网域，然后点击该网域内发现的范围。

  6. 点击查找可用 IP 范围 。

  7. 在前缀长度 中，选择要 查找的范围的大小。

    系统会列出指定大小的可用范围。

gcloud

使用 gcloud alpha number-registry discovered-ranges find-free-ip-ranges 命令在发现的范围内查找可用 IP 范围。

gcloud alpha number-registry discovered-ranges find-free-ip-ranges DISCOVERED_RANGE_NAME \
    --cidr-prefix-length=PREFIX_LENGTH \
    --range-count=RANGE_COUNT \
    --location=global

替换以下内容：

  • DISCOVERED_RANGE_NAME：发现的范围的名称。
  • PREFIX_LENGTH：要查找的范围的 CIDR 前缀长度。使用 32 查找单个 IPv4 地址。
  • RANGE_COUNT：要查找的可用范围的数量。

在自定义范围内查找可用 IP 范围

如果给定 IP 地址范围不存在自定义范围，则该范围被视为可用 IP 范围。如果您想使用 Cloud Number Registry 在自定义范围内查找可用 IP 范围，请确保所有正在使用的 IP 地址和 IP 地址范围都有对应的自定义范围。

控制台

  1. 在 Google Cloud 控制台中，前往 Cloud Number Registry 页面。

    前往 Cloud Number Registry

  2. 点击注册表簿 标签页。

  3. 点击注册表簿。

  4. 点击自定义网域 标签页。

  5. 点击自定义网域，然后点击该网域内的自定义范围。

  6. 点击查找可用 IP 范围 。

  7. 在前缀长度 中，选择要 查找的范围的大小。

    系统会列出指定大小的可用范围。

gcloud

使用 gcloud alpha number-registry custom-ranges find-free-ip-ranges 命令在自定义范围内查找可用 IP 范围。

gcloud alpha number-registry custom-ranges find-free-ip-ranges CUSTOM_RANGE_NAME \
    --cidr-prefix-length=PREFIX_LENGTH \
    --range-count=RANGE_COUNT \
    --location=global

替换以下内容：

  • CUSTOM_RANGE_NAME：自定义范围的名称。
  • PREFIX_LENGTH：要查找的范围的 CIDR 前缀长度。使用 32 查找单个 IPv4 地址。
  • RANGE_COUNT：要查找的可用范围的数量。

搜索 IP 地址资源

您可以在注册表簿中搜索 IP 地址资源。

您可以在查询中使用以下过滤条件：

  • IP 地址：要搜索的 IP 地址，例如 10.10.10.46。
  • 大区：要搜索的大区名称，例如 vpc-global-123456789。
  • 父范围：您要在其中搜索的父范围的 URI，例如 projects/project3/locations/global/customRanges/range7。
  • IP 版本：要过滤的 IP 版本。

  • 属性：您可以按属性文本进行过滤，也可以按键 和值进行过滤，但不能在同一查询中同时包含这两者。

    • 按文本过滤：要在 范围中搜索的属性文本，例如 europe-west1。
    • 按键和值过滤：要过滤的属性键和值， 例如键 addressType 和值 INTERNAL。

控制台

  1. 在 Google Cloud 控制台中，前往 Cloud Number Registry 页面。

    前往 Cloud Number Registry

  2. 点击注册表簿 标签页。

  3. 点击注册表簿。

  4. 点击 IP 搜索 标签页。

  5. 使用 IP 地址 字段和过滤条件 部分输入搜索查询，然后点击搜索 。

    • 如需搜索特定 IP 地址，请在 IP 地址 字段中输入该 IP 地址。
    • 如需按 IP 版本、网域、父范围或属性过滤搜索结果，请在过滤条件 部分中输入搜索查询。

gcloud

使用 gcloud alpha number-registry registry-books search-ip-resources 命令搜索 IP 资源。

您可以按以下方式组合过滤条件：

  • 您可以使用 AND 在同一查询中组合两个或多个过滤条件。
  • 您只能将 AND NOT 与 attribute:(KEY=VALUE) 过滤条件结合使用。
  • 您可以在给定查询中使用 attribute 或 attribute_text，但不能 同时使用两者。
gcloud alpha number-registry registry-books search-ip-resources REGISTRY_BOOK \
    --query=QUERY \
    --show-utilization \
    --location=global

替换以下内容：

  • REGISTRY_BOOK：要在其中搜索的注册表簿的名称。
  • QUERY：搜索查询，例如：
    • "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)"