Mengkueri Cloud Number Registry

Pratinjau

Produk ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Halaman ini menjelaskan cara mengkueri 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 Anda perlukan untuk melihat informasi yang disimpan di Cloud Number Registry, minta administrator Anda 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.

Menampilkan penggunaan alamat IP

Anda dapat melihat penggunaan alamat IP untuk rentang yang ditemukan atau rentang kustom.

Menampilkan penggunaan rentang yang ditemukan

gcloud

Tampilkan penggunaan rentang yang ditemukan menggunakan gcloud alpha number-registry discovered-ranges show-utilization perintah.

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

Ganti kode berikut:

• DISCOVERED_RANGE_NAME: nama rentang yang ditemukan.

Menampilkan penggunaan rentang kustom

gcloud

Tampilkan penggunaan rentang kustom menggunakan perintah gcloud alpha number-registry custom-ranges show-utilization.

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

Ganti kode berikut:

• CUSTOM_RANGE_NAME: nama rentang kustom.

Menemukan rentang IP gratis

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

Menemukan rentang IP gratis dalam rentang yang ditemukan

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

• Hasil mungkin mencakup alamat yang tidak dapat digunakan dalam rentang subnet IPv4 dan alamat yang tidak dapat digunakan dalam rentang subnet IPv6.

• Hasil mungkin mencakup alamat IP efemeral yang ditetapkan ke instance yang dimatikan.

gcloud

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

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 dari rentang yang akan ditemukan. Gunakan 32 untuk menemukan alamat IPv4 individual.
• RANGE_COUNT: jumlah rentang gratis 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 digunakan memiliki rentang kustom yang sesuai.

gcloud

Temukan rentang IP gratis dalam rentang kustom menggunakan gcloud alpha number-registry custom-ranges find-free-ip-ranges perintah.

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 dari rentang yang akan ditemukan. Gunakan 32 untuk menemukan alamat IPv4 individual.
• RANGE_COUNT: jumlah rentang gratis yang akan ditemukan.

Menelusuri resource alamat IP

Anda dapat menelusuri resource alamat IP dalam buku registri.

Anda dapat menggunakan filter berikut dalam kueri:

• realm: Nama realm yang akan ditelusuri—misalnya, prod-realm-5.
• parent_range: URI rentang induk yang ingin Anda telusuri—misalnya, projects/project3/locations/global/customRanges/range7.
• ip_address: Alamat IP yang akan ditelusuri—misalnya, 10.10.10.46.
• ip_version: Versi IP yang akan difilter.
• attribute_text: Teks atribut yang akan ditelusuri dalam rentang—misalnya, production.
• attribute: Kunci dan nilai atribut yang akan difilter—misalnya, attribute:(environment=production).

Anda dapat menggabungkan filter dengan cara berikut:

• Anda dapat menggabungkan dua filter atau lebih dalam kueri yang sama menggunakan AND.
• Anda hanya dapat menggunakan AND NOT dalam kombinasi dengan filter attribute:(KEY=VALUE).

• Anda dapat menggunakan attribute atau attribute_text dalam kueri tertentu, tetapi tidak keduanya.

gcloud

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

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 ditelusuri.
• QUERY: kueri untuk penelusuran Anda—misalnya:
  • "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)"