Cloud Number Registry abfragen

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

Hinweis

  1. Richten Sie die Cloud Number Registry ein.
  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.

Unbelegte IP-Bereiche suchen

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

Unbelegte IP-Bereiche in ermittelten Bereichen suchen

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

Console

  1. Rufen Sie in der Google Cloud Console die Seite Cloud Number Registry auf.

    Cloud Number Registry aufrufen

  2. Klicken Sie auf den Tab Registry-Bücher.

  3. Klicken Sie auf ein Registry-Buch.

  4. Klicken Sie auf den Tab Ermittelte Bereiche.

  5. Klicken Sie auf einen ermittelten Bereich und dann auf einen ermittelten Bereich innerhalb dieses Bereichs.

  6. Klicken Sie auf Unbelegte IP-Bereiche suchen.

  7. Wählen Sie unter Präfixlänge die Größe des Bereichs aus, den Sie suchen möchten.

    Die verfügbaren Bereiche der angegebenen Größe werden aufgelistet.

gcloud

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

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 suchenden Bereiche. Verwenden Sie 32, um einzelne IPv4-Adressen zu suchen.
  • RANGE_COUNT: die Anzahl der zu suchenden unbelegten Bereiche.

Unbelegte IP-Bereiche in benutzerdefinierten Bereichen suchen

Wenn für einen bestimmten IP-Adressbereich kein benutzerdefinierter Bereich vorhanden ist, gilt der Bereich als unbelegter IP-Bereich. Wenn Sie die Cloud Number Registry verwenden möchten, um unbelegte IP-Bereiche in benutzerdefinierten Bereichen zu suchen, muss für alle verwendeten IP-Adressen und IP-Adressbereiche ein entsprechender benutzerdefinierter Bereich vorhanden sein.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Cloud Number Registry auf.

    Cloud Number Registry aufrufen

  2. Klicken Sie auf den Tab Registry-Bücher.

  3. Klicken Sie auf ein Registry-Buch.

  4. Klicken Sie auf den Tab Benutzerdefinierte Bereiche.

  5. Klicken Sie auf einen benutzerdefinierten Bereich und dann auf einen benutzerdefinierten Bereich innerhalb dieses Bereichs.

  6. Klicken Sie auf Unbelegte IP-Bereiche suchen.

  7. Wählen Sie unter Präfixlänge die Größe des Bereichs aus, den Sie suchen möchten.

    Die verfügbaren Bereiche der angegebenen Größe werden aufgelistet.

gcloud

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

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 suchenden Bereiche. Verwenden Sie 32, um einzelne IPv4-Adressen zu suchen.
  • RANGE_COUNT: die Anzahl der zu suchenden unbelegten Bereiche.

Nach IP-Adressressourcen suchen

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

Sie können die folgenden Filter in Abfragen verwenden:

  • IP-Adresse: Die IP-Adresse, nach der gesucht werden soll, z. B. 10.10.10.46.
  • Bereich: Der Name des Bereichs, in dem gesucht werden soll, z. B. vpc-global-123456789.
  • Übergeordneter Bereich: Der URI des übergeordneten Bereichs, in dem Sie suchen möchten , z. B. projects/project3/locations/global/customRanges/range7.
  • IP-Version: Die IP-Version, nach der gefiltert werden soll.

  • Attribute: Sie können nach Attributtext oder nach Schlüsseln und Werten filtern, aber nicht beides in derselben Abfrage verwenden.

    • Nach Text filtern: Der Attributtext, nach dem in Bereichen gesucht werden soll, z. B. europe-west1.
    • Nach Schlüsseln und Werten filtern: Der Attributschlüssel und -wert, nach dem gefiltert werden soll , z. B. der Schlüssel addressType mit dem Wert INTERNAL.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Cloud Number Registry auf.

    Cloud Number Registry aufrufen

  2. Klicken Sie auf den Tab Registry-Bücher.

  3. Klicken Sie auf ein Registry-Buch.

  4. Klicken Sie auf den Tab IP-Suche.

  5. Geben Sie Ihre Suchanfrage im Feld IP-Adresse und im Bereich Filter ein und klicken Sie auf Suchen.

    • Wenn Sie nach einer bestimmten IP-Adresse suchen möchten, geben Sie sie im Feld IP-Adresse ein.
    • Wenn Sie Ihre Suche nach IP-Version, Bereich, übergeordnetem Bereich oder Attributen filtern möchten, geben Sie Ihre Suchanfrage im Bereich Filter ein.

gcloud

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

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 verwenden, aber nicht beides.
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.
    • "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)"