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 che regionali. Puoi utilizzare un endpoint di servizio globale o regionale per inviare richieste a Spanner.

Utilizza l'endpoint globale se non hai requisiti di limitazioni regionali rigorosi. Sebbene i dati siano 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 a livello di regione applica le restrizioni regionali. I dati vengono archiviati ed elaborati all'interno della stessa regione. Gli endpoint regionali per Spanner assicurano e garantiscono che i dati archiviati ed elaborati siano limitati alla configurazione dell'istanza regionale 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 alle risorse appartenenti a una configurazione di istanza diversa. Devi prima creare un'istanza nella configurazione dell'istanza regionale prima di poter utilizzare l'endpoint regionale per quella configurazione dell'istanza.

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

Sicurezza e conformità per gli endpoint regionali

Il vantaggio dell'utilizzo di un endpoint regionale Spanner rispetto a un endpoint globale è che l'endpoint regionale offre isolamento e protezione a livello di regione per soddisfare i requisiti di sicurezza, conformità e regolamentari.

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 a livello di regione

Non puoi accedere a una configurazione di istanze a due regioni o a più regioni con un endpoint regionale. Devi utilizzare l'endpoint globale per accedere alle configurazioni di istanze a due regioni o per più regioni. Ad esempio, se hai un'istanza nella configurazione delle istanze multiregione 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 a livello di regione in una delle risorse dell'istanza, il spostamento dell'istanza influisce su tutte le richieste che utilizzano l'endpoint a livello di regione perché l'applicazione delle norme a livello di regione blocca l'accesso alle istanze cross region. Le richieste che utilizzano un endpoint globale non sono interessate.

Convenzione di denominazione degli endpoint regionali

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

Per ulteriori informazioni, consulta Regioni disponibili per gli endpoint a livello di area geografica.

Specifica di un endpoint a livello di regione

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

gcloud

Per specificare un endpoint a livello di regione e sostituire l'endpoint globale, esegui il seguente comando:

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

Specifica il seguente valore:

REGION
La regione per cui impostare un endpoint a livello di regione. 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 sull'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 con l'indirizzo dell'endpoint regionale utilizzando il seguente pattern:

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

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

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

Per ulteriori informazioni, consulta la sezione relativa all'API REST e alle regioni disponibili per gli endpoint a livello di regione.

API RPC

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

spanner.REGION.rep.googleapis.com

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

spanner.me-central2.rep.googleapis.com

Per ulteriori informazioni, consulta l'API RPC e le regioni disponibili per gli endpoint a livello di area geografica.

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

Passaggi successivi