API Reference

This API reference is organized by resource type. Each resource type has one or more data representations and one or more methods.

Resource types

  1. Addresses
  2. Autoscalers
  3. BackendBuckets
  4. BackendServices
  5. DiskTypes
  6. Disks
  7. Firewalls
  8. ForwardingRules
  9. GlobalAddresses
  10. GlobalForwardingRules
  11. GlobalOperations
  12. HealthChecks
  13. HttpHealthChecks
  14. HttpsHealthChecks
  15. Images
  16. InstanceGroupManagers
  17. InstanceGroups
  18. InstanceTemplates
  19. Instances
  20. Licenses
  21. MachineTypes
  22. Networks
  23. Projects
  24. RegionAutoscalers
  25. RegionBackendServices
  26. RegionInstanceGroupManagers
  27. RegionInstanceGroups
  28. RegionOperations
  29. Regions
  30. Routers
  31. Routes
  32. Snapshots
  33. SslCertificates
  34. Subnetworks
  35. TargetHttpProxies
  36. TargetHttpsProxies
  37. TargetInstances
  38. TargetPools
  39. TargetSslProxies
  40. TargetVpnGateways
  41. UrlMaps
  42. VpnTunnels
  43. ZoneOperations
  44. Zones

Addresses

For Addresses Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
aggregatedList GET  /project/aggregated/addresses Retrieves an aggregated list of addresses.
delete DELETE  /project/regions/region/addresses/address Deletes the specified address resource.
get GET  /project/regions/region/addresses/address Returns the specified address resource.
insert POST  /project/regions/region/addresses Creates an address resource in the specified project using the data included in the request.
list GET  /project/regions/region/addresses Retrieves a list of addresses contained within the specified region.

Autoscalers

For Autoscalers Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
aggregatedList GET  /project/aggregated/autoscalers Retrieves an aggregated list of autoscalers.
delete DELETE  /project/zones/zone/autoscalers/autoscaler Deletes the specified autoscaler.
get GET  /project/zones/zone/autoscalers/autoscaler Returns the specified autoscaler resource. Get a list of available autoscalers by making a list() request.
insert POST  /project/zones/zone/autoscalers Creates an autoscaler in the specified project using the data included in the request.
list GET  /project/zones/zone/autoscalers Retrieves a list of autoscalers contained within the specified zone.
patch PATCH  /project/zones/zone/autoscalers Updates an autoscaler in the specified project using the data included in the request. This method supports patch semantics.

Required query parameters: autoscaler

update PUT  /project/zones/zone/autoscalers Updates an autoscaler in the specified project using the data included in the request.

BackendBuckets

For BackendBuckets Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
delete DELETE  /project/global/backendBuckets/backendBucket Deletes the specified BackendBucket resource.
get GET  /project/global/backendBuckets/backendBucket Returns the specified BackendBucket resource. Get a list of available backend buckets by making a list() request.
insert POST  /project/global/backendBuckets Creates a BackendBucket resource in the specified project using the data included in the request.
list GET  /project/global/backendBuckets Retrieves the list of BackendBucket resources available to the specified project.
patch PATCH  /project/global/backendBuckets/backendBucket Updates the specified BackendBucket resource with the data included in the request. This method supports patch semantics.
update PUT  /project/global/backendBuckets/backendBucket Updates the specified BackendBucket resource with the data included in the request.

BackendServices

For BackendServices Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
delete DELETE  /project/global/backendServices/backendService Deletes the specified BackendService resource.
get GET  /project/global/backendServices/backendService Returns the specified BackendService resource. Get a list of available backend services by making a list() request.
getHealth POST  /project/global/backendServices/backendService/getHealth Gets the most recent health check results for this BackendService.
insert POST  /project/global/backendServices Creates a BackendService resource in the specified project using the data included in the request. There are several restrictions and guidelines to keep in mind when creating a backend service. Read Restrictions and Guidelines for more information.
list GET  /project/global/backendServices Retrieves the list of BackendService resources available to the specified project.
patch PATCH  /project/global/backendServices/backendService Updates the specified BackendService resource with the data included in the request. There are several restrictions and guidelines to keep in mind when updating a backend service. Read Restrictions and Guidelines for more information. This method supports patch semantics.
update PUT  /project/global/backendServices/backendService Updates the specified BackendService resource with the data included in the request. There are several restrictions and guidelines to keep in mind when updating a backend service. Read Restrictions and Guidelines for more information.

DiskTypes

For DiskTypes Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
aggregatedList GET  /project/aggregated/diskTypes Retrieves an aggregated list of disk types.
get GET  /project/zones/zone/diskTypes/diskType Returns the specified disk type. Get a list of available disk types by making a list() request.
list GET  /project/zones/zone/diskTypes Retrieves a list of disk types available to the specified project.

Disks

