BigQuery regional endpoints
This page describes how you can usePrivate Service Connect regionalendpointsto access resources in BigQuery. Regional endpoints letyou run your workloads in a manner that complies withdataresidency and data sovereigntyrequirements, where your request traffic is routed directly to the regionspecified in the endpoint.
Overview
Regional endpoints are request endpoints that help restrict requests to proceedonly if the affected resource exists in the location specified by the endpoint.For example, if you use the endpointhttps://bigquery.us-central1.rep.googleapis.com in a delete datasetrequest, then the request only proceeds if the dataset is located inUS-CENTRAL1.
Unlike global endpoints, where requests can be routed through a differentlocation from where the resource resides, regional endpoints can help torestrict your requests to the location specified by the endpoint where theresource resides. Regional endpoints terminate TLS sessions in the locationspecified by the endpoint for requests received from the Internet, otherGoogle Cloud resources (such as Compute Engine virtual machines), on-premiseservices using VPN or Interconnect, and Virtual Private Clouds (VPCs).
Regional endpoints help to ensure data residency by keeping your at-rest andin-transit table data within the location specified by the endpoint. Thisexcludes resource metadata, such as dataset names andIAM policies. For more information, seeNote on servicedata.
BigQuery includes multiple APIs. The following APIs are availablefor use with regional endpoint:
| API | URL | Reference |
|---|---|---|
| BigQuery API | bigquery.LOCATION.rep.googleapis.com | REST |
| BigQuery Storage API | bigquerystorage.LOCATION.rep.googleapis.com | RPC |
| BigQuery Reservations API | bigqueryreservation.LOCATION.rep.googleapis.com | RPC andREST |
| BigQuery Migration API | bigquerymigration.LOCATION.rep.googleapis.com | REST |
| BigQuery Data Transfer Service API | bigquerydatatransfer.LOCATION.rep.googleapis.com | RPC andREST |
Supported locations
You can use regional endpoints to keep your data within the following locations:
Asia-Pacific
- Delhi
asia-south2 - Mumbai
asia-south1
- Delhi
Europe
- Belgium
europe-west1 - Frankfurt
europe-west3 - London
europe-west2 - Milan
europe-west8 - Paris
europe-west9 - Zürich
europe-west6
- Belgium
Middle East
- Dammam
me-central2
- Dammam
United States
- Iowa
us-central1 - South Carolina
us-east1 - Northern Virginia
us-east4 - Columbus, Ohio
us-east5 - Dallas
us-south1 - Oregon
us-west1 - Los Angeles
us-west2 - Salt Lake City
us-west3 - Las Vegas
us-west4
- Iowa
Supported operations
Regional endpoints can only be used to perform operations that access or mutateresources stored in the location specified by the endpoint.Regional endpoints cannot be used to perform operations that access or mutateresources outside of the location specified by the endpoint.
For example, when you use the regional endpointhttps://bigquery.us-central1.rep.googleapis.com, you can read tables indatasets located inUS-CENTRAL1, and copy a table from a source dataset to adestination dataset only when both datasets are located inUS-CENTRAL1. If youattempt to read or copy a table from outsideUS-CENTRAL1, you get anerror.
Limitations and restrictions
Regional endpoints cannot be used to perform the following operations:
- Operations that access or mutate resources outside of the location specifiedby the endpoint
- Copying, replicating, or rewriting resources from one location to another.
Keep in mind the following restrictions when using regional endpoints:
- Regional endpoints don't supportmutual Transport Layer Security (mTLS).
- Using a regional endpoint won't restrict the creation of resources outside ofthe endpoint region. To restrict resource creation, useOrganization Policy Serviceresource locations constraint.
- Cross-region dataset replication andcross-region table copyingaren't restricted by endpoint protection.
Tools for using regional endpoints
Console
To access BigQuery resources in a manner that's compliant withdata residency or sovereignty requirements, use the jurisdictionalGoogle Cloud console URLs:
| Resource | URL |
|---|---|
| Dataset list for a project | https://console.JURISDICTION.cloud.google.com/bigquery?project=PROJECT_ID |
| Table list for a dataset | https://console.JURISDICTION.cloud.google.com/bigquery/projects/PROJECT_ID/datasets/DATASET_NAME/tables |
| Details for a table | https://console.JURISDICTION.cloud.google.com/bigquery/projects/PROJECT_ID/datasets/DATASET_NAME/tables/TABLE_NAME |
ReplaceJURISDICTION with one of the followingvalues:
euif the resource is located in the European Unionsaif the resource is located in the Kingdom of Saudi Arabiausif the resource is located in the United States
eu,sa, orus.Command line
To configure the Google Cloud CLI for use with regional endpoints,complete the following steps:
Make sure you're using the Google Cloud CLI 402.0.0 or newer.
Set the
api_endpoint_overrides/bigqueryproperty to the regionalendpoint you want to use:gcloud config set api_endpoint_overrides/bigquery https://bigquery.LOCATION.rep.googleapis.com/bigquery/v2/
Alternatively, you can set the
CLOUDSDK_API_ENDPOINT_OVERRIDES_BIGQUERYenvironment variable to theendpoint:CLOUDSDK_API_ENDPOINT_OVERRIDES_BIGQUERY=https://bigquery.LOCATION.rep.googleapis.com/bigquery/v2/ gcloud alpha bq datasets list
REST APIs
For REST API, instead of sending a REST request to aservice endpoint, send therequest to the regional endpoint in the following format:https://bigquery.LOCATION.rep.googleapis.com.
Restrict global API endpoint usage
To help enforce the use of regional endpoints, use theconstraints/gcp.restrictEndpointUsage organization policy constraint to blockrequests to the global API endpoint. For more information, seeRestricting endpoint usage.
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-12-15 UTC.