This page describes how to create and manage Google Distributed Cloud network resources in a Distributed Cloud connected zone.
Distributed Cloud connected servers ship with a single pre-configured network, the default Distributed Cloud network. Distributed Cloud connected servers don't support configuring additional networks.
For more information about Distributed Cloud networks, see How Distributed Cloud connected works.
Keep the following in mind:
- You can create up to 20 networks per Distributed Cloud zone.
- A network is a virtual private network instantiated within the target zone.
- The network is instantiated as a Virtual Routing Function (VRF).
- Packets are routed independently inside a network.
Create a network
To create a Distributed Cloud network, 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
Use the gcloud edge-cloud networking networks create
command:
gcloud edge-cloud networking networks create NETWORK_NAME \ --location=REGION \ --zone=ZONE_NAME \ --mtu=MTU_SIZE
Replace the following:
NETWORK_NAME
: a descriptive name that uniquely identifies this network.REGION
: the Google Cloud region to which the target Distributed Cloud connected zone belongs.ZONE_NAME
: the name of the target Distributed Cloud connected 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 thedefault
network and be the same for all networks.
API
Make a POST
request to the projects.locations.zones.networks.create
method:
POST /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/networks?networkId=NETWORK_ID { "labels": { LABELS, }, "mtu": { MTU_SIZE, }, }
Replace the following:
PROJECT_ID
: the ID of the target Google Cloud project.REGION
: the Google Cloud region to which the target Distributed Cloud connected zone belongs.ZONE_NAME
: the name of the target Distributed Cloud 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 networks provisioned within a Distributed Cloud connected 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 connected zone belongs.ZONE_NAME
: the name of the target Distributed Cloud connected 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 connected zone belongs.ZONE_NAME
: the name of the target Distributed Cloud 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 thenextPageToken
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 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:
gcloud edge-cloud networking networks describe NETWORK_NAME \ --location=REGION \ --zone=ZONE_NAME
Replace the following:
NETWORK_NAME
: the name of the target network.REGION
: the Google Cloud region to which the target Distributed Cloud connected zone belongs.ZONE_NAME
: the name of the target Distributed Cloud connected zone.
API
Make a GET
request to the projects.locations.zones.networks.get
method:
GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/networks/NETWORK_ID
Replace the following:
PROJECT_ID
: the ID of the target Google Cloud project.REGION
: the Google Cloud region to which the target Distributed Cloud connected zone belongs.ZONE_NAME
: the name of the target Distributed Cloud connected zone.NETWORK_ID
: the ID of the target network.
Check the operational status of a network
To check the operational status of a Distributed Cloud 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 get-status
command:
gcloud edge-cloud networking networks get-status NETWORK_NAME \ --location=REGION \ --zone=ZONE_NAME
Replace the following:
NETWORK_NAME
: the name of the target network.REGION
: the Google Cloud region to which the target Distributed Cloud connected zone belongs.ZONE_NAME
: the name of the target Distributed Cloud connected zone.
API
Make a GET
request to the projects.locations.zones.networks.diagnose
method:
GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/networks/NETWORK_ID:diagnose
Replace the following:
PROJECT_ID
: the ID of the target Google Cloud project.REGION
: the Google Cloud region to which the target Distributed Cloud connected zone belongs.ZONE_NAME
: the name of the target Distributed Cloud connected zone.NETWORK_ID
: the ID of the target network.
Delete a network
To delete a Distributed Cloud network, 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
Use the gcloud edge-cloud networking networks delete
command:
gcloud edge-cloud networking networks delete NETWORK_NAME \ --location=REGION \ --zone=ZONE_NAME
Replace the following:
NETWORK_NAME
: the name of the target network.REGION
: the Google Cloud region to which the target Distributed Cloud connected zone belongs.ZONE_NAME
: the name of the target Distributed Cloud connected zone.
API
Make a DELETE
request to the projects.locations.zones.networks.delete
method:
DELETE /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/networks/NETWORK_ID
Replace the following:
PROJECT_ID
: the ID of the target Google Cloud project.REGION
: the Google Cloud region to which the target Distributed Cloud connected zone belongs.ZONE_NAME
: the name of the target Distributed Cloud connected zone.NETWORK_ID
: the ID of the target network.
What's next
- Deploy workloads on Distributed Cloud connected
- Manage interconnects
- Create and manage interconnect attachments
- Create and manage routers
- Create and manage subnetworks
- Create and manage VPN connections
- Manage zones