Mengkueri Cloud Number Registry

Halaman ini menjelaskan cara membuat kueri informasi yang disimpan di Cloud Number Registry.

Sebelum memulai

  1. Siapkan Cloud Number Registry.
  2. Pilih project di organisasi Anda yang telah dikonfigurasi untuk memberikan akses Cloud Number Registry.
  3. Pastikan Anda memiliki izin yang diperlukan untuk menyelesaikan panduan ini.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna melihat informasi yang disimpan di Cloud Number Registry, minta administrator untuk memberi Anda peran IAM Cloud Number Registry IPAM Viewer (roles/cloudnumberregistry.ipamViewer) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Menemukan rentang IP gratis

Anda dapat menemukan rentang alamat IP yang tersedia dalam rentang yang ditemukan atau rentang kustom.

Menemukan rentang IP kosong dalam rentang yang ditemukan

Saat Anda menemukan rentang IP gratis dalam rentang yang ditemukan, batasan berikut berlaku:

Konsol

  1. Di konsol Google Cloud , buka halaman Cloud Number Registry.

    Buka Cloud Number Registry

  2. Klik tab Buku catatan.

  3. Klik buku catatan.

  4. Klik tab Realm yang ditemukan.

  5. Klik realm yang ditemukan, lalu klik rentang yang ditemukan di dalam realm tersebut.

  6. Klik Find free IP ranges.

  7. Di Panjang awalan, pilih ukuran rentang yang ingin Anda temukan.

    Rentang yang tersedia dengan ukuran yang ditentukan akan dicantumkan.

gcloud

Temukan rentang IP kosong dalam rentang yang ditemukan menggunakan perintah gcloud alpha number-registry discovered-ranges find-free-ip-ranges.

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

Ganti kode berikut:

  • DISCOVERED_RANGE_NAME: nama rentang yang ditemukan.
  • PREFIX_LENGTH: panjang awalan CIDR rentang yang akan ditemukan. Gunakan 32 untuk menemukan alamat IPv4 individual.
  • RANGE_COUNT: jumlah rentang kosong yang akan ditemukan.

Menemukan rentang IP gratis dalam rentang kustom

Jika rentang kustom tidak ada untuk rentang alamat IP tertentu, rentang tersebut dianggap sebagai rentang IP gratis. Jika Anda ingin menggunakan Cloud Number Registry untuk menemukan rentang IP gratis dalam rentang kustom, pastikan semua alamat IP dan rentang alamat IP yang sedang digunakan memiliki rentang kustom yang sesuai.

Konsol

  1. Di konsol Google Cloud , buka halaman Cloud Number Registry.

    Buka Cloud Number Registry

  2. Klik tab Buku catatan.

  3. Klik buku catatan.

  4. Klik tab Custom realms.

  5. Klik realm kustom, lalu klik rentang kustom di dalam realm tersebut.

  6. Klik Find free IP ranges.

  7. Di Panjang awalan, pilih ukuran rentang yang ingin Anda temukan.

    Rentang yang tersedia dengan ukuran yang ditentukan akan dicantumkan.

gcloud

Temukan rentang IP gratis dalam rentang kustom menggunakan perintah 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

Ganti kode berikut:

  • CUSTOM_RANGE_NAME: nama rentang kustom.
  • PREFIX_LENGTH: panjang awalan CIDR rentang yang akan ditemukan. Gunakan 32 untuk menemukan alamat IPv4 individual.
  • RANGE_COUNT: jumlah rentang kosong yang akan ditemukan.

Menelusuri resource alamat IP

Anda dapat menelusuri resource alamat IP dalam buku registri.

Anda dapat menggunakan filter berikut dalam kueri:

  • Alamat IP: Alamat IP yang akan dicari—misalnya, 10.10.10.46.
  • Realm: Nama realm yang akan dicari—misalnya, vpc-global-123456789.
  • Rentang induk: URI rentang induk yang ingin Anda telusuri di dalamnya—misalnya, projects/project3/locations/global/customRanges/range7.
  • IP version: Versi IP yang akan difilter.

  • Atribut: Anda dapat memfilter menurut teks atribut atau menurut kunci dan nilai, tetapi Anda tidak dapat menyertakan keduanya dalam kueri yang sama.

    • Filter menurut teks: Teks atribut yang akan ditelusuri dalam rentang—misalnya, europe-west1.
    • Filter menurut kunci dan nilai: Kunci dan nilai atribut yang akan difilter—misalnya, kunci addressType dengan nilai INTERNAL.

Konsol

  1. Di konsol Google Cloud , buka halaman Cloud Number Registry.

    Buka Cloud Number Registry

  2. Klik tab Buku catatan.

  3. Klik buku catatan.

  4. Klik tab Penelusuran IP.

  5. Masukkan kueri penelusuran Anda menggunakan kolom IP address dan bagian Filters, lalu klik Search.

    • Untuk menelusuri alamat IP tertentu, masukkan alamat IP di kolom Alamat IP.
    • Untuk memfilter penelusuran menurut versi IP, realm, rentang induk, atau atribut, masukkan kueri penelusuran di bagian Filter.

gcloud

Telusuri resource IP menggunakan perintah gcloud alpha number-registry registry-books search-ip-resources.

Anda dapat menggabungkan filter dengan cara berikut:

  • Anda dapat menggabungkan dua atau beberapa filter dalam kueri yang sama dengan menggunakan AND.
  • Anda dapat menggunakan AND NOT bersama dengan filter attribute:(KEY=VALUE) saja.
  • Anda dapat menggunakan attribute atau attribute_text dalam kueri tertentu, tetapi tidak keduanya.
gcloud alpha number-registry registry-books search-ip-resources REGISTRY_BOOK \
    --query=QUERY \
    --show-utilization \
    --location=global

Ganti kode berikut:

  • REGISTRY_BOOK: nama buku registri yang akan dicari.
  • QUERY: kueri untuk penelusuran Anda—misalnya:
    • "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)"