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 プレフィックス長。個々の IPv4 アドレスを検索するには、32 を使用します。
  • 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 プレフィックス長。個々の IPv4 アドレスを検索するには、32 を使用します。
  • 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 を使用すると、同じクエリで 2 つ以上のフィルタを組み合わせることができます。
  • 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)"