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, como bigquery.googleapis.com Google Cloud . Google Cloud Os serviços permitem o acesso a recursos usando diferentes tipos de endpoints de API, incluindo regionais, multirregionais, globais e de local. 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 Google Cloud serviços por um endpoint de API com escopo para uma única Google Cloud região. O tráfego enviado a um endpoint regional é processado e o TLS é encerrado totalmente na região especificada.

Para a maioria dos Google Cloud serviços, é 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 de API regionais 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 Google Cloud serviço, como storage, compute, ou bigquery.
  • REGION: onome da região, como us-central1 ou europe-west1. Google Cloud

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

SERVICE.REGION.p.rep.googleapis.com

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

Endpoints multirregionais

Os endpoints de API multirregionais fornecem acesso a Google Cloud serviços por um endpoint de API com escopo para um conjunto de Google Cloud regiões 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 o TLS é encerrado totalmente na jurisdição especificada.

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

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

SERVICE.MULTI_REGION.rep.googleapis.com

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

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

SERVICE.MULTI_REGION.p.rep.googleapis.com

  • SERVICE: o nome do Google Cloud serviço, como storage, compute, ou bigquery.
  • MULTI_REGION: 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 de API globais não especificam o local no nome do host do URL. Esses endpoints com 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 veicular chamadas de API de uma população de clientes dispersa pela Internet. No entanto, esses endpoints não fornecem isolamento regional ou 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, é possível usar endpoints globais.

Os endpoints globais têm o seguinte formato:

SERVICE.googleapis.com

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

Endpoints de local

Os endpoints de API regionais 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 de local não oferecem suporte aos seguintes recursos:

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

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

LOCATION-SERVICE.googleapis.com

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

Documentação de referência

A seguir