限制端点用量

本页面简要介绍了限制端点用量 组织政策限制条件,该限制条件可让企业管理员控制可以在其 Google Cloud 资源层次结构中使用哪些 Google Cloud API 端点。

管理员可以使用此限制条件来定义对允许的 Google Cloud API 端点(例如全球、位置或区域端点)的分层限制。例如,您可以将项目配置为拒绝向全局 bigquery.googleapis.com 端点发送的请求,但允许向位置性 LOCATION-bigquery.googleapis.com 端点发送的请求。通过限制全球 API 端点的使用,组织可以确保仅使用允许的位置或区域端点,从而满足合规性要求。

“限制端点使用”限制条件通过禁止列表进行设置,允许向未明确禁止的任何受支持服务的 API 端点发出请求。

此限制条件会控制对所有范围内资源的运行时访问权限。包含此限制条件的组织政策更新后,会立即应用于该政策范围内的所有资源,但最终会保持一致。

我们建议管理员谨慎管理包含此限制条件的组织政策的更新。例如,您应考虑在试运行模式下设置政策,以监控政策变更在强制执行之前会对现有工作流程产生何种影响。

API 端点类型

API 端点(或服务端点)是指定 Google Cloud API 服务(例如 bigquery.googleapis.com)的网络地址的网址。Google Cloud 服务允许使用不同类型的 API 端点(包括全球端点、位置端点和区域端点)访问资源。对每种类型的支持取决于服务。

  • 全球 API 端点不会在网址主机名中指定位置。 例如:

    • storage.googleapis.com
    • content-bigqueryconnection.googleapis.com
    • bigquerydatatransfer.mtls.googleapis.com
    • logging.googleapis.com

    这些全局范围的端点提供高可用性服务端点,可尽可能靠近客户端终止 TLS 会话,从而最大限度地减少通过互联网为分散的客户端群体提供 API 调用服务时的延迟。

  • 位置 API 端点在网址主机名中指定位置。例如:

    • us-storage.googleapis.com
    • content-us-west3-bigqueryconnection.googleapis.com
    • us-west1-bigquerydatatransfer.mtls.googleapis.com
    • us-central1-logging.googleapis.com

    对于需要使用特定位置的服务并希望确保通过专用连接访问的传输中数据保留在特定位置的客户,这些位置端点可带来诸多好处。

  • 区域 API 端点将位置指定为子网域。例如:

    • storage.us-east2.rep.googleapis.com
    • content-bigqueryconnection.us-west3.rep.googleapis.com
    • bigquerydatatransfer.us-west1.rep.mtls.googleapis.com
    • logging.us-central1.rep.googleapis.com

    对于需要使用特定位置服务的客户,这些区域端点可提供最大优势,并可帮助客户确保通过专用连接或公共互联网访问的传输中数据始终保留在特定位置。

限制

“限制端点用量”限制条件用于控制使用特定 API 端点访问资源的能力。请勿将其与其他类似限制混淆,例如:

为了避免破坏现有的服务基础架构,您应该先在非生产项目和文件夹中测试任何新的组织政策,然后再将该政策逐步应用于整个组织。

该限制适用于一部分特定的产品和资源类型。如需查看支持的服务列表以及每项服务的行为详细信息,请参阅支持的 API 端点部分。

如需了解数据存储承诺,请参阅Google Cloud 服务条款服务专用条款。包含“限制端点用量”限制条件的组织政策不是数据留存承诺。

设置组织政策

要设置、更改或删除组织政策,您必须拥有组织政策管理员角色。

组织政策限制条件可以在组织、文件夹和项目级层进行设置。每项政策都适用于其相应资源层次结构中的所有资源,但可能会在该资源层次结构的较低级层被替换。

如需详细了解政策评估,请参阅了解层次结构评估

“限制端点用量”限制条件是一种列表限制条件。您可以通过限制条件的 denied_values 列表添加和移除端点。

控制台

  1. 前往 Google Cloud 控制台中的组织政策页面。

    转到组织政策

  2. 项目选择器中,选择要为其设置组织政策的组织、文件夹或项目。

  3. 在组织政策表中,选择限制端点使用以打开其政策详情页面。

  4. 点击管理政策

  5. 应用对象下,选择自定义

  6. 政策执行下,选择此政策的继承方式。

    1. 如果要继承父资源的组织政策并将其与此政策合并,请选择与父资源规则合并

    2. 如果您要替换任何现有组织政策,请选择替换

  7. 点击添加规则

  8. 政策值下方,选择自定义

  9. 政策类型下,选择拒绝以创建拒绝端点列表。

  10. 自定义值下,将您要阻止的 API 端点主机名添加到列表中。

    1. 例如,如需屏蔽 BigQuery 的全局 API 端点,请输入 bigquery.googleapis.com

    2. 如需添加更多端点,请点击添加值

  11. 如需执行政策,请点击保存

gcloud

您可以通过 gcloud resource-manager org-policies set-policy 命令设置组织政策。如需强制执行包含限制端点使用限制条件的组织政策,请先创建一个包含要更新的政策的 YAML 文件:

constraint: constraints/gcp.restrictEndpointUsage
listPolicy:
    deniedValues:
    - storage.googleapis.com
    - content-bigqueryreservation.googleapis.com
    - bigquerystorage.mtls.googleapis.com
    - logging.googleapis.com

在运行命令之前,请将以下占位值替换为您自己的值:

  • RESOURCE_TYPE:资源类型,可以是项目或文件夹。例如 project
  • RESOURCE_ID:项目或文件夹的资源 ID。例如 8767234
gcloud resource-manager org-policies set-policy \
--RESOURCE_TYPE='RESOURCE_ID' /tmp/policy.yaml

响应中包含新设置的组织政策:

constraint: constraints/gcp.restrictEndpointUsage
etag: CKCRl6oGEPjG-tMB
listPolicy:
  deniedValues:
  - storage.googleapis.com
  - content-bigqueryreservation.googleapis.com
  - bigquerystorage.mtls.googleapis.com
  - logging.googleapis.com
updateTime: '2023-11-04T04:29:20.444507Z'

如果对被拒绝的 API 端点的请求尝试访问资源,则该请求将失败,并且系统会返回一条错误消息,说明失败的原因。

在试运行模式下创建组织政策

