Create and manage subnetworks

This page describes how to create and manage Google Distributed Cloud Edge subnetwork resources in a Distributed Cloud Edge zone.

For more information about Distributed Cloud Edge subnetworks, see How Distributed Cloud Edge works .

Keep the following in mind:

• You can create up to 20 subnetworks within each network.
• The subnetwork is a VLAN within the parent network. As such, each subnetwork must have a globally unique VLAN ID. Distributed Cloud Edge does not allow the reuse of VLAN IDs.
• To have Distributed Cloud Edge assign an unused VLAN ID at random, specify 0 as the VLAN ID when you create the subnetwork.
• The subnetwork is accessible to all nodes in your Distributed Cloud Edge zone.

Create a subnetwork

To create a Distributed Cloud Edge subnetwork, complete the steps in this section.

To complete this task, you must have the Edge Network Admin role ( roles/edgenetwork.admin ) in your Google Cloud project.

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

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 
,
   },
 }

List subnetworks

To list subnetworks provisioned within a Distributed Cloud Edge zone, complete the steps in this section.

To complete this task, you must have the Edge Network Viewer role ( roles/edgenetwork.viewer ) in your Google Cloud project.

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

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

Get information about a subnetwork

To get information about a Distributed Cloud Edge subnetwork, complete the steps in this section.

To complete this task, you must have the Edge Network Viewer role ( roles/edgenetwork.viewer ) in your Google Cloud project.

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

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

This operation returns detailed information about the resource, including its provisioning state:

• PENDING : the resource has not yet begun provisioning and has not yet been propagated throughout the zone.
• PROVISIONING : the resource is being provisioned; you must wait until it has been propagated throughout the zone.
• RUNNING : the resource has been successfully provisioned and propagated throughout the zone; it is ready to use.
• FAILED : the provisioning of the resource was not successful; the resource has not been propagated throughout the zone.

Delete a subnetwork

To delete a Distributed Cloud Edge subnetwork, complete the steps in this section.

To complete this task, you must have the Edge Network Admin role ( roles/edgenetwork.admin ) in your Google Cloud project.

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

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

What's next

• Deploy workloads on Google Distributed Cloud Edge
• Manage interconnects
• Create and manage interconnect attachments
• Create and manage networks
• Create and manage routers
• Create and manage VPN connections
• Manage zones