For Disks Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
aggregatedList GET  /project/aggregated/disks Retrieves an aggregated list of persistent disks.
createSnapshot POST  /project/zones/zone/disks/disk/createSnapshot Creates a snapshot of a specified persistent disk.
delete DELETE  /project/zones/zone/disks/disk Deletes the specified persistent disk. Deleting a disk removes its data permanently and is irreversible. However, deleting a disk does not delete any snapshots previously made from the disk. You must separately delete snapshots.
get GET  /project/zones/zone/disks/disk Returns a specified persistent disk. Get a list of available persistent disks by making a list() request.
insert POST  /project/zones/zone/disks Creates a persistent disk in the specified project using the data in the request. You can create a disk with a sourceImage, a sourceSnapshot, or create an empty 500 GB data disk by omitting all properties. You can also create a disk that is larger than the default size by specifying the sizeGb property.
list GET  /project/zones/zone/disks Retrieves a list of persistent disks contained within the specified zone.
resize POST  /project/zones/zone/disks/disk/resize Resizes the specified persistent disk.

Firewalls

For Firewalls Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
delete DELETE  /project/global/firewalls/firewall Deletes the specified firewall.
get GET  /project/global/firewalls/firewall Returns the specified firewall.
insert POST  /project/global/firewalls Creates a firewall rule in the specified project using the data included in the request.
list GET  /project/global/firewalls Retrieves the list of firewall rules available to the specified project.
patch PATCH  /project/global/firewalls/firewall Updates the specified firewall rule with the data included in the request. This method supports patch semantics.
update PUT  /project/global/firewalls/firewall Updates the specified firewall rule with the data included in the request.

ForwardingRules

For ForwardingRules Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
aggregatedList GET  /project/aggregated/forwardingRules Retrieves an aggregated list of forwarding rules.
delete DELETE  /project/regions/region/forwardingRules/forwardingRule Deletes the specified ForwardingRule resource.
get GET  /project/regions/region/forwardingRules/forwardingRule Returns the specified ForwardingRule resource.
insert POST  /project/regions/region/forwardingRules Creates a ForwardingRule resource in the specified project and region using the data included in the request.
list GET  /project/regions/region/forwardingRules Retrieves a list of ForwardingRule resources available to the specified project and region.
setTarget POST  /project/regions/region/forwardingRules/forwardingRule/setTarget Changes target URL for forwarding rule. The new target should be of the same type as the old target.

GlobalAddresses

For GlobalAddresses Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
delete DELETE  /project/global/addresses/address Deletes the specified address resource.
get GET  /project/global/addresses/address Returns the specified address resource. Get a list of available addresses by making a list() request.
insert POST  /project/global/addresses Creates an address resource in the specified project using the data included in the request.
list GET  /project/global/addresses Retrieves a list of global addresses.

GlobalForwardingRules

For GlobalForwardingRules Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
delete DELETE  /project/global/forwardingRules/forwardingRule Deletes the specified ForwardingRule resource.
get GET  /project/global/forwardingRules/forwardingRule Returns the specified ForwardingRule resource. Get a list of available forwarding rules by making a list() request.
insert POST  /project/global/forwardingRules Creates a ForwardingRule resource in the specified project and region using the data included in the request.
list GET  /project/global/forwardingRules Retrieves a list of ForwardingRule resources available to the specified project.
setTarget POST  /project/global/forwardingRules/forwardingRule/setTarget Changes target URL for forwarding rule. The new target should be of the same type as the old target.

GlobalOperations

For GlobalOperations Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
aggregatedList GET  /project/aggregated/operations Retrieves an aggregated list of all operations.
delete DELETE  /project/global/operations/operation Deletes the specified Operations resource.
get GET  /project/global/operations/operation Retrieves the specified Operations resource. Get a list of operations by making a list() request.
list GET  /project/global/operations Retrieves a list of Operation resources contained within the specified project.

HealthChecks

For HealthChecks Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
delete DELETE  /project/global/healthChecks/healthCheck Deletes the specified HealthCheck resource.
get GET  /project/global/healthChecks/healthCheck Returns the specified HealthCheck resource. Get a list of available health checks by making a list() request.
insert POST  /project/global/healthChecks Creates a HealthCheck resource in the specified project using the data included in the request.
list GET  /project/global/healthChecks Retrieves the list of HealthCheck resources available to the specified project.
patch PATCH  /project/global/healthChecks/healthCheck Updates a HealthCheck resource in the specified project using the data included in the request. This method supports patch semantics.
update PUT  /project/global/healthChecks/healthCheck Updates a HealthCheck resource in the specified project using the data included in the request.

HttpHealthChecks

