Ringkasan endpoint API Google Cloud

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

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

Endpoint regional

Endpoint API regional menyediakan akses ke Google Cloud layanan melalui endpoint API yang dicakup ke satu Google Cloud region. 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 menggunakan resource regional dalam region yang ditentukan. Operasi pada resource global, resource multi-regional, 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, seperti storage, compute, atau bigquery. Google Cloud
  • REGION: nama region, seperti us-central1 atau europe-west1. Google Cloud

Endpoint API regional pribadi memiliki format berikut:

SERVICE.REGION.p.rep.googleapis.com

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

Endpoint multi-regional

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

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

Endpoint API multi-region menentukan wilayah hukum sebagai subdomain. Endpoint multi-regional publik memiliki format berikut:

SERVICE.MULTI_REGION.rep.googleapis.com

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

Endpoint API multi-regional pribadi memiliki format berikut:

SERVICE.MULTI_REGION.p.rep.googleapis.com

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

Endpoint global

Endpoint API global tidak menentukan lokasi di nama host URL. Endpoint yang dicakup secara global ini menyediakan endpoint layanan ketersediaan tinggi yang menghentikan sesi TLS sedekat mungkin dengan klien, yang meminimalkan latensi saat melayani panggilan API dari populasi klien yang tersebar melalui 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 Google Cloud layanan, seperti storage, compute, atau bigquery.

Endpoint lokasi

Endpoint API regional menggantikan endpoint lokasi. Endpoint lokasi adalah nama host layanan regional atau multi-regional 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, seperti us-central1, europe-west1, atau us. Google Cloud
  • SERVICE: nama layanan, seperti storage, compute, atau bigquery. Google Cloud

Dokumentasi referensi

Langkah berikutnya