处于试运行模式的组织政策是一种组织政策,违反该政策的行为会被记录在审核日志中,但不会被拒绝。您可以使用限制端点用量限制条件以试运行模式创建组织政策,以便在强制执行实际政策之前,监控该政策对组织的影响。如需了解详情,请参阅以试运行模式创建组织政策

错误消息

如果您设置了一项组织政策来拒绝某个端点,则在资源层次结构中使用该端点的操作会失败。系统会返回错误消息,说明失败的原因,此外还会生成一个审核日志条目以进一步监控、提醒或调试。

错误消息示例

在以下示例中,使用 API 端点 storage.googleapis.com 的 curl 请求因违反政策而失败:

curl -X GET \
-H "Authorization: Bearer OAUTH2_TOKEN" \
-o "SAVE_TO_LOCATION" \
"https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME?alt=media"

Access to projects/foo-123 through endpoint storage.googleapis.com was denied by
the constraints/gcp.restrictEndpointUsage organization policy constraint. To
access this resource, please use an allowed endpoint.

审核日志条目示例

以下示例审核日志条目展示了资源访问权限被拒绝的情况:

{
  logName: "projects/my-projectid/logs/cloudaudit.googleapis.com%2Fpolicy"
  protoPayload: {
    @type: "type.googleapis.com/google.cloud.audit.AuditLog"
    status: {
      code: 7
      message: "Access to projects/my-projectid through endpoint bigquery.googleapis.com was denied by the constraints/gcp.restrictEndpointUsage organization policy constraint. To access this resource, please use an allowed endpoint."
    }
    serviceName: "bigquery.googleapis.com"
    methodName: "google.cloud.bigquery.v2.TableDataService.InsertAll"
    resourceName: "projects/my-projectid"
    authenticationInfo: {
      principalEmail: "user_or_service_account@example.com"
    }
  }
  requestMetadata: {
    callerIp: "123.123.123.123"
  }
  policyViolationInfo: {
    orgPolicyViolationInfo: {
      violationInfo: [
        {
          constraint: "constraints/gcp.restrictEndpointUsage"
          checkedValue: "bigquery.googleapis.com"
          policyType: LIST_CONSTRAINT
        }
      ]
    }
  }
  resource: {
    type: "audited_resource"
    labels: {
      project_id: "224034263908"
      method: "google.cloud.bigquery.v2.TableDataService.InsertAll"
      service: "bigquery.googleapis.com"
    }
  }
  severity: "ERROR"
  timestamp: "2024-12-05T01:15:30.332519510Z"
  receiveTimestamp: "2024-08-15T17:55:01.159788588Z"
  insertId: "42"
}

支持的 API 端点

“限制端点使用情况”限制条件支持下表中列出的产品的 API 端点。

对于每款产品,该表都提供了主要全球 API 端点。不过,每款产品可能还支持其全局 API 端点的 SERVICE_NAME.mtls.googleapis.com 变体或 content-SERVICE_NAME.googleapis.com 变体,例如 pubsub.mtls.googleapis.comcontent-pubsub.googleapis.com。如需限制产品全球 API 端点的所有变体,您可以使用值组。此外,“限制端点使用”限制条件还支持这些产品的区域和位置 API 端点。请参阅产品的 API 文档,确定可用的全球、位置和区域端点的完整列表。

产品 API 端点 备注
API Gateway 全球 API 端点:
  • apigateway.googleapis.com

API 密钥 全球 API 端点:
  • apikeys.googleapis.com

Access Approval 全球 API 端点:
  • accessapproval.googleapis.com

Access Context Manager 全球 API 端点:
  • accesscontextmanager.googleapis.com

Google Agentspace 全球 API 端点:
  • discoveryengine.googleapis.com


位置信息 API 端点:
  • us-discoveryengine.googleapis.com
  • eu-discoveryengine.googleapis.com

Apigee API Hub 全球 API 端点:
  • apihub.googleapis.com

Apigee API Management API 全球 API 端点:
  • apim.googleapis.com

Apigee Connect API 全球 API 端点:
  • apigeeconnect.googleapis.com

Apigee portal API 全球 API 端点:
  • apigeeportal.googleapis.com

Apigee Registry API 全球 API 端点:
  • apigeeregistry.googleapis.com

App Config Manager API 全球 API 端点:
  • appconfigmanager.googleapis.com

App Design Center 全球 API 端点:
  • designcenter.googleapis.com

Application Integration 全球 API 端点:
  • integrations.googleapis.com

Artifact Analysis 全球 API 端点:
  • containeranalysis.googleapis.com
  • ondemandscanning.googleapis.com

Artifact Registry 全球 API 端点:
  • artifactregistry.googleapis.com

有保障的开源软件 全球 API 端点:
  • assuredoss.googleapis.com

Assured Workloads 全球 API 端点:
  • assuredworkloads.googleapis.com

Audit Manager 全球 API 端点:
  • auditmanager.googleapis.com

Authorization Toolkit API 全球 API 端点:
  • authztoolkit.googleapis.com

备份和灾难恢复服务 全球 API 端点:
  • backupdr.googleapis.com

Backup for GKE 全球 API 端点:
  • gkebackup.googleapis.com

Batch 全球 API 端点:
  • batch.googleapis.com

Chrome 企业进阶版 全球 API 端点:
  • beyondcorp.googleapis.com

BigLake 全球 API 端点:
  • biglake.googleapis.com

BigQuery 连接 全球 API 端点:
  • bigqueryconnection.googleapis.com

BigQuery Data Policy 全球 API 端点:
  • bigquerydatapolicy.googleapis.com

BigQuery Data Transfer 全球 API 端点:
  • bigquerydatatransfer.googleapis.com

BigQuery 迁移 全球 API 端点:
  • bigquerymigration.googleapis.com

BigQuery Reservation 全球 API 端点:
  • bigqueryreservation.googleapis.com

BigQuery Saved Query API 全球 API 端点:
  • bigquery-sq.googleapis.com

BigQuery 存储 全球 API 端点:
  • bigquerystorage.googleapis.com

BigQuery 全球 API 端点:
  • bigquery.googleapis.com
  • www.googleapis.com (BigQuery)

www.googleapis.com/.../bigquery/... 是旧版 API 端点格式。您的组织应改用较新的 API。您可以向“限制端点用量”政策限制条件添加 www.googleapis.com (BigQuery),以避免意外使用旧版 API。
Binary Authorization 全球 API 端点:
  • binaryauthorization.googleapis.com

