Get a list of VMs

  import 
  
 ( 
  
 "context" 
  
 "fmt" 
  
 "io" 
  
 compute 
  
 "cloud.google.com/go/compute/apiv1" 
  
 computepb 
  
 "cloud.google.com/go/compute/apiv1/computepb" 
  
 "google.golang.org/api/iterator" 
  
 "google.golang.org/protobuf/proto" 
 ) 
 // listAllInstances prints all instances present in a project, grouped by their zone. 
 func 
  
 listAllInstances 
 ( 
 w 
  
 io 
 . 
 Writer 
 , 
  
 projectID 
  
 string 
 ) 
  
 error 
  
 { 
  
 // projectID := "your_project_id" 
  
 ctx 
  
 := 
  
 context 
 . 
 Background 
 () 
  
 instancesClient 
 , 
  
 err 
  
 := 
  
 compute 
 . 
  NewInstancesRESTClient 
 
 ( 
 ctx 
 ) 
  
 if 
  
 err 
  
 != 
  
 nil 
  
 { 
  
 return 
  
 fmt 
 . 
 Errorf 
 ( 
 "NewInstancesRESTClient: %w" 
 , 
  
 err 
 ) 
  
 } 
  
 defer 
  
 instancesClient 
 . 
 Close 
 () 
  
 // Use the `MaxResults` parameter to limit the number of results that the API returns per response page. 
  
 req 
  
 := 
  
& computepb 
 . 
 AggregatedListInstancesRequest 
 { 
  
 Project 
 : 
  
 projectID 
 , 
  
 MaxResults 
 : 
  
 proto 
 . 
 Uint32 
 ( 
 3 
 ), 
  
 } 
  
 it 
  
 := 
  
 instancesClient 
 . 
 AggregatedList 
 ( 
 ctx 
 , 
  
 req 
 ) 
  
 fmt 
 . 
 Fprintf 
 ( 
 w 
 , 
  
 "Instances found:\n" 
 ) 
  
 // Despite using the `MaxResults` parameter, you don't need to handle the pagination 
  
 // yourself. The returned iterator object handles pagination 
  
 // automatically, returning separated pages as you iterate over the results. 
  
 for 
  
 { 
  
 pair 
 , 
  
 err 
  
 := 
  
 it 
 . 
 Next 
 () 
  
 if 
  
 err 
  
 == 
  
 iterator 
 . 
  Done 
 
  
 { 
  
 break 
  
 } 
  
 if 
  
 err 
  
 != 
  
 nil 
  
 { 
  
 return 
  
 err 
  
 } 
  
 instances 
  
 := 
  
 pair 
 . 
 Value 
 . 
 Instances 
  
 if 
  
 len 
 ( 
 instances 
 ) 
 > 
 0 
  
 { 
  
 fmt 
 . 
 Fprintf 
 ( 
 w 
 , 
  
 "%s\n" 
 , 
  
 pair 
 . 
 Key 
 ) 
  
 for 
  
 _ 
 , 
  
 instance 
  
 := 
  
 range 
  
 instances 
  
 { 
  
 fmt 
 . 
 Fprintf 
 ( 
 w 
 , 
  
 "- %s %s\n" 
 , 
  
 instance 
 . 
 GetName 
 (), 
  
 instance 
 . 
 GetMachineType 
 ()) 
  
 } 
  
 } 
  
 } 
  
 return 
  
 nil 
 } 
 

  // Copyright 2021 Google LLC 
 // 
 // Licensed under the Apache License, Version 2.0 (the "License"); 
 // you may not use this file except in compliance with the License. 
 // You may obtain a copy of the License at 
 // 
 //     https://www.apache.org/licenses/LICENSE-2.0 
 // 
 // Unless required by applicable law or agreed to in writing, software 
 // distributed under the License is distributed on an "AS IS" BASIS, 
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
 // See the License for the specific language governing permissions and 
 // limitations under the License. 
 package 
  
 snippets 
 import 
  
 ( 
  
 "context" 
  
 "fmt" 
  
 "io" 
  
 compute 
  
 "cloud.google.com/go/compute/apiv1" 
  
 computepb 
  
 "cloud.google.com/go/compute/apiv1/computepb" 
  
 "google.golang.org/api/iterator" 
 ) 
 // listInstances prints a list of instances created in given project in given zone. 
 func 
  
 listInstances 
 ( 
 w 
  
 io 
 . 
 Writer 
 , 
  
 projectID 
 , 
  
 zone 
  
 string 
 ) 
  
 error 
  
 { 
  
 // projectID := "your_project_id" 
  
 // zone := "europe-central2-b" 
  
 ctx 
  
 := 
  
 context 
 . 
 Background 
 () 
  
 instancesClient 
 , 
  
 err 
  
 := 
  
 compute 
 . 
  NewInstancesRESTClient 
 
 ( 
 ctx 
 ) 
  
 if 
  
 err 
  
 != 
  
 nil 
  
 { 
  
 return 
  
 fmt 
 . 
 Errorf 
 ( 
 "NewInstancesRESTClient: %w" 
 , 
  
 err 
 ) 
  
 } 
  
 defer 
  
 instancesClient 
 . 
 Close 
 () 
  
 req 
  
 := 
  
& computepb 
 . 
 ListInstancesRequest 
 { 
  
 Project 
 : 
  
 projectID 
 , 
  
 Zone 
 : 
  
 zone 
 , 
  
 } 
  
 it 
  
 := 
  
 instancesClient 
 . 
 List 
 ( 
 ctx 
 , 
  
 req 
 ) 
  
 fmt 
 . 
 Fprintf 
 ( 
 w 
 , 
  
 "Instances found in zone %s:\n" 
 , 
  
 zone 
 ) 
  
 for 
  
 { 
  
 instance 
 , 
  
 err 
  
 := 
  
 it 
 . 
 Next 
 () 
  
 if 
  
 err 
  
 == 
  
 iterator 
 . 
  Done 
 
  
 { 
  
 break 
  
 } 
  
 if 
  
 err 
  
 != 
  
 nil 
  
 { 
  
 return 
  
 err 
  
 } 
  
 fmt 
 . 
 Fprintf 
 ( 
 w 
 , 
  
 "- %s %s\n" 
 , 
  
 instance 
 . 
 GetName 
 (), 
  
 instance 
 . 
 GetMachineType 
 ()) 
  
 } 
  
 return 
  
 nil 
 } 
 

  import 
  
 com.google.cloud.compute.v1. AggregatedListInstancesRequest 
 
 ; 
 import 
  
 com.google.cloud.compute.v1. Instance 
 
 ; 
 import 
  
 com.google.cloud.compute.v1. InstancesClient 
 
 ; 
 import 
  
 com.google.cloud.compute.v1. InstancesClient 
