Stay organized with collections
Save and categorize content based on your preferences.
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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-03-05 UTC."],[[["API endpoints, which are URLs specifying the network address of a Google Cloud API service, can be global, locational, or regional."],["Global API endpoints, like `storage.googleapis.com`, do not specify a location and are designed for high availability and low latency for clients around the world."],["Locational API endpoints, such as `us-west1-storage.googleapis.com`, include the location in the hostname and are used by customers who require location-specific services and wish to keep in-transit data in a specific area."],["Regional API endpoints, exemplified by `storage.us-west1.rep.googleapis.com`, use a location subdomain and offer the greatest control for keeping in-transit data within a specific region, either via private connectivity or the internet."],["Assured Workloads control packages support global API endpoints, while support for locational and regional endpoints varies, with the availability of both locational and regional endpoints being limited across Google Cloud services."]]],[]]
