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 ha endpoint sia globali sia regionali. Puoi utilizzare un endpoint di servizio globale o regionale per effettuare richieste a Spanner.

Utilizza l'endpoint globale se non hai requisiti di limitazione regionale 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 e trattati nella stessa regione. Gli endpoint regionali per Spanner garantiscono che i dati archiviati e trattati siano limitati alla configurazione dell'istanza regionale di Spanner in cui risiede il database. Utilizza gli endpoint regionali se la località dei dati deve essere limitata e controllata per rispettare i requisiti normativi. Non puoi utilizzare un endpoint regionale per accedere alle risorse appartenenti a una configurazione di istanza diversa. Prima di poter utilizzare l'endpoint regionale per una configurazione di istanza, devi prima creare un'istanza nella configurazione di istanza regionale.

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

Sicurezza e conformità per gli endpoint regionali

Il vantaggio di utilizzare un endpoint regionale di 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 appartenenti a quella configurazione di istanza regionale. Ad esempio, non puoi utilizzare spanner.me-central2.rep.googleapis.com per gestire le richieste se l'istanza a cui stai accedendo appartiene alla configurazione di 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 multi-regione con un endpoint regionale. Devi utilizzare l'endpoint globale per accedere alle configurazioni di istanza a due regioni o multi-regione. Ad esempio, se hai un'istanza nella configurazione di istanza multi-regione nam7, non puoi utilizzare l'endpoint regionale spanner.us-central1.rep.googleapis.com per inviare richieste all'istanza in nam7.

Se hai richieste attive che utilizzano endpoint regionali su una delle risorse dell'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. 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 di istanza regionali. L'endpoint regionale segue il formato spanner.REGION.rep.googleapis.com. Ad esempio, sia il nome della configurazione di 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 un endpoint regionale

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

gcloud

Per specificare un endpoint regionale ed eseguire l'override dell'endpoint globale, esegui il comando seguente:

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 comando seguente:

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

Per riconfigurare un endpoint regionale nell'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 dei dati nella configurazione di istanza regionale Dammam (me-central2), utilizza:

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

Per saperne di più, consulta API REST e Regioni disponibili per gli endpoint regionali per maggiori informazioni.

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 dei dati nella configurazione di istanza regionale Dammam (me-central2), utilizza:

spanner.me-central2.rep.googleapis.com

Per saperne di più, consulta API RPC e Regioni disponibili per gli endpoint regionali per ulteriori informazioni.

Regioni disponibili per gli endpoint regionali

Gli endpoint regionali di Spanner sono disponibili nelle seguenti regioni:

Nome regionale 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 delle policy dell'organizzazione constraints/gcp.restrictEndpointUsage per bloccare le richieste all'endpoint API globale. Per saperne di più, consulta Limitare l'utilizzo degli endpoint.

Passaggi successivi