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 è un URL di base che specifica l'indirizzo di rete di un servizio API. Spanner ha endpoint globali e a livello di regione. Usa un endpoint di servizio globale o regionale per le richieste a Spanner.

Utilizza l'endpoint globale se non hai requisiti rigidi per le restrizioni regionali. Sebbene i dati siano archiviati all'interno della regione selezionata, potrebbero essere elaborati al di fuori di quest'ultima. L'endpoint globale di Spanner è spanner.googleapis.com. L'endpoint API predefinito accede all'endpoint globale.

Un endpoint a livello di regione applica restrizioni a livello di regione. I dati vengono archiviati ed elaborati all'interno della stessa regione. Gli endpoint a livello di regione per Spanner assicurano e garantiscono che i dati archiviati ed elaborati siano limitati alla configurazione dell'istanza a livello di regione di Spanner in cui si trova il database. Utilizza endpoint regionali se la località dei dati deve essere limitata e controllata per rispettare i requisiti normativi. Non puoi utilizzare un endpoint a livello di regione per accedere alle risorse che appartengono a una configurazione dell'istanza diversa. Devi 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.

Un endpoint regionale di Spanner è disponibile solo nella me-central2 configurazione dell'istanza regionale 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 offre l'isolamento e la protezione a livello di regione per soddisfare i requisiti di sicurezza, conformità e normativi.

Puoi usare solo endpoint a livello di regione che appartengono a quella configurazione dell'istanza a livello di regione. 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 dell'istanza a livello di regione 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 endpoint a livello di regione. Devi utilizzare l'endpoint globale per accedere alle configurazioni di istanze a due o più regioni. Ad esempio, se hai un'istanza nella configurazione dell'istanza multiregionale nam7, non puoi utilizzare l'endpoint a livello di regione spanner.us-central1.rep.googleapis.com per inviare richieste alla tua istanza in nam7.

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

Convenzione di denominazione degli endpoint a livello di regione

I nomi degli endpoint a livello di regione di Spanner seguono la stessa convenzione di denominazione dei nomi di configurazione delle istanze a livello di regione. L'endpoint a livello di regione 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 a livello di regione per Dammam sono me-central2. Pertanto, l'endpoint a livello di regione è spanner.me-central2.rep.googleapis.com.

Solo me-central2 è disponibile come possibile endpoint a livello di regione.

Specifica di un endpoint a livello di regione

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

gcloud

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

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

Specifica il valore seguente:

REGION
La regione per la quale impostare un endpoint a livello di regione. Ad esempio, me-central2.

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

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

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

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

Ad esempio, se vuoi applicare le garanzie dei dati nella configurazione dell'istanza a livello di regione Dammam (me-central2), utilizza:

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

Fai riferimento ad API REST per ulteriori informazioni.

API RPC

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

spanner.REGION.rep.googleapis.com

Ad esempio, se vuoi applicare le garanzie dei dati nella configurazione dell'istanza a livello di regione Dammam (me-central2), utilizza:

spanner.me-central2.rep.googleapis.com

Per ulteriori informazioni, fai riferimento ad API RPC.

Passaggi successivi