Panoramica dell'endpoint API Google Cloud

Un endpoint API, o endpoint di servizio, è un URL che specifica l'indirizzo di rete di un servizio API, ad esempio bigquery.googleapis.com. Google Cloud Google Cloud consentono l'accesso alle risorse utilizzando diversi tipi di endpoint API, tra cui regionali, multiregionali, globali e locali. Il supporto per ogni tipo di endpoint dipende dal servizio.

Questo documento descrive brevemente ogni tipo di endpoint per fornire chiarezza sulle differenze e indicazioni su quale tipo di endpoint utilizzare.

Endpoint regionali

Gli endpoint API regionali forniscono l'accesso ai Google Cloud servizi tramite un endpoint API limitato a una singola Google Cloud regione. Il traffico inviato a un endpoint regionale viene elaborato e il protocollo TLS viene terminato interamente all'interno della regione specificata.

Per la maggior parte dei servizi Google Cloud , puoi utilizzare endpoint regionali per lavorare con risorse regionali all'interno della regione specificata. Le operazioni sulle risorse globali, sulle risorse multiregionali e sulle risorse regionali esterne alla regione in genere non sono supportate dall'endpoint regionale.

Gli endpoint API regionali specificano la località come sottodominio. Gli endpoint regionali pubblici hanno il seguente formato:

SERVICE.REGION.rep.googleapis.com

  • SERVICE: il nome del servizio Google Cloud , ad esempio storage, compute o bigquery.
  • REGION: il nome della regione Google Cloud , ad esempio us-central1 o europe-west1.

Gli endpoint API regionali privati hanno il seguente formato:

SERVICE.REGION.p.rep.googleapis.com

  • SERVICE: il nome del servizio Google Cloud , ad esempio storage, compute o bigquery.
  • REGION: il nome della regione Google Cloud , ad esempio us-central1 o europe-west1.
  • .p.: indica una destinazione privata destinata alla connettività Private Service Connect.

Endpoint multiregionali

Gli endpoint API multiregionali forniscono l'accesso ai servizi Google Cloud tramite un endpoint API con ambito definito per un insieme di regioni Google Cloud all'interno dello stesso paese, ad esempio Stati Uniti, India o Canada, o giurisdizione, ad esempio l'Unione Europea. Il traffico inviato a un endpoint multiregionale viene elaborato e il protocollo TLS viene terminato interamente all'interno della giurisdizione specificata.

Per la maggior parte dei servizi Google Cloud , puoi utilizzare endpoint multiregionali per lavorare con risorse multiregionali all'interno della multiregione specificata. Le operazioni su risorse globali, regionali e multiregionali di altre giurisdizioni in genere non sono supportate.

Gli endpoint API multiregionali specificano la giurisdizione come sottodominio. Gli endpoint multiregionali pubblici hanno il seguente formato:

SERVICE.MULTI_REGION.rep.googleapis.com

  • SERVICE: il nome del servizio Google Cloud , ad esempio storage, compute o bigquery.
  • MULTI_REGION: il nome Google Cloud multiregionale, ad esempio us o eu.

Gli endpoint API multiregionali privati hanno il seguente formato:

SERVICE.MULTI_REGION.p.rep.googleapis.com

  • SERVICE: il nome del servizio Google Cloud , ad esempio storage, compute o bigquery.
  • MULTI_REGION: il nome della regione multipla, ad esempio Google Cloud o us.eu
  • .p.: indica una destinazione privata destinata alla connettività Private Service Connect.

Endpoint globali

Gli endpoint API globali non specificano la posizione nel nome host dell'URL. Questi endpoint con ambito globale forniscono endpoint di servizio ad alta disponibilità che terminano la sessione TLS il più vicino possibile al client, il che riduce al minimo la latenza durante la gestione delle chiamate API da una popolazione di client dispersa su internet. Tuttavia, questi endpoint non forniscono alcun isolamento regionale o conformità alla residenza dei dati.

Per le applicazioni che possono gestire le dipendenze globali e richiedono prestazioni rapide dalla rete globale di Google, puoi utilizzare gli endpoint globali.

Gli endpoint globali hanno il seguente formato:

SERVICE.googleapis.com

Dove SERVICE è il nome del servizio Google Cloud , ad esempio storage, compute o bigquery.

Endpoint basati sulla posizione

Gli endpoint API regionali stanno sostituendo gli endpoint basati sulla posizione. Gli endpoint basati sulla località sono nomi host di servizi regionali o multiregionali che puoi utilizzare per accedere ai dati in una determinata località.

Tuttavia, gli endpoint basati sulla posizione non supportano le seguenti funzionalità:

  • Connessioni conformi alla residenza dei dati da on-premise tramite internet
  • Isolamento del dominio in errore

Gli endpoint di località specificano la località nel nome host dell'URL e hanno il seguente formato:

LOCATION-SERVICE.googleapis.com

  • LOCATION: il nome della regione Google Cloud , ad esempio us-central1, europe-west1 o us.
  • SERVICE: il nome del servizio Google Cloud , ad esempio storage, compute o bigquery.

Documentazione di riferimento

Passaggi successivi