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