Endpoint layanan global dan regional

Halaman ini menjelaskan endpoint layanan global dan regional Spanner dan 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 milik konfigurasi instance yang berbeda. Anda harus terlebih dahulu membuat instance dalam konfigurasi instance regional sebelum dapat menggunakan endpoint regional untuk konfigurasi instance tersebut.

Endpoint regional Spanner hanya tersedia di konfigurasi instance regional me-central2 Dammam. Kebijakan penyimpanan Spanner yang mendasarinya tidak akan berubah, terlepas dari endpoint yang Anda gunakan.

Keamanan dan kepatuhan untuk endpoint regional

Manfaat menggunakan endpoint regional Spanner di atas endpoint global adalah endpoint regional menyediakan 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 menayangkan 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 multi-region dengan endpoint regional. Anda harus menggunakan endpoint global untuk mengakses konfigurasi instance multi-region. Misalnya, jika 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 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 penegakan 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.

Hanya me-central2 yang tersedia sebagai endpoint regional yang memungkinkan.

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 regional. 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, konfigurasikan 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 untuk informasi lebih lanjut.

RPC API

Endpoint API default mengakses endpoint global. Untuk menggunakan endpoint regional, konfigurasikan 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 untuk informasi selengkapnya.

Langkah selanjutnya