Mengelola dan menemukan endpoint

Pratinjau

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

Pengelolaan yang efektif atas kumpulan agen Anda memerlukan akurasi jaringan endpoint. Dokumen ini menjelaskan cara menemukan endpoint yang tersedia, memperbarui detail koneksinya, atau menghapusnya jika tidak lagi digunakan.

Sebelum memulai

Sebelum dapat mengelola endpoint, daftarkan endpoint di Agent Registry. Anda juga memerlukan project ID Anda untuk melakukan tugas ini.

Untuk menggunakan perintah gcloud CLI dalam dokumen ini, pastikan Anda telah menyiapkan lingkungan Google Cloud CLI.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk mengelola endpoint di Agent Registry, minta administrator untuk memberi Anda peran IAM berikut pada project:

• Endpoint penemuan: Agent Registry API Viewer (roles/agentregistry.viewer)
• Endpoint update dan penghapusan: Editor Agent Registry API (roles/agentregistry.editor)

Untuk mengetahui informasi selengkapnya tentang pemberian 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 endpoint

Untuk menjelajahi URL target dan REST API yang terdaftar di lingkungan Anda, buat daftar resource endpoint yang tersedia.

Mencantumkan semua endpoint

Mencantumkan semua endpoint terdaftar di lingkungan Anda:

Konsol

1. Di konsol Google Cloud , buka Agent Registry:

   Buka Agent Registry

2. Dari pemilih project, pilih Google Cloud project tempat Anda menyiapkan Agent Registry.

3. Pilih tab Endpoints.

   Halaman ini menampilkan daftar semua endpoint terdaftar dan detailnya, seperti nama, deskripsi, dan lokasi.

4. Untuk melihat detail koneksi lengkap endpoint, klik nama endpoint.

gcloud

Untuk mencantumkan semua endpoint di lokasi tertentu, gunakan perintah endpoints list:

gcloud alpha agent-registry endpoints list \
  --project=PROJECT_ID \
  --location=REGION

Ganti kode berikut:

• PROJECT_ID: Project ID.
• REGION: Region registri.

Memfilter endpoint terdaftar

Jika memiliki beberapa endpoint, Anda dapat memfilter daftar menurut metadata endpoint:

Konsol

1. Di konsol Google Cloud , buka Agent Registry:

   Buka Agent Registry

2. Dari pemilih project, pilih Google Cloud project tempat Anda menyiapkan Agent Registry.

3. Pilih tab Endpoints.

   Halaman ini menampilkan daftar semua endpoint terdaftar dan detailnya, seperti nama, deskripsi, dan lokasi.

4. Untuk memfilter menurut lokasi, klik menu Lokasi, pilih lokasi yang ingin Anda filter, lalu klik Terapkan.

   Halaman ini menampilkan daftar endpoint terdaftar yang difilter untuk kondisi yang Anda pilih.

gcloud

Filter daftar Anda untuk hanya menampilkan resource yang cocok dengan metadata tertentu, menggunakan flag --filter:

gcloud alpha agent-registry endpoints list \
  --project=PROJECT_ID \
  --location=REGION \
  --filter="FILTER_EXPRESSION"

Ganti FILTER_EXPRESSION dengan ekspresi filter untuk endpoint yang ingin Anda filter. Misalnya, untuk memfilter menurut nama tampilan, gunakan displayName='DISPLAY_NAME'.

Melihat detail dari endpoint

Melihat detail dari endpoint tertentu, termasuk detail koneksi dan pengikatan protokolnya:

Konsol

1. Di konsol Google Cloud , buka Agent Registry:

   Buka Agent Registry

2. Dari pemilih project, pilih Google Cloud project tempat Anda menyiapkan Agent Registry.

3. Pilih tab Endpoints.

   Halaman ini menampilkan daftar semua endpoint terdaftar dan detailnya, seperti nama, deskripsi, dan lokasi.

4. Klik nama endpoint yang ingin Anda lihat.

   Halaman Ringkasan menampilkan nama, deskripsi, lokasi, dan detail koneksi endpoint, termasuk URL tujuan dan binding protokol.

gcloud

Mengambil metadata mendetail tentang endpoint tertentu, termasuk URL antarmuka lengkap dan pengikatan protokolnya:

gcloud alpha agent-registry endpoints describe ENDPOINT_NAME \
  --project=PROJECT_ID \
  --location=REGION

Ganti kode berikut:

• PROJECT_ID: Project ID.
• REGION: Region registri.
• ENDPOINT_NAME: Nama endpoint Anda, misalnya, my-external-api.

Memperbarui endpoint

Jika URL pokok endpoint target eksternal berubah, Anda dapat memperbarui detail antarmuka endpoint.

Ikuti langkah-langkah berikut untuk memperbarui endpoint:

Konsol

1. Di konsol Google Cloud , buka Agent Registry:

   Buka Agent Registry

2. Dari pemilih project, pilih Google Cloud project tempat Anda menyiapkan Agent Registry.

3. Pilih tab Endpoints.

   Halaman ini menampilkan daftar semua endpoint terdaftar dan detailnya, seperti nama, deskripsi, dan lokasi.

4. Klik nama endpoint yang ingin Anda perbarui.

   Halaman Ringkasan menampilkan nama, deskripsi, lokasi, dan detail koneksi endpoint, termasuk URL tujuan dan binding protokol.

5. Klik Edit.

6. Di panel Edit layanan, masukkan informasi yang diperbarui untuk endpoint, seperti nama tampilan, deskripsi, dan URL tujuan. Anda dapat menguji koneksi ke endpoint dari panel ini.

7. Klik Simpan.

gcloud

Untuk Agent Registry API, resource Endpoint digunakan untuk penemuan. Oleh karena itu, Anda harus memperbarui resource Service yang terdaftar secara langsung.

Gunakan tanda --interfaces untuk menentukan URL target baru:

gcloud alpha agent-registry services update ENDPOINT_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --interfaces=url=ENDPOINT_URL,protocolBinding=PROTOCOL

Ganti kode berikut:

• ENDPOINT_NAME: Nama endpoint Anda, misalnya, my-external-api.
• PROJECT_ID: Project ID.
• REGION: Region registri.
• ENDPOINT_URL: URL target baru, misalnya, https://new-api.example.com/v1/data.
• PROTOCOL: Binding protokol untuk antarmuka. Nilai yang valid adalah HTTP_JSON, GRPC, atau JSONRPC.

Menghapus endpoint

Untuk menghapus endpoint dari registry, Anda harus menghapus resource Service yang mendasarinya. Tindakan ini akan segera menghapus endpoint dari hasil penelusuran penemuan.

Ikuti langkah-langkah berikut untuk menghapus endpoint dari registri Anda:

Konsol

1. Di konsol Google Cloud , buka Agent Registry:

   Buka Agent Registry

2. Dari pemilih project, pilih Google Cloud project tempat Anda menyiapkan Agent Registry.

3. Pilih tab Endpoints.

   Halaman ini menampilkan daftar semua endpoint terdaftar dan detailnya, seperti nama, deskripsi, dan lokasi.

4. Klik nama endpoint yang ingin Anda hapus.

   Halaman Ringkasan menampilkan nama, deskripsi, lokasi, dan detail koneksi endpoint, termasuk URL tujuan dan binding protokol.

5. Klik Delete.

6. Di jendela Delete endpoint, masukkan DELETE untuk mengonfirmasi tindakan.

7. Klik Hapus.

gcloud

gcloud alpha agent-registry services delete ENDPOINT_NAME \
  --project=PROJECT_ID \
  --location=REGION