Data Catalog 资源托管在全球多个位置，这些位置被称为区域。区域是指您可以在其中访问资源的特定地理位置。如需了解详情，请参阅地理位置和区域。
为减少网络延迟，我们建议您使用靠近您的使用位置的区域 API 端点。例如，如果您计划从亚洲访问 Data Catalog，则可以使用台湾的端点。
支持的区域
| 区域 | 区域端点 | 支持的资源 | |
|---|---|---|---|
| 美洲 | |||
| 蒙特利尔 | northamerica-northeast1-datacatalog.googleapis.com |
标记模板、BigQuery、用户创建的条目、数据沿袭 | |
| 多伦多 | northamerica-northeast2-datacatalog.googleapis.com |
标记模板、用户创建的条目、数据沿袭 | |
| 圣保罗 | southamerica-east1-datacatalog.googleapis.com |
标记模板、BigQuery、用户创建的条目、数据沿袭 | |
| 圣地亚哥 | southamerica-west1-datacatalog.googleapis.com |
标记模板、BigQuery、用户创建的条目、数据沿袭 | |
| 爱荷华 | us-central1-datacatalog.googleapis.com |
标记模板、BigQuery、用户创建的条目、数据沿袭 | |
| 南卡罗来纳 | us-east1-datacatalog.googleapis.com |
标记模板、BigQuery、用户创建的条目、数据沿袭 | |
| 北弗吉尼亚 | us-east4-datacatalog.googleapis.com |
标记模板、BigQuery、用户创建的条目、数据沿袭 | |
| 哥伦布 | us-east5-datacatalog.googleapis.com |
标记模板、BigQuery、用户创建的条目、数据沿袭 | |
| 达拉斯 | us-south1-datacatalog.googleapis.com |
标记模板、BigQuery、用户创建的条目、数据沿袭 | |
| 北弗吉尼亚 | aws-us-east-1-datacatalog.googleapis.com、azure-eastus2-datacatalog.googleapis.com |
BigQuery（连接除外） | |
| 俄勒冈 | us-west1-datacatalog.googleapis.com |
标记模板、用户创建的条目、数据沿袭 | |
| 俄勒冈 | aws-us-west-2-datacatalog.googleapis.com |
BigQuery（连接除外） | |
| 洛杉矶 | us-west2-datacatalog.googleapis.com |
标记模板、BigQuery、用户创建的条目、数据沿袭 | |
| 盐湖城 | us-west3-datacatalog.googleapis.com |
标记模板、BigQuery、用户创建的条目、数据沿袭 | |
| 拉斯维加斯 | us-west4-datacatalog.googleapis.com |
标记模板、BigQuery、用户创建的条目、数据沿袭 | |
| 欧洲 | |||
| 华沙 | europe-central2-datacatalog.googleapis.com |
标记模板、BigQuery、用户创建的条目、数据沿袭 | |
| 芬兰 | europe-north1-datacatalog.googleapis.com |
标记模板、BigQuery、用户创建的条目、数据沿袭 | |
| 比利时 | europe-west1-datacatalog.googleapis.com |
标记模板、BigQuery、用户创建的条目、数据沿袭 | |
| 爱尔兰 | aws-eu-west-1-datacatalog.googleapis.com |
BigQuery（连接除外） | |
| 伦敦 | europe-west2-datacatalog.googleapis.com |
标记模板、BigQuery、用户创建的条目、数据沿袭 | |
| 法兰克福 | europe-west3-datacatalog.googleapis.com |
标记模板、BigQuery、用户创建的条目、数据沿袭 | |
| 荷兰 | europe-west4-datacatalog.googleapis.com |
标记模板、用户创建的条目、数据沿袭 | |
| 苏黎世 | europe-west6-datacatalog.googleapis.com |
标记模板、BigQuery、用户创建的条目、数据沿袭 | |
| 米兰 | europe-west8-datacatalog.googleapis.com |
标记模板、BigQuery、用户创建的条目、数据沿袭 | |
| 巴黎 | europe-west9-datacatalog.googleapis.com |
标记模板、BigQuery、用户创建的条目、数据沿袭 | |
| 柏林 | europe-west10-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目 | |
| 都灵 | europe-west12-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目 | |
| 马德里 | europe-southwest1-datacatalog.googleapis.com |
标记模板、BigQuery、用户创建的条目、数据沿袭 | |
| 亚太地区 | |||
| 中国台湾 | asia-east1-datacatalog.googleapis.com |
标记模板、BigQuery、用户创建的条目、数据沿袭 | |
| 香港 | asia-east2-datacatalog.googleapis.com |
标记模板、BigQuery、用户创建的条目、数据沿袭 | |
| 东京 | asia-northeast1-datacatalog.googleapis.com |
标记模板、BigQuery、用户创建的条目、数据沿袭 | |
| 大阪 | asia-northeast2-datacatalog.googleapis.com |
标记模板、BigQuery、用户创建的条目、数据沿袭 | |
| 首尔 | asia-northeast3-datacatalog.googleapis.com |
标记模板、BigQuery、用户创建的条目、数据沿袭 | |
| 首尔 | aws-ap-northeast-2-datacatalog.googleapis.com |
BigQuery（连接除外） | |
| 孟买 | asia-south1-datacatalog.googleapis.com |
标记模板、BigQuery、用户创建的条目、数据沿袭 | |
| 德里 | asia-south2-datacatalog.googleapis.com |
标记模板、BigQuery、用户创建的条目、数据沿袭 | |
| 新加坡 | asia-southeast1-datacatalog.googleapis.com |
标记模板、BigQuery、用户创建的条目、数据沿袭 | |
| 雅加达 | asia-southeast2-datacatalog.googleapis.com |
标记模板、BigQuery、用户创建的条目、数据沿袭 | |
| 悉尼 | australia-southeast1-datacatalog.googleapis.com |
标记模板、BigQuery、用户创建的条目、数据沿袭 | |
| 墨尔本 | australia-southeast2-datacatalog.googleapis.com |
标记模板、用户创建的条目、数据沿袭 | |
| 中东 | |||
| 多哈 | me-central1-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目 | |
| 达曼 | me-central2-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目 | |
| 特拉维夫 | me-west1-datacatalog.googleapis.com |
标记模板、BigQuery、用户创建的条目、数据沿袭 | |
| 非洲 | |||
| 约翰内斯堡 | africa-south1-datacatalog.googleapis.com |
代码模板、BigQuery、用户创建的条目 |
| 多区域 | 多区域端点 | 支持的资源 |
|---|---|---|
| 亚洲 | asia-datacatalog.googleapis.com |
标记模板、用户创建的条目、数据沿袭 |
| 欧盟 | eu-datacatalog.googleapis.com |
BigQuery、代码模板、用户创建的条目、数据沿袭 |
| 美国 | us-datacatalog.googleapis.com |
BigQuery、代码模板、用户创建的条目、数据沿袭 |
| BigQuery Omni 区域 | 区域端点 | 支持的资源 |
|---|---|---|
| AWS 亚太地区（首尔） | aws-ap-northeast-2-datacatalog.googleapis.com |
数据沿袭 |
| AWS 欧盟西部（爱尔兰） | aws-eu-west-1-datacatalog.googleapis.com |
数据沿袭 |
| AWS 美国东部（北弗吉尼亚） | aws-us-east-1-datacatalog.googleapis.com |
数据沿袭 |
| AWS 美国西部（俄勒冈） | aws-us-west-2-datacatalog.googleapis.com |
数据沿袭 |
| Azure 美国东部 2（弗吉尼亚） | azure-eastus2-datacatalog.googleapis.com |
数据沿袭 |
多区域（美国、欧盟）
eu 和 us 等多区域是特殊区域，Data Catalog 可以在这些区域中的任意位置复制和传送资源。
使用区域 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 客户端库已实现此功能。