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
Scopri di più sulle configurazioni delle istanze di Spanner.
Scopri di più sull'API REST Spanner e sugli endpoint globali e a livello di regione.
Scopri di più sull'API RPC Spanner e sugli endpoint globali e a livello di regione.