View network profiles
This page describes how to view network profiles in Google Cloud.
Required roles
To get the permissions that
you need to view network profiles,
ask your administrator to grant you the Compute Network Viewer
( roles/compute.networkViewer
)
IAM role on your project.
For more information about granting roles, see Manage access to projects, folders, and organizations
.
This predefined role contains the permissions required to view network profiles. To see the exact permissions that are required, expand the Required permissionssection:
Required permissions
The following permissions are required to view network profiles:
-
compute.networkProfiles.get -
compute.networkProfiles.list
You might also be able to get these permissions with custom roles or other predefined roles .
List network profiles
This section describes how to list network profiles by using the Google Cloud CLI and the API. There is a unique instance of a given network profile for each location in which it is available.
If you are using the Google Cloud console, you can view the list of network profiles by location as part of the network profile configuration when you create a VPC network. For more information, see Create a VPC network for RDMA NICs .
gcloud
To list all network profiles in Google Cloud, use the gcloud compute network-profiles list
command
.
gcloud compute network-profiles list
To list the network profiles that are available in a specific zone, use the location.name
filter.
gcloud compute network-profiles list --filter='location.name= ZONE '
Replace ZONE
with the zone for which you want to view
network profiles, such as europe-west1-b
.
To list all instances of a specific network profile, use the --filter
flag.
gcloud compute network-profiles list --filter= NAME
Replace NAME
with the relevant part of the network profile
resource name, such as roce
or falcon
.
API
To list all network profiles in Google Cloud, use the networkProfiles.list
method
.
GET https://compute.googleapis.com/compute/projects/ PROJECT_ID /global/networkProfiles
Replace PROJECT_ID
with your project ID.
View the details of a network profile
This section describes how to view the details of a network profile by using the Google Cloud CLI or the API.
If you are using the Google Cloud console, you can view the details of a network profile as part of the network profile configuration when you create a VPC network , or when viewing an existing network that has a network profile configured.
gcloud
To view the details of a network profile, use the gcloud compute network-profiles describe
command
.
gcloud compute network-profiles describe NETWORK_PROFILE
Replace NETWORK_PROFILE
with the name of the network profile.
API
To view the details of a network profile, use the networkProfiles.get
method
.
GET https://compute.googleapis.com/compute/projects/ PROJECT_ID /global/networkProfiles/ NETWORK_PROFILE
Replace the following:
-
PROJECT_ID: your project ID. -
NETWORK_PROFILE: the name of the network profile.
What's next
- Get an overview of network profiles for specific use cases .
- Learn about RDMA network profiles .
- Create a VPC network for RDMA NICs .
