Endpoint layanan global dan regional

Halaman ini menjelaskan endpoint layanan global dan regional Spanner serta cara menggunakannya.

Endpoint layanan adalah URL dasar yang menentukan alamat jaringan layanan API. Spanner memiliki endpoint global dan regional. Anda dapat menggunakan endpoint layanan global atau regional untuk membuat permintaan ke Spanner.

Gunakan endpoint global jika Anda tidak memiliki persyaratan pembatasan regional yang ketat. Meskipun data disimpan dalam region yang dipilih, data mungkin diproses di luar region tersebut. Endpoint global untuk Spanner adalah spanner.googleapis.com. Endpoint API default mengakses endpoint global.

Endpoint regional menerapkan pembatasan regional. Data disimpan dan diproses dalam region yang sama. Endpoint regional untuk Spanner memastikan dan menjamin bahwa data yang disimpan dan diproses dibatasi untuk konfigurasi instance regional Spanner tempat database berada. Gunakan endpoint regional jika lokasi data Anda harus dibatasi dan dikontrol untuk mematuhi persyaratan peraturan. Anda tidak dapat menggunakan endpoint regional untuk mengakses resource yang termasuk dalam konfigurasi instance yang berbeda. Anda harus membuat instance terlebih dahulu dalam konfigurasi instance regional sebelum dapat menggunakan endpoint regional untuk konfigurasi instance tersebut.

Untuk mempelajari wilayah yang dapat Anda gunakan, lihat Wilayah yang tersedia untuk endpoint regional. Kebijakan penyimpanan Spanner yang mendasarinya tidak berubah, terlepas dari endpoint yang Anda gunakan.

Keamanan dan kepatuhan untuk endpoint regional

Manfaat menggunakan endpoint regional Spanner dibandingkan endpoint global adalah endpoint regional memberikan isolasi dan perlindungan regional untuk memenuhi persyaratan keamanan, kepatuhan, dan peraturan.

Anda hanya dapat menggunakan endpoint regional yang termasuk dalam konfigurasi instance regional tersebut. Misalnya, Anda tidak dapat menggunakan spanner.me-central2.rep.googleapis.com untuk melayani permintaan jika instance yang Anda akses termasuk dalam konfigurasi instance regional us-central1. Permintaan akan ditolak dengan error InvalidRegionalRequest.

Batasan endpoint regional

Anda tidak dapat mengakses konfigurasi instance dual-region atau multi-region dengan endpoint regional. Anda harus menggunakan endpoint global untuk mengakses konfigurasi instance dual-region atau multi-region. Misalnya, jika Anda memiliki instance dalam konfigurasi instance multi-region nam7, Anda tidak dapat menggunakan endpoint regional spanner.us-central1.rep.googleapis.com untuk mengirim permintaan ke instance Anda di nam7.

Jika Anda memiliki permintaan aktif yang menggunakan endpoint regional pada salah satu resource instance, memindahkan instance akan memengaruhi semua permintaan yang menggunakan endpoint regional karena penerapan regional memblokir akses ke instance lintas-region. Permintaan yang menggunakan endpoint global tidak terpengaruh.

Konvensi penamaan endpoint regional

Nama endpoint regional Spanner mengikuti konvensi penamaan yang sama dengan nama konfigurasi instance regional. Endpoint regional mengikuti format spanner.REGION.rep.googleapis.com. Misalnya, nama konfigurasi instance regional dan nama endpoint regional untuk Dammam adalah me-central2. Oleh karena itu, endpoint regionalnya adalah spanner.me-central2.rep.googleapis.com.

Untuk mengetahui informasi selengkapnya, lihat Region yang tersedia untuk endpoint regional.

Menentukan endpoint regional

Anda dapat menentukan endpoint regional Spanner menggunakan permintaan Google Cloud CLI, REST, atau RPC API.

gcloud

Untuk menentukan endpoint regional dan mengganti endpoint global, jalankan perintah berikut:

gcloud config set api_endpoint_overrides/spanner https://spanner.REGION.rep.googleapis.com/

Berikan nilai berikut:

REGION
Region yang akan ditetapkan endpoint regionalnya. Contoh, me-central2.

Misalnya, untuk mengonfigurasi endpoint regional sebagai me-central2, jalankan perintah berikut:

gcloud config set api_endpoint_overrides/spanner https://spanner.me-central2.rep.googleapis.com/

Untuk mengonfigurasi ulang endpoint regional ke endpoint global, jalankan:

gcloud config unset api_endpoint_overrides/spanner

REST API

Endpoint API default mengakses endpoint global. Untuk menggunakan endpoint regional, konfigurasi endpoint ke alamat endpoint regional menggunakan pola berikut:

https://spanner.REGION.rep.googleapis.com

Misalnya, jika Anda ingin menerapkan jaminan data dalam konfigurasi instance regional Dammam (me-central2), gunakan:

  https://spanner.me-central2.rep.googleapis.com

Lihat REST API dan Region yang tersedia untuk endpoint regional untuk mengetahui informasi selengkapnya.

RPC API

Endpoint API default mengakses endpoint global. Untuk menggunakan endpoint regional, konfigurasi endpoint ke alamat endpoint regional menggunakan pola berikut:

spanner.REGION.rep.googleapis.com

Misalnya, jika Anda ingin menerapkan jaminan data dalam konfigurasi instance regional Dammam (me-central2), gunakan:

spanner.me-central2.rep.googleapis.com

Lihat RPC API dan Region yang tersedia untuk endpoint regional untuk mengetahui informasi selengkapnya.

Region yang tersedia untuk endpoint regional

Endpoint regional Spanner tersedia di region berikut:

Nama regional dasar Deskripsi region
Amerika
us-central1 Iowa
us-central2 Oklahoma
us-east1 Carolina Selatan
us-east4 Northern Virginia
us-east5 Columbus
us-east7 Alabama
us-south1 Dallas
us-west1 Oregon
us-west2 Los Angeles
us-west3 Salt Lake City
us-west4 Las Vegas
us-west8 Phoenix
Timur Tengah
me-central2 Dammam
Eropa
europe-west8 Milan

Membatasi penggunaan endpoint API global

Untuk membantu menerapkan penggunaan endpoint regional, gunakan batasan kebijakan organisasi constraints/gcp.restrictEndpointUsage untuk memblokir permintaan ke endpoint API global. Untuk mengetahui informasi selengkapnya, lihat Membatasi penggunaan endpoint.

Langkah berikutnya