Ringkasan endpoint API Google Cloud

Endpoint API, atau endpoint layanan, adalah URL yang menentukan alamat jaringan layanan API Google Cloud , seperti bigquery.googleapis.com. LayananGoogle Cloud memungkinkan akses ke resource menggunakan berbagai jenis endpoint API, termasuk regional, multiregional, global, dan lokasi. Dukungan untuk setiap jenis endpoint bergantung pada layanan.

Dokumen ini secara singkat menjelaskan setiap jenis endpoint untuk memberikan kejelasan tentang perbedaannya dan panduan tentang jenis endpoint yang akan digunakan.

Endpoint regional

Endpoint API regional menyediakan akses ke layanan Google Cloud melalui endpoint API yang dicakup ke satu region Google Cloud . Traffic yang dikirim ke endpoint regional diproses dan TLS dihentikan sepenuhnya dalam region yang ditentukan.

Untuk sebagian besar Google Cloud layanan, Anda dapat menggunakan endpoint regional untuk bekerja dengan resource regional dalam region yang ditentukan. Operasi pada resource global, resource multiregional, dan resource regional di luar region biasanya tidak didukung dari endpoint regional.

Endpoint API regional menentukan lokasi sebagai subdomain. Endpoint regional publik memiliki format berikut:

SERVICE.REGION.rep.googleapis.com

  • SERVICE: nama layanan Google Cloud , seperti storage, compute, atau bigquery.
  • REGION: nama region Google Cloud , seperti us-central1 atau europe-west1.

Endpoint API regional pribadi memiliki format berikut:

SERVICE.REGION.p.rep.googleapis.com

  • SERVICE: nama layanan Google Cloud , seperti storage, compute, atau bigquery.
  • REGION: nama region Google Cloud , seperti us-central1 atau europe-west1.
  • .p.: menunjukkan target pribadi yang ditujukan untuk konektivitas Private Service Connect.

Endpoint multiregional

Endpoint API multiregional menyediakan akses ke layanan Google Cloud melalui endpoint API yang dicakup ke serangkaian region Google Cloud dalam negara yang sama, seperti Amerika Serikat, India, atau Kanada, atau yurisdiksi, seperti Uni Eropa. Traffic yang dikirim ke endpoint multiregional diproses dan TLS dihentikan sepenuhnya dalam yurisdiksi yang ditentukan.

Untuk sebagian besar layanan Google Cloud , Anda dapat menggunakan endpoint multiregional untuk bekerja dengan resource multiregional dalam multiregion yang ditentukan. Operasi pada resource global, resource regional, dan resource multiregional dari yurisdiksi lain biasanya tidak didukung.

Endpoint API multiregional menentukan yurisdiksi sebagai subdomain. Endpoint multiregional publik memiliki format berikut:

SERVICE.MULTIREGION.rep.googleapis.com

  • SERVICE: nama layanan Google Cloud , seperti storage, compute, atau bigquery.
  • MULTIREGION: nama multi-region Google Cloud , seperti us atau eu.

Endpoint API multiregional pribadi memiliki format berikut:

SERVICE.MULTIREGION.p.rep.googleapis.com

  • SERVICE: nama layanan Google Cloud , seperti storage, compute, atau bigquery.
  • MULTIREGION: Google Cloud nama multi-region, seperti us atau eu.
  • .p.: menunjukkan target pribadi yang ditujukan untuk konektivitas Private Service Connect.

Endpoint global

Endpoint API global tidak menentukan lokasi di nama host URL. Endpoint dengan cakupan global ini menyediakan endpoint layanan dengan ketersediaan tinggi yang menghentikan sesi TLS sedekat mungkin dengan klien, yang meminimalkan latensi saat melayani panggilan API dari populasi klien yang tersebar di internet. Namun, endpoint ini tidak memberikan isolasi regional atau kepatuhan residensi data.

Untuk aplikasi yang dapat menangani dependensi global dan memerlukan performa cepat dari jaringan global Google, Anda dapat menggunakan endpoint global.

Endpoint global memiliki format berikut:

SERVICE.googleapis.com

Dengan SERVICE adalah nama layanan Google Cloud , seperti storage, compute, atau bigquery.

Endpoint lokasi

Endpoint API regional menggantikan endpoint lokasi. Endpoint lokasi adalah nama host layanan regional atau multiregional yang dapat Anda gunakan untuk mengakses data di lokasi tertentu.

Namun, endpoint lokasi tidak mendukung fitur berikut:

  • Koneksi yang mematuhi residensi data dari lokal melalui internet
  • Isolasi domain kegagalan

Endpoint lokasi menentukan lokasi di nama host URL dan memiliki format berikut:

LOCATION-SERVICE.googleapis.com

  • LOCATION: nama region Google Cloud , seperti us-central1, europe-west1, atau us.
  • SERVICE: nama layanan Google Cloud , seperti storage, compute, atau bigquery.

Dokumentasi referensi

Langkah berikutnya