本页面介绍如何在 Distributed Cloud 区域中创建和管理 Google Distributed Cloud 互联连接资源。
此功能仅适用于 Distributed Cloud Rack。 Distributed Cloud Servers 不支持互联附件资源。
如需详细了解 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 可用区的名称。