For HttpHealthChecks Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
delete DELETE  /project/global/httpHealthChecks/httpHealthCheck Deletes the specified HttpHealthCheck resource.
get GET  /project/global/httpHealthChecks/httpHealthCheck Returns the specified HttpHealthCheck resource. Get a list of available HTTP health checks by making a list() request.
insert POST  /project/global/httpHealthChecks Creates a HttpHealthCheck resource in the specified project using the data included in the request.
list GET  /project/global/httpHealthChecks Retrieves the list of HttpHealthCheck resources available to the specified project.
patch PATCH  /project/global/httpHealthChecks/httpHealthCheck Updates a HttpHealthCheck resource in the specified project using the data included in the request. This method supports patch semantics.
update PUT  /project/global/httpHealthChecks/httpHealthCheck Updates a HttpHealthCheck resource in the specified project using the data included in the request.

HttpsHealthChecks

For HttpsHealthChecks Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
delete DELETE  /project/global/httpsHealthChecks/httpsHealthCheck Deletes the specified HttpsHealthCheck resource.
get GET  /project/global/httpsHealthChecks/httpsHealthCheck Returns the specified HttpsHealthCheck resource. Get a list of available HTTPS health checks by making a list() request.
insert POST  /project/global/httpsHealthChecks Creates a HttpsHealthCheck resource in the specified project using the data included in the request.
list GET  /project/global/httpsHealthChecks Retrieves the list of HttpsHealthCheck resources available to the specified project.
patch PATCH  /project/global/httpsHealthChecks/httpsHealthCheck Updates a HttpsHealthCheck resource in the specified project using the data included in the request. This method supports patch semantics.
update PUT  /project/global/httpsHealthChecks/httpsHealthCheck Updates a HttpsHealthCheck resource in the specified project using the data included in the request.

Images

For Images Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
delete DELETE  /project/global/images/image Deletes the specified image.
deprecate POST  /project/global/images/image/deprecate Sets the deprecation status of an image.

If an empty request body is given, clears the deprecation status instead.
get GET  /project/global/images/image Returns the specified image. Get a list of available images by making a list() request.
getFromFamily GET  /project/global/images/family/family Returns the latest image that is part of an image family and is not deprecated.
insert POST  /project/global/images Creates an image in the specified project using the data included in the request.
list GET  /project/global/images Retrieves the list of private images available to the specified project. Private images are images you create that belong to your project. This method does not get any images that belong to other projects, including publicly-available images, like Debian 8. If you want to get a list of publicly-available images, use this method to make a request to the respective image project, such as debian-cloud or windows-cloud.

InstanceGroupManagers

For InstanceGroupManagers Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
abandonInstances POST  /project/zones/zone/instanceGroupManagers/instanceGroupManager/abandonInstances Schedules a group action to remove the specified instances from the managed instance group. Abandoning an instance does not delete the instance, but it does remove the instance from any target pools that are applied by the managed instance group. This method reduces the targetSize of the managed instance group by the number of instances that you abandon. This operation is marked as DONE when the action is scheduled even if the instances have not yet been removed from the group. You must separately verify the status of the abandoning action with the listmanagedinstances method.
aggregatedList GET  /project/aggregated/instanceGroupManagers Retrieves the list of managed instance groups and groups them by zone.
delete DELETE  /project/zones/zone/instanceGroupManagers/instanceGroupManager Deletes the specified managed instance group and all of the instances in that group. Note that the instance group must not belong to a backend service. Read Deleting an instance group for more information.
deleteInstances POST  /project/zones/zone/instanceGroupManagers/instanceGroupManager/deleteInstances Schedules a group action to delete the specified instances in the managed instance group. The instances are also removed from any target pools of which they were a member. This method reduces the targetSize of the managed instance group by the number of instances that you delete. This operation is marked as DONE when the action is scheduled even if the instances are still being deleted. You must separately verify the status of the deleting action with the listmanagedinstances method.
get GET  /project/zones/zone/instanceGroupManagers/instanceGroupManager Returns all of the details about the specified managed instance group. Get a list of available managed instance groups by making a list() request.
insert POST  /project/zones/zone/instanceGroupManagers Creates a managed instance group using the information that you specify in the request. After the group is created, it schedules an action to create instances in the group using the specified instance template. This operation is marked as DONE when the group is created even if the instances in the group have not yet been created. You must separately verify the status of the individual instances with the listmanagedinstances method.
list GET  /project/zones/zone/instanceGroupManagers Retrieves a list of managed instance groups that are contained within the specified project and zone.
listManagedInstances POST  /project/zones/zone/instanceGroupManagers/instanceGroupManager/listManagedInstances Lists all of the instances in the managed instance group. Each instance in the list has a currentAction, which indicates the action that the managed instance group is performing on the instance. For example, if the group is still creating an instance, the currentAction is CREATING. If a previous action failed, the list displays the errors for that failed action.
recreateInstances POST  /project/zones/zone/instanceGroupManagers/instanceGroupManager/recreateInstances Schedules a group action to recreate the specified instances in the managed instance group. The instances are deleted and recreated using the current instance template for the managed instance group. This operation is marked as DONE when the action is scheduled even if the instances have not yet been recreated. You must separately verify the status of the recreating action with the listmanagedinstances method.
resize POST  /project/zones/zone/instanceGroupManagers/instanceGroupManager/resize Resizes the managed instance group. If you increase the size, the group creates new instances using the current instance template. If you decrease the size, the group deletes instances. The resize operation is marked DONE when the resize actions are scheduled even if the group has not yet added or deleted any instances. You must separately verify the status of the creating or deleting actions with the listmanagedinstances method.

