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 verify 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 verify that in-transit data remains in a particular location when accessed through either private connectivity or the public internet.