本页面介绍如何在 Distributed Cloud 可用区中创建和管理 Google Distributed Cloud 互连连接资源。
如需详细了解 Distributed Cloud 互连 连接,请参阅 Distributed Cloud 的工作原理。
请注意以下几点:
- 我们建议您同时创建互连连接及其对应的路由器。如需了解详情,请参阅 创建路由器。
- 您可以选择指定一个 VLAN ID,用于为通过互连连接的数据包添加标记。
- 您为数据包标记指定的 VLAN ID 是互连连接的本地 ID。换句话说,给定的互连连接不属于与关联其他互连的互连连接或与任何互连连接都不关联的子网络相同的第 2 层网域。因此,虽然为数据包标记指定的 VLAN ID 在目标互连上创建的所有互连连接中必须是唯一的,但它可以在其他互连和与互连连接不关联的子网络上重复使用。
创建互连连接
如需创建 Distributed Cloud 互连连接,请完成本部分中的步骤。
如需完成此任务,您必须在您的 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 CloudZONE_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 CloudZONE_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 CloudZONE_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 CloudZONE_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 CloudZONE_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 CloudZONE_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 CloudZONE_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 CloudZONE_NAME:目标 Distributed Cloud 可用区的名称。