Endpoint di servizio globali e a livello di regione

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

Un endpoint di servizio è una base URL che specifica l'indirizzo di rete di un servizio API. Spanner dispone di endpoint sia globali che regionali. Puoi usare un servizio globale o regionale per effettuare 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 di Spanner in cui risiede il database. Utilizza endpoint a livello di regione se la località dei dati deve essere limitati e controllati 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.

Un endpoint regionale Spanner è disponibile solo nella configurazione dell'istanza regionaleme-central2 di Dammam. I criteri di archiviazione di Spanner sottostanti non cambiano indipendentemente dall'endpoint utilizzato.

Sicurezza e conformità per gli endpoint a livello di regione

Il vantaggio di usare un endpoint a livello di regione di Spanner rispetto a un endpoint globale è che l'endpoint a livello di regione fornisce l'isolamento a livello di regione protezione dei dati 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 a livello di regione

Non puoi accedere a una configurazione di istanze a due o più regioni con un a livello di regione. Devi utilizzare l'endpoint globale per accedere alla doppia regione o configurazioni di istanze multiregionali. Ad esempio, se hai un'istanza in la configurazione dell'istanza multiregionale nam7, non puoi utilizzare endpoint spanner.us-central1.rep.googleapis.com per inviare richieste ai tuoi 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 interessate.

Convenzione di denominazione degli endpoint regionali

I nomi degli endpoint a livello di regione di Spanner seguono la stessa convenzione di denominazione come nomi di configurazione delle istanze a livello di regione. 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. Di conseguenza, l'endpoint a livello di regione spanner.me-central2.rep.googleapis.com.

Solo me-central2 è disponibile come possibile endpoint regionale.

Specifica di un endpoint a livello di regione

Puoi specificare un endpoint a livello di regione di Spanner utilizzando Richieste Google Cloud CLI, REST o API RPC.

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 la quale 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 una regione configura l'endpoint in base all'indirizzo dell'endpoint a livello di regione 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, fai riferimento ad API REST.

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, fai riferimento ad API RPC.

Passaggi successivi