查詢 Cloud Number Registry

本頁說明如何查詢儲存在 Cloud Number Registry 中的資訊。

事前準備

  1. 設定 Cloud Number Registry。
  2. 選取貴機構中已設定提供 Cloud Number Registry 存取權的專案。
  3. 確認您具備完成本指南所需的權限。

必要的角色

如要取得查看 Cloud Number Registry 中所儲存資訊所需的權限，請要求管理員授予您專案的「Cloud Number Registry IPAM 檢視者 」(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

如要在自訂範圍中找出可用的 IP 範圍，請使用 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

更改下列內容：

  • CUSTOM_RANGE_NAME：自訂範圍的名稱。
  • PREFIX_LENGTH：要尋找的範圍 CIDR 前置字串長度。使用 32 找出個別 IPv4 位址。
  • RANGE_COUNT：要尋找的可用範圍數量。

搜尋 IP 位址資源

您可以在註冊資料庫中搜尋 IP 位址資源。

您可以在查詢中使用下列篩選器：

  • IP 位址：要搜尋的 IP 位址，例如： 10.10.10.46。
  • Realm：要搜尋的領域名稱，例如 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 address」(IP 位址) 欄位和「Filters」(篩選器) 專區輸入搜尋查詢，然後按一下「Search」(搜尋)。

    • 如要搜尋特定 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)"