创建和管理互连连接

本页面介绍如何在 Distributed Cloud 区域中创建和管理 Google Distributed Cloud 互联连接资源。

如需详细了解 Distributed Cloud 互连附件，请参阅 Distributed Cloud 的运作方式。

请注意以下几点：

  • 我们建议您同时创建互连连接及其对应的路由器。如需了解详情，请参阅创建路由器。
  • 您可以选择指定一个 VLAN ID，用于标记通过互连连接的数据包。
  • 您为数据包标记指定的 VLAN ID 仅适用于互连连接。换句话说，给定的互连连接不属于与以下各项关联的互连连接或子网（未与任何互连连接关联）的同一第 2 层网域：其他互连、因此，虽然为数据包标记指定的 VLAN ID 在目标互连上创建的所有互连连接中必须是唯一的，但可以在其他互连上以及未与互连连接关联的子网上重复使用。

创建互连连接

如需创建分布式云互连连接，请完成本部分中的步骤。

如需完成此任务，您必须在 Google Cloud 项目中拥有 Edge Network Admin 角色(roles/edgenetwork.admin)。

gcloud

使用 gcloud edge-cloud networking interconnects attachments dedicated create 命令：

gcloud edge-cloud networking interconnects attachments dedicated create ATTACHMENT_NAME \
    --interconnect=INTERCONNECT_NAME \
    --network=NETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME \
    --vlan-id=VLAN_ID \
    --mtu=MTU_SIZE

替换以下内容：

  • ATTACHMENT_NAME：唯一标识此互连连接的描述性名称。
  • INTERCONNECT_NAME：此互连连接所连接的互连的名称。
  • NETWORK_NAME：相应互联附件资源所服务的 Distributed Cloud 网络的名称。
  • REGION：目标 Distributed Cloud 可用区所属的 Google Cloud 区域。
  • ZONE_NAME：目标 Distributed Cloud 可用区的名称。
  • VLAN_ID（可选）：通过此互连连接的数据包所标记的 VLAN ID。有效值介于 2 和 4095 之间。如果您省略此值或将其设置为 0，则数据包将不带标记。
  • MTU_SIZE：相应互联连接附件所实例化的子网的最大传输单元 (MTU) 大小。有效值为 1500 和 9000。

API

向 projects.locations.zones.interconnectAttachments.create 方法发出 POST 请求：

POST /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/interconnectAttachments?interconnectAttachmentId=ATTACHMENT_ID
 {
  "labels": { LABELS,
   },
  "interconnect": { INTERCONNECT_NAME,
   },
  "network": { NETWORK_NAME,
   },
  "vlanId": { VLAN_ID,
   },
  "mtu": { MTU_SIZE,
   },       
 }

替换以下内容：

  • PROJECT_ID：目标Google Cloud 项目的 ID。
  • REGION：目标 Distributed Cloud 可用区所属的 Google Cloud 区域。
  • ZONE_NAME：目标 Distributed Cloud 可用区的名称。
  • ATTACHMENT_ID：唯一标识相应互联连接的 ID。
  • LABELS：要应用于此互联附件资源的标签列表。
  • INTERCONNECT_NAME：此互连连接所连接的互连的名称。
  • NETWORK_NAME：相应互联连接资源所服务的网络。
  • VLAN_ID：相应子网在此互连连接在路由器上实例化时所用的 VLAN ID。有效值介于 2 和 4095 之间。值为 0 时，子网配置为不带标记。
  • MTU_SIZE：相应互联连接附件所实例化的子网的最大传输单元 (MTU) 大小。有效值为 1500 和 9000。

列出互连连接

如需列出 Distributed Cloud 可用区中的 Distributed Cloud 互连连接，请完成本部分中的步骤。

如需完成此任务，您必须在 Google Cloud 项目中拥有 Edge Network Viewer 角色 (roles/edgenetwork.viewer)。

gcloud

使用 gcloud edge-cloud networking interconnects attachments list 命令：

gcloud edge-cloud networking interconnects attachments list \
    --location=REGION \
    --zone=ZONE_NAME