Required query parameters: size

setInstanceTemplate POST  /project/zones/zone/instanceGroupManagers/instanceGroupManager/setInstanceTemplate Specifies the instance template to use when creating new instances in this group. The templates for existing instances in the group do not change unless you recreate them.
setTargetPools POST  /project/zones/zone/instanceGroupManagers/instanceGroupManager/setTargetPools Modifies the target pools to which all instances in this managed instance group are assigned. The target pools automatically apply to all of the instances in the managed instance group. This operation is marked DONE when you make the request even if the instances have not yet been added to their target pools. The change might take some time to apply to all of the instances in the group depending on the size of the group.

InstanceGroups

For InstanceGroups Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
addInstances POST  /project/zones/zone/instanceGroups/instanceGroup/addInstances Adds a list of instances to the specified instance group. All of the instances in the instance group must be in the same network/subnetwork. Read Adding instances for more information.
aggregatedList GET  /project/aggregated/instanceGroups Retrieves the list of instance groups and sorts them by zone.
delete DELETE  /project/zones/zone/instanceGroups/instanceGroup Deletes the specified instance group. The instances in the group are not deleted. Note that instance group must not belong to a backend service. Read Deleting an instance group for more information.
get GET  /project/zones/zone/instanceGroups/instanceGroup Returns the specified instance group. Get a list of available instance groups by making a list() request.
insert POST  /project/zones/zone/instanceGroups Creates an instance group in the specified project using the parameters that are included in the request.
list GET  /project/zones/zone/instanceGroups Retrieves the list of instance groups that are located in the specified project and zone.
listInstances POST  /project/zones/zone/instanceGroups/instanceGroup/listInstances Lists the instances in the specified instance group.
removeInstances POST  /project/zones/zone/instanceGroups/instanceGroup/removeInstances Removes one or more instances from the specified instance group, but does not delete those instances.
setNamedPorts POST  /project/zones/zone/instanceGroups/instanceGroup/setNamedPorts Sets the named ports for the specified instance group.

InstanceTemplates

For InstanceTemplates Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
delete DELETE  /project/global/instanceTemplates/instanceTemplate Deletes the specified instance template. If you delete an instance template that is being referenced from another instance group, the instance group will not be able to create or recreate virtual machine instances. Deleting an instance template is permanent and cannot be undone.
get GET  /project/global/instanceTemplates/instanceTemplate Returns the specified instance template. Get a list of available instance templates by making a list() request.
insert POST  /project/global/instanceTemplates Creates an instance template in the specified project using the data that is included in the request. If you are creating a new template to update an existing instance group, your new instance template must use the same network or, if applicable, the same subnetwork as the original template.
list GET  /project/global/instanceTemplates Retrieves a list of instance templates that are contained within the specified project and zone.

Instances

For Instances Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
addAccessConfig POST  /project/zones/zone/instances/instance/addAccessConfig Adds an access config to an instance's network interface.

Required query parameters: networkInterface

aggregatedList GET  /project/aggregated/instances Retrieves aggregated list of instances.
attachDisk POST  /project/zones/zone/instances/instance/attachDisk Attaches a Disk resource to an instance.
delete DELETE  /project/zones/zone/instances/instance Deletes the specified Instance resource. For more information, see Stopping or Deleting an Instance.
deleteAccessConfig POST  /project/zones/zone/instances/instance/deleteAccessConfig Deletes an access config from an instance's network interface.

Required query parameters: accessConfig, networkInterface

detachDisk POST  /project/zones/zone/instances/instance/detachDisk Detaches a disk from an instance.

Required query parameters: deviceName

get GET  /project/zones/zone/instances/instance Returns the specified Instance resource. Get a list of available instances by making a list() request.
getSerialPortOutput GET  /project/zones/zone/instances/instance/serialPort Returns the specified instance's serial port output.
insert POST  /project/zones/zone/instances Creates an instance resource in the specified project using the data included in the request.
list GET  /project/zones/zone/instances Retrieves the list of instances contained within the specified zone.
reset POST  /project/zones/zone/instances/instance/reset Performs a hard reset on the instance.
setDiskAutoDelete POST  /project/zones/zone/instances/instance/setDiskAutoDelete Sets the auto-delete flag for a disk attached to an instance.

Required query parameters: autoDelete, deviceName

