Panoramica dell'endpoint API Google Cloud

Un endpoint API, o endpoint di servizio, è un URL che specifica l'indirizzo di rete di un servizio Google Cloud API, ad esempio bigquery.googleapis.com. Google Cloud I servizi 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 sul tipo di endpoint da utilizzare.

Endpoint regionali

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

Per la maggior parte dei servizi, puoi utilizzare gli endpoint regionali per lavorare con le risorse regionali all'interno della regione specificata. Google Cloud In genere, le operazioni sulle risorse globali, sulle risorse multiregionali e sulle risorse regionali fuori regione 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 Google Cloud servizio, ad esempio storage, compute, o bigquery.
  • REGION: il nome della regione, ad esempio us-central1 o europe-west1. Google Cloud

Gli endpoint API regionali privati hanno il seguente formato:

SERVICE.REGION.p.rep.googleapis.com

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

Endpoint multiregionali

Gli endpoint API multiregionali forniscono l'accesso ai Google Cloud servizi tramite un endpoint API con ambito limitato a un insieme di Google Cloud regioni 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 TLS viene terminato interamente all'interno della giurisdizione specificata.

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

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

SERVICE.MULTIREGION.rep.googleapis.com

  • SERVICE: il nome del Google Cloud servizio, ad esempio storage, compute, o bigquery.
  • MULTIREGION: il nome della Google Cloud multiregione, ad esempio us o eu.

Gli endpoint API multiregionali privati hanno il seguente formato:

SERVICE.MULTIREGION.p.rep.googleapis.com

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

Endpoint globali

Gli endpoint API globali non specificano la località nel nome host dell'URL. Questi endpoint con ambito globale forniscono endpoint di servizio a elevata 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 Google Cloud servizio, ad esempio storage, compute, o bigquery.

Endpoint locali

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

Tuttavia, gli endpoint locali non supportano le seguenti funzionalità:

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

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

LOCATION-SERVICE.googleapis.com

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

Documentazione di riferimento

Passaggi successivi