Cloud Number Registry abfragen

Auf dieser Seite wird erläutert, wie Sie Informationen abfragen, die in der Cloud Number Registry gespeichert sind.

Hinweis

  1. Cloud Number Registry einrichten.
  2. Wählen Sie das Projekt in Ihrer Organisation aus, das für den Zugriff auf die Cloud Number Registry konfiguriert wurde.
  3. Prüfen Sie, ob Sie die Berechtigungen haben, die zum Ausführen der Schritte in dieser Anleitung erforderlich sind.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die Cloud Number Registry IPAM Viewer (roles/cloudnumberregistry.ipamViewer) IAM-Rolle für Ihr Projekt zu gewähren, um die Berechtigungen zu erhalten, die Sie zum Aufrufen von Informationen benötigen, die in der Cloud Number Registry gespeichert sind. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

IP-Adressauslastung anzeigen

Sie können die IP-Adressauslastung für ermittelte oder benutzerdefinierte Bereiche ansehen.

Auslastung eines ermittelten Bereichs anzeigen

gcloud

Verwenden Sie den Befehl gcloud alpha number-registry discovered-ranges show-utilization, um die Auslastung eines ermittelten Bereichs anzuzeigen.

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

Ersetzen Sie Folgendes:

  • DISCOVERED_RANGE_NAME: der Name des ermittelten Bereichs.

Auslastung eines benutzerdefinierten Bereichs anzeigen

gcloud

Verwenden Sie den Befehl gcloud alpha number-registry custom-ranges show-utilization, um die Auslastung eines benutzerdefinierten Bereichs anzuzeigen.

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

Ersetzen Sie Folgendes:

  • CUSTOM_RANGE_NAME: der Name des benutzerdefinierten Bereichs.

Kostenlose IP-Bereiche finden

Sie können verfügbare IP-Adressbereiche in ermittelten oder benutzerdefinierten Bereichen finden.

Kostenlose IP-Bereiche in ermittelten Bereichen finden

Wenn Sie kostenlose IP-Bereiche in ermittelten Bereichen finden, gelten die folgenden Einschränkungen:

gcloud

Verwenden Sie den Befehl gcloud alpha number-registry discovered-ranges find-free-ip-ranges, um kostenlose IP-Bereiche in ermittelten Bereichen zu finden.

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

Ersetzen Sie Folgendes:

  • DISCOVERED_RANGE_NAME: der Name des ermittelten Bereichs.
  • PREFIX_LENGTH: die CIDR-Präfixlänge der zu findenden Bereiche. Verwenden Sie 32, um einzelne IPv4-Adressen zu finden.
  • RANGE_COUNT: die Anzahl der zu findenden kostenlosen Bereiche.

Kostenlose IP-Bereiche in benutzerdefinierten Bereichen finden

Wenn für einen bestimmten IP-Adressbereich kein benutzerdefinierter Bereich vorhanden ist, gilt der Bereich als kostenloser IP-Bereich. Wenn Sie die Cloud Number Registry verwenden möchten, um kostenlose IP-Bereiche in benutzerdefinierten Bereichen zu finden, müssen alle verwendeten IP-Adressen und IP-Adressbereiche einen entsprechenden benutzerdefinierten Bereich haben.

gcloud

Verwenden Sie den Befehl gcloud alpha number-registry custom-ranges find-free-ip-ranges, um kostenlose IP-Bereiche in benutzerdefinierten Bereichen zu finden.

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

Ersetzen Sie Folgendes:

  • CUSTOM_RANGE_NAME: der Name des benutzerdefinierten Bereichs.
  • PREFIX_LENGTH: die CIDR-Präfixlänge der zu findenden Bereiche. Verwenden Sie 32, um einzelne IPv4-Adressen zu finden.
  • RANGE_COUNT: die Anzahl der zu findenden kostenlosen Bereiche.

Nach IP-Ressourcen suchen

Sie können in einem Registry-Buch nach IP-Adressressourcen suchen.

Sie können die folgenden Filter in Abfragen verwenden:

  • realm: Der Name des Bereichs, in dem gesucht werden soll, z. B. prod-realm-5.
  • parent_range: Die URI des übergeordneten Bereichs, in dem gesucht werden soll, z. B. projects/project3/locations/global/customRanges/range7.
  • ip_address: Die IP-Adresse, nach der gesucht werden soll, z. B. 10.10.10.46.
  • ip_version: Die IP-Version, nach der gefiltert werden soll.
  • attribute_text: Der Attributtext, nach dem in Bereichen gesucht werden soll, z. B. production.
  • attribute: Der Attributschlüssel und -wert, nach denen gefiltert werden soll, z. B. attribute:(environment=production).

Sie können Filter auf folgende Arten kombinieren:

  • Sie können zwei oder mehr Filter in derselben Abfrage mit AND kombinieren.
  • Sie können AND NOT nur in Kombination mit dem attribute:(KEY=VALUE) Filter verwenden.

  • Sie können in einer bestimmten Abfrage entweder attribute oder attribute_text, aber nicht beides verwenden.

gcloud

Verwenden Sie den Befehl gcloud alpha number-registry registry-books search-ip-resources, um nach IP-Ressourcen zu suchen.

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

Ersetzen Sie Folgendes:

  • REGISTRY_BOOK: der Name des Registry-Buchs, in dem gesucht werden soll.
  • QUERY: die Abfrage für Ihre Suche, z. B.:
    • "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)"