setMachineType POST  /project/zones/zone/instances/instance/setMachineType Changes the machine type for a stopped instance to the machine type specified in the request.
setMetadata POST  /project/zones/zone/instances/instance/setMetadata Sets metadata for the specified instance to the data included in the request.
setScheduling POST  /project/zones/zone/instances/instance/setScheduling Sets an instance's scheduling options.
setTags POST  /project/zones/zone/instances/instance/setTags Sets tags for the specified instance to the data included in the request.
start POST  /project/zones/zone/instances/instance/start Starts an instance that was stopped using the using the instances().stop method. For more information, see Restart an instance.
startWithEncryptionKey POST  /project/zones/zone/instances/instance/startWithEncryptionKey Starts an instance that was stopped using the using the instances().stop method. For more information, see Restart an instance.
stop POST  /project/zones/zone/instances/instance/stop Stops a running instance, shutting it down cleanly, and allows you to restart the instance at a later time. Stopped instances do not incur per-minute, virtual machine usage charges while they are stopped, but any resources that the virtual machine is using, such as persistent disks and static IP addresses, will continue to be charged until they are deleted. For more information, see Stopping an instance.

Licenses

For Licenses Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
get GET  /project/global/licenses/license Returns the specified License resource. Get a list of available licenses by making a list() request.

MachineTypes

For MachineTypes Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
aggregatedList GET  /project/aggregated/machineTypes Retrieves an aggregated list of machine types.
get GET  /project/zones/zone/machineTypes/machineType Returns the specified machine type. Get a list of available machine types by making a list() request.
list GET  /project/zones/zone/machineTypes Retrieves a list of machine types available to the specified project.

Networks

For Networks Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
delete DELETE  /project/global/networks/network Deletes the specified network.
get GET  /project/global/networks/network Returns the specified network. Get a list of available networks by making a list() request.
insert POST  /project/global/networks Creates a network in the specified project using the data included in the request.
list GET  /project/global/networks Retrieves the list of networks available to the specified project.
switchToCustomMode POST  /project/global/networks/network/switchToCustomMode Switches the network mode from auto subnet mode to custom subnet mode.

Projects

For Projects Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
get GET  /project Returns the specified Project resource.
moveDisk POST  /project/moveDisk Moves a persistent disk from one zone to another.
moveInstance POST  /project/moveInstance Moves an instance and its attached persistent disks from one zone to another.
setCommonInstanceMetadata POST  /project/setCommonInstanceMetadata Sets metadata common to all instances within the specified project using the data included in the request.
setUsageExportBucket POST  /project/setUsageExportBucket Enables the usage export feature and sets the usage export bucket where reports are stored. If you provide an empty request body using this method, the usage export feature will be disabled.

RegionAutoscalers

For RegionAutoscalers Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
delete DELETE  /project/regions/region/autoscalers/autoscaler Deletes the specified autoscaler.
get GET  /project/regions/region/autoscalers/autoscaler Returns the specified autoscaler.
insert POST  /project/regions/region/autoscalers Creates an autoscaler in the specified project using the data included in the request.
list GET  /project/regions/region/autoscalers Retrieves a list of autoscalers contained within the specified region.
patch PATCH  /project/regions/region/autoscalers Updates an autoscaler in the specified project using the data included in the request. This method supports patch semantics.

Required query parameters: autoscaler

update PUT  /project/regions/region/autoscalers Updates an autoscaler in the specified project using the data included in the request.

RegionBackendServices

For RegionBackendServices Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
delete DELETE  /project/regions/region/backendServices/backendService Deletes the specified regional BackendService resource.
get GET  /project/regions/region/backendServices/backendService Returns the specified regional BackendService resource.
getHealth POST  /project/regions/region/backendServices/backendService/getHealth Gets the most recent health check results for this regional BackendService.
insert POST  /project/regions/region/backendServices Creates a regional BackendService resource in the specified project using the data included in the request. There are several restrictions and guidelines to keep in mind when creating a regional backend service. Read Restrictions and Guidelines for more information.

list GET  /project/regions/region/backendServices Retrieves the list of regional BackendService resources available to the specified project in the given region.
patch PATCH  /project/regions/region/backendServices/backendService Updates the specified regional BackendService resource with the data included in the request. There are several restrictions and guidelines to keep in mind when updating a backend service. Read Restrictions and Guidelines for more information. This method supports patch semantics.
update PUT  /project/regions/region/backendServices/backendService Updates the specified regional BackendService resource with the data included in the request. There are several restrictions and guidelines to keep in mind when updating a backend service. Read Restrictions and Guidelines for more information.

RegionInstanceGroupManagers

