Endpoint di servizio globali e a livello di regione

Questa pagina descrive gli endpoint di servizio Spanner globali e a livello di regione 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 a livello di regione. Puoi usare un endpoint di servizio globale o regionale per effettuare richieste a Spanner.

Utilizza l'endpoint globale se non hai requisiti rigorosi per le restrizioni regionali. Anche se sono archiviati all'interno della regione selezionata, i dati potrebbero essere elaborati al di fuori della regione. L'endpoint globale di Spanner è spanner.googleapis.com. L'endpoint API predefinito consente di accedere all'endpoint globale.

Un endpoint a livello di regione applica restrizioni a livello di regione. I dati vengono archiviati ed elaborati nella 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 gli endpoint a livello di regione 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 a risorse appartenenti 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 a livello di regione Spanner è disponibile solo nella me-central2 configurazione dell'istanza regionale Dammam. I criteri di archiviazione sottostanti di Spanner non cambiano indipendentemente dall'endpoint utilizzato.

Sicurezza e conformità per gli endpoint a livello di regione

Il vantaggio dell'utilizzo di un endpoint a livello di regione Spanner su un endpoint globale è che questo endpoint fornisce isolamento e protezione a livello di regione per soddisfare i requisiti di sicurezza, conformità e normative.

Puoi utilizzare solo gli 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 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 multiregionali con un endpoint a livello di regione. Devi utilizzare l'endpoint globale per accedere alle configurazioni delle istanze multiregionali. 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 delle risorse dell'istanza, lo spostamento dell'istanza ha un impatto 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 usano un endpoint globale non sono interessate.

Convenzione di denominazione degli endpoint a livello di regione

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

È disponibile solo me-central2 come possibile endpoint a livello di regione.

Specifica di un endpoint a livello di regione

Puoi specificare un endpoint a livello di regione 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 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 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 per l'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, 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 delle istanze a livello di regione Dammam (me-central2), usa:

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

Per ulteriori informazioni, consulta la sezione API REST.

API RPC

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

spanner.REGION.rep.googleapis.com

Ad esempio, se vuoi applicare le garanzie relative ai dati nella configurazione delle istanze a livello di regione Dammam (me-central2), usa:

spanner.me-central2.rep.googleapis.com

Per saperne di più, consulta la pagina relativa all'API RPC.

Passaggi successivi