Version latest

• 3.9.1 (latest)
• 3.8.1

Google Compute Engine: Node.js Client

Google Compute Engine Client Library for Node.js

A comprehensive list of changes in each version may be found in the CHANGELOG.

• Google Compute Engine Node.js Client API Reference
• Google Compute Engine Documentation
• github.com/googleapis/google-cloud-node/packages/google-cloud-compute

Read more about the client libraries for Cloud APIs, including the older Google APIs Client Libraries, in Client Libraries Explained.

Table of contents:

• Quickstart
  • Before you begin
  • Installing the client library
  • Using the client library
• Samples
• Versioning
• Contributing
• License

Quickstart

Before you begin

1. Select or create a Cloud Platform project.
2. Enable billing for your project.
3. Enable the Google Compute Engine API.
4. Set up authentication with a service account so you can access the API from your local workstation.

Installing the client library

npm install @google-cloud/compute

Using the client library

/**
 * 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();

Samples

Samples are in the samples/ directory. Each sample's README.md has instructions for running its sample.

Sample	Source Code	Try it
Accelerator_types.aggregated_list	source code
Accelerator_types.get	source code
Accelerator_types.list	source code
Addresses.aggregated_list	source code
Addresses.delete	source code
Addresses.get	source code
Addresses.insert	source code
Addresses.list	source code
Addresses.set_labels	source code
Autoscalers.aggregated_list	source code
Autoscalers.delete	source code
Autoscalers.get	source code
Autoscalers.insert	source code
Autoscalers.list	source code
Autoscalers.patch	source code
Autoscalers.update	source code
Backend_buckets.add_signed_url_key	source code
Backend_buckets.delete	source code
Backend_buckets.delete_signed_url_key	source code
Backend_buckets.get	source code
Backend_buckets.insert	source code
Backend_buckets.list	source code
Backend_buckets.patch	source code
Backend_buckets.set_edge_security_policy	source code
Backend_buckets.update	source code
Backend_services.add_signed_url_key	source code
Backend_services.aggregated_list	source code
Backend_services.delete	source code
Backend_services.delete_signed_url_key	source code
Backend_services.get	source code
Backend_services.get_health	source code
Backend_services.get_iam_policy	source code
Backend_services.insert	source code
Backend_services.list	source code
Backend_services.patch	source code
Backend_services.set_edge_security_policy	source code
Backend_services.set_iam_policy	source code
Backend_services.set_security_policy	source code
Backend_services.update	source code
Disk_types.aggregated_list	source code
Disk_types.get	source code
Disk_types.list	source code
Disks.add_resource_policies	source code
Disks.aggregated_list	source code
Disks.create_snapshot	source code
Disks.delete	source code
Disks.get	source code
Disks.get_iam_policy	source code
Disks.insert	source code
Disks.list	source code
Disks.remove_resource_policies	source code
Disks.resize	source code
Disks.set_iam_policy	source code
Disks.set_labels	source code
Disks.test_iam_permissions	source code
Disks.update	source code
External_vpn_gateways.delete	source code
External_vpn_gateways.get	source code
External_vpn_gateways.insert	source code
External_vpn_gateways.list	source code
External_vpn_gateways.set_labels	source code
External_vpn_gateways.test_iam_permissions	source code
Firewall_policies.add_association	source code
Firewall_policies.add_rule	source code
Firewall_policies.clone_rules	source code
Firewall_policies.delete	source code
Firewall_policies.get	source code
Firewall_policies.get_association	source code
Firewall_policies.get_iam_policy	source code
Firewall_policies.get_rule	source code
Firewall_policies.insert	source code
Firewall_policies.list	source code
Firewall_policies.list_associations	source code
Firewall_policies.move	source code
Firewall_policies.patch	source code
Firewall_policies.patch_rule	source code
Firewall_policies.remove_association	source code
Firewall_policies.remove_rule	source code
Firewall_policies.set_iam_policy	source code
Firewall_policies.test_iam_permissions	source code
Firewalls.delete	source code
Firewalls.get	source code
Firewalls.insert	source code
Firewalls.list	source code
Firewalls.patch	source code
Firewalls.update	source code
Forwarding_rules.aggregated_list	source code
Forwarding_rules.delete	source code
Forwarding_rules.get	source code
Forwarding_rules.insert	source code
Forwarding_rules.list	source code
Forwarding_rules.patch	source code
Forwarding_rules.set_labels	source code
Forwarding_rules.set_target	source code
Global_addresses.delete	source code
Global_addresses.get	source code
Global_addresses.insert	source code
Global_addresses.list	source code
Global_addresses.set_labels	source code
Global_forwarding_rules.delete	source code
Global_forwarding_rules.get	source code
Global_forwarding_rules.insert	source code
Global_forwarding_rules.list	source code
Global_forwarding_rules.patch	source code
Global_forwarding_rules.set_labels	source code
Global_forwarding_rules.set_target	source code
Global_network_endpoint_groups.attach_network_endpoints	source code
Global_network_endpoint_groups.delete	source code
Global_network_endpoint_groups.detach_network_endpoints	source code
Global_network_endpoint_groups.get	source code
Global_network_endpoint_groups.insert	source code
Global_network_endpoint_groups.list	source code
Global_network_endpoint_groups.list_network_endpoints	source code
Global_operations.aggregated_list	source code
Global_operations.delete	source code
Global_operations.get	source code
Global_operations.list	source code
Global_operations.wait	source code
Global_organization_operations.delete	source code
Global_organization_operations.get	source code
Global_organization_operations.list	source code
Global_public_delegated_prefixes.delete	source code
Global_public_delegated_prefixes.get	source code
Global_public_delegated_prefixes.insert	source code
Global_public_delegated_prefixes.list	source code
Global_public_delegated_prefixes.patch	source code
Health_checks.aggregated_list	source code
Health_checks.delete	source code
Health_checks.get	source code
Health_checks.insert	source code
Health_checks.list	source code
Health_checks.patch	source code
Health_checks.update	source code
Image_family_views.get	source code
Images.delete	source code
Images.deprecate	source code
Images.get	source code
Images.get_from_family	source code
Images.get_iam_policy	source code
Images.insert	source code
Images.list	source code
Images.patch	source code
Images.set_iam_policy	source code
Images.set_labels	source code
Images.test_iam_permissions	source code
Instance_group_managers.abandon_instances	source code
Instance_group_managers.aggregated_list	source code
Instance_group_managers.apply_updates_to_instances	source code
Instance_group_managers.create_instances	source code
Instance_group_managers.delete	source code
Instance_group_managers.delete_instances	source code
Instance_group_managers.delete_per_instance_configs	source code
Instance_group_managers.get	source code
Instance_group_managers.insert	source code
Instance_group_managers.list	source code
Instance_group_managers.list_errors	source code
Instance_group_managers.list_managed_instances	source code
Instance_group_managers.list_per_instance_configs	source code
Instance_group_managers.patch	source code
Instance_group_managers.patch_per_instance_configs	source code
Instance_group_managers.recreate_instances	source code
Instance_group_managers.resize	source code
Instance_group_managers.set_instance_template	source code
Instance_group_managers.set_target_pools	source code
Instance_group_managers.update_per_instance_configs	source code
Instance_groups.add_instances	source code
Instance_groups.aggregated_list	source code
Instance_groups.delete	source code
Instance_groups.get	source code
Instance_groups.insert	source code
Instance_groups.list	source code
Instance_groups.list_instances	source code
Instance_groups.remove_instances	source code
Instance_groups.set_named_ports	source code
Instance_templates.aggregated_list	source code
Instance_templates.delete	source code
Instance_templates.get	source code
Instance_templates.get_iam_policy	source code
Instance_templates.insert	source code
Instance_templates.list	source code
Instance_templates.set_iam_policy	source code
Instance_templates.test_iam_permissions	source code
Instances.add_access_config	source code
Instances.add_resource_policies	source code
Instances.aggregated_list	source code
Instances.attach_disk	source code
Instances.bulk_insert	source code
Instances.delete	source code
Instances.delete_access_config	source code
Instances.detach_disk	source code
Instances.get	source code
Instances.get_effective_firewalls	source code
Instances.get_guest_attributes	source code
Instances.get_iam_policy	source code
Instances.get_screenshot	source code
Instances.get_serial_port_output	source code
Instances.get_shielded_instance_identity	source code
Instances.insert	source code
Instances.list	source code
Instances.list_referrers	source code
Instances.remove_resource_policies	source code
Instances.reset	source code
Instances.resume	source code
Instances.send_diagnostic_interrupt	source code
Instances.set_deletion_protection	source code
Instances.set_disk_auto_delete	source code
Instances.set_iam_policy	source code
Instances.set_labels	source code
Instances.set_machine_resources	source code
Instances.set_machine_type	source code
Instances.set_metadata	source code
Instances.set_min_cpu_platform	source code
Instances.set_name	source code
Instances.set_scheduling	source code
Instances.set_service_account	source code
Instances.set_shielded_instance_integrity_policy	source code
Instances.set_tags	source code
Instances.simulate_maintenance_event	source code
Instances.start	source code
Instances.start_with_encryption_key	source code
Instances.stop	source code
Instances.suspend	source code
Instances.test_iam_permissions	source code
Instances.update	source code
Instances.update_access_config	source code
Instances.update_display_device	source code
Instances.update_network_interface	source code
Instances.update_shielded_instance_config	source code
Interconnect_attachments.aggregated_list	source code
Interconnect_attachments.delete	source code
Interconnect_attachments.get	source code
Interconnect_attachments.insert	source code
Interconnect_attachments.list	source code
Interconnect_attachments.patch	source code
Interconnect_attachments.set_labels	source code
Interconnect_locations.get	source code
Interconnect_locations.list	source code
Interconnects.delete	source code
Interconnects.get	source code
Interconnects.get_diagnostics	source code
Interconnects.insert	source code
Interconnects.list	source code
Interconnects.patch	source code
Interconnects.set_labels	source code
License_codes.get	source code
License_codes.test_iam_permissions	source code
Licenses.delete	source code
Licenses.get	source code
Licenses.get_iam_policy	source code
Licenses.insert	source code
Licenses.list	source code
Licenses.set_iam_policy	source code
Licenses.test_iam_permissions	source code
Machine_images.delete	source code
Machine_images.get	source code
Machine_images.get_iam_policy	source code
Machine_images.insert	source code
Machine_images.list	source code
Machine_images.set_iam_policy	source code
Machine_images.test_iam_permissions	source code
Machine_types.aggregated_list	source code
Machine_types.get	source code
Machine_types.list	source code
Network_attachments.aggregated_list	source code
Network_attachments.delete	source code
Network_attachments.get	source code
Network_attachments.get_iam_policy	source code
Network_attachments.insert	source code
Network_attachments.list	source code
Network_attachments.set_iam_policy	source code
Network_attachments.test_iam_permissions	source code
Network_edge_security_services.aggregated_list	source code
Network_edge_security_services.delete	source code
Network_edge_security_services.get	source code
Network_edge_security_services.insert	source code
Network_edge_security_services.patch	source code
Network_endpoint_groups.aggregated_list	source code
Network_endpoint_groups.attach_network_endpoints	source code
Network_endpoint_groups.delete	source code
Network_endpoint_groups.detach_network_endpoints	source code
Network_endpoint_groups.get	source code
Network_endpoint_groups.insert	source code
Network_endpoint_groups.list	source code
Network_endpoint_groups.list_network_endpoints	source code
Network_endpoint_groups.test_iam_permissions	source code
Network_firewall_policies.add_association	source code
Network_firewall_policies.add_rule	source code
Network_firewall_policies.clone_rules	source code
Network_firewall_policies.delete	source code
Network_firewall_policies.get	source code
Network_firewall_policies.get_association	source code
Network_firewall_policies.get_iam_policy	source code
Network_firewall_policies.get_rule	source code
Network_firewall_policies.insert	source code
Network_firewall_policies.list	source code
Network_firewall_policies.patch	source code
Network_firewall_policies.patch_rule	source code
Network_firewall_policies.remove_association	source code
Network_firewall_policies.remove_rule	source code
Network_firewall_policies.set_iam_policy	source code
Network_firewall_policies.test_iam_permissions	source code
Networks.add_peering	source code
Networks.delete	source code
Networks.get	source code
Networks.get_effective_firewalls	source code
Networks.insert	source code
Networks.list	source code
Networks.list_peering_routes	source code
Networks.patch	source code
Networks.remove_peering	source code
Networks.switch_to_custom_mode	source code
Networks.update_peering	source code
Node_groups.add_nodes	source code
Node_groups.aggregated_list	source code
Node_groups.delete	source code
Node_groups.delete_nodes	source code
Node_groups.get	source code
Node_groups.get_iam_policy	source code
Node_groups.insert	source code
Node_groups.list	source code
Node_groups.list_nodes	source code
Node_groups.patch	source code
Node_groups.set_iam_policy	source code
Node_groups.set_node_template	source code
Node_groups.simulate_maintenance_event	source code
Node_groups.test_iam_permissions	source code
Node_templates.aggregated_list	source code
Node_templates.delete	source code
Node_templates.get	source code
Node_templates.get_iam_policy	source code
Node_templates.insert	source code
Node_templates.list	source code
Node_templates.set_iam_policy	source code
Node_templates.test_iam_permissions	source code
Node_types.aggregated_list	source code
Node_types.get	source code
Node_types.list	source code
Packet_mirrorings.aggregated_list	source code
Packet_mirrorings.delete	source code
Packet_mirrorings.get	source code
Packet_mirrorings.insert	source code
Packet_mirrorings.list	source code
Packet_mirrorings.patch	source code
Packet_mirrorings.test_iam_permissions	source code
Projects.disable_xpn_host	source code
Projects.disable_xpn_resource	source code
Projects.enable_xpn_host	source code
Projects.enable_xpn_resource	source code
Projects.get	source code
Projects.get_xpn_host	source code
Projects.get_xpn_resources	source code
Projects.list_xpn_hosts	source code
Projects.move_disk	source code
Projects.move_instance	source code
Projects.set_common_instance_metadata	source code
Projects.set_default_network_tier	source code
Projects.set_usage_export_bucket	source code
Public_advertised_prefixes.delete	source code
Public_advertised_prefixes.get	source code
Public_advertised_prefixes.insert	source code
Public_advertised_prefixes.list	source code
Public_advertised_prefixes.patch	source code
Public_delegated_prefixes.aggregated_list	source code
Public_delegated_prefixes.delete	source code
Public_delegated_prefixes.get	source code
Public_delegated_prefixes.insert	source code
Public_delegated_prefixes.list	source code
Public_delegated_prefixes.patch	source code
Region_autoscalers.delete	source code
Region_autoscalers.get	source code
Region_autoscalers.insert	source code
Region_autoscalers.list	source code
Region_autoscalers.patch	source code
Region_autoscalers.update	source code
Region_backend_services.delete	source code
Region_backend_services.get	source code
Region_backend_services.get_health	source code
Region_backend_services.get_iam_policy	source code
Region_backend_services.insert	source code
Region_backend_services.list	source code
Region_backend_services.patch	source code
Region_backend_services.set_iam_policy	source code
Region_backend_services.update	source code
Region_commitments.aggregated_list	source code
Region_commitments.get	source code
Region_commitments.insert	source code
Region_commitments.list	source code
Region_commitments.update	source code
Region_disk_types.get	source code
Region_disk_types.list	source code
Region_disks.add_resource_policies	source code
Region_disks.create_snapshot	source code
Region_disks.delete	source code
Region_disks.get	source code
Region_disks.get_iam_policy	source code
Region_disks.insert	source code
Region_disks.list	source code
Region_disks.remove_resource_policies	source code
Region_disks.resize	source code
Region_disks.set_iam_policy	source code
Region_disks.set_labels	source code
Region_disks.test_iam_permissions	source code
Region_disks.update	source code
Region_health_check_services.delete	source code
Region_health_check_services.get	source code
Region_health_check_services.insert	source code
Region_health_check_services.list	source code
Region_health_check_services.patch	source code
Region_health_checks.delete	source code
Region_health_checks.get	source code
Region_health_checks.insert	source code
Region_health_checks.list	source code
Region_health_checks.patch	source code
Region_health_checks.update	source code
Region_instance_group_managers.abandon_instances	source code
Region_instance_group_managers.apply_updates_to_instances	source code
Region_instance_group_managers.create_instances	source code
Region_instance_group_managers.delete	source code
Region_instance_group_managers.delete_instances	source code
Region_instance_group_managers.delete_per_instance_configs	source code
Region_instance_group_managers.get	source code
Region_instance_group_managers.insert	source code
Region_instance_group_managers.list	source code
Region_instance_group_managers.list_errors	source code
Region_instance_group_managers.list_managed_instances	source code
Region_instance_group_managers.list_per_instance_configs	source code
Region_instance_group_managers.patch	source code
Region_instance_group_managers.patch_per_instance_configs	source code
Region_instance_group_managers.recreate_instances	source code
Region_instance_group_managers.resize	source code
Region_instance_group_managers.set_instance_template	source code
Region_instance_group_managers.set_target_pools	source code
Region_instance_group_managers.update_per_instance_configs	source code
Region_instance_groups.get	source code
Region_instance_groups.list	source code
Region_instance_groups.list_instances	source code
Region_instance_groups.set_named_ports	source code
Region_instance_templates.delete	source code
Region_instance_templates.get	source code
Region_instance_templates.insert	source code
Region_instance_templates.list	source code
Region_instances.bulk_insert	source code
Region_network_endpoint_groups.delete	source code
Region_network_endpoint_groups.get	source code
Region_network_endpoint_groups.insert	source code
Region_network_endpoint_groups.list	source code
Region_network_firewall_policies.add_association	source code
Region_network_firewall_policies.add_rule	source code
Region_network_firewall_policies.clone_rules	source code
Region_network_firewall_policies.delete	source code
Region_network_firewall_policies.get	source code
Region_network_firewall_policies.get_association	source code