Configura gli endpoint regionali

Gli endpoint regionali ti consentono di eseguire i workload di App Hub in modo conforme ai requisiti di residenza dei dati e sovranità dei dati, in cui il traffico delle richieste viene indirizzato direttamente alla regione specificata nell'endpoint.

Che cosa sono gli endpoint regionali?

Gli endpoint regionali sono endpoint di richiesta che consentono di procedere con le richieste solo se la risorsa interessata esiste nella località specificata dall'endpoint. Ad esempio, quando utilizzi l'endpoint https://apphub.us-central1.rep.googleapis.com in una richiesta di gestione delle risorse, la richiesta procede solo se l'applicazione o il componente registrato si trova in us-central1.

A differenza degli endpoint globali, in cui le richieste potrebbero essere elaborate in una località diversa da quella in cui si trova la risorsa, gli endpoint regionali elaborano le richieste solo all'interno della località specificata dall'endpoint. Gli endpoint regionali terminano le sessioni TLS nella località specificata dall'endpoint per le richieste ricevute da internet, da altre risorse Google Cloud , come le macchine virtuali di Compute Engine, dai servizi on-premise che utilizzano VPN o Interconnect e dai virtual private cloud (VPC).

Gli endpoint regionali supportano la residenza dei dati garantendo che i metadati della tua applicazione rimangano all'interno della regione specificata sia at-rest sia in transito.

Limitazioni

Non puoi utilizzare gli endpoint regionali per gestire le risorse globali in App Hub, come applicazioni globali, perimetri, collegamenti di progetti di servizio (SPA) e confini.

Le richieste API relative a queste risorse globali che utilizzano un endpoint regionale non andranno a buon fine perché includono la località /global/ nel percorso dell'API. Ad esempio, la richiesta GET .../locations/global/applications/globalApp verrà rifiutata.

Per gestire le risorse globali, utilizza l'endpoint globale standard, https://apphub.googleapis.com.

Località supportate

Puoi utilizzare gli endpoint regionali per tutte le località regionali in cui App Hub è disponibile. Per un elenco delle regioni supportate, consulta Località.

Strumenti per l'utilizzo degli endpoint regionali

Puoi configurare Google Cloud CLI o effettuare richieste API REST o RPC dirette utilizzando gli endpoint regionali.

Google Cloud CLI

Per configurare Google Cloud CLI per l'utilizzo con gli endpoint regionali, segui questi passaggi:

  1. Assicurati di utilizzare Google Cloud CLI versione 402.0.0 o successive.

  2. Imposta la proprietà api_endpoint_overrides/apphub sull'endpoint regionale che vuoi utilizzare:

    gcloud config set api_endpoint_overrides/apphub https://apphub.LOCATION.rep.googleapis.com/

    Sostituisci LOCATION con una regione supportata, ad esempio us-central1.

In alternativa, imposta la variabile di ambiente CLOUDSDK_API_ENDPOINT_OVERRIDES_APPHUB sull'endpoint:

CLOUDSDK_API_ENDPOINT_OVERRIDES_APPHUB=https://apphub.LOCATION.rep.googleapis.com/
gcloud apphub applications list

API REST

Per inviare richieste agli endpoint regionali, utilizza il seguente URI, sostituendo LOCATION con una regione supportata:

https://apphub.LOCATION.rep.googleapis.com

Ad esempio, puoi utilizzare il seguente endpoint per accedere ad App Hub nella regione us-central1:

https://apphub.us-central1.rep.googleapis.com

Terraform

Per utilizzare gli endpoint regionali con Terraform, devi eseguire l'override dell'endpoint App Hub nel blocco del provider Google.

Quando imposti un endpoint regionale come endpoint personalizzato, non puoi utilizzare Terraform per gestire risorse globali come google_apphub_service_project_attachment.

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/"
}

Librerie client

Per utilizzare gli endpoint regionali con le librerie client, devi eseguire l'override della proprietà api_endpoint nelle opzioni client.

L'esempio seguente utilizza la libreria client 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)

Limitazione dell'utilizzo degli endpoint API globali

Per contribuire a imporre l'utilizzo di endpoint regionali, puoi utilizzare il vincolo delle policy dell'organizzazione constraints/gcp.restrictEndpointUsage per bloccare le richieste all'endpoint API globale. Per saperne di più sulla limitazione dell'utilizzo degli endpoint, consulta Limita l'utilizzo degli endpoint.