Endpoint regionali

Questa pagina descrive gli endpoint a livello di regione di Cloud Spanner. Puoi utilizzare un endpoint di servizio globale o a livello di area geografica per inviare richieste a Spanner. Utilizza un endpoint a livello di area geografica per applicare la limitazione regionale e assicurarti che i dati vengano archiviati ed elaborati nella stessa area geografica.

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.

Utilizza l'endpoint globale se non hai requisiti rigorosi di limitazione a livello di area geografica. Anche se i dati vengono archiviati all'interno dell'area geografica selezionata, in rari casi potrebbero essere elaborati al di fuori dell'area geografica. L'endpoint globale per Spanner è spanner.googleapis.com. L'endpoint API predefinito accede all'endpoint globale.

Un endpoint a livello di area geografica applica restrizioni a livello di area geografica. I dati vengono archiviati ed elaborati all'interno della stessa regione. Gli endpoint a livello di regione per Spanner assicurano che i dati archiviati ed elaborati siano limitati alla configurazione delle istanze a livello di regione di Spanner in cui risiede il database. Utilizza gli endpoint a livello di regione se la località dei dati deve essere limitata e controllata in modo da soddisfare i requisiti normativi. Non puoi utilizzare un endpoint a livello di regione per accedere alle risorse appartenenti a una diversa configurazione di istanza. Devi prima creare un'istanza nella configurazione dell'istanza a livello di regione prima di poter utilizzare l'endpoint a livello di regione per la configurazione dell'istanza.

Gli endpoint a livello di regione di Spanner sono disponibili in tutte le configurazioni dell'istanza a livello di regione. Non sono disponibili nelle configurazioni di istanze a più aree geografiche. I criteri di archiviazione di Spanner sottostanti non cambiano a prescindere dall'endpoint utilizzato.

Sicurezza e conformità

Il vantaggio di usare un endpoint a livello di regione di Spanner rispetto a un endpoint globale è che quest'ultimo offre isolamento e protezione a livello di area geografica per soddisfare requisiti di sicurezza, conformità e normativi.

Devi utilizzare solo gli endpoint a livello di regione che appartengono a questa configurazione di istanza a livello di regione. Ad esempio, non puoi utilizzare us-west1-spanner.googleapis.com per gestire le richieste se l'istanza a cui accedi appartiene alla configurazione di istanza a livello di regione us-central1. La richiesta verrà rifiutata con un errore InvalidRegionalRequest.

Limitazioni

Non puoi accedere a una configurazione di istanza con più regioni con un endpoint a livello di regione. Devi utilizzare l'endpoint globale per accedere alle configurazioni delle istanze su più aree geografiche. Ad esempio, se disponi di un'istanza nella configurazione di istanze con più regioni nam7, con us-central1 come località di replica, non puoi utilizzare l'endpoint a livello di regione us-central1-spanner.googleapis.com per inviare richieste all'istanza in nam7.

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

Semantica dell'endpoint a livello di regione

I nomi di endpoint a livello di regione di Spanner seguono la stessa convenzione di denominazione dei nomi di configurazione dell'istanza a livello di regione. L'endpoint della regione segue il formato <REGION>-spanner.googleapis.com. Ad esempio, sia il nome di configurazione dell'istanza a livello di regione sia il nome dell'endpoint a livello di regione per l'Iowa sono us-central1. In questo caso, l'endpoint a livello di regione è us-central1-spanner.googleapis.com. Per un elenco di tutte le configurazioni di istanze a livello di regione disponibili, consulta Configurazioni per area geografica.

Come specificare un endpoint a livello di regione

Puoi specificare un endpoint di Spanner a livello di regione che utilizza le richieste dell'interfaccia a riga di comando di Google Cloud CLI e API RPC.

gcloud

Per specificare un endpoint a livello di regione ed eseguire l'override dell'endpoint globale, esegui questo comando:

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

Fornisci il seguente valore:

REGION
La regione per la quale impostare un endpoint a livello di regione. Ad esempio, us-central1 o europe-west1.

Ad esempio, per configurare l'endpoint a livello di regione come us-central1, esegui questo comando:

gcloud config set api_endpoint_overrides/spanner https://us-central1-spanner.googleapis.com/

Per riconfigurare un endpoint a livello di regione 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 a livello di regione, configuralo all'indirizzo dell'endpoint a livello di regione utilizzando il seguente pattern:

https://REGION-spanner.googleapis.com

Ad esempio, se vuoi applicare le garanzie di dati nella configurazione dell'istanza a livello di regione Iowa (us-central1), utilizza:

  https://us-central1-spanner.googleapis.com

Fai riferimento all'API REST per ulteriori informazioni.

API RPC

L'endpoint API predefinito accede all'endpoint globale. Per utilizzare un endpoint a livello di regione, configuralo all'indirizzo dell'endpoint a livello di regione utilizzando il seguente pattern:

REGION-spanner.googleapis.com

Ad esempio, se vuoi applicare le garanzie di dati nella configurazione dell'istanza a livello di regione Iowa (us-central1), utilizza:

us-central1-spanner.googleapis.com

Per ulteriori informazioni, fai riferimento all'API RPC.

Passaggi successivi