Endpoint di servizio globali e regionali

Questa pagina descrive gli endpoint di servizio globali e regionali di Spanner e come utilizzarli.

Un endpoint di servizio è un URL di base che specifica l'indirizzo di rete di un servizio API. Spanner dispone di endpoint globali e regionali. Puoi utilizzare un endpoint di servizio globale o regionale per effettuare richieste a Spanner.

Utilizza l'endpoint globale se non hai requisiti di restrizione regionali rigorosi. Sebbene i dati vengano archiviati nella regione selezionata, potrebbero essere trattati al di fuori della regione. L'endpoint globale per Spanner è spanner.googleapis.com. L'endpoint API predefinito accede all'endpoint globale.

Un endpoint regionale applica le limitazioni regionali. I dati vengono archiviati ed elaborati nella stessa regione. Gli endpoint regionali per Spanner garantiscono che i dati archiviati ed elaborati siano limitati alla configurazione dell'istanza regionale di Spanner in cui risiede il database. Utilizza gli endpoint regionali se la posizione dei dati deve essere limitata e controllata per rispettare i requisiti normativi. Non puoi utilizzare un endpoint regionale per accedere a risorse appartenenti a una configurazione di istanza diversa. Prima di poter utilizzare l'endpoint regionale per la configurazione dell'istanza, devi prima creare un'istanza nella configurazione dell'istanza regionale.

Per scoprire quali regioni puoi utilizzare, consulta Regioni disponibili per gli endpoint regionali. I criteri di archiviazione Spanner sottostanti non cambiano indipendentemente dall'endpoint utilizzato.

Sicurezza e conformità per gli endpoint regionali

Il vantaggio di utilizzare un endpoint regionale Spanner rispetto a un endpoint globale è che l'endpoint regionale fornisce isolamento e protezione regionali per soddisfare i requisiti di sicurezza, conformità e normativi.

Puoi utilizzare solo gli endpoint regionali che appartengono alla configurazione dell'istanza regionale. Ad esempio, non puoi utilizzare spanner.me-central2.rep.googleapis.com per gestire le richieste se l'istanza a cui accedi appartiene alla configurazione dell'istanza regionale us-central1. La richiesta verrà rifiutata con un errore InvalidRegionalRequest.

Limitazioni degli endpoint regionali

Non puoi accedere a una configurazione di istanza a due regioni o multiregionale con un endpoint regionale. Devi utilizzare l'endpoint globale per accedere alle configurazioni delle istanze a due regioni o multiregionali. Ad esempio, se hai un'istanza nella configurazione dell'istanza multiregionale nam7, non puoi utilizzare l'endpoint regionale spanner.us-central1.rep.googleapis.com per inviare richieste alla tua istanza in nam7.

Se hai richieste attive che utilizzano endpoint regionali su una qualsiasi delle risorse istanza, lo spostamento dell'istanza influisce su tutte le richieste che utilizzano l'endpoint regionale perché l'applicazione regionale blocca l'accesso alle istanze tra regioni diverse. Le richieste che utilizzano un endpoint globale non sono interessate.

Convenzione di denominazione degli endpoint regionali

I nomi degli endpoint regionali di Spanner seguono la stessa convenzione di denominazione dei nomi delle configurazioni delle istanze regionali. L'endpoint a livello di regione segue il formato spanner.REGION.rep.googleapis.com. Ad esempio, sia il nome della configurazione dell'istanza regionale sia il nome dell'endpoint regionale per Dammam sono me-central2. Pertanto, l'endpoint regionale è spanner.me-central2.rep.googleapis.com.

Per saperne di più, consulta Regioni disponibili per gli endpoint regionali.

Specifica di un endpoint a livello di regione

Puoi specificare un endpoint regionale Spanner utilizzando le richieste API Google Cloud CLI, REST o RPC.

gcloud

Per specificare un endpoint regionale e ignorare l'endpoint globale, esegui questo comando:

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

Fornisci il seguente valore:

REGION
La regione per cui impostare un endpoint regionale. Ad esempio, me-central2.

Ad esempio, per configurare l'endpoint regionale come me-central2, esegui il seguente comando:

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

Per riconfigurare un endpoint regionale in modo che diventi l'endpoint globale, esegui:

gcloud config unset api_endpoint_overrides/spanner

API REST

L'endpoint API predefinito accede all'endpoint globale. Per utilizzare un endpoint regionale, configura l'endpoint all'indirizzo dell'endpoint regionale utilizzando il seguente pattern:

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

Ad esempio, se vuoi applicare le garanzie sui dati nella configurazione dell'istanza regionale Dammam (me-central2), utilizza:

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

Per ulteriori informazioni, consulta API REST e Regioni disponibili per gli endpoint regionali.

API RPC

L'endpoint API predefinito accede all'endpoint globale. Per utilizzare un endpoint regionale, configura l'endpoint all'indirizzo dell'endpoint regionale utilizzando il seguente pattern:

spanner.REGION.rep.googleapis.com

Ad esempio, se vuoi applicare le garanzie sui dati nella configurazione dell'istanza regionale Dammam (me-central2), utilizza:

spanner.me-central2.rep.googleapis.com

Per ulteriori informazioni, consulta API RPC e Regioni disponibili per gli endpoint regionali.

Regioni disponibili per gli endpoint regionali

Gli endpoint regionali di Spanner sono disponibili nelle seguenti regioni:

Nome regione di base Descrizione della regione
Americhe
us-central1 Iowa
us-central2 Oklahoma
us-east1 Carolina del Sud
us-east4 Virginia del Nord
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
Medio Oriente
me-central2 Dammam
Europa
europe-west8 Milano

Limita l'utilizzo degli endpoint API globali

Per contribuire a imporre l'utilizzo di endpoint regionali, utilizza il vincolo del criterio dell'organizzazione constraints/gcp.restrictEndpointUsage per bloccare le richieste all'endpoint API globale. Per ulteriori informazioni, vedi Limitare l'utilizzo degli endpoint.

Passaggi successivi