.AggregatedListPagedResponse 
 ; 
 import 
  
 com.google.cloud.compute.v1. InstancesScopedList 
 
 ; 
 import 
  
 java.io.IOException 
 ; 
 import 
  
 java.util.Map 
 ; 
 public 
  
 class 
 ListAllInstances 
  
 { 
  
 public 
  
 static 
  
 void 
  
 main 
 ( 
 String 
 [] 
  
 args 
 ) 
  
 throws 
  
 IOException 
  
 { 
  
 // TODO(developer): Replace these variables before running the sample 
  
 String 
  
 project 
  
 = 
  
 "your-project-id" 
 ; 
  
 listAllInstances 
 ( 
 project 
 ); 
  
 } 
  
 // List all instances in the specified project ID. 
  
 public 
  
 static 
  
 AggregatedListPagedResponse 
  
 listAllInstances 
 ( 
 String 
  
 project 
 ) 
  
 throws 
  
 IOException 
  
 { 
  
 // Initialize client that will be used to send requests. This client only needs to be created 
  
 // once, and can be reused for multiple requests. After completing all of your requests, call 
  
 // the `instancesClient.close()` method on the client to 
  
 // safely clean up any remaining background resources. 
  
 try 
  
 ( 
  InstancesClient 
 
  
 instancesClient 
  
 = 
  
  InstancesClient 
 
 . 
 create 
 ()) 
  
 { 
  
 // Use the `setMaxResults` parameter to limit the number of results 
  
 // that the API returns per response page. 
  
  AggregatedListInstancesRequest 
 
  
 aggregatedListInstancesRequest 
  
 = 
  
  AggregatedListInstancesRequest 
 
  
 . 
 newBuilder 
 () 
  
 . 
 setProject 
 ( 
 project 
 ) 
  
 . 
 setMaxResults 
 ( 
 5 
 ) 
  
 . 
 build 
 (); 
  
  InstancesClient 
 
 . 
 AggregatedListPagedResponse 
  
 response 
  
 = 
  
 instancesClient 
  
 . 
 aggregatedList 
 ( 
 aggregatedListInstancesRequest 
 ); 
  
 // Despite using the `setMaxResults` parameter, you don't need to handle the pagination 
  
 // yourself. The returned `AggregatedListPager` object handles pagination 
  
 // automatically, requesting next pages as you iterate over the results. 
  
 for 
  
 ( 
 Map 
 . 
 Entry<String 
 , 
  
 InstancesScopedList 
>  
 zoneInstances 
  
 : 
  
 response 
 . 
 iterateAll 
 ()) 
  
 { 
  
 // Instances scoped by each zone 
  
 String 
  
 zone 
  
 = 
  
 zoneInstances 
 . 
 getKey 
 (); 
  
 if 
  
 ( 
 ! 
 zoneInstances 
 . 
 getValue 
 (). 
 getInstancesList 
 (). 
 isEmpty 
 ()) 
  
 { 
  
 // zoneInstances.getKey() returns the fully qualified address. 
  
 // Hence, strip it to get the zone name only 
  
 System 
 . 
 out 
 . 
 printf 
 ( 
 "Instances at %s: " 
 , 
  
 zone 
 . 
 substring 
 ( 
 zone 
 . 
 lastIndexOf 
 ( 
 '/' 
 ) 
  
 + 
  
 1 
 )); 
  
 for 
  
 ( 
 Instance 
  
 instance 
  
 : 
  
 zoneInstances 
 . 
 getValue 
 (). 
 getInstancesList 
 ()) 
  
 { 
  
 System 
 . 
 out 
 . 
 println 
 ( 
 instance 
 . 
 getName 
 ()); 
  
 } 
  
 } 
  
 } 
  
 System 
 . 
 out 
 . 
 println 
 ( 
 "####### Listing all instances complete #######" 
 ); 
  
 return 
  
 response 
 ; 
  
 } 
  
 } 
 } 
 

  /* 
 * Copyright 2021 Google LLC 
 * 
 * Licensed under the Apache License, Version 2.0 (the "License"); 
 * you may not use this file except in compliance with the License. 
 * You may obtain a copy of the License at 
 * 
 * http://www.apache.org/licenses/LICENSE-2.0 
 * 
 * Unless required by applicable law or agreed to in writing, software 
 * distributed under the License is distributed on an "AS IS" BASIS, 
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
 * See the License for the specific language governing permissions and 
 * limitations under the License. 
 */ 
 package 
  
 compute 
 ; 
 import 
  
 com.google.cloud.compute.v1. Instance 
 
 ; 
 import 
  
 com.google.cloud.compute.v1. InstancesClient 
 
 ; 
 import 
  
 java.io.IOException 
 ; 
 public 
  
 class 
 ListInstance 
  
 { 
  
 public 
  
 static 
  
 void 
  
 main 
 ( 
 String 
 [] 
  
 args 
 ) 
  
 throws 
  
 IOException 
  
 { 
  
 // TODO(developer): Replace these variables before running the sample 
  
 String 
  
 project 
  
 = 
  
 "your-project-id" 
 ; 
  
 String 
  
 zone 
  
 = 
  
 "zone-name" 
 ; 
  
 listInstances 
 ( 
 project 
 , 
  
 zone 
 ); 
  
 } 
  
 // List all instances in the given zone in the specified project ID. 
  
 public 
  
 static 
  
 void 
  
 listInstances 
 ( 
 String 
  
 project 
 , 
  
 String 
  
 zone 
 ) 
  
 throws 
  
 IOException 
  
 { 
  
 // Initialize client that will be used to send requests. This client only needs to be created 
  
 // once, and can be reused for multiple requests. After completing all of your requests, call 
  
 // the `instancesClient.close()` method on the client to 
  
 // safely clean up any remaining background resources. 
  
 try 
  
 ( 
  InstancesClient 
 
  
 instancesClient 
  
 = 
  
  InstancesClient 
 
 . 
 create 
 ()) 
  
 { 
  
 // Set the project and zone to retrieve instances present in the zone. 
  
 System 
 . 
 out 
 . 
 printf 
 ( 
 "Listing instances from %s in %s:" 
 , 
  
 project 
 , 
  
 zone 
 ); 
  
 for 
  
 ( 
  Instance 
 
  
 zoneInstance 
  
 : 
  
 instancesClient 
 . 
 list 
 ( 
 project 
 , 
  
 zone 
 ). 
 iterateAll 
 ()) 
  
 { 
  
 System 
 . 
 out 
 . 
 println 
 ( 
 zoneInstance 
 . 
 getName 
 ()); 
  
 } 
  
 System 
 . 
 out 
 . 
 println 
 ( 
 "####### Listing instances complete #######" 
 ); 
  
 } 
  
 } 
 } 
 

  /** 
 * TODO(developer): Uncomment and replace these variables before running the sample. 
 */ 
 // const projectId = 'YOUR_PROJECT_ID'; 
 const 
  
 compute 
  
 = 
  
 require 
 ( 
 ' @google-cloud/compute 
' 
 ); 
 // List all instances in the specified project. 
 async 
  
 function 
  
 listAllInstances 
 () 
  
 { 
  
 const 
  
 instancesClient 
  
 = 
  
 new 
  
 compute 
 . 
  InstancesClient 
 
 (); 
  
 //Use the `maxResults` parameter to limit the number of results that the API returns per response page. 
  
 const 
  
 aggListRequest 
  
 = 
  
 instancesClient 
 . 
 aggregatedListAsync 
 ({ 
  
 project 
 : 
  
 projectId 
 , 
  
 maxResults 
 : 
  
 5 
 , 
  
 }); 
  
 console 
 . 
 log 
 ( 
 'Instances found:' 
 ); 
  
 // Despite using the `maxResults` parameter, you don't need to handle the pagination 
  
 // yourself. The returned object handles pagination automatically, 
  
 // requesting next pages as you iterate over the results. 
  
 for 
  
 await 
  
 ( 
 const 
  
 [ 
 zone 
 , 
  
 instancesObject 
 ] 
  
 of 
  
 aggListRequest 
 ) 
  
 { 
  
 const 
  
 instances 
  
 = 
  
 instancesObject 
 . 
 instances 
 ; 
  
 if 
  
 ( 
 instances 
 && 
 instances 
 . 
 length 
 > 
 0 
 ) 
  
 { 
  
 console 
 . 
 log 
 ( 
 ` 
 ${ 
 zone 
 } 
 ` 
 ); 
  
 for 
  
 ( 
 const 
  
 instance 
  
 of 
  
 instances 
 ) 
  
 { 
  
 console 
 . 
 log 
 ( 
 ` - 
 ${ 
 instance 
 . 
 name 
 } 
 ( 
 ${ 
 instance 
 . 
 machineType 
 } 
 )` 
 ); 
  
 } 
  
 } 
  
 } 
 } 
 listAllInstances 
 (); 
 

  // Copyright 2021 Google LLC 
 // 
 // Licensed under the Apache License, Version 2.0 (the "License"); 
 // you may not use this file except in compliance with the License. 
 // You may obtain a copy of the License at 
 // 
 //      http://www.apache.org/licenses/LICENSE-2.0 
 // 
 // Unless required by applicable law or agreed to in writing, software 
 // distributed under the License is distributed on an "AS IS" BASIS, 
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
 // See the License for the specific language governing permissions and 
 // limitations under the License. 
 /** 
 * Gets a list of instances created in given project in given zone. 
 * 
 * @param {string} projectId - ID or number of the project you want to use. 
 * @param {string} zone - Name of the zone you want to check, for example: us-west3-b 
 */ 
 function 
  
 main 
 ( 
 projectId 
 , 
  
 zone 
 ) 
  
 { 
  
 /** 
 * TODO(developer): Uncomment and replace these variables before running the sample. 
 */ 
  
 // const projectId = 'YOUR_PROJECT_ID'; 
  
 // const zone = 'europe-central2-b' 
  
 const 
  
 compute 
  
 = 
  
 require 
 ( 
 ' @google-cloud/compute 
' 
 ); 
  
 // List all instances in the given zone in the specified project. 
  
 async 
  
 function 
  
 listInstances 
 () 
  
 { 
  
 const 
  
 instancesClient 
  
 = 
  
 new 
  
 compute 
 . 
  InstancesClient 
 
 (); 
  
 const 
  
 [ 
 instanceList 
 ] 
  
 = 
  
 await 
  
 instancesClient 
 . 
 list 
 ({ 
  
 project 
 : 
  
 projectId 
 , 
  
 zone 
 , 
  
 }); 
  
 console 
 . 
 log 
 ( 
 `Instances found in zone 
 ${ 
 zone 
 } 
 :` 
 ); 
  
 for 
  
 ( 
 const 
  
 instance 
  
 of 
  
 instanceList 
 ) 
  
 { 
  
 console 
 . 
 log 
 ( 
 ` - 
 ${ 
 instance 
 . 
 name 
 } 
 ( 
 ${ 
 instance 
 . 
 machineType 
 } 
 )` 
 ); 
  
 } 
  
 } 
  
 listInstances 
 (); 
 } 
 main 
 (... 
 process 
 . 
 argv 
 . 
 slice 
 ( 
 2 
 )); 
 

  from 
  
 __future__ 
  
 import 
 annotations 
 from 
  
 collections 
  
 import 
 defaultdict 
 from 
  
 collections.abc 
  
 import 
 Iterable 
 from 
  
 google.cloud 
  
 import 
 compute_v1 
 def 
  
 list_all_instances 
 ( 
 project_id 
 : 
 str 
 , 
 ) 
 - 