For RegionInstanceGroupManagers Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
abandonInstances POST  /project/regions/region/instanceGroupManagers/instanceGroupManager/abandonInstances Schedules a group action to remove the specified instances from the managed instance group. Abandoning an instance does not delete the instance, but it does remove the instance from any target pools that are applied by the managed instance group. This method reduces the targetSize of the managed instance group by the number of instances that you abandon. This operation is marked as DONE when the action is scheduled even if the instances have not yet been removed from the group. You must separately verify the status of the abandoning action with the listmanagedinstances method.
delete DELETE  /project/regions/region/instanceGroupManagers/instanceGroupManager Deletes the specified managed instance group and all of the instances in that group.
deleteInstances POST  /project/regions/region/instanceGroupManagers/instanceGroupManager/deleteInstances Schedules a group action to delete the specified instances in the managed instance group. The instances are also removed from any target pools of which they were a member. This method reduces the targetSize of the managed instance group by the number of instances that you delete. This operation is marked as DONE when the action is scheduled even if the instances are still being deleted. You must separately verify the status of the deleting action with the listmanagedinstances method.
get GET  /project/regions/region/instanceGroupManagers/instanceGroupManager Returns all of the details about the specified managed instance group.
insert POST  /project/regions/region/instanceGroupManagers Creates a managed instance group using the information that you specify in the request. After the group is created, it schedules an action to create instances in the group using the specified instance template. This operation is marked as DONE when the group is created even if the instances in the group have not yet been created. You must separately verify the status of the individual instances with the listmanagedinstances method.
list GET  /project/regions/region/instanceGroupManagers Retrieves the list of managed instance groups that are contained within the specified region.
listManagedInstances POST  /project/regions/region/instanceGroupManagers/instanceGroupManager/listManagedInstances Lists the instances in the managed instance group and instances that are scheduled to be created. The list includes any current actions that the group has scheduled for its instances.
recreateInstances POST  /project/regions/region/instanceGroupManagers/instanceGroupManager/recreateInstances Schedules a group action to recreate the specified instances in the managed instance group. The instances are deleted and recreated using the current instance template for the managed instance group. This operation is marked as DONE when the action is scheduled even if the instances have not yet been recreated. You must separately verify the status of the recreating action with the listmanagedinstances method.
resize POST  /project/regions/region/instanceGroupManagers/instanceGroupManager/resize Changes the intended size for the managed instance group. If you increase the size, the group schedules actions to create new instances using the current instance template. If you decrease the size, the group schedules delete actions on one or more instances. The resize operation is marked DONE when the resize actions are scheduled even if the group has not yet added or deleted any instances. You must separately verify the status of the creating or deleting actions with the listmanagedinstances method.

Required query parameters: size

setInstanceTemplate POST  /project/regions/region/instanceGroupManagers/instanceGroupManager/setInstanceTemplate Sets the instance template to use when creating new instances or recreating instances in this group. Existing instances are not affected.
setTargetPools POST  /project/regions/region/instanceGroupManagers/instanceGroupManager/setTargetPools Modifies the target pools to which all new instances in this group are assigned. Existing instances in the group are not affected.

RegionInstanceGroups

For RegionInstanceGroups Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
get GET  /project/regions/region/instanceGroups/instanceGroup Returns the specified instance group resource.
list GET  /project/regions/region/instanceGroups Retrieves the list of instance group resources contained within the specified region.
listInstances POST  /project/regions/region/instanceGroups/instanceGroup/listInstances Lists the instances in the specified instance group and displays information about the named ports. Depending on the specified options, this method can list all instances or only the instances that are running.
setNamedPorts POST  /project/regions/region/instanceGroups/instanceGroup/setNamedPorts Sets the named ports for the specified regional instance group.

RegionOperations

For RegionOperations Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
delete DELETE  /project/regions/region/operations/operation Deletes the specified region-specific Operations resource.
get GET  /project/regions/region/operations/operation Retrieves the specified region-specific Operations resource.
list GET  /project/regions/region/operations Retrieves a list of Operation resources contained within the specified region.

Regions

For Regions Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
get GET  /project/regions/region Returns the specified Region resource. Get a list of available regions by making a list() request.
list GET  /project/regions Retrieves the list of region resources available to the specified project.

Routers

For Routers Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
aggregatedList GET  /project/aggregated/routers Retrieves an aggregated list of routers.
delete DELETE  /project/regions/region/routers/router Deletes the specified Router resource.
get GET  /project/regions/region/routers/router Returns the specified Router resource. Get a list of available routers by making a list() request.
getRouterStatus GET  /project/regions/region/routers/router/getRouterStatus Retrieves runtime information of the specified router.
insert POST  /project/regions/region/routers Creates a Router resource in the specified project and region using the data included in the request.
list GET  /project/regions/region/routers Retrieves a list of Router resources available to the specified project.
patch PATCH  /project/regions/region/routers/router Updates the specified Router resource with the data included in the request. This method supports patch semantics.
update PUT  /project/regions/region/routers/router Updates the specified Router resource with the data included in the request.

Routes

