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 servicio de la API de Google Cloud , como bigquery.googleapis.com. Los servicios deGoogle Cloud permiten el acceso a los recursos a través de 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 sus diferencias y brindar orientación sobre qué tipo de extremo usar.

Extremos regionales

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

En la mayoría de los servicios de Google Cloud , 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 se admiten desde el extremo regional.

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

SERVICE.REGION.rep.googleapis.com

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

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

SERVICE.REGION.p.rep.googleapis.com

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

Extremos multirregionales

Los extremos de API multirregionales proporcionan acceso a los servicios de Google Cloud a través de un extremo de API que se limita a un conjunto de regiones de Google Cloud 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.

En la mayoría de los servicios de Google Cloud , 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, regionales y multirregionales de otras jurisdicciones.

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

SERVICE.MULTI_REGION.rep.googleapis.com

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

Los extremos de API multirregionales privados tienen el siguiente formato:

SERVICE.MULTI_REGION.p.rep.googleapis.com

  • SERVICE: Es el nombre del servicio de Google Cloud , como storage, compute o bigquery.
  • MULTI_REGION: El Google Cloud nombre de la multirregión, como us o eu.
  • .p.: Indica un destino privado previsto para 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 con 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

Aquí SERVICE es el nombre del servicio de Google Cloud , como storage, compute o bigquery.

Extremos de ubicación

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

Sin embargo, los extremos locales no admiten las siguientes funciones:

  • Conexiones que cumplen con la residencia de datos desde las instalaciones locales a través de Internet
  • Aislamiento del dominio de falla

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 de Google Cloud , como us-central1, europe-west1 o us.
  • SERVICE: Es el nombre del servicio de Google Cloud , como storage, compute o bigquery.

Documentación de referencia

¿Qué sigue?