Visão geral do endpoint de API Google Cloud

Um endpoint de API, ou endpoint de serviço, é um URL que especifica o endereço de rede de um serviço de API Google Cloud , como bigquery.googleapis.com. Os serviços doGoogle Cloud permitem o acesso a recursos usando diferentes tipos de endpoints de API, incluindo regionais, multirregionais, globais e locais. O suporte para cada tipo de endpoint depende do serviço.

Este documento descreve brevemente cada tipo de endpoint para esclarecer as diferenças entre eles e orientar sobre qual tipo usar.

Endpoints regionais

Os endpoints de API regionais fornecem acesso a serviços do Google Cloud por um endpoint de API com escopo para uma única região do Google Cloud . O tráfego enviado a um endpoint regional é processado e o TLS é encerrado totalmente na região especificada.

Para a maioria dos serviços do Google Cloud , é possível usar endpoints regionais para trabalhar com recursos regionais na região especificada. As operações em recursos globais, multirregionais e regionais fora da região normalmente não são compatíveis com o endpoint regional.

Os endpoints regionais da API especificam o local como um subdomínio. Os endpoints regionais públicos têm o seguinte formato:

SERVICE.REGION.rep.googleapis.com

  • SERVICE: o nome do serviço Google Cloud , como storage, compute ou bigquery.
  • REGION: o nome da região Google Cloud , como us-central1 ou europe-west1.

Os endpoints regionais particulares da API têm o seguinte formato:

SERVICE.REGION.p.rep.googleapis.com

  • SERVICE: o nome do serviço Google Cloud , como storage, compute ou bigquery.
  • REGION: o nome da região Google Cloud , como us-central1 ou europe-west1.
  • .p.: indica um destino particular destinado à conectividade do Private Service Connect.

Endpoints multirregionais

Os endpoints de API multirregionais oferecem acesso aos serviços do Google Cloud por um endpoint de API que está no escopo de um conjunto de regiões do Google Cloud no mesmo país, como Estados Unidos, Índia ou Canadá, ou jurisdição, como a União Europeia. O tráfego enviado a um endpoint multirregional é processado e encerrado por TLS totalmente dentro da jurisdição especificada.

Para a maioria dos serviços do Google Cloud , é possível usar endpoints multirregionais para trabalhar com recursos multirregionais na multirregião especificada. Operações em recursos globais, regionais e multirregionais de outras jurisdições geralmente não são compatíveis.

Os endpoints multirregionais da API especificam a jurisdição como um subdomínio. Os endpoints públicos multirregionais têm o seguinte formato:

SERVICE.MULTIREGION.rep.googleapis.com

  • SERVICE: o nome do serviço Google Cloud , como storage, compute ou bigquery.
  • MULTIREGION: o nome da multirregião do Google Cloud , como us ou eu.

Os endpoints particulares multirregionais da API têm o seguinte formato:

SERVICE.MULTIREGION.p.rep.googleapis.com

  • SERVICE: o nome do serviço Google Cloud , como storage, compute ou bigquery.
  • MULTIREGION: o Google Cloud nome da multirregião, como us ou eu.
  • .p.: indica um destino particular destinado à conectividade do Private Service Connect.

Endpoints globais

Os endpoints globais da API não especificam o local no nome do host do URL. Esses endpoints de escopo global fornecem endpoints de serviço de alta disponibilidade que encerram a sessão TLS o mais próximo possível do cliente, o que minimiza a latência ao atender chamadas de API de uma população de clientes dispersa pela Internet. No entanto, esses endpoints não oferecem isolamento regional nem conformidade com a residência de dados.

Para aplicativos que podem processar dependências globais e precisam de desempenho rápido da rede global do Google, use endpoints globais.

Os endpoints globais têm o seguinte formato:

SERVICE.googleapis.com

Em que SERVICE é o nome do serviço Google Cloud , como storage, compute ou bigquery.

Endpoints de local

Os endpoints regionais da API estão substituindo os endpoints de local. Os endpoints de local são nomes de host de serviço regionais ou multirregionais que podem ser usados para acessar dados em um determinado local.

No entanto, os endpoints locais não são compatíveis com os seguintes recursos:

  • Conexões compatíveis com a residência de dados do local pela Internet
  • Isolamento de domínio de falha

Os endpoints regionais especificam o local no nome do host do URL e têm o seguinte formato:

LOCATION-SERVICE.googleapis.com

  • LOCATION: o nome da região Google Cloud , como us-central1, europe-west1 ou us.
  • SERVICE: o nome do serviço Google Cloud , como storage, compute ou bigquery.

Documentação de referência

A seguir