For Routes Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
delete DELETE  /project/global/routes/route Deletes the specified Route resource.
get GET  /project/global/routes/route Returns the specified Route resource. Get a list of available routes by making a list() request.
insert POST  /project/global/routes Creates a Route resource in the specified project using the data included in the request.
list GET  /project/global/routes Retrieves the list of Route resources available to the specified project.

Snapshots

For Snapshots Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
delete DELETE  /project/global/snapshots/snapshot Deletes the specified Snapshot resource. Keep in mind that deleting a single snapshot might not necessarily delete all the data on that snapshot. If any data on the snapshot that is marked for deletion is needed for subsequent snapshots, the data will be moved to the next corresponding snapshot.

For more information, see Deleting snaphots.
get GET  /project/global/snapshots/snapshot Returns the specified Snapshot resource. Get a list of available snapshots by making a list() request.
list GET  /project/global/snapshots Retrieves the list of Snapshot resources contained within the specified project.

SslCertificates

For SslCertificates Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
delete DELETE  /project/global/sslCertificates/sslCertificate Deletes the specified SslCertificate resource.
get GET  /project/global/sslCertificates/sslCertificate Returns the specified SslCertificate resource. Get a list of available SSL certificates by making a list() request.
insert POST  /project/global/sslCertificates Creates a SslCertificate resource in the specified project using the data included in the request.
list GET  /project/global/sslCertificates Retrieves the list of SslCertificate resources available to the specified project.

Subnetworks

For Subnetworks Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
aggregatedList GET  /project/aggregated/subnetworks Retrieves an aggregated list of subnetworks.
delete DELETE  /project/regions/region/subnetworks/subnetwork Deletes the specified subnetwork.
expandIpCidrRange POST  /project/regions/region/subnetworks/subnetwork/expandIpCidrRange Expands the IP CIDR range of the subnetwork to a specified value.
get GET  /project/regions/region/subnetworks/subnetwork Returns the specified subnetwork. Get a list of available subnetworks list() request.
insert POST  /project/regions/region/subnetworks Creates a subnetwork in the specified project using the data included in the request.
list GET  /project/regions/region/subnetworks Retrieves a list of subnetworks available to the specified project.

TargetHttpProxies

For TargetHttpProxies Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
delete DELETE  /project/global/targetHttpProxies/targetHttpProxy Deletes the specified TargetHttpProxy resource.
get GET  /project/global/targetHttpProxies/targetHttpProxy Returns the specified TargetHttpProxy resource. Get a list of available target HTTP proxies by making a list() request.
insert POST  /project/global/targetHttpProxies Creates a TargetHttpProxy resource in the specified project using the data included in the request.
list GET  /project/global/targetHttpProxies Retrieves the list of TargetHttpProxy resources available to the specified project.
setUrlMap POST  /project/targetHttpProxies/targetHttpProxy/setUrlMap Changes the URL map for TargetHttpProxy.

TargetHttpsProxies

For TargetHttpsProxies Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
delete DELETE  /project/global/targetHttpsProxies/targetHttpsProxy Deletes the specified TargetHttpsProxy resource.
get GET  /project/global/targetHttpsProxies/targetHttpsProxy Returns the specified TargetHttpsProxy resource. Get a list of available target HTTPS proxies by making a list() request.
insert POST  /project/global/targetHttpsProxies Creates a TargetHttpsProxy resource in the specified project using the data included in the request.
list GET  /project/global/targetHttpsProxies Retrieves the list of TargetHttpsProxy resources available to the specified project.
setSslCertificates POST  /project/targetHttpsProxies/targetHttpsProxy/setSslCertificates Replaces SslCertificates for TargetHttpsProxy.
setUrlMap POST  /project/targetHttpsProxies/targetHttpsProxy/setUrlMap Changes the URL map for TargetHttpsProxy.

TargetInstances

For TargetInstances Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
aggregatedList GET  /project/aggregated/targetInstances Retrieves an aggregated list of target instances.
delete DELETE  /project/zones/zone/targetInstances/targetInstance Deletes the specified TargetInstance resource.
get GET  /project/zones/zone/targetInstances/targetInstance Returns the specified TargetInstance resource. Get a list of available target instances by making a list() request.
insert POST  /project/zones/zone/targetInstances Creates a TargetInstance resource in the specified project and zone using the data included in the request.
list GET  /project/zones/zone/targetInstances Retrieves a list of TargetInstance resources available to the specified project and zone.

TargetPools

