API endpoint types
This page describes the different types of API endpoints that can be used in
Assured Workloads. An API endpoint (or service endpoint) is a URL
that specifies the network address of a Google Cloud API service, such as
bigquery.googleapis.com
. Google Cloud services allow access to resources using
different types of API endpoints, including global, locational, and regional
endpoints. Availability for each type depends on whether they are provided by a
given Google Cloud product or service.
All Assured Workloads control packages support global API endpoints. Support for locational and regional API endpoints varies across control packages.
Global API endpoints
A global API endpoint doesn't specify the location in the URL hostname. For example:
storage.googleapis.com
bigquery.googleapis.com
logging.googleapis.com
These globally scoped endpoints provide highly available service endpoints that terminate the TLS session as close to the client as possible, which minimizes latency when serving API calls from a dispersed client population over the internet.
Locational API endpoints
A locational API endpoint specifies the location in the URL hostname. For example:
us-west1-storage.googleapis.com
us-west1-bigquery.googleapis.com
us-west1-logging.googleapis.com
These locational endpoints offer benefits to customers who require the use of location-specific services, and want to ensure that in-transit data remains in a particular location when accessed through private connectivity.
Regional API endpoints
A regional API endpoint specifies the location as a subdomain. For example:
storage.us-west1.rep.googleapis.com
bigquery.us-west1.rep.googleapis.com
logging.us-west1.rep.googleapis.com
These regional endpoints offer the most benefits to customers who require the use of location-specific services, and want to have ways to ensure that in-transit data remains in a particular location when accessed through either private connectivity or the public internet.