Endpoint regional App Hub memungkinkan Anda merutekan traffic langsung ke region tertentu untuk membantu Anda memenuhi persyaratan residensi data. Anda dapat mengonfigurasi endpoint ini di Google Cloud CLI, REST API, Terraform, dan library klien, serta membatasi penggunaan endpoint global dengan kebijakan organisasi.
Apa yang dimaksud dengan endpoint regional?
Endpoint regional adalah endpoint permintaan yang hanya mengizinkan permintaan untuk dilanjutkan jika resource yang terpengaruh ada di lokasi yang ditentukan oleh endpoint. Misalnya, saat Anda menggunakan endpoint https://apphub.us-central1.rep.googleapis.com dalam permintaan untuk mengelola resource, permintaan hanya akan dilanjutkan jika aplikasi atau komponen terdaftar berada di us-central1.
Tidak seperti endpoint global, tempat permintaan mungkin diproses di lokasi yang berbeda dari tempat resource berada, endpoint regional hanya memproses permintaan dalam lokasi yang ditentukan oleh endpoint. Endpoint regional menghentikan sesi TLS di lokasi yang ditentukan oleh endpoint untuk permintaan yang diterima dari internet, resource Google Cloud lain, seperti virtual machine Compute Engine, layanan lokal yang menggunakan VPN atau Interconnect, dan Virtual Private Cloud (VPC).
Endpoint regional mendukung residensi data dengan memastikan bahwa metadata aplikasi Anda tetap berada dalam region yang ditentukan, baik saat dalam penyimpanan maupun saat dalam pengiriman.
Batasan
Anda tidak dapat menggunakan endpoint regional untuk mengelola resource global atau multi-regional di
App Hub, seperti aplikasi global, aplikasi multi-regional
(us dan eu), lampiran project layanan, dan batasan.
Lampiran dan batas project layanan hanya ada di lokasi global,
dan endpoint regional menolak permintaan apa pun yang lokasi jalurnya tidak cocok dengan
region yang ditentukan di endpoint, termasuk /locations/global/,
/locations/us/, /locations/eu/, atau region yang berbeda. Misalnya, pengiriman
GET .../locations/global/applications/globalApp ke endpoint regional akan
ditolak.
Untuk mengelola resource global atau multi-regional, gunakan endpoint global,
https://apphub.googleapis.com.
Lokasi yang didukung
Anda dapat menggunakan endpoint regional untuk semua lokasi regional tempat App Hub tersedia. Untuk mengetahui daftar wilayah yang didukung, lihat Lokasi.
Alat untuk menggunakan endpoint regional
Anda dapat mengonfigurasi Google Cloud CLI atau membuat permintaan REST atau RPC API langsung menggunakan endpoint regional.
Google Cloud CLI
Untuk mengonfigurasi Google Cloud CLI agar dapat digunakan dengan endpoint regional, ikuti langkah-langkah berikut:
Pastikan Anda menggunakan Google Cloud CLI versi
468.0.0atau yang lebih baru.Tetapkan properti
api_endpoint_overrides/apphubke endpoint regional yang ingin Anda gunakan:gcloud config set api_endpoint_overrides/apphub https://apphub.LOCATION.rep.googleapis.com/Ganti
LOCATIONdengan wilayah yang didukung, sepertius-central1.
Atau, tetapkan variabel lingkungan CLOUDSDK_API_ENDPOINT_OVERRIDES_APPHUB ke endpoint:
CLOUDSDK_API_ENDPOINT_OVERRIDES_APPHUB=https://apphub.LOCATION.rep.googleapis.com/ \
gcloud apphub applications list --location=LOCATION
REST API
Untuk membuat permintaan ke endpoint regional, gunakan URI berikut, dengan mengganti
LOCATION dengan wilayah yang didukung:
https://apphub.LOCATION.rep.googleapis.com
Misalnya, Anda dapat menggunakan endpoint berikut untuk mengakses App Hub di region us-central1:
https://apphub.us-central1.rep.googleapis.com
Terraform
Untuk menggunakan endpoint regional dengan Terraform, Anda harus mengganti endpoint App Hub di blok penyedia Google.
Saat menetapkan endpoint regional sebagai endpoint kustom, Anda tidak dapat menggunakan Terraform
untuk mengelola resource global atau multi-regional, seperti
google_apphub_service_project_attachment, google_apphub_boundary, atau
aplikasi di global, us, atau eu.
provider "google" {
project = "project-id"
region = "us-central1"
# Override the App Hub API endpoint to use a regional endpoint
apphub_custom_endpoint = "https://apphub.us-central1.rep.googleapis.com/v1/"
}
Library klien
Untuk menggunakan endpoint regional dengan library klien, Anda harus mengganti properti api_endpoint di opsi klien.
Contoh berikut menggunakan library klien Python.
from google.cloud import apphub_v1
from google.api_core import client_options
rep_endpoint = "apphub.us-central1.rep.googleapis.com"
options = client_options.ClientOptions(api_endpoint=rep_endpoint)
# Instantiate the client
client = apphub_v1.AppHubClient(client_options=options)
Membatasi penggunaan endpoint API global
Untuk membantu menerapkan penggunaan endpoint regional, Anda dapat menggunakan
batasan kebijakan organisasi constraints/gcp.restrictEndpointUsage untuk memblokir
permintaan ke endpoint API global. Untuk mengetahui informasi selengkapnya tentang cara membatasi penggunaan endpoint, lihat Membatasi penggunaan endpoint.