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 di 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.

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 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 a 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.

Solo me-central2 è disponibile come possibile endpoint regionale.

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 l'API REST.

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 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.

Passaggi successivi