Data Catalog 在全球多个位置（称为“区域”）托管资源。区域是指您可以访问资源的特定地理位置。如需了解详情，请参阅地理位置和地区。
为减少网络延迟，我们建议您使用靠近您的使用位置的区域 API 端点。例如，如果您计划从亚洲访问 Data Catalog，则可以使用台湾的端点。
支持的区域
| 区域 | 区域端点 | 支持的资源 | |
|---|---|---|---|
| 非洲 | |||
| 约翰内斯堡 | africa-south1-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 美洲 | |||
| 哥伦布 | us-east5-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 达拉斯 | us-south1-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 爱荷华 | us-central1-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 拉斯维加斯 | us-west4-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 洛杉矶 | us-west2-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 墨西哥 | northamerica-south1-datacatalog.googleapis.com |
代码模板、用户创建的条目 | |
| 蒙特利尔 | northamerica-northeast1-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 北弗吉尼亚 | us-east4-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 俄勒冈 | us-west1-datacatalog.googleapis.com |
代码模板、用户创建的条目、数据谱系 | |
| 盐湖城 | us-west3-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 圣地亚哥 | southamerica-west1-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 圣保罗 | southamerica-east1-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 南卡罗来纳 | us-east1-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 多伦多 | northamerica-northeast2-datacatalog.googleapis.com |
代码模板、用户创建的条目、数据谱系 | |
| 亚太地区 | |||
| 德里 | asia-south2-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 香港 | asia-east2-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 雅加达 | asia-southeast2-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 墨尔本 | australia-southeast2-datacatalog.googleapis.com |
代码模板、用户创建的条目、数据谱系 | |
| 孟买 | asia-south1-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 大阪 | asia-northeast2-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 首尔 | asia-northeast3-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 新加坡 | asia-southeast1-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 悉尼 | australia-southeast1-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 台湾 | asia-east1-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 东京 | asia-northeast1-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 欧洲 | |||
| 比利时 | europe-west1-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 柏林 | europe-west10-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 芬兰 | europe-north1-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 法兰克福 | europe-west3-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 伦敦 | europe-west2-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 马德里 | europe-southwest1-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 米兰 | europe-west8-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 荷兰 | europe-west4-datacatalog.googleapis.com |
代码模板、用户创建的条目、数据谱系 | |
| 巴黎 | europe-west9-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 都灵 | europe-west12-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 华沙 | europe-central2-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 苏黎世 | europe-west6-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 中东 | |||
| Dammam* | me-central2-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 多哈 | me-central1-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 | |
| 特拉维夫 | me-west1-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目、数据传承 |
* 达曼设有特定于该区域的访问权限控制，详情请参阅此文档。
多区域（eu、us）
eu 和 us 等多区域也是特殊区域，Data Catalog 可以在这些区域内的任意位置复制和传送资源。
| 多区域 | 多区域端点 | 支持的资源 |
|---|---|---|
| 亚洲 | asia-datacatalog.googleapis.com |
代码模板、用户创建的条目、数据谱系 |
| 欧盟 | eu-datacatalog.googleapis.com |
BigQuery、代码模板、用户创建的条目、数据谱系 |
| 美国 | us-datacatalog.googleapis.com |
BigQuery、代码模板、用户创建的条目、数据谱系 |
BigQuery Omni 区域
| BigQuery Omni 区域 | 区域端点 | 支持的资源 | |
|---|---|---|---|
| AWS | |||
| AWS - 亚太地区（首尔） | aws-ap-northeast-2-datacatalog.googleapis.com |
BigQuery（连接除外）、数据传承 | |
| AWS - 亚太地区（悉尼） | aws-ap-southeast-2-datacatalog.googleapis.com |
BigQuery（连接除外）、数据传承 | |
| AWS - 欧洲（法兰克福） | aws-eu-central-1-datacatalog.googleapis.com |
BigQuery（连接除外）、数据传承 | |
| AWS - 欧洲（爱尔兰） | aws-eu-west-1-datacatalog.googleapis.com |
BigQuery（连接除外）、数据传承 | |
| AWS - 美国东部（北弗吉尼亚） | aws-us-east-1-datacatalog.googleapis.com |
BigQuery（连接除外）、数据传承 | |
| AWS - 美国西部（俄勒冈） | aws-us-west-2-datacatalog.googleapis.com |
BigQuery（连接除外）、数据传承 | |
| Azure | |||
| Azure - 美国东部 2（弗吉尼亚） | azure-eastus2-datacatalog.googleapis.com |
BigQuery（连接除外）、数据传承 | |
| Azure - 美国西部 2（华盛顿） | azure-westus2-datacatalog.googleapis.com |
数据沿袭 |
使用区域 API 访问资源
您可以使用区域端点来访问资源（请参阅支持的区域）。通过客户端库，您可以配置端点。
为了向后兼容，datacatalog.googleapis.com 端点支持区域 API，但存在一些限制。如需了解详情，请参阅 HTTP 批处理支持和 gRPC 支持。我们建议您为区域 API 使用区域端点。
非区域性 API
虽然数据资源位于特定区域，但 Data Catalog 搜索功能是全球范围的。SearchCatalog 和 LookupEntry 等非区域性 API 可返回来自所有地区的资源，并可通过 datacatalog.googleapis.com 端点访问。
HTTP 批处理支持
Data Catalog 支持 HTTP 批处理，允许您在单个请求中批量发送 API 调用。
将 HTTP 批处理用于区域 API 时存在一些限制：
- HTTP 批处理请求只能包含属于同一区域的资源的 API 请求。
- 在批处理区域 API 时，您必须使用区域端点。
datacatalog.googleapis.com不支持批处理区域 API。 区域性请求和非区域性请求不能一起批量处理。 - 非区域相关 API（
SearchCatalog和LookupEntry）可使用datacatalog.googleapis.com端点进行批处理。
如果您不确定自己是否在使用 HTTP 批处理，请执行以下操作：
- 检查您是否直接发出了路径设置为
/batch的 HTTP 请求，例如http://datacatalog.googleapis.com/batch。 如果您在使用 Google API 客户端库，请检查以下内容：
- Java：使用 BatchRequest 调用 API。
- Python：使用 BatchHTTP 请求调用 API。
- 其他库也存在类似的绑定关系（请参阅库专用文档）。
gRPC 支持
建议您在将 gRPC 用于区域 API 时使用区域端点。
如果您使用手动创建的 gRPC 库调用 datacatalog.googleapis.com 端点，则必须在请求中指定带有 locations=<region> 标记的 x-google-request-params 标头。在内部使用 gRPC 的现有 Cloud 客户端库已经指定了此值。