管理专用连接配置

概览

在本部分中，您将了解如何使用 Datastream API 创建和删除专用连接配置，以及如何检索其相关信息。

专用连接配置包含 Datastream 通过专用网络（在 Google Cloud 内部，或者与通过 VPN 或互连连接的外部来源）与数据源进行通信的信息。此通信通过 Virtual Private Cloud (VPC) 对等互连连接进行。

您可以通过两种方式使用 Datastream API。您可以进行 REST API 调用，也可以使用 Google Cloud CLI (CLI)。

如需查看如何使用 gcloud 管理 Datastream 专用连接配置的概要信息，请点击此处。

创建专用连接配置

在创建专用连接配置之前，请确保您具备以下条件：

  • 拥有一个 VPC 网络，用于与 Datastream 的专用网络建立对等互连。如需详细了解如何创建 VPC 网络，请参阅使用 VPC 网络对等互连。
  • VPC 网络上有可用的 IP 范围。Datastream 会使用此 IP 范围创建与提供的 VPC 的 VPC 对等互连，因此该范围不能与该 VPC 中的子网重叠。因此，Datastream 可以与数据源通信。

以下是与创建专用连接配置关联的两个参数：

  • vpcName:，指定 VPC 网络的名称和路径。
  • subnet:，提供 VPC 网络上可用的 IP 范围。

以下代码展示了创建专用连接配置的请求，并将连接方法指定为使用 VPC 对等互连 (vpcPeeringConfig)。

REST

POST https://datastream.googleapis.com/v1/projects/[project-id]/locations/
[location]/privateConnections?privateConnectionId=[private-connectivity configuration-id]
{
  "displayName": "[private-connectivity-configuration-display-name]",
  "vpcPeeringConfig": {
      "vpcName": "[name-and-path-of-VPC-network]",
      "subnet": "[subnet]"
  }
}

例如：

POST https://datastream.googleapis.com/v1/projects/myProjectId/locations/
us-central1/privateConnections?privateConnectionId=myPrivateConnection
{
  "displayName": "my private connectivity configuration",
  "vpcPeeringConfig": {
    "vpcName": "projects/my-project/global/networks/my-vpc",
    "subnet": "10.11.12.13/29"
  }
}

创建专用连接配置后，您可以调用 privateConnections/get 方法来查看有关该配置的信息。您将看到如下所示的输出：

{
  "name": "projects/projectId/location/us-central1/privateConnections/myPrivateConnection",
  "createTime": "2019-12-22T16:17:37.159786963Z",
  "updateTime": "2019-12-22T16:17:37.159786963Z",
  "displayName": "my private connectivity configuration",
  "state": "CREATED",
  "vpcPeeringConfig": {
    "vpcName": "projects/my-project/global/networks/my-vpc",
    "subnet": "10.11.12.13/29"
  }  
}

gcloud

如需详细了解如何使用 gcloud 创建专用连接配置，请点击此处。

获取专用连接配置的相关信息

以下代码展示了检索有关已创建的专用连接配置的信息的请求。

REST

GET https://datastream.googleapis.com/v1/projects/[project-id]/locations/
[location]/privateConnections/[private-connectivity-configuration-id]

例如：

GET https://datastream.googleapis.com/v1/projects/myProjectId/locations/
us-central1/privateConnections/myPrivateConnection

gcloud

如需详细了解如何使用 gcloud 检索专用连接配置的相关信息，请点击此处。

列出专用连接配置

以下代码展示了检索有关所有专用连接配置的信息的请求。

REST

GET https://datastream.googleapis.com/v1/projects/[project-id]/locations/
[location]/privateConnections

gcloud

如需详细了解如何使用 gcloud 检索有关所有专用连接配置的信息，请点击此处。

删除专用连接配置

以下代码展示了删除专用连接配置的请求。删除配置后，使用该配置的任何连接配置文件都将失效。此外，使用这些连接配置文件的任何数据流都将无法运行。

如需解决此问题，请为每个连接配置文件分配不同的专用连接配置。如需了解详情，请参阅更新连接配置文件。

REST

DELETE https://datastream.googleapis.com/v1/projects/[project-id]/locations/
[location]/privateConnections/[private-connectivity-configuration-id] {"force": true}

例如：

DELETE https://datastream.googleapis.com/v1/projects/myProjectId/locations/
us-central1/privateConnections/myPrivateConnection {"force": true}

gcloud

如需详细了解如何使用 gcloud 删除专用连接配置，请点击此处。

后续步骤