Descripción general del extremo de API de Google Cloud

Un extremo de API, o extremo de servicio, es una URL que especifica la dirección de red de un Google Cloud servicio de API, como bigquery.googleapis.com. Google Cloud Los servicios permiten el acceso a los recursos mediante diferentes tipos de extremos de API, incluidos los regionales, multirregionales, globales y de ubicación. La compatibilidad con cada tipo de extremo depende del servicio.

En este documento, se describe brevemente cada tipo de extremo para aclarar en qué se diferencian y brindar orientación sobre qué tipo de extremo usar.

Extremos regionales

Los extremos de la API regional proporcionan acceso a Google Cloud los servicios a través de un extremo de API que se limita a una sola Google Cloud región. El tráfico que se envía a un extremo regional se procesa y finaliza con TLS por completo dentro de la región especificada.

Para la mayoría de los Google Cloud servicios, puedes usar extremos regionales para trabajar con recursos regionales dentro de la región especificada. Por lo general, las operaciones en recursos globales, recursos multirregionales y recursos regionales fuera de la región no son compatibles con el extremo regional.

Los extremos de la API regional especifican la ubicación como un subdominio. Los extremos regionales públicos tienen el siguiente formato:

SERVICE.REGION.rep.googleapis.com

  • SERVICE: el nombre del Google Cloud servicio, como storage, compute, o bigquery.
  • REGION: el nombre de la región, como us-central1 o europe-west1. Google Cloud

Los extremos de la API regional privada tienen el siguiente formato:

SERVICE.REGION.p.rep.googleapis.com

  • SERVICE: el nombre del Google Cloud servicio, como storage, compute, o bigquery.
  • REGION: el nombre de la región, como us-central1 o europe-west1. Google Cloud
  • .p.: indica un destino privado destinado a la conectividad de Private Service Connect.

Extremos multirregionales

Los extremos de la API multirregional proporcionan acceso a Google Cloud los servicios a través de un extremo de API que se limita a un conjunto de Google Cloud regiones dentro del mismo país, como Estados Unidos, India o Canadá, o jurisdicción, como la Unión Europea. El tráfico que se envía a un extremo multirregional se procesa y finaliza con TLS por completo dentro de la jurisdicción especificada.

Para la mayoría de los Google Cloud servicios, puedes usar extremos multirregionales para trabajar con recursos multirregionales dentro de la multirregión especificada. Por lo general, no se admiten las operaciones en recursos globales, recursos regionales y recursos multirregionales de otras jurisdicciones.

Los extremos de la API multirregional especifican la jurisdicción como un subdominio. Los extremos multirregionales públicos tienen el siguiente formato:

SERVICE.MULTIREGION.rep.googleapis.com

  • SERVICE: el nombre del Google Cloud servicio, como storage, compute, o bigquery.
  • MULTIREGION: el nombre de la multirregión, como us o eu. Google Cloud

Los extremos de la API multirregional privada tienen el siguiente formato:

SERVICE.MULTIREGION.p.rep.googleapis.com

  • SERVICE: el nombre del Google Cloud servicio, como storage, compute, o bigquery.
  • MULTIREGION: el Google Cloud nombre de la multirregión, como us o eu.
  • .p.: indica un destino privado destinado a la conectividad de Private Service Connect.

Extremos globales

Los extremos de la API global no especifican la ubicación en el nombre de host de la URL. Estos extremos de alcance global proporcionan extremos de servicio de alta disponibilidad que finalizan la sesión de TLS lo más cerca posible del cliente, lo que minimiza la latencia cuando se publican llamadas a la API desde una población de clientes dispersa a través de Internet. Sin embargo, estos extremos no proporcionan aislamiento regional ni cumplimiento de la residencia de datos.

Para las aplicaciones que pueden controlar las dependencias globales y necesitan un rendimiento rápido de la red global de Google, puedes usar extremos globales.

Los extremos globales tienen el siguiente formato:

SERVICE.googleapis.com

Donde SERVICE es el nombre del Google Cloud servicio, como storage, compute, o bigquery.

Extremos de ubicación

Los extremos de la API regional reemplazan a los extremos de ubicación. Los extremos de ubicación son nombres de host de servicios regionales o multirregionales que puedes usar para acceder a los datos en una ubicación determinada.

Sin embargo, los extremos de ubicación no admiten las siguientes funciones:

  • Conexiones compatibles con la residencia de datos desde las instalaciones locales a través de Internet
  • Aislamiento de dominios con fallas

Los extremos de ubicación especifican la ubicación en el nombre de host de la URL y tienen el siguiente formato:

LOCATION-SERVICE.googleapis.com

  • LOCATION: el nombre de la región, como us-central1, europe-west1, o us. Google Cloud
  • SERVICE: el nombre del Google Cloud servicio, como storage, compute, o bigquery.

Documentación de referencia

¿Qué sigue?