NETWORK_NAME: a descriptive name that uniquely
identifies this network.
REGION: the Google Cloud region to which the
target Distributed Cloud Edge zone belongs.
ZONE_NAME: the name of the target
Distributed Cloud Edge zone.
MTU_SIZE: the maximum transmission unit (MTU) size for
this network. Valid values are 1500 and 9000. This value must match the
MTU size of the default network and be the same for all networks.
API
Make a POST request to the projects.locations.zones.networks.create
method:
PROJECT_ID: the ID of the target Google Cloud project.
REGION: the Google Cloud region to which the
target Distributed Cloud Edge zone belongs.
ZONE_NAME: the name of the target
Distributed Cloud Edge zone.
NETWORK_ID: a unique ID that identifies this network.
LABELS: a list of labels to apply to this network
resource.
MTU_SIZE: the maximum transmission unit (MTU) size for
this network. Valid values are 1500 and 9000.
List networks
To list Distributed Cloud Edge networks 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
Use the gcloud edge-cloud networking networks list command:
gcloud edge-cloud networking networks list \
--location=REGION \
--zone=ZONE_NAME
Replace the following:
REGION: the Google Cloud region to which the
target Distributed Cloud Edge zone belongs.
ZONE_NAME: the name of the target
Distributed Cloud Edge zone.
API
Make a GET request to the projects.locations.zones.networks.list
method:
GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/networks?filter=FILTER&pageSize=PAGE_SIZE&orderBy=SORT_BY&pageToken=PAGE_TOKEN
Replace the following:
PROJECT_ID: the ID of the target Google Cloud project.
REGION: the Google Cloud region to which the
target Distributed Cloud Edge zone belongs.
ZONE_NAME: the name of the target
Distributed Cloud Edge zone.
FILTER: an expression that constrains the returned
results to specific values.
PAGE_SIZE: the number of results to return per page.
SORT_BY: a comma-delimited list of field names by which
the returned results are sorted. The default sort order is ascending; for
descending sort order, prefix the desired field with ~.
PAGE_TOKEN: a token received in the response to the
last list request in the nextPageToken field in the response. Send this
token to receive a page of results.
Get information about a network
To get information about a Distributed Cloud Edge network,
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
Use the gcloud edge-cloud networking networks describe command:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-03 UTC."],[[["\u003cp\u003eThis guide outlines how to create and manage virtual private networks, called networks, within a Google Distributed Cloud Edge zone, where each network is a Virtual Routing Function (VRF).\u003c/p\u003e\n"],["\u003cp\u003eYou can create up to 20 networks per Distributed Cloud Edge zone, and packets are routed independently within each network.\u003c/p\u003e\n"],["\u003cp\u003eThe document details the process of creating, listing, getting information about, checking the operational status of, and deleting networks using both \u003ccode\u003egcloud\u003c/code\u003e commands and API requests.\u003c/p\u003e\n"],["\u003cp\u003eManaging these networks requires the Edge Network Admin role for creating and deleting, and the Edge Network Viewer role for listing, getting information, and checking status.\u003c/p\u003e\n"],["\u003cp\u003eThe MTU size, which can be either 1500 or 9000, must be the same for all networks within the zone, and match the MTU size of the \u003ccode\u003edefault\u003c/code\u003e network.\u003c/p\u003e\n"]]],[],null,["# Create and manage networks\n\nThis page describes how to create and manage Google Distributed Cloud Edge network\nresources in a Distributed Cloud Edge zone.\n\nFor more information about Distributed Cloud Edge networks, see\n[How Distributed Cloud Edge\nworks](/distributed-cloud/edge/1.5.1/docs/how-it-works#networking).\n| **Note:** The Google Cloud CLI instructions on this page assume that you are using [Cloud Shell](/shell/docs) or another environment with `bash` installed.\n\nKeep the following in mind:\n\n- You can create up to 20 networks per Distributed Cloud Edge zone.\n- A network is a virtual private network instantiated within the target zone.\n- The network is instantiated as a Virtual Routing Function (VRF).\n- Packets are routed independently inside a network.\n\nCreate a network\n----------------\n\nTo create a Distributed Cloud Edge network, complete the steps\nin this section.\n\nTo complete this task, you must have the\n[Edge Network Admin role](/distributed-cloud/edge/1.5.1/docs/permissions#edge-network-admin)\n(`roles/edgenetwork.admin`) in your Google Cloud project. \n\n### gcloud\n\nUse the `gcloud edge-cloud networking networks create` command: \n\n```\ngcloud edge-cloud networking networks create NETWORK_NAME \\\n --location=REGION \\\n --zone=ZONE_NAME \\\n --mtu=MTU_SIZE\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eNETWORK_NAME\u003c/var\u003e: a descriptive name that uniquely identifies this network.\n- \u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e: the Google Cloud region to which the target Distributed Cloud Edge zone belongs.\n- \u003cvar translate=\"no\"\u003eZONE_NAME\u003c/var\u003e: the name of the target Distributed Cloud Edge zone.\n- \u003cvar translate=\"no\"\u003eMTU_SIZE\u003c/var\u003e: the maximum transmission unit (MTU) size for this network. Valid values are 1500 and 9000. This value must match the MTU size of the `default` network and be the same for all networks.\n\n### API\n\nMake a `POST` request to the `projects.locations.zones.networks.create`\nmethod: \n\n```\nPOST /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/networks?networkId=NETWORK_ID\n{\n \"labels\": { LABELS,\n },\n \"mtu\": { MTU_SIZE,\n },\n}\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: the ID of the target Google Cloud project.\n- \u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e: the Google Cloud region to which the target Distributed Cloud Edge zone belongs.\n- \u003cvar translate=\"no\"\u003eZONE_NAME\u003c/var\u003e: the name of the target Distributed Cloud Edge zone.\n- \u003cvar translate=\"no\"\u003eNETWORK_ID\u003c/var\u003e: a unique ID that identifies this network.\n- \u003cvar translate=\"no\"\u003eLABELS\u003c/var\u003e: a list of labels to apply to this network resource.\n- \u003cvar translate=\"no\"\u003eMTU_SIZE\u003c/var\u003e: the maximum transmission unit (MTU) size for this network. Valid values are 1500 and 9000.\n\nList networks\n-------------\n\nTo list Distributed Cloud Edge networks provisioned within a\nDistributed Cloud Edge zone, complete the steps in this section.\n\nTo complete this task, you must have the\n[Edge Network Viewer role](/distributed-cloud/edge/1.5.1/docs/permissions#edge-network-viewer)\n(`roles/edgenetwork.viewer`) in your Google Cloud project. \n\n### gcloud\n\nUse the `gcloud edge-cloud networking networks list` command: \n\n```\ngcloud edge-cloud networking networks list \\\n --location=REGION \\\n --zone=ZONE_NAME\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e: the Google Cloud region to which the target Distributed Cloud Edge zone belongs.\n- \u003cvar translate=\"no\"\u003eZONE_NAME\u003c/var\u003e: the name of the target Distributed Cloud Edge zone.\n\n### API\n\nMake a `GET` request to the `projects.locations.zones.networks.list`\nmethod: \n\n```\nGET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/networks?filter=FILTER&pageSize=PAGE_SIZE&orderBy=SORT_BY&pageToken=PAGE_TOKEN\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: the ID of the target Google Cloud project.\n- \u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e: the Google Cloud region to which the target Distributed Cloud Edge zone belongs.\n- \u003cvar translate=\"no\"\u003eZONE_NAME\u003c/var\u003e: the name of the target Distributed Cloud Edge zone.\n- \u003cvar translate=\"no\"\u003eFILTER\u003c/var\u003e: an expression that constrains the returned results to specific values.\n- \u003cvar translate=\"no\"\u003ePAGE_SIZE\u003c/var\u003e: the number of results to return per page.\n- \u003cvar translate=\"no\"\u003eSORT_BY\u003c/var\u003e: a comma-delimited list of field names by which the returned results are sorted. The default sort order is ascending; for descending sort order, prefix the desired field with `~`.\n- \u003cvar translate=\"no\"\u003ePAGE_TOKEN\u003c/var\u003e: a token received in the response to the last list request in the `nextPageToken` field in the response. Send this token to receive a page of results.\n\nGet information about a network\n-------------------------------\n\nTo get information about a Distributed Cloud Edge network,\ncomplete the steps in this section.\n\nTo complete this task, you must have the\n[Edge Network Viewer role](/distributed-cloud/edge/1.5.1/docs/permissions#edge-network-viewer)\n(`roles/edgenetwork.viewer`) in your Google Cloud project. \n\n### gcloud\n\nUse the `gcloud edge-cloud networking networks describe` command: \n\n```\ngcloud edge-cloud networking networks describe NETWORK_NAME \\\n --location=REGION \\\n --zone=ZONE_NAME\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eNETWORK_NAME\u003c/var\u003e: the name of the target network.\n- \u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e: the Google Cloud region to which the target Distributed Cloud Edge zone belongs.\n- \u003cvar translate=\"no\"\u003eZONE_NAME\u003c/var\u003e: the name of the target Distributed Cloud Edge zone.\n\n### API\n\nMake a `GET` request to the `projects.locations.zones.networks.get`\nmethod: \n\n```\nGET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/networks/NETWORK_ID\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: the ID of the target Google Cloud project.\n- \u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e: the Google Cloud region to which the target Distributed Cloud Edge zone belongs.\n- \u003cvar translate=\"no\"\u003eZONE_NAME\u003c/var\u003e: the name of the target Distributed Cloud Edge zone.\n- \u003cvar translate=\"no\"\u003eNETWORK_ID\u003c/var\u003e: the ID of the target network.\n\nCheck the operational status of a network\n-----------------------------------------\n\nTo check the operational status of a Distributed Cloud Edge\nnetwork, complete the steps in this section.\n\nTo complete this task, you must have the\n[Edge Network Viewer role](/distributed-cloud/edge/1.5.1/docs/permissions#edge-network-viewer)\n(`roles/edgenetwork.viewer`) in your Google Cloud project. \n\n### gcloud\n\nUse the `gcloud edge-cloud networking networks get-status` command: \n\n```\ngcloud edge-cloud networking networks get-status NETWORK_NAME \\\n --location=REGION \\\n --zone=ZONE_NAME\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eNETWORK_NAME\u003c/var\u003e: the name of the target network.\n- \u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e: the Google Cloud region to which the target Distributed Cloud Edge zone belongs.\n- \u003cvar translate=\"no\"\u003eZONE_NAME\u003c/var\u003e: the name of the target Distributed Cloud Edge zone.\n\n### API\n\nMake a `GET` request to the `projects.locations.zones.networks.diagnose`\nmethod: \n\n```\n GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/networks/NETWORK_ID:diagnose\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: the ID of the target Google Cloud project.\n- \u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e: the Google Cloud region to which the target Distributed Cloud Edge zone belongs.\n- \u003cvar translate=\"no\"\u003eZONE_NAME\u003c/var\u003e: the name of the target Distributed Cloud Edge zone.\n- \u003cvar translate=\"no\"\u003eNETWORK_ID\u003c/var\u003e: the ID of the target network.\n\nDelete a network\n----------------\n\nTo delete a Distributed Cloud Edge network, complete the steps\nin this section.\n\nTo complete this task, you must have the\n[Edge Network Admin role](/distributed-cloud/edge/1.5.1/docs/permissions#edge-network-admin)\n(`roles/edgenetwork.admin`) in your Google Cloud project. \n\n### gcloud\n\nUse the `gcloud edge-cloud networking networks delete` command: \n\n```\ngcloud edge-cloud networking networks delete NETWORK_NAME \\\n --location=REGION \\\n --zone=ZONE_NAME\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eNETWORK_NAME\u003c/var\u003e: the name of the target network.\n- \u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e: the Google Cloud region to which the target Distributed Cloud Edge zone belongs.\n- \u003cvar translate=\"no\"\u003eZONE_NAME\u003c/var\u003e: the name of the target Distributed Cloud Edge zone.\n\n### API\n\nMake a `DELETE` request to the `projects.locations.zones.networks.delete`\nmethod: \n\n```\n DELETE /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/networks/NETWORK_ID\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: the ID of the target Google Cloud project.\n- \u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e: the Google Cloud region to which the target Distributed Cloud Edge zone belongs.\n- \u003cvar translate=\"no\"\u003eZONE_NAME\u003c/var\u003e: the name of the target Distributed Cloud Edge zone.\n- \u003cvar translate=\"no\"\u003eNETWORK_ID\u003c/var\u003e: the ID of the target network.\n\nWhat's next\n-----------\n\n- [Deploy workloads on Distributed Cloud Edge](/distributed-cloud/edge/1.5.1/docs/deploy)\n- [Manage interconnects](/distributed-cloud/edge/1.5.1/docs/interconnects)\n- [Create and manage interconnect attachments](/distributed-cloud/edge/1.5.1/docs/attachments)\n- [Create and manage routers](/distributed-cloud/edge/1.5.1/docs/routers)\n- [Create and manage subnetworks](/distributed-cloud/edge/1.5.1/docs/subnetworks)\n- [Create and manage VPN connections](/distributed-cloud/edge/1.5.1/docs/vpn-connections)\n- [Manage zones](/distributed-cloud/edge/1.5.1/docs/zones)"]]