区块链分析 全球 API 端点:
  • blockchain.googleapis.com

Blockchain Node Engine 全球 API 端点:
  • blockchainnodeengine.googleapis.com

Blockchain Validator Manager 全球 API 端点:
  • blockchainvalidatormanager.googleapis.com

容量规划工具 全球 API 端点:
  • capacityplanner.googleapis.com

Certificate Authority Service 全球 API 端点:
  • privateca.googleapis.com

Certificate Manager 全球 API 端点:
  • certificatemanager.googleapis.com

Cloud Asset Inventory 全球 API 端点:
  • cloudasset.googleapis.com

Cloud Billing 全球 API 端点:
  • cloudbilling.googleapis.com

Cloud Build 全球 API 端点:
  • cloudbuild.googleapis.com

Cloud CDN 全球 API 端点:
  • compute.googleapis.com

Cloud Commerce Producer API 全球 API 端点:
  • cloudcommerceproducer.googleapis.com

Cloud Controls Partner API 全球 API 端点:
  • cloudcontrolspartner.googleapis.com

Cloud DNS 全球 API 端点:
  • dns.googleapis.com

Cloud Data Fusion 全球 API 端点:
  • datafusion.googleapis.com

Cloud Deployment Manager 全球 API 端点:
  • runtimeconfig.googleapis.com
  • deploymentmanager.googleapis.com

Cloud Domains 全球 API 端点:
  • domains.googleapis.com

Cloud Healthcare API 全球 API 端点:
  • healthcare.googleapis.com

Cloud Interconnect 全球 API 端点:
  • compute.googleapis.com

Cloud Intrusion Detection System 全球 API 端点:
  • ids.googleapis.com

Cloud Key Management Service 全球 API 端点:
  • cloudkms.googleapis.com

Cloud Life Sciences 全球 API 端点:
  • lifesciences.googleapis.com

Cloud Load Balancing 全球 API 端点:
  • compute.googleapis.com

Cloud Logging 全球 API 端点:
  • logging.googleapis.com

Cloud Monitoring 全球 API 端点:
  • monitoring.googleapis.com

Cloud NAT 全球 API 端点:
  • compute.googleapis.com

Cloud Natural Language API 全球 API 端点:
  • language.googleapis.com

Cloud Next Generation Firewall Enterprise 全球 API 端点:
  • networksecurity.googleapis.com

Cloud 新一代防火墙基本功能版 全球 API 端点:
  • compute.googleapis.com
  • networksecurity.googleapis.com

Cloud 新一代防火墙标准版 全球 API 端点:
  • compute.googleapis.com
  • networksecurity.googleapis.com

Cloud OS Login API 全球 API 端点:
  • oslogin.googleapis.com

Cloud Router 全球 API 端点:
  • compute.googleapis.com

Cloud Run 全球 API 端点:
  • run.googleapis.com

Cloud SQL 全球 API 端点:
  • sqladmin.googleapis.com

Cloud Service Mesh 全球 API 端点:
  • meshconfig.googleapis.com
  • networksecurity.googleapis.com
  • networkservices.googleapis.com
  • trafficdirector.googleapis.com

Spanner 全球 API 端点:
  • spanner.googleapis.com

Cloud Storage 全球 API 端点:
  • storage.googleapis.com
  • storage-download.googleapis.com
  • storage-upload.googleapis.com
  • www.googleapis.com (Cloud Storage)

端点 storage-download.googleapis.comstorage-upload.googleapis.comwww.googleapis.com/.../storage/... 是旧版 API 端点格式。您的组织应改用较新的 storage.googleapis.com API 端点。为防止意外使用旧版 API,您可以将 storage-download.googleapis.comstorage-upload.googleapis.comwww.googleapis.com (Cloud Storage) 添加到“限制端点使用情况”政策限制条件的禁止名单中。

使用位置端点时,不支持某些 Cloud Storage 操作。如需了解详情,请参阅位置端点。如果您已配置“限制端点用量”限制条件来限制全局端点,则可以使用 Google Cloud 控制台执行这些操作。这些操作不会携带数据留存服务条款中定义的客户数据,您可以在 Google Cloud 控制台中使用它们,而不会违反 ITAR 合规性要求。