For TargetPools Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
addHealthCheck POST  /project/regions/region/targetPools/targetPool/addHealthCheck Adds health check URLs to a target pool.
addInstance POST  /project/regions/region/targetPools/targetPool/addInstance Adds an instance to a target pool.
aggregatedList GET  /project/aggregated/targetPools Retrieves an aggregated list of target pools.
delete DELETE  /project/regions/region/targetPools/targetPool Deletes the specified target pool.
get GET  /project/regions/region/targetPools/targetPool Returns the specified target pool. Get a list of available target pools by making a list() request.
getHealth POST  /project/regions/region/targetPools/targetPool/getHealth Gets the most recent health check results for each IP for the instance that is referenced by the given target pool.
insert POST  /project/regions/region/targetPools Creates a target pool in the specified project and region using the data included in the request.
list GET  /project/regions/region/targetPools Retrieves a list of target pools available to the specified project and region.
removeHealthCheck POST  /project/regions/region/targetPools/targetPool/removeHealthCheck Removes health check URL from a target pool.
removeInstance POST  /project/regions/region/targetPools/targetPool/removeInstance Removes instance URL from a target pool.
setBackup POST  /project/regions/region/targetPools/targetPool/setBackup Changes a backup target pool's configurations.

TargetSslProxies

For TargetSslProxies Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
delete DELETE  /project/global/targetSslProxies/targetSslProxy Deletes the specified TargetSslProxy resource.
get GET  /project/global/targetSslProxies/targetSslProxy Returns the specified TargetSslProxy resource. Get a list of available target SSL proxies by making a list() request.
insert POST  /project/global/targetSslProxies Creates a TargetSslProxy resource in the specified project using the data included in the request.
list GET  /project/global/targetSslProxies Retrieves the list of TargetSslProxy resources available to the specified project.
setBackendService POST  /project/global/targetSslProxies/targetSslProxy/setBackendService Changes the BackendService for TargetSslProxy.
setProxyHeader POST  /project/global/targetSslProxies/targetSslProxy/setProxyHeader Changes the ProxyHeaderType for TargetSslProxy.
setSslCertificates POST  /project/global/targetSslProxies/targetSslProxy/setSslCertificates Changes SslCertificates for TargetSslProxy.

TargetVpnGateways

For TargetVpnGateways Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
aggregatedList GET  /project/aggregated/targetVpnGateways Retrieves an aggregated list of target VPN gateways.
delete DELETE  /project/regions/region/targetVpnGateways/targetVpnGateway Deletes the specified target VPN gateway.
get GET  /project/regions/region/targetVpnGateways/targetVpnGateway Returns the specified target VPN gateway. Get a list of available target VPN gateways by making a list() request.
insert POST  /project/regions/region/targetVpnGateways Creates a target VPN gateway in the specified project and region using the data included in the request.
list GET  /project/regions/region/targetVpnGateways Retrieves a list of target VPN gateways available to the specified project and region.

UrlMaps

For UrlMaps Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
delete DELETE  /project/global/urlMaps/urlMap Deletes the specified UrlMap resource.
get GET  /project/global/urlMaps/urlMap Returns the specified UrlMap resource. Get a list of available URL maps by making a list() request.
insert POST  /project/global/urlMaps Creates a UrlMap resource in the specified project using the data included in the request.
invalidateCache POST  /project/global/urlMaps/urlMap/invalidateCache Initiates a cache invalidation operation, invalidating the specified path, scoped to the specified UrlMap.
list GET  /project/global/urlMaps Retrieves the list of UrlMap resources available to the specified project.
patch PATCH  /project/global/urlMaps/urlMap Updates the specified UrlMap resource with the data included in the request. This method supports patch semantics.
update PUT  /project/global/urlMaps/urlMap Updates the specified UrlMap resource with the data included in the request.
validate POST  /project/global/urlMaps/urlMap/validate Runs static validation for the UrlMap. In particular, the tests of the provided UrlMap will be run. Calling this method does NOT create the UrlMap.

VpnTunnels

For VpnTunnels Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
aggregatedList GET  /project/aggregated/vpnTunnels Retrieves an aggregated list of VPN tunnels.
delete DELETE  /project/regions/region/vpnTunnels/vpnTunnel Deletes the specified VpnTunnel resource.
get GET  /project/regions/region/vpnTunnels/vpnTunnel Returns the specified VpnTunnel resource. Get a list of available VPN tunnels by making a list() request.
insert POST  /project/regions/region/vpnTunnels Creates a VpnTunnel resource in the specified project and region using the data included in the request.
list GET  /project/regions/region/vpnTunnels Retrieves a list of VpnTunnel resources contained in the specified project and region.

ZoneOperations

For ZoneOperations Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
delete DELETE  /project/zones/zone/operations/operation Deletes the specified zone-specific Operations resource.
get GET  /project/zones/zone/operations/operation Retrieves the specified zone-specific Operations resource.
list GET  /project/zones/zone/operations Retrieves a list of Operation resources contained within the specified zone.

Zones

For Zones Resource details, see the resource representation page.

Method HTTP request Description
URIs relative to https://www.googleapis.com/compute/v1/projects, unless otherwise noted
get GET  /project/zones/zone Returns the specified Zone resource. Get a list of available zones by making a list() request.
list GET  /project/zones Retrieves the list of Zone resources available to the specified project.

Send feedback about...

Compute Engine