替换以下内容：

  • REGION：目标 Distributed Cloud 可用区所属的 Google Cloud 区域。
  • ZONE_NAME：目标 Distributed Cloud 可用区的名称。

API

向 projects.locations.zones.interconnectAttachments.list 方法发出 GET 请求：

GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/interconnectAttachments?filter=FILTER&pageSize=PAGE_SIZE&orderBy=SORT_BY&pageToken=PAGE_TOKEN

替换以下内容：

  • PROJECT_ID：目标Google Cloud 项目的 ID。
  • REGION：目标 Distributed Cloud 可用区所属的 Google Cloud 区域。
  • ZONE_NAME：目标 Distributed Cloud 可用区的名称。
  • FILTER：将返回的结果限制为特定值的表达式。
  • PAGE_SIZE：每页要返回的结果数。
  • SORT_BY：用于对返回的结果进行排序的字段名称的英文逗号分隔列表。默认排序顺序为升序；如需降序排序，请在所需字段前加上 ~。
  • PAGE_TOKEN：在响应的 nextPageToken 字段中，对上一个列表请求的响应中收到的令牌。发送此令牌可接收下一页结果。

获取互连附件的相关信息

如需获取有关 Distributed Cloud 互连连接的信息，请完成本部分中的步骤。

如需完成此任务，您必须在 Google Cloud 项目中拥有 Edge Network Viewer 角色 (roles/edgenetwork.viewer)。

gcloud

使用 gcloud edge-cloud networking interconnects attachments describe 命令：

gcloud edge-cloud networking interconnects attachments describe ATTACHMENT_NAME \
    --location=REGION \
    --zone=ZONE_NAME

替换以下内容：

  • ATTACHMENT_NAME：目标互联连接的名称。
  • REGION：目标 Distributed Cloud 可用区所属的 Google Cloud 区域。
  • ZONE_NAME：目标 Distributed Cloud 可用区的名称。

API

向 projects.locations.zones.interconnectAttachments.get 方法发出 GET 请求：

GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/interconnectAttachments/ATTACHMENT_ID

替换以下内容：

  • PROJECT_ID：目标Google Cloud 项目的 ID。
  • ATTACHMENT_ID：目标互联连接的名称。
  • REGION：目标 Distributed Cloud 可用区所属的 Google Cloud 区域。
  • ZONE_NAME：目标 Distributed Cloud 可用区的名称。

此操作会返回有关资源的详细信息，包括其预配状态，如下所示：

  • PENDING：资源尚未开始预配，也尚未在整个可用区内传播。
  • PROVISIONING：资源正在预配；您必须等待资源传播到整个可用区。
  • RUNNING：资源已成功预配并传播到整个可用区；资源已可供使用。
  • FAILED：资源预配未成功；资源尚未在整个可用区中传播。

删除互连连接

如需删除 Distributed Cloud 互联附件，请完成本部分中的步骤。

如需完成此任务，您必须在 Google Cloud 项目中拥有 Edge Network Admin 角色(roles/edgenetwork.admin)。

gcloud

使用 gcloud edge-cloud networking interconnects attachments delete 命令：

gcloud edge-cloud networking interconnects attachments delete ATTACHMENT_NAME \
    --location=REGION \
    --zone=ZONE_NAME

替换以下内容：

  • ATTACHMENT_NAME：目标互联连接的名称。
  • REGION：目标 Distributed Cloud 可用区所属的 Google Cloud 区域。
  • ZONE_NAME：目标 Distributed Cloud 可用区的名称。

API

向 projects.locations.zones.interconnectAttachments.delete 方法发出 DELETE 请求：

DELETE /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/subnets/SUBNETWORK_ID

替换以下内容：

  • PROJECT_ID：目标Google Cloud 项目的 ID。
  • ATTACHMENT_NAME：目标互联连接的名称。
  • REGION：目标 Distributed Cloud 可用区所属的 Google Cloud 区域。
  • ZONE_NAME：目标 Distributed Cloud 可用区的名称。

后续步骤