目前不支持全球端点的虚拟托管样式端点(例如 https://BUCKET_NAME.storage.googleapis.com)。

Cloud Support API 全球 API 端点:
  • cloudsupport.googleapis.com

Cloud Tool Results API 全球 API 端点:
  • toolresults.googleapis.com

Cloud VPN 全球 API 端点:
  • compute.googleapis.com

Cloud Workstations 全球 API 端点:
  • workstations.googleapis.com

Commerce Agreement Publishing API 全球 API 端点:
  • commerceagreementpublishing.googleapis.com

Commerce Business Enablement API 全球 API 端点:
  • commercebusinessenablement.googleapis.com

Commerce Price Management API 全球 API 端点:
  • commercepricemanagement.googleapis.com

Compute Engine 全球 API 端点:
  • compute.googleapis.com

机密计算 全球 API 端点:
  • confidentialcomputing.googleapis.com

关联 全球 API 端点:
  • gkeconnect.googleapis.com

Connect 网关 全球 API 端点:
  • connectgateway.googleapis.com

Contact Center AI Platform API 全球 API 端点:
  • contactcenteraiplatform.googleapis.com

Container Threat Detection 全球 API 端点:
  • containerthreatdetection.googleapis.com

Content Warehouse API 全球 API 端点:
  • contentwarehouse.googleapis.com

Continuous Validation API 全球 API 端点:
  • continuousvalidation.googleapis.com

Data Labeling API 全球 API 端点:
  • datalabeling.googleapis.com

Data Security Posture Management API 全球 API 端点:
  • dspm.googleapis.com

数据库迁移服务 全球 API 端点:
  • datamigration.googleapis.com

Dataform 全球 API 端点:
  • dataform.googleapis.com

Dataflow 全球 API 端点:
  • dataflow.googleapis.com

Dataplex Universal Catalog 全球 API 端点:
  • dataplex.googleapis.com
  • datalineage.googleapis.com

Dataproc 全球 API 端点:
  • dataproc.googleapis.com

Dataproc on GDC 全球 API 端点:
  • dataprocgdc.googleapis.com

Google Distributed Cloud 全球 API 端点:
  • opsconfigmonitoring.googleapis.com
  • gdcvmmanager.googleapis.com
  • gdchardwaremanagement.googleapis.com

Distributed Cloud Edge Container API 全球 API 端点:
  • edgecontainer.googleapis.com

Distributed Cloud Edge Network API 全球 API 端点:
  • edgenetwork.googleapis.com

Document AI 全球 API 端点:
  • documentai.googleapis.com


位置信息 API 端点:
  • us-documentai.googleapis.com
  • eu-documentai.googleapis.com
  • europe-west2-documentai.googleapis.com
  • europe-west3-documentai.googleapis.com
  • asia-south1-documentai.googleapis.com
  • asia-southeast1-documentai.googleapis.com
  • australia-southeast1-documentai.googleapis.com
  • northamerica-northeast1-documentai.googleapis.com

Enterprise Knowledge Graph 全球 API 端点:
  • enterpriseknowledgegraph.googleapis.com

Error Reporting 全球 API 端点:
  • clouderrorreporting.googleapis.com

重要联系人 全球 API 端点:
  • essentialcontacts.googleapis.com

Eventarc API 全球 API 端点:
  • eventarc.googleapis.com

Filestore 全球 API 端点:
  • file.googleapis.com

Firestore 全球 API 端点:
  • firestore.googleapis.com


位置信息 API 端点:
  • africa-south1-firestore.googleapis.com
  • asia-east1-firestore.googleapis.com
  • asia-east2-firestore.googleapis.com
  • asia-northeast1-firestore.googleapis.com
  • asia-northeast2-firestore.googleapis.com
  • asia-northeast3-firestore.googleapis.com
  • asia-south1-firestore.googleapis.com
  • asia-south2-firestore.googleapis.com
  • asia-southeast1-firestore.googleapis.com
  • asia-southeast2-firestore.googleapis.com
  • australia-southeast1-firestore.googleapis.com
  • australia-southeast2-firestore.googleapis.com
  • eur3-firestore.googleapis.com
  • europe-central2-firestore.googleapis.com
  • europe-north1-firestore.googleapis.com
  • europe-north2-firestore.googleapis.com
  • europe-southwest1-firestore.googleapis.com
  • europe-west1-firestore.googleapis.com
  • europe-west2-firestore.googleapis.com
  • europe-west3-firestore.googleapis.com
  • europe-west4-firestore.googleapis.com
  • europe-west6-firestore.googleapis.com
  • europe-west8-firestore.googleapis.com
  • europe-west9-firestore.googleapis.com
  • europe-west10-firestore.googleapis.com
  • europe-west12-firestore.googleapis.com
  • me-central1-firestore.googleapis.com
  • me-central2-firestore.googleapis.com
  • me-west1-firestore.googleapis.com
  • nam5-firestore.googleapis.com
  • nam7-firestore.googleapis.com
  • northamerica-northeast1-firestore.googleapis.com
  • northamerica-northeast2-firestore.googleapis.com
  • northamerica-south1-firestore.googleapis.com
  • southamerica-east1-firestore.googleapis.com
  • southamerica-west1-firestore.googleapis.com
  • us-central1-firestore.googleapis.com
  • us-east1-firestore.googleapis.com
  • us-east4-firestore.googleapis.com
  • us-east5-firestore.googleapis.com
  • us-south1-firestore.googleapis.com
  • us-west1-firestore.googleapis.com
  • us-west2-firestore.googleapis.com
  • us-west3-firestore.googleapis.com
  • us-west4-firestore.googleapis.com

Datastore 模式的 Firestore (Datastore) 全球 API 端点:
  • datastore.googleapis.com


位置信息 API 端点:
  • africa-south1-datastore.googleapis.com
  • asia-east1-datastore.googleapis.com
  • asia-east2-datastore.googleapis.com
  • asia-northeast1-datastore.googleapis.com
  • asia-northeast2-datastore.googleapis.com
  • asia-northeast3-datastore.googleapis.com
  • asia-south1-datastore.googleapis.com
  • asia-south2-datastore.googleapis.com
  • asia-southeast1-datastore.googleapis.com
  • asia-southeast2-datastore.googleapis.com
  • australia-southeast1-datastore.googleapis.com
  • australia-southeast2-datastore.googleapis.com
  • eur3-datastore.googleapis.com
  • europe-central2-datastore.googleapis.com
  • europe-north1-datastore.googleapis.com
  • europe-north2-datastore.googleapis.com
  • europe-southwest1-datastore.googleapis.com
  • europe-west1-datastore.googleapis.com
  • europe-west2-datastore.googleapis.com
  • europe-west3-datastore.googleapis.com
  • europe-west4-datastore.googleapis.com
  • europe-west6-datastore.googleapis.com
  • europe-west8-datastore.googleapis.com
  • europe-west9-datastore.googleapis.com
  • europe-west10-datastore.googleapis.com
  • europe-west12-datastore.googleapis.com
  • me-central1-datastore.googleapis.com
  • me-central2-datastore.googleapis.com
  • me-west1-datastore.googleapis.com
  • nam5-datastore.googleapis.com
  • nam7-datastore.googleapis.com
  • northamerica-northeast1-datastore.googleapis.com
  • northamerica-northeast2-datastore.googleapis.com
  • northamerica-south1-datastore.googleapis.com
  • southamerica-east1-datastore.googleapis.com
  • southamerica-west1-datastore.googleapis.com
  • us-central1-datastore.googleapis.com
  • us-east1-datastore.googleapis.com
  • us-east4-datastore.googleapis.com
  • us-east5-datastore.googleapis.com
  • us-south1-datastore.googleapis.com
  • us-west1-datastore.googleapis.com
  • us-west2-datastore.googleapis.com
  • us-west3-datastore.googleapis.com
  • us-west4-datastore.googleapis.com

Financial Services API 全球 API 端点:
  • financialservices.googleapis.com

Firebase App Hosting 全球 API 端点:
  • firebaseapphosting.googleapis.com

Firebase Data Connect 全球 API 端点:
  • firebasedataconnect.googleapis.com

Firebase 安全规则 全球 API 端点:
  • firebaserules.googleapis.com

Vertex AI 上的生成式 AI 全球 API 端点:
  • aiplatform.googleapis.com


位置信息 API 端点:
  • africa-south1-aiplatform.googleapis.com
  • asia-east1-aiplatform.googleapis.com
  • asia-east2-aiplatform.googleapis.com
  • asia-northeast1-aiplatform.googleapis.com
  • asia-northeast2-aiplatform.googleapis.com
  • asia-northeast3-aiplatform.googleapis.com
  • asia-south1-aiplatform.googleapis.com
  • asia-south2-aiplatform.googleapis.com
  • asia-southeast1-aiplatform.googleapis.com
  • asia-southeast2-aiplatform.googleapis.com
  • australia-southeast1-aiplatform.googleapis.com
  • australia-southeast2-aiplatform.googleapis.com
  • europe-central2-aiplatform.googleapis.com
  • europe-north1-aiplatform.googleapis.com
  • europe-southwest1-aiplatform.googleapis.com
  • europe-west1-aiplatform.googleapis.com
  • europe-west2-aiplatform.googleapis.com
  • europe-west3-aiplatform.googleapis.com
  • europe-west4-aiplatform.googleapis.com
  • europe-west6-aiplatform.googleapis.com
  • europe-west8-aiplatform.googleapis.com
  • europe-west9-aiplatform.googleapis.com
  • europe-west12-aiplatform.googleapis.com
  • me-central1-aiplatform.googleapis.com
  • me-central2-aiplatform.googleapis.com
  • me-west1-aiplatform.googleapis.com
  • northamerica-northeast1-aiplatform.googleapis.com
  • northamerica-northeast2-aiplatform.googleapis.com
  • southamerica-east1-aiplatform.googleapis.com
  • southamerica-west1-aiplatform.googleapis.com
  • us-central1-aiplatform.googleapis.com
  • us-east1-aiplatform.googleapis.com
  • us-east4-aiplatform.googleapis.com
  • us-east5-aiplatform.googleapis.com
  • us-south1-aiplatform.googleapis.com
  • us-west1-aiplatform.googleapis.com
  • us-west2-aiplatform.googleapis.com
  • us-west3-aiplatform.googleapis.com
  • us-west4-aiplatform.googleapis.com

GKE Dataplane Management 全球 API 端点:
  • gkedataplanemanagement.googleapis.com

GKE Enterprise Edge API 全球 API 端点:
  • anthosedge.googleapis.com

Hub(舰队) 全球 API 端点:
  • gkehub.googleapis.com

GKE Multi-cloud 全球 API 端点:
  • gkemulticloud.googleapis.com

GKE On-Prem API 全球 API 端点:
  • gkeonprem.googleapis.com

Gemini for Google Cloud API 全球 API 端点:
  • cloudaicompanion.googleapis.com

Google Cloud API 全球 API 端点:
  • cloud.googleapis.com

Google Cloud Armor 全球 API 端点:
  • compute.googleapis.com

Google Cloud Migration Center 全球 API 端点:
  • migrationcenter.googleapis.com

Google Cloud Observability 全球 API 端点:
  • stackdriver.googleapis.com

Google Kubernetes Engine 全球 API 端点:
  • container.googleapis.com
  • configdelivery.googleapis.com

Google Security Operations Partner API 全球 API 端点:
  • chroniclepartner.googleapis.com

Google Security Operations 不支持限制全球 API 端点。

位置信息 API 端点:
  • africa-south1-chronicle.googleapis.com
  • asia-northeast1-chronicle.googleapis.com
  • asia-south1-chronicle.googleapis.com
  • asia-southeast1-chronicle.googleapis.com
  • asia-southeast2-chronicle.googleapis.com
  • australia-southeast1-chronicle.googleapis.com
  • eu-chronicle.googleapis.com
  • europe-west12-chronicle.googleapis.com
  • europe-west2-chronicle.googleapis.com
  • europe-west3-chronicle.googleapis.com
  • europe-west6-chronicle.googleapis.com
  • europe-west9-chronicle.googleapis.com
  • me-central1-chronicle.googleapis.com
  • me-central2-chronicle.googleapis.com
  • me-west1-chronicle.googleapis.com
  • northamerica-northeast2-chronicle.googleapis.com
  • southamerica-east1-chronicle.googleapis.com
  • us-chronicle.googleapis.com

区域 API 端点:
  • chronicle.africa-south1.rep.googleapis.com
  • chronicle.asia-northeast1.rep.googleapis.com
  • chronicle.asia-south1.rep.googleapis.com
  • chronicle.asia-southeast1.rep.googleapis.com
  • chronicle.asia-southeast2.rep.googleapis.com
  • chronicle.australia-southeast1.rep.googleapis.com
  • chronicle.eu.rep.googleapis.com
  • chronicle.europe-west12.rep.googleapis.com
  • chronicle.europe-west2.rep.googleapis.com
  • chronicle.europe-west3.rep.googleapis.com
  • chronicle.europe-west6.rep.googleapis.com
  • chronicle.europe-west9.rep.googleapis.com
  • chronicle.me-central1.rep.googleapis.com
  • chronicle.me-central2.rep.googleapis.com
  • chronicle.me-west1.rep.googleapis.com
  • chronicle.northamerica-northeast2.rep.googleapis.com
  • chronicle.southamerica-east1.rep.googleapis.com
  • chronicle.us.rep.googleapis.com

Google Workspace 加购项 全球 API 端点:
  • gsuiteaddons.googleapis.com

Identity and Access Management 全球 API 端点:
  • iam.googleapis.com

Identity-Aware Proxy 全球 API 端点:
  • iap.googleapis.com

映像流式传输 全球 API 端点:
  • containerfilesystem.googleapis.com

Immersive Stream 全球 API 端点:
  • stream.googleapis.com

Infrastructure Manager 全球 API 端点:
  • config.googleapis.com

Integration Connectors 全球 API 端点:
  • connectors.googleapis.com

KRM API Hosting 全球 API 端点:
  • krmapihosting.googleapis.com

Live Stream API 全球 API 端点:
  • livestream.googleapis.com

Looker API 全球 API 端点:
  • looker.googleapis.com

AlloyDB for PostgreSQL 全球 API 端点:
  • alloydb.googleapis.com

适用于 Apache Flink 的 BigQuery 引擎 全球 API 端点:
  • managedflink.googleapis.com

Managed Kafka API 全球 API 端点:
  • managedkafka.googleapis.com

Media Asset Manager 全球 API 端点:
  • mediaasset.googleapis.com

Memorystore for Memcached 全球 API 端点:
  • memcache.googleapis.com

Memorystore for Redis 全球 API 端点:
  • redis.googleapis.com

Message Streams API 全球 API 端点:
  • messagestreams.googleapis.com

Microservices API 全球 API 端点:
  • microservices.googleapis.com

Model Armor 全球 API 端点:
  • modelarmor.googleapis.com

Network Connectivity Center 全球 API 端点:
  • networkconnectivity.googleapis.com

Network Intelligence Center 全球 API 端点:
  • networkmanagement.googleapis.com

Network Service Tiers 全球 API 端点:
  • compute.googleapis.com

Persistent Disk 全球 API 端点:
  • compute.googleapis.com

Oracle Database@Google Cloud 全球 API 端点:
  • oracledatabase.googleapis.com

Parallelstore 全球 API 端点:
  • parallelstore.googleapis.com

Policy Analyzer 全球 API 端点:
  • policyanalyzer.googleapis.com

政策问题排查工具 全球 API 端点:
  • policytroubleshooter.googleapis.com

逐步发布 全球 API 端点:
  • progressiverollout.googleapis.com

Pub/Sub 全球 API 端点:
  • pubsub.googleapis.com

Public Certificate Authority 机构 全球 API 端点:
  • publicca.googleapis.com

Recommender 全球 API 端点:
  • recommender.googleapis.com

Remote Build Execution 全球 API 端点:
  • remotebuildexecution.googleapis.com

Retail API 全球 API 端点:
  • retail.googleapis.com

网络保险中心 全球 API 端点:
  • riskmanager.googleapis.com

SaaS Service Management API 全球 API 端点:
  • saasservicemgmt.googleapis.com

SecLM API 全球 API 端点:
  • seclm.googleapis.com

Secret Manager 全球 API 端点:
  • secretmanager.googleapis.com

安全 Web 代理 全球 API 端点:
  • networksecurity.googleapis.com
  • networkservices.googleapis.com

Security Command Center 全球 API 端点:
  • securitycenter.googleapis.com
  • securitycentermanagement.googleapis.com
  • securityposture.googleapis.com

Cloud Data Loss Prevention 全球 API 端点:
  • dlp.googleapis.com

Service Account Credentials API 全球 API 端点:
  • iamcredentials.googleapis.com

Service Directory 全球 API 端点:
  • servicedirectory.googleapis.com

个性化服务健康状况 全球 API 端点:
  • servicehealth.googleapis.com

Service Networking 全球 API 端点:
  • servicenetworking.googleapis.com

Speaker ID 全球 API 端点:
  • speakerid.googleapis.com

Speech-to-Text 全球 API 端点:
  • speech.googleapis.com


位置信息 API 端点:
  • asia-northeast1-speech.googleapis.com
  • asia-northeast3-speech.googleapis.com
  • asia-south1-speech.googleapis.com
  • asia-southeast1-speech.googleapis.com
  • australia-southeast1-speech.googleapis.com
  • europe-west1-speech.googleapis.com
  • europe-west2-speech.googleapis.com
  • europe-west3-speech.googleapis.com
  • europe-west4-speech.googleapis.com
  • northamerica-northeast1-speech.googleapis.com
  • southamerica-east1-speech.googleapis.com
  • us-central1-speech.googleapis.com
  • us-east1-speech.googleapis.com
  • us-east4-speech.googleapis.com
  • us-west1-speech.googleapis.com

存储空间分析 全球 API 端点:
  • storageinsights.googleapis.com

Storage Transfer Service 全球 API 端点:
  • storagebatchoperations.googleapis.com

Text-to-Speech 全球 API 端点:
  • texttospeech.googleapis.com

Timeseries Insights API 全球 API 端点:
  • timeseriesinsights.googleapis.com

Transcoder API 全球 API 端点:
  • transcoder.googleapis.com

Transfer Appliance 全球 API 端点:
  • transferappliance.googleapis.com

虚拟机管理器 全球 API 端点:
  • osconfig.googleapis.com

Vertex AI API 全球 API 端点:
  • aiplatform.googleapis.com


位置信息 API 端点:
  • africa-south1-aiplatform.googleapis.com
  • asia-east1-aiplatform.googleapis.com
  • asia-east2-aiplatform.googleapis.com
  • asia-northeast1-aiplatform.googleapis.com
  • asia-northeast2-aiplatform.googleapis.com
  • asia-northeast3-aiplatform.googleapis.com
  • asia-south1-aiplatform.googleapis.com
  • asia-south2-aiplatform.googleapis.com
  • asia-southeast1-aiplatform.googleapis.com
  • asia-southeast2-aiplatform.googleapis.com
  • australia-southeast1-aiplatform.googleapis.com
  • australia-southeast2-aiplatform.googleapis.com
  • europe-central2-aiplatform.googleapis.com
  • europe-north1-aiplatform.googleapis.com
  • europe-southwest1-aiplatform.googleapis.com
  • europe-west1-aiplatform.googleapis.com
  • europe-west2-aiplatform.googleapis.com
  • europe-west3-aiplatform.googleapis.com
  • europe-west4-aiplatform.googleapis.com
  • europe-west6-aiplatform.googleapis.com
  • europe-west8-aiplatform.googleapis.com
  • europe-west9-aiplatform.googleapis.com
  • europe-west12-aiplatform.googleapis.com
  • me-central1-aiplatform.googleapis.com
  • me-central2-aiplatform.googleapis.com
  • me-west1-aiplatform.googleapis.com
  • northamerica-northeast1-aiplatform.googleapis.com
  • northamerica-northeast2-aiplatform.googleapis.com
  • southamerica-east1-aiplatform.googleapis.com
  • southamerica-west1-aiplatform.googleapis.com
  • us-central1-aiplatform.googleapis.com
  • us-east1-aiplatform.googleapis.com
  • us-east4-aiplatform.googleapis.com
  • us-east5-aiplatform.googleapis.com
  • us-south1-aiplatform.googleapis.com
  • us-west1-aiplatform.googleapis.com
  • us-west2-aiplatform.googleapis.com
  • us-west3-aiplatform.googleapis.com
  • us-west4-aiplatform.googleapis.com

Vertex AI Workbench 全球 API 端点:
  • notebooks.googleapis.com

Vertex AI in Firebase 全球 API 端点:
  • firebasevertexai.googleapis.com

Video Search API 全球 API 端点:
  • cloudvideosearch.googleapis.com

Video Stitcher API 全球 API 端点:
  • videostitcher.googleapis.com

Virtual Private Cloud (VPC) 全球 API 端点:
  • compute.googleapis.com

Web Risk 全球 API 端点:
  • webrisk.googleapis.com

Web Security Scanner 全球 API 端点:
  • websecurityscanner.googleapis.com

Workflows 全球 API 端点:
  • workflows.googleapis.com

Workload Certificate API 全球 API 端点:
  • workloadcertificate.googleapis.com

值组

值组是 Google 精心挑选的组和 API 端点的集合,可让您更轻松地定义端点限制。值组包含许多相关 API 端点。Google 会不断扩充值组,您无需更改组织政策即可适应新的端点。

如需在组织政策中使用值组,请在您的条目前面添加 in: 字符串作为前缀。如需详细了解如何使用值前缀,请参阅使用限制条件。 调用以设置组织政策时,将验证组名称。使用无效的群组名称会导致政策设置失败。

下表包含最新的可用组列表:

详情 直接成员
global-artifactregistry-endpoints Artifact Registry 全球 API 端点:
in:global-artifactregistry-endpoints
值:
  • artifactregistry.googleapis.com
  • artifactregistry.mtls.googleapis.com
  • content-artifactregistry.googleapis.com
  • content-artifactregistry.mtls.googleapis.com
global-bigquery-connections-endpoints BigQuery Connections 全球 API 端点:
in:global-bigquery-connections-endpoints
值:
  • bigqueryconnection.googleapis.com
  • bigqueryconnection.mtls.googleapis.com
  • content-bigqueryconnection.googleapis.com
  • content-bigqueryconnection.mtls.googleapis.com
global-bigquery-datapolicy-endpoints BigQuery Data Policy 全球 API 端点:
in:global-bigquery-datapolicy-endpoints
值:
  • bigquerydatapolicy.googleapis.com
  • bigquerydatapolicy.mtls.googleapis.com
  • content-bigquerydatapolicy.googleapis.com
  • content-bigquerydatapolicy.mtls.googleapis.com
global-bigquery-datatransfer-endpoints BigQuery Data Transfer 全球 API 端点:
in:global-bigquery-datatransfer-endpoints
值:
  • bigquerydatatransfer.googleapis.com
  • bigquerydatatransfer.mtls.googleapis.com
  • content-bigquerydatatransfer.googleapis.com
  • content-bigquerydatatransfer.mtls.googleapis.com
global-bigquery-migration-endpoints BigQuery Migration 全球 API 端点:
in:global-bigquery-migration-endpoints
值:
  • bigquerymigration.googleapis.com
  • bigquerymigration.mtls.googleapis.com
  • content-bigquerymigration.googleapis.com
  • content-bigquerymigration.mtls.googleapis.com
global-certificatemanager-endpoints Certificate Manager 全局 API 端点:
in:global-certificatemanager-endpoints
值:
  • certificatemanager.googleapis.com
  • certificatemanager.mtls.googleapis.com
global-cloudbuild-endpoints Cloud Build 全球 API 端点:
in:global-cloudbuild-endpoints
值:
  • cloudbuild.googleapis.com
  • cloudbuild.mtls.googleapis.com
  • content-cloudbuild.googleapis.com
global-compsoer-endpoints Cloud Composer 全球 API 端点:
in:global-composer-endpoints
值:
  • composer.googleapis.com
global-compute-endpoints Cloud Compute Engine 全局 API 端点:
in:global-compute-endpoints
值:
  • compute.googleapis.com
  • compute.mtls.googleapis.com
  • content-compute.googleapis.com
  • content-compute.mtls.googleapis.com
global-container-endpoints Google Kubernetes Engine 全球 API 端点:
in:global-container-endpoints
值:
  • container.googleapis.com
  • container.mtls.googleapis.com
  • content-container.googleapis.com
  • content-container.mtls.googleapis.com
global-containeranalysis-endpoints Container Analysis 全球 API 端点:
in:global-containeranalysis-endpoints
值:
  • containeranalysis.googleapis.com
  • containeranalysis.mtls.googleapis.com
  • content-containeranalysis.googleapis.com
  • content-ondemandscanning.mtls.googleapis.com
  • ondemandscanning.googleapis.com
  • ondemandscanning.mtls.googleapis.com
global-containerthreatdetection-endpoints Container Threat Detection 服务全局 API 端点:
in:global-containerthreatdetection-endpoints
值:
  • containerthreatdetection.googleapis.com
  • containerthreatdetection.mtls.googleapis.com
  • content-containerthreatdetection.googleapis.com
  • content-containerthreatdetection.mtls.googleapis.com
global-dataflow-endpoints Dataflow 全球 API 端点:
in:global-dataflow-endpoints
值:
  • content-dataflow.googleapis.com
  • dataflow.googleapis.com
global-dlp-endpoints Sensitive Data Protection DLP 全球 API 端点:
in:global-dlp-endpoints
值:
  • content-dlp.googleapis.com
  • dlp.googleapis.com
global-dns-endpoints Cloud DNS 全局 API 端点:
in:global-dns-endpoints
值:
  • content-dns.googleapis.com
  • content-dns.mtls.googleapis.com
  • dns.googleapis.com
  • dns.mtls.googleapis.com
global-filestore-endpoints Filestore 全球级 API 端点:
in:global-filestore-endpoints
值:
  • content-file.googleapis.com
  • content-file.mtls.googleapis.com
  • file.googleapis.com
  • file.mtls.googleapis.com
global-iam-endpoints Cloud IAM 全球 API 端点:
in:global-iam-endpoints
值:
  • content-iam.googleapis.com
  • content-iam.mtls.googleapis.com
  • iam.googleapis.com
  • iam.mtls.googleapis.com
global-iap-endpoints IAP 全局 API 端点:
in:global-iap-endpoints
值:
  • content-iap.googleapis.com
  • iap.googleapis.com
global-kms-endpoints Cloud Key Management Service 全球 API 端点:
in:global-kms-endpoints
值:
  • cloudkms.googleapis.com
  • cloudkms.mtls.googleapis.com
  • content-cloudkms.googleapis.com
  • content-cloudkms.mtls.googleapis.com
global-managedkafka-endpoints Managed Kafka 全球 API 端点:
in:global-managedkafka-endpoints
值:
  • content-managedkafka.googleapis.com
  • content-managedkafka.mtls.googleapis.com
  • managedkafka.googleapis.com
  • managedkafka.mtls.googleapis.com
global-memcache-endpoints Memorystore for Memcache 全球 API 端点:
in:global-memcache-endpoints
值:
  • content-memcache.googleapis.com
  • content-memcache.mtls.googleapis.com
  • memcache.googleapis.com
  • memcache.mtls.googleapis.com
global-migrationcenter-endpoints Migration Center 全局 API 端点:
in:global-migrationcenter-endpoints
值:
  • content-migrationcenter.googleapis.com
  • content-migrationcenter.mtls.googleapis.com
  • migrationcenter.googleapis.com
  • migrationcenter.mtls.googleapis.com
global-networkconnectivity-endpoints Network Connectivity 全球 API 端点:
in:global-networkconnectivity-endpoints
值:
  • content-networkconnectivity.googleapis.com
  • content-networkconnectivity.mtls.googleapis.com
  • networkconnectivity.googleapis.com
  • networkconnectivity.mtls.googleapis.com
global-osconfig-endpoints 虚拟机管理器全局 API 端点:
in:global-osconfig-endpoints
值:
  • content-osconfig.googleapis.com
  • content-osconfig.mtls.googleapis.com
  • osconfig.googleapis.com
  • osconfig.mtls.googleapis.com
global-oslogin-endpoints OS Login API 端点:
in:global-oslogin-endpoints
值:
  • oslogin.googleapis.com
global-policytroubleshooter-endpoints Policy Troubleshooter 全球 API 端点:
in:global-policytroubleshooter-endpoints
值:
  • content-policytroubleshooter.googleapis.com
  • content-policytroubleshooter.mtls.googleapis.com
  • policytroubleshooter.googleapis.com
  • policytroubleshooter.mtls.googleapis.com
global-progressiverollout-endpoints Ripple 全球 API 端点:
in:global-progressiverollout-endpoints
值:
  • content-progressiverollout.googleapis.com
  • content-progressiverollout.mtls.googleapis.com
  • progressiverollout.googleapis.com
  • progressiverollout.mtls.googleapis.com
global-pubsub-endpoints Pub/Sub 全球 API 端点:
in:global-pubsub-endpoints
值:
  • content-pubsub.googleapis.com
  • content-pubsub.mtls.googleapis.com
  • pubsub.googleapis.com
  • pubsub.mtls.googleapis.com
global-redis-endpoints Memorystore for Redis 全球 API 端点:
in:global-redis-endpoints
值:
  • content-redis.googleapis.com
  • content-redis.mtls.googleapis.com
  • redis.googleapis.com
  • redis.mtls.googleapis.com
global-run-endpoints Cloud Run 全球 API 端点:
in:global-run-endpoints
值:
  • content-run.googleapis.com
  • content-run.mtls.googleapis.com
  • run.googleapis.com
  • run.mtls.googleapis.com
global-secretmanager-endpoints Secret Manager 全局 API 端点:
in:global-secretmanager-endpoints
值:
  • content-secretmanager.googleapis.com
  • content-secretmanager.mtls.googleapis.com
  • secretmanager.googleapis.com
  • secretmanager.mtls.googleapis.com
global-securityposture-endpoints Security Posture 全球 API 端点:
in:global-securityposture-endpoints
值:
  • content-securityposture.googleapis.com
  • content-securityposture.mtls.googleapis.com
  • securityposture.googleapis.com
  • securityposture.mtls.googleapis.com
global-servicenetworking-endpoints Service Networking 全局 API 端点:
in:global-servicenetworking-endpoints
值:
  • content-servicenetworking.googleapis.com
  • content-servicenetworking.mtls.googleapis.com
  • servicenetworking.googleapis.com
  • servicenetworking.mtls.googleapis.com
global-websecurityscanner-endpoints Web Security Scanner 全局 API 端点:
in:global-websecurityscanner-endpoints
值:
  • content-websecurityscanner.googleapis.com
  • content-websecurityscanner.mtls.googleapis.com
  • websecurityscanner.googleapis.com
  • websecurityscanner.mtls.googleapis.com
global-workstations-endpoints Cloud Workstations 全球 API 端点:
in:global-workstations-endpoints
值:
  • content-workstations.googleapis.com
  • content-workstations.mtls.googleapis.com
  • workstations.googleapis.com
  • workstations.mtls.googleapis.com
global-bigquery-endpoints BigQuery 全球 API 端点:
in:global-bigquery-endpoints
值:
  • bigquery.googleapis.com
  • bigquery.mtls.googleapis.com
  • content-bigquery.googleapis.com
  • content-bigquery.mtls.googleapis.com
  • www.googleapis.com (BigQuery)
global-bigqueryreservation-endpoints BigQuery Reservation 全局 API 端点:
in:global-bigqueryreservation-endpoints
值:
  • bigqueryreservation.googleapis.com
  • bigqueryreservation.mtls.googleapis.com
  • content-bigqueryreservation.googleapis.com
  • content-bigqueryreservation.mtls.googleapis.com
global-bigquerystorage-endpoints BigQuery Storage 全球 API 端点:
in:global-bigquerystorage-endpoints
值:
  • bigquerystorage.googleapis.com
  • bigquerystorage.mtls.googleapis.com
  • content-bigquerystorage.googleapis.com
  • content-bigquerystorage.mtls.googleapis.com
global-logging-endpoints Cloud Logging 全球 API 端点:
in:global-logging-endpoints
值:
  • content-logging.googleapis.com
  • content-logging.mtls.googleapis.com
  • logging.googleapis.com
  • logging.mtls.googleapis.com
global-storage-endpoints Cloud Storage 全球 API 端点:
in:global-storage-endpoints
值:
  • content-storage.googleapis.com
  • content-storage.mtls.googleapis.com
  • storage.googleapis.com
  • storage.mtls.googleapis.com