> dict 
 [ 
 str 
 , 
 Iterable 
 [ 
 compute_v1 
 . 
 Instance 
 ]]: 
  
 """ 
 Returns a dictionary of all instances present in a project, grouped by their zone. 
 Args: 
 project_id: project ID or project number of the Cloud project you want to use. 
 Returns: 
 A dictionary with zone names as keys (in form of "zones/{zone_name}") and 
 iterable collections of Instance objects as values. 
 """ 
 instance_client 
 = 
 compute_v1 
 . 
 InstancesClient 
 () 
 request 
 = 
 compute_v1 
 . 
 AggregatedListInstancesRequest 
 () 
 request 
 . 
 project 
 = 
 project_id 
 # Use the `max_results` parameter to limit the number of results that the API returns per response page. 
 request 
 . 
 max_results 
 = 
 50 
 agg_list 
 = 
 instance_client 
 . 
 aggregated_list 
 ( 
 request 
 = 
 request 
 ) 
 all_instances 
 = 
 defaultdict 
 ( 
 list 
 ) 
 print 
 ( 
 "Instances found:" 
 ) 
 # Despite using the `max_results` parameter, you don't need to handle the pagination 
 # yourself. The returned `AggregatedListPager` object handles pagination 
 # automatically, returning separated pages as you iterate over the results. 
 for 
 zone 
 , 
 response 
 in 
 agg_list 
 : 
 if 
 response 
 . 
 instances 
 : 
 all_instances 
 [ 
 zone 
 ] 
 . 
 extend 
 ( 
 response 
 . 
 instances 
 ) 
 print 
 ( 
 f 
 " 
 { 
 zone 
 } 
 :" 
 ) 
 for 
 instance 
 in 
 response 
 . 
 instances 
 : 
 print 
 ( 
 f 
 " - 
 { 
 instance 
 . 
 name 
 } 
 ( 
 { 
 instance 
 . 
 machine_type 
 } 
 )" 
 ) 
 return 
 all_instances 
 

  #  Copyright 2022 Google LLC 
 # 
 #  Licensed under the Apache License, Version 2.0 (the "License"); 
 #  you may not use this file except in compliance with the License. 
 #  You may obtain a copy of the License at 
 # 
 #      http://www.apache.org/licenses/LICENSE-2.0 
 # 
 #  Unless required by applicable law or agreed to in writing, software 
 #  distributed under the License is distributed on an "AS IS" BASIS, 
 #  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
 #  See the License for the specific language governing permissions and 
 #  limitations under the License. 
 # flake8: noqa 
 # This file is automatically generated. Please do not modify it directly. 
 # Find the relevant recipe file in the samples/recipes or samples/ingredients 
 # directory and apply your changes there. 
 from 
  
 __future__ 
  
 import 
 annotations 
 from 
  
 collections.abc 
  
 import 
 Iterable 
 from 
  
 google.cloud 
  
 import 
 compute_v1 
 def 
  
 list_instances 
 ( 
 project_id 
 : 
 str 
 , 
 zone 
 : 
 str 
 ) 
 - 
> Iterable 
 [ 
 compute_v1 
 . 
 Instance 
 ]: 
  
 """ 
 List all instances in the given zone in the specified project. 
 Args: 
 project_id: project ID or project number of the Cloud project you want to use. 
 zone: name of the zone you want to use. For example: “us-west3-b” 
 Returns: 
 An iterable collection of Instance objects. 
 """ 
 instance_client 
 = 
 compute_v1 
 . 
 InstancesClient 
 () 
 instance_list 
 = 
 instance_client 
 . 
 list 
 ( 
 project 
 = 
 project_id 
 , 
 zone 
 = 
 zone 
 ) 
 print 
 ( 
 f 
 "Instances found in zone 
 { 
 zone 
 } 
 :" 
 ) 
 for 
 instance 
 in 
 instance_list 
 : 
 print 
 ( 
 f 
 " - 
 { 
 instance 
 . 
 name 
 } 
 ( 
 { 
 instance 
 . 
 machine_type 
 } 
 )" 
 ) 
 return 
 instance_list