创建和管理子网

本页面介绍如何在 Distributed Cloud 可用区中创建和管理 Google Distributed Cloud 子网资源。

如需详细了解 Distributed Cloud 子网， 请参阅 Distributed Cloud 的工作原理。

请注意以下几点：

  • 您可以在每个网络中创建最多 20 个子网。
  • 子网是父网络中的 VLAN。因此，每个子网都必须具有全局唯一的 VLAN ID。Distributed Cloud 不允许重复使用 VLAN ID。
  • 如需让 Distributed Cloud 随机分配未使用的 VLAN ID，请在创建子网时将 VLAN ID 指定为 0。
  • Distributed Cloud 可用区中的所有节点都可以访问该子网。

创建子网

如需创建 Distributed Cloud 子网，请完成本部分中的步骤。

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

gcloud

使用 gcloud edge-cloud networking subnets create 命令：

gcloud edge-cloud networking subnets create SUBNETWORK_NAME \
    --network=NETWORK_NAME \
    --ipv4-range=IPV4_RANGE \
    --vlan-id=VLAN_ID \
    --location=REGION \
    --zone=ZONE_NAME

替换以下内容：

  • SUBNETWORK_NAME：一个描述性名称，用于唯一标识此子网。
  • NETWORK_NAME：封装此子网的网络。
  • IPV4_RANGE：此子网涵盖的 IPv4 地址范围，采用 IP 地址/前缀格式。
  • VLAN_ID：此子网的目标 VLAN ID。
  • REGION：目标 Distributed Cloud 可用区所属的区域。 Google Cloud
  • ZONE_NAME：目标 Distributed Cloud 可用区的名称。

API

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

 POST /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/subnets?subnetId=SUBNETWORK_ID
 {
  "labels": { LABELS,
   },
  "network": { NETWORK_NAME,
   },
  "ipv4Cidr": { IPV4_RANGE,
   },
  "vlanId": { VLAN_ID,
   },
 }

替换以下内容：

  • PROJECT_ID：目标 Google Cloud 项目的 ID。
  • REGION：目标 Distributed Cloud 可用区所属的区域。 Google Cloud
  • ZONE_NAME：目标 Distributed Cloud 可用区的名称。
  • SUBNETWORK_ID：用于唯一标识此子网的 ID。
  • LABELS：要应用于此子网资源的标签列表。
  • NETWORK_NAME：封装此子网的网络。
  • IPV4_RANGE：此子网涵盖的 IPv4 地址范围，采用 IP 地址/前缀格式。
  • VLAN_ID：此子网的目标 VLAN ID。

列出子网

如需列出在 Distributed Cloud 可用区内预配的子网，请完成本部分中的步骤。

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

gcloud

使用 gcloud edge-cloud networking subnets list 命令：

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

替换以下内容：

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

API

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

 GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/subnets?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 subnets describe 命令：

gcloud edge-cloud networking subnets describe SUBNETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME

替换以下内容：

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

API

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

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

替换以下内容：

  • PROJECT_ID：目标 Google Cloud 项目的 ID。
  • REGION：目标 Distributed Cloud 可用区所属的区域。 Google Cloud
  • ZONE_NAME：目标 Distributed Cloud 可用区的名称。
  • SUBNETWORK_NAME：目标子网的名称。

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

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

删除子网

如需删除 Distributed Cloud 子网，请完成本部分中的步骤。

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

gcloud

使用 gcloud edge-cloud networking subnets delete 命令：

gcloud edge-cloud networking subnets delete SUBNETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME

替换以下内容：

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

API

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

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

替换以下内容：

  • PROJECT_ID：目标 Google Cloud 项目的 ID。
  • REGION：目标 Distributed Cloud 可用区所属的区域。 Google Cloud
  • ZONE_NAME：目标 Distributed Cloud 可用区的名称。
  • SUBNETWORK_NAME：目标子网的名称。

后续步骤