Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

公共网络连接

本页面介绍了 Integration Connectors 如何连接到可公开访问的后端应用。

您可以通过以下两种方式连接到公共后端应用：

直接连接到公共后端应用。
通过防火墙连接到公共后端应用。

直接连接到公共后端应用

如果您可以公开连接到后端应用，则可以通过在 Hostname 字段中指定端点，将连接配置为使用公共端点。您的连接将可以直接访问后端应用。

通过防火墙连接到公共后端应用

如果您想使用防火墙限制对公共端点的访问，可以将 Integration Connectors 配置为使用一组静态 IP 地址来处理来自连接的流量。配置完成后，来自连接的所有调用都将源自一组静态 IP 地址，您可以将这些地址列入防火墙的许可名单。如需允许连接通过防火墙进行连接，您必须执行以下高级别步骤：

创建防火墙，并通过该防火墙路由出站流量。
为连接分配静态 IP 地址。
将分配的静态 IP 地址列入防火墙的许可名单。

创建和配置防火墙的步骤不在本页面的讨论范围内。本页面仅介绍如何为连接分配静态 IP 地址。

默认情况下，Integration Connectors 会自动分配 IP 地址。不过，您可以将 Integration Connectors 配置为生成静态 IP 地址，而不是自动 IP 地址。Integration Connectors 会在区域级分配静态 IP 地址。例如，us-east1 区域的静态 IP 地址与 us-west2 区域的静态 IP 地址不同。

如需为连接分配静态 IP 地址，请执行以下步骤：

获取要为其分配静态 IP 地址的连接的区域。您可以在“连接”页面的 Location 列中查看连接区域。
转到“连接”页面
在 Google Cloud 控制台中，激活 Cloud Shell。

激活 Cloud Shell

Cloud Shell 会话随即会在控制台的底部启动，并显示命令行提示符。 Google Cloud Cloud Shell 是一个已安装 Google Cloud CLI 且已为当前项目设置值的 Shell 环境。该会话可能需要几秒钟时间来完成初始化。

提示： 即使此步骤提到打开 Cloud Shell，您也可以在常规终端上运行命令，因为您将调用 Integration Connectors 公共 API。

配置 Integration Connectors，以便为从第 1 步获取的区域分配静态 IP 地址。在 Cloud Shell 中运行以下命令。

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{"networkConfig": {"egressMode": "static_ip"}}' \
https://connectors.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/regionalSettings?updateMask="networkConfig"

将 LOCATION 设置为在第 1 步中获取的区域。

运行此命令会返回类似于以下内容的响应：

{
"name": "projects/test-01/locations/us-central1/operations/operation-1696840994443-6074494b6d138-8215226d-516faaf8",
"metadata": {
  "@type": "type.googleapis.com/google.cloud.connectors.v1.OperationMetadata",
  "createTime": "2023-10-09T08:43:14.467058513Z",
  "target": "projects/test-01/locations/us-central1/regionalSettings",
  "verb": "update",
  "requestedCancellation": false,
  "apiVersion": "v1"
 },
"done": false
}

此命令会返回操作 ID 并启动一个长时间运行的操作 (LRO)，该操作可能需要一些时间才能完成。等待 LRO 完成。您可以使用以下命令跟踪操作的进度：

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://connectors.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID

如果静态 IP 地址分配成功，您将收到类似于以下内容的响应：

...
...
"response": {
  "@type": "type.googleapis.com/google.cloud.connectors.v1.RegionalSettings",
  "name": "projects/test-01/locations/us-central1/regionalSettings",
  "networkConfig": {
   "egressMode": "STATIC_IP",
    "egressIps": [
      "35.193.227.203",
      "34.133.63.9",
      "35.223.253.58",
      "34.170.27.253"
    ]
  }
}

在此示例响应中，为 us-central1 区域分配了四个静态 IP 地址，并且该区域的 egressMode 设置为 STATIC_IP。

将静态 IP 地址（在第 4 步中获取）列入防火墙规则的许可名单。

获取区域的静态 IP 地址

如果您想随时获取分配给区域（位置）的静态 IP 地址，请运行以下命令：

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  https://connectors.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/regionalSettings

运行此命令会返回类似于以下内容的响应：

  "response": {
    "@type": "type.googleapis.com/google.cloud.connectors.v1.RegionalSettings",
    "name": "projects/test-01/locations/us-central1/regionalSettings",
    "networkConfig": {
     "egressMode": "STATIC_IP",
      "egressIps": [
        "35.193.227.203",
        "34.133.63.9",
        "35.223.253.58",
        "34.170.27.253"
      ]
    }
  }

为区域分配自动 IP 地址

如果您想移除区域的静态 IP 地址配置并自动分配 IP 地址，则必须在终端中运行以下命令：

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{"networkConfig": {"egressMode": "auto_ip"}}' \
    https://connectors.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/regionalSettings?updateMask="networkConfig"

与之前用于配置静态 IP 地址的命令类似，此命令也会返回操作 ID 并启动一个长时间运行的操作 (LRO)，该操作可能需要一些时间才能完成。等待 LRO 完成。

注意事项

为区域分配静态 IP 地址时，请考虑以下几点：

对于项目中的不同区域，预留的静态 IP 地址集是不同的。
当您将区域的出站模式从 STATIC_IP 更改为 AUTO_IP 时，系统不会保留原始的静态 IP 地址集；因此，当您再次将出站模式从 AUTO_IP 更改为 STATIC_IP 时，系统会分配一组新的静态 IP 地址。
当您将出站模式从 AUTO_IP 更改为 STATIC_IP 或反之亦然时，可能会出现几秒钟的停机时间。