Roll of googleapis as of 4/7/2015.

discovery/googleapis/compute__v1.json

 {
     "auth": {
         "oauth2": {
             "scopes": {
                 "https://www.googleapis.com/auth/cloud-platform": {
                     "description": "View and manage your data across Google Cloud Platform services"
                 },
                 "https://www.googleapis.com/auth/compute": {
                     "description": "View and manage your Google Compute Engine resources"
                 },
@@ skipping 11 matching lines @@
                 }
             }
         }
     },
     "basePath": "/compute/v1/projects/",
     "baseUrl": "https://www.googleapis.com/compute/v1/projects/",
     "batchPath": "batch",
     "description": "API for the Google Compute Engine service.",
     "discoveryVersion": "v1",
     "documentationLink": "https://developers.google.com/compute/docs/reference/latest/",
-    "etag": "\"ye6orv2F-1npMW3u9suM3a7C5Bo/l_CmYt94fAo4o_kPq2u7fu2_ix0\"",
+    "etag": "\"ye6orv2F-1npMW3u9suM3a7C5Bo/X7hvmvZAuE2GX5lBTJUD_xWfVrI\"",
     "icons": {
         "x16": "https://www.google.com/images/icons/product/compute_engine-16.png",
         "x32": "https://www.google.com/images/icons/product/compute_engine-32.png"
     },
     "id": "compute:v1",
     "kind": "discovery#restDescription",
     "name": "compute",
     "ownerDomain": "google.com",
     "ownerName": "Google",
     "parameters": {
@@ skipping 66 matching lines @@
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Optional. Tag returned by a previous list request truncated by maxResults. Used to continue a previous list request.",
                             "location": "query",
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/aggregated/addresses",
                     "response": {
                         "$ref": "AddressAggregatedList"
                     },
@@ skipping 14 matching lines @@
                     ],
                     "parameters": {
                         "address": {
                             "description": "Name of the address resource to delete.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "region": {
-                            "description": "Name of the region scoping this request.",
+                            "description": "The name of the region for this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/regions/{region}/addresses/{address}",
                     "response": {
                         "$ref": "Operation"
                     },
@@ skipping 13 matching lines @@
                     ],
                     "parameters": {
                         "address": {
                             "description": "Name of the address resource to return.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "region": {
-                            "description": "Name of the region scoping this request.",
+                            "description": "The name of the region for this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/regions/{region}/addresses/{address}",
                     "response": {
                         "$ref": "Address"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute",
                         "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 },
                 "insert": {
                     "description": "Creates an address resource in the specified project using the data included in the request.",
                     "httpMethod": "POST",
                     "id": "compute.addresses.insert",
                     "parameterOrder": [
                         "project",
                         "region"
                     ],
                     "parameters": {
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "region": {
-                            "description": "Name of the region scoping this request.",
+                            "description": "The name of the region for this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/regions/{region}/addresses",
                     "request": {
                         "$ref": "Address"
                     },
@@ skipping 27 matching lines @@
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Optional. Tag returned by a previous list request truncated by maxResults. Used to continue a previous list request.",
                             "location": "query",
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "region": {
-                            "description": "Name of the region scoping this request.",
+                            "description": "The name of the region for this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/regions/{region}/addresses",
                     "response": {
                         "$ref": "AddressList"
                     },
@@ skipping 280 matching lines @@
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Optional. Tag returned by a previous list request truncated by maxResults. Used to continue a previous list request.",
                             "location": "query",
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/aggregated/diskTypes",
                     "response": {
                         "$ref": "DiskTypeAggregatedList"
                     },
@@ skipping 14 matching lines @@
                     ],
                     "parameters": {
                         "diskType": {
                             "description": "Name of the disk type resource to return.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "zone": {
-                            "description": "Name of the zone scoping this request.",
+                            "description": "The name of the zone for this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/zones/{zone}/diskTypes/{diskType}",
                     "response": {
                         "$ref": "DiskType"
                     },
@@ skipping 25 matching lines @@
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Optional. Tag returned by a previous list request truncated by maxResults. Used to continue a previous list request.",
                             "location": "query",
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "zone": {
-                            "description": "Name of the zone scoping this request.",
+                            "description": "The name of the zone for this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/zones/{zone}/diskTypes",
                     "response": {
                         "$ref": "DiskTypeList"
                     },
@@ skipping 28 matching lines @@
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Optional. Tag returned by a previous list request truncated by maxResults. Used to continue a previous list request.",
                             "location": "query",
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/aggregated/disks",
                     "response": {
                         "$ref": "DiskAggregatedList"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute",
                         "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 },
                 "createSnapshot": {
+                    "description": "Creates a snapshot of this disk.",
                     "httpMethod": "POST",
                     "id": "compute.disks.createSnapshot",
                     "parameterOrder": [
                         "project",
                         "zone",
                         "disk"
                     ],
                     "parameters": {
                         "disk": {
-                            "description": "Name of the persistent disk resource to snapshot.",
+                            "description": "Name of the persistent disk to snapshot.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "zone": {
-                            "description": "Name of the zone scoping this request.",
+                            "description": "The name of the zone for this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/zones/{zone}/disks/{disk}/createSnapshot",
                     "request": {
                         "$ref": "Snapshot"
                     },
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "delete": {
-                    "description": "Deletes the specified persistent disk resource.",
+                    "description": "Deletes the specified persistent disk.",
                     "httpMethod": "DELETE",
                     "id": "compute.disks.delete",
                     "parameterOrder": [
                         "project",
                         "zone",
                         "disk"
                     ],
                     "parameters": {
                         "disk": {
-                            "description": "Name of the persistent disk resource to delete.",
+                            "description": "Name of the persistent disk to delete.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "zone": {
-                            "description": "Name of the zone scoping this request.",
+                            "description": "The name of the zone for this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/zones/{zone}/disks/{disk}",
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "get": {
-                    "description": "Returns the specified persistent disk resource.",
+                    "description": "Returns a specified persistent disk.",
                     "httpMethod": "GET",
                     "id": "compute.disks.get",
                     "parameterOrder": [
                         "project",
                         "zone",
                         "disk"
                     ],
                     "parameters": {
                         "disk": {
-                            "description": "Name of the persistent disk resource to return.",
+                            "description": "Name of the persistent disk to return.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "zone": {
-                            "description": "Name of the zone scoping this request.",
+                            "description": "The name of the zone for this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/zones/{zone}/disks/{disk}",
                     "response": {
                         "$ref": "Disk"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute",
                         "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 },
                 "insert": {
-                    "description": "Creates a persistent disk resource in the specified project using the data included in the request.",
+                    "description": "Creates a persistent disk in the specified project using the data included in the request.",
                     "httpMethod": "POST",
                     "id": "compute.disks.insert",
                     "parameterOrder": [
                         "project",
                         "zone"
                     ],
                     "parameters": {
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "sourceImage": {
                             "description": "Optional. Source image to restore onto a disk.",
                             "location": "query",
                             "type": "string"
                         },
                         "zone": {
-                            "description": "Name of the zone scoping this request.",
+                            "description": "The name of the zone for this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/zones/{zone}/disks",
                     "request": {
                         "$ref": "Disk"
                     },
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "list": {
-                    "description": "Retrieves the list of persistent disk resources contained within the specified zone.",
+                    "description": "Retrieves the list of persistent disks contained within the specified zone.",
                     "httpMethod": "GET",
                     "id": "compute.disks.list",
                     "parameterOrder": [
                         "project",
                         "zone"
                     ],
                     "parameters": {
                         "filter": {
                             "description": "Optional. Filter expression for filtering listed resources.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
                             "description": "Optional. Maximum count of results to be returned. Maximum value is 500 and default value is 500.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Optional. Tag returned by a previous list request truncated by maxResults. Used to continue a previous list request.",
                             "location": "query",
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "zone": {
-                            "description": "Name of the zone scoping this request.",
+                            "description": "The name of the zone for this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/zones/{zone}/disks",
                     "response": {
                         "$ref": "DiskList"
                     },
@@ skipping 17 matching lines @@
                     ],
                     "parameters": {
                         "firewall": {
                             "description": "Name of the firewall resource to delete.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/global/firewalls/{firewall}",
                     "response": {
                         "$ref": "Operation"
                     },
@@ skipping 12 matching lines @@
                     ],
                     "parameters": {
                         "firewall": {
                             "description": "Name of the firewall resource to return.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/global/firewalls/{firewall}",
                     "response": {
                         "$ref": "Firewall"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute",
                         "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 },
                 "insert": {
                     "description": "Creates a firewall resource in the specified project using the data included in the request.",
                     "httpMethod": "POST",
                     "id": "compute.firewalls.insert",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/global/firewalls",
                     "request": {
                         "$ref": "Firewall"
                     },
@@ skipping 26 matching lines @@
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Optional. Tag returned by a previous list request truncated by maxResults. Used to continue a previous list request.",
                             "location": "query",
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/global/firewalls",
                     "response": {
                         "$ref": "FirewallList"
                     },
@@ skipping 13 matching lines @@
                     ],
                     "parameters": {
                         "firewall": {
                             "description": "Name of the firewall resource to update.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/global/firewalls/{firewall}",
                     "request": {
                         "$ref": "Firewall"
                     },
@@ skipping 15 matching lines @@
                     ],
                     "parameters": {
                         "firewall": {
                             "description": "Name of the firewall resource to update.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/global/firewalls/{firewall}",
                     "request": {
                         "$ref": "Firewall"
                     },
@@ skipping 284 matching lines @@
                     ],
                     "parameters": {
                         "address": {
                             "description": "Name of the address resource to delete.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/global/addresses/{address}",
                     "response": {
                         "$ref": "Operation"
                     },
@@ skipping 12 matching lines @@
                     ],
                     "parameters": {
                         "address": {
                             "description": "Name of the address resource to return.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/global/addresses/{address}",
                     "response": {
                         "$ref": "Address"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute",
                         "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 },
                 "insert": {
                     "description": "Creates an address resource in the specified project using the data included in the request.",
                     "httpMethod": "POST",
                     "id": "compute.globalAddresses.insert",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/global/addresses",
                     "request": {
                         "$ref": "Address"
                     },
@@ skipping 26 matching lines @@
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Optional. Tag returned by a previous list request truncated by maxResults. Used to continue a previous list request.",
                             "location": "query",
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/global/addresses",
                     "response": {
                         "$ref": "AddressList"
                     },
@@ skipping 208 matching lines @@
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Optional. Tag returned by a previous list request truncated by maxResults. Used to continue a previous list request.",
                             "location": "query",
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/aggregated/operations",
                     "response": {
                         "$ref": "OperationAggregatedList"
                     },
@@ skipping 13 matching lines @@
                     ],
                     "parameters": {
                         "operation": {
                             "description": "Name of the operation resource to delete.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/global/operations/{operation}",
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "get": {
                     "description": "Retrieves the specified operation resource.",
                     "httpMethod": "GET",
                     "id": "compute.globalOperations.get",
                     "parameterOrder": [
                         "project",
                         "operation"
                     ],
                     "parameters": {
                         "operation": {
                             "description": "Name of the operation resource to return.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/global/operations/{operation}",
                     "response": {
                         "$ref": "Operation"
                     },
@@ skipping 24 matching lines @@
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Optional. Tag returned by a previous list request truncated by maxResults. Used to continue a previous list request.",
                             "location": "query",
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/global/operations",
                     "response": {
                         "$ref": "OperationList"
                     },
@@ skipping 233 matching lines @@
                     ],
                     "parameters": {
                         "image": {
                             "description": "Name of the image resource to delete.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/global/images/{image}",
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "deprecate": {
-                    "description": "Sets the deprecation status of an image. If no message body is given, clears the deprecation status instead.",
+                    "description": "Sets the deprecation status of an image.\n\nIf an empty request body is given, clears the deprecation status instead.",
                     "httpMethod": "POST",
                     "id": "compute.images.deprecate",
                     "parameterOrder": [
                         "project",
                         "image"
                     ],
                     "parameters": {
                         "image": {
                             "description": "Image name.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/global/images/{image}/deprecate",
                     "request": {
                         "$ref": "DeprecationStatus"
                     },
@@ skipping 15 matching lines @@
                     ],
                     "parameters": {
                         "image": {
                             "description": "Name of the image resource to return.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/global/images/{image}",
                     "response": {
                         "$ref": "Image"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute",
                         "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 },
                 "insert": {
                     "description": "Creates an image resource in the specified project using the data included in the request.",
                     "httpMethod": "POST",
                     "id": "compute.images.insert",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/global/images",
                     "request": {
                         "$ref": "Image"
                     },
@@ skipping 29 matching lines @@
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Optional. Tag returned by a previous list request truncated by maxResults. Used to continue a previous list request.",
                             "location": "query",
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/global/images",
                     "response": {
                         "$ref": "ImageList"
                     },
@@ skipping 156 matching lines @@
                     "httpMethod": "POST",
                     "id": "compute.instances.addAccessConfig",
                     "parameterOrder": [
                         "project",
                         "zone",
                         "instance",
                         "networkInterface"
                     ],
                     "parameters": {
                         "instance": {
-                            "description": "Instance name.",
+                            "description": "The instance name for this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "networkInterface": {
-                            "description": "Network interface name.",
+                            "description": "The name of the network interface to add to this instance.",
                             "location": "query",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Project name.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "zone": {
-                            "description": "Name of the zone scoping this request.",
+                            "description": "The name of the zone for this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/zones/{zone}/instances/{instance}/addAccessConfig",
                     "request": {
                         "$ref": "AccessConfig"
                     },
@@ skipping 25 matching lines @@
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Optional. Tag returned by a previous list request truncated by maxResults. Used to continue a previous list request.",
                             "location": "query",
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/aggregated/instances",
                     "response": {
                         "$ref": "InstanceAggregatedList"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute",
                         "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 },
                 "attachDisk": {
-                    "description": "Attaches a disk resource to an instance.",
+                    "description": "Attaches a Disk resource to an instance.",
                     "httpMethod": "POST",
                     "id": "compute.instances.attachDisk",
                     "parameterOrder": [
                         "project",
                         "zone",
                         "instance"
                     ],
                     "parameters": {
                         "instance": {
                             "description": "Instance name.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Project name.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "zone": {
-                            "description": "Name of the zone scoping this request.",
+                            "description": "The name of the zone for this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/zones/{zone}/instances/{instance}/attachDisk",
                     "request": {
                         "$ref": "AttachedDisk"
                     },
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "delete": {
-                    "description": "Deletes the specified instance resource.",
+                    "description": "Deletes the specified Instance resource. For more information, see Shutting down an instance.",
                     "httpMethod": "DELETE",
                     "id": "compute.instances.delete",
                     "parameterOrder": [
                         "project",
                         "zone",
                         "instance"
                     ],
                     "parameters": {
                         "instance": {
                             "description": "Name of the instance resource to delete.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "zone": {
-                            "description": "Name of the zone scoping this request.",
+                            "description": "The name of the zone for this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/zones/{zone}/instances/{instance}",
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "deleteAccessConfig": {
                     "description": "Deletes an access config from an instance's network interface.",
                     "httpMethod": "POST",
                     "id": "compute.instances.deleteAccessConfig",
                     "parameterOrder": [
                         "project",
                         "zone",
                         "instance",
                         "accessConfig",
                         "networkInterface"
                     ],
                     "parameters": {
                         "accessConfig": {
-                            "description": "Access config name.",
+                            "description": "The name of the access config to delete.",
                             "location": "query",
                             "required": true,
                             "type": "string"
                         },
                         "instance": {
-                            "description": "Instance name.",
+                            "description": "The instance name for this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "networkInterface": {
-                            "description": "Network interface name.",
+                            "description": "The name of the network interface.",
                             "location": "query",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Project name.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "zone": {
-                            "description": "Name of the zone scoping this request.",
+                            "description": "The name of the zone for this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/zones/{zone}/instances/{instance}/deleteAccessConfig",
                     "response": {
                         "$ref": "Operation"
                     },
@@ skipping 21 matching lines @@
                             "type": "string"
                         },
                         "instance": {
                             "description": "Instance name.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Project name.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "zone": {
-                            "description": "Name of the zone scoping this request.",
+                            "description": "The name of the zone for this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/zones/{zone}/instances/{instance}/detachDisk",
                     "response": {
                         "$ref": "Operation"
                     },
@@ skipping 13 matching lines @@
                     ],
                     "parameters": {
                         "instance": {
                             "description": "Name of the instance resource to return.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "zone": {
-                            "description": "Name of the zone scoping this request.",
+                            "description": "The name of the The name of the zone for this request..",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/zones/{zone}/instances/{instance}",
                     "response": {
                         "$ref": "Instance"
                     },
@@ skipping 14 matching lines @@
                     ],
                     "parameters": {
                         "instance": {
                             "description": "Name of the instance scoping this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "zone": {
-                            "description": "Name of the zone scoping this request.",
+                            "description": "The name of the zone for this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/zones/{zone}/instances/{instance}/serialPort",
                     "response": {
                         "$ref": "SerialPortOutput"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute",
                         "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 },
                 "insert": {
                     "description": "Creates an instance resource in the specified project using the data included in the request.",
                     "httpMethod": "POST",
                     "id": "compute.instances.insert",
                     "parameterOrder": [
                         "project",
                         "zone"
                     ],
                     "parameters": {
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "zone": {
-                            "description": "Name of the zone scoping this request.",
+                            "description": "The name of the zone for this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/zones/{zone}/instances",
                     "request": {
                         "$ref": "Instance"
                     },
@@ skipping 27 matching lines @@
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Optional. Tag returned by a previous list request truncated by maxResults. Used to continue a previous list request.",
                             "location": "query",
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "zone": {
-                            "description": "Name of the zone scoping this request.",
+                            "description": "The name of the zone for this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/zones/{zone}/instances",
                     "response": {
                         "$ref": "InstanceList"
                     },
@@ skipping 14 matching lines @@
                     ],
                     "parameters": {
                         "instance": {
                             "description": "Name of the instance scoping this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "zone": {
-                            "description": "Name of the zone scoping this request.",
+                            "description": "The name of the zone for this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/zones/{zone}/instances/{instance}/reset",
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "setDiskAutoDelete": {
-                    "description": "Sets the auto-delete flag for a disk attached to an instance",
+                    "description": "Sets the auto-delete flag for a disk attached to an instance.",
                     "httpMethod": "POST",
                     "id": "compute.instances.setDiskAutoDelete",
                     "parameterOrder": [
                         "project",
                         "zone",
                         "instance",
                         "autoDelete",
                         "deviceName"
                     ],
                     "parameters": {
                         "autoDelete": {
                             "description": "Whether to auto-delete the disk when the instance is deleted.",
                             "location": "query",
                             "required": true,
                             "type": "boolean"
                         },
                         "deviceName": {
-                            "description": "Disk device name to modify.",
+                            "description": "The device name of the disk to modify.",
                             "location": "query",
                             "pattern": "\\w[\\w.-]{0,254}",
                             "required": true,
                             "type": "string"
                         },
                         "instance": {
-                            "description": "Instance name.",
+                            "description": "The instance name.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Project name.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "zone": {
-                            "description": "Name of the zone scoping this request.",
+                            "description": "The name of the zone for this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/zones/{zone}/instances/{instance}/setDiskAutoDelete",
                     "response": {
                         "$ref": "Operation"
                     },
@@ skipping 13 matching lines @@
                     ],
                     "parameters": {
                         "instance": {
                             "description": "Name of the instance scoping this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "zone": {
-                            "description": "Name of the zone scoping this request.",
+                            "description": "The name of the zone for this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/zones/{zone}/instances/{instance}/setMetadata",
                     "request": {
                         "$ref": "Metadata"
                     },
@@ skipping 16 matching lines @@
                     ],
                     "parameters": {
                         "instance": {
                             "description": "Instance name.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Project name.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "zone": {
-                            "description": "Name of the zone scoping this request.",
+                            "description": "The name of the zone for this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/zones/{zone}/instances/{instance}/setScheduling",
                     "request": {
                         "$ref": "Scheduling"
                     },
@@ skipping 16 matching lines @@
                     ],
                     "parameters": {
                         "instance": {
                             "description": "Name of the instance scoping this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "zone": {
-                            "description": "Name of the zone scoping this request.",
+                            "description": "The name of the zone for this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/zones/{zone}/instances/{instance}/setTags",
                     "request": {
                         "$ref": "Tags"
                     },
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "start": {
-                    "description": "Starts an instance",
+                    "description": "This method starts an instance that was stopped using the using the instances().stop method. For more information, see Restart an instance.",
                     "httpMethod": "POST",
                     "id": "compute.instances.start",
                     "parameterOrder": [
                         "project",
                         "zone",
                         "instance"
                     ],
                     "parameters": {
                         "instance": {
                             "description": "Name of the instance resource to start.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "zone": {
-                            "description": "Name of the zone scoping this request.",
+                            "description": "The name of the zone for this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/zones/{zone}/instances/{instance}/start",
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "stop": {
-                    "description": "Stops an instance",
+                    "description": "This method 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.",
                     "httpMethod": "POST",
                     "id": "compute.instances.stop",
                     "parameterOrder": [
                         "project",
                         "zone",
                         "instance"
                     ],
                     "parameters": {
                         "instance": {
                             "description": "Name of the instance resource to start.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "zone": {
-                            "description": "Name of the zone scoping this request.",
+                            "description": "The name of the zone for this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/zones/{zone}/instances/{instance}/stop",
                     "response": {
                         "$ref": "Operation"
                     },
@@ skipping 16 matching lines @@
                     ],
                     "parameters": {
                         "license": {
                             "description": "Name of the license resource to return.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/global/licenses/{license}",
                     "response": {
                         "$ref": "License"
                     },
@@ skipping 70 matching lines @@
                             "type": "string"
                         },
                         "project": {
                             "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "zone": {
-                            "description": "Name of the zone scoping this request.",
+                            "description": "The name of the zone for this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/zones/{zone}/machineTypes/{machineType}",
                     "response": {
                         "$ref": "MachineType"
                     },
@@ skipping 32 matching lines @@
                             "type": "string"
                         },
                         "project": {
                             "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "zone": {
-                            "description": "Name of the zone scoping this request.",
+                            "description": "The name of the zone for this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/zones/{zone}/machineTypes",
                     "response": {
                         "$ref": "MachineTypeList"
                     },
@@ skipping 17 matching lines @@
                     ],
                     "parameters": {
                         "network": {
                             "description": "Name of the network resource to delete.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/global/networks/{network}",
                     "response": {
                         "$ref": "Operation"
                     },
@@ skipping 12 matching lines @@
                     ],
                     "parameters": {
                         "network": {
                             "description": "Name of the network resource to return.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/global/networks/{network}",
                     "response": {
                         "$ref": "Network"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute",
                         "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 },
                 "insert": {
                     "description": "Creates a network resource in the specified project using the data included in the request.",
                     "httpMethod": "POST",
                     "id": "compute.networks.insert",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/global/networks",
                     "request": {
                         "$ref": "Network"
                     },
@@ skipping 26 matching lines @@
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Optional. Tag returned by a previous list request truncated by maxResults. Used to continue a previous list request.",
                             "location": "query",
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/global/networks",
                     "response": {
                         "$ref": "NetworkList"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute",
                         "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 }
             }
         },
         "projects": {
             "methods": {
                 "get": {
                     "description": "Returns the specified project resource.",
                     "httpMethod": "GET",
                     "id": "compute.projects.get",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "project": {
-                            "description": "Name of the project resource to retrieve.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}",
                     "response": {
                         "$ref": "Project"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute",
                         "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 },
+                "moveDisk": {
+                    "description": "Moves a persistent disk from one zone to another.",
+                    "httpMethod": "POST",
+                    "id": "compute.projects.moveDisk",
+                    "parameterOrder": [
+                        "project"
+                    ],
+                    "parameters": {
+                        "project": {
+                            "description": "Project ID for this request.",
+                            "location": "path",
+                            "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
+                            "required": true,
+                            "type": "string"
+                        }
+                    },
+                    "path": "{project}/moveDisk",
+                    "request": {
+                        "$ref": "DiskMoveRequest"
+                    },
+                    "response": {
+                        "$ref": "Operation"
+                    },
+                    "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/compute"
+                    ]
+                },
+                "moveInstance": {
+                    "description": "Moves an instance and its attached persistent disks from one zone to another.",
+                    "httpMethod": "POST",
+                    "id": "compute.projects.moveInstance",
+                    "parameterOrder": [
+                        "project"
+                    ],
+                    "parameters": {
+                        "project": {
+                            "description": "Project ID for this request.",
+                            "location": "path",
+                            "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
+                            "required": true,
+                            "type": "string"
+                        }
+                    },
+                    "path": "{project}/moveInstance",
+                    "request": {
+                        "$ref": "InstanceMoveRequest"
+                    },
+                    "response": {
+                        "$ref": "Operation"
+                    },
+                    "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/compute"
+                    ]
+                },
                 "setCommonInstanceMetadata": {
                     "description": "Sets metadata common to all instances within the specified project using the data included in the request.",
                     "httpMethod": "POST",
                     "id": "compute.projects.setCommonInstanceMetadata",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/setCommonInstanceMetadata",
                     "request": {
                         "$ref": "Metadata"
                     },
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "setUsageExportBucket": {
-                    "description": "Sets usage export location",
+                    "description": "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.",
                     "httpMethod": "POST",
                     "id": "compute.projects.setUsageExportBucket",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/setUsageExportBucket",
                     "request": {
                         "$ref": "UsageExportLocation"
                     },
@@ skipping 23 matching lines @@
                     ],
                     "parameters": {
                         "operation": {
                             "description": "Name of the operation resource to delete.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "region": {
                             "description": "Name of the region scoping this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
@@ skipping 17 matching lines @@
                     ],
                     "parameters": {
                         "operation": {
                             "description": "Name of the operation resource to return.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "region": {
                             "description": "Name of the zone scoping this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
@@ skipping 32 matching lines @@
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Optional. Tag returned by a previous list request truncated by maxResults. Used to continue a previous list request.",
                             "location": "query",
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "region": {
                             "description": "Name of the region scoping this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
@@ skipping 17 matching lines @@
                 "get": {
                     "description": "Returns the specified region resource.",
                     "httpMethod": "GET",
                     "id": "compute.regions.get",
                     "parameterOrder": [
                         "project",
                         "region"
                     ],
                     "parameters": {
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "region": {
                             "description": "Name of the region resource to return.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
@@ skipping 31 matching lines @@
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Optional. Tag returned by a previous list request truncated by maxResults. Used to continue a previous list request.",
                             "location": "query",
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/regions",
                     "response": {
                         "$ref": "RegionList"
                     },
@@ skipping 1146 matching lines @@
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 }
             }
         },
+        "targetVpnGateways": {
+            "methods": {
+                "aggregatedList": {
+                    "description": "Retrieves the list of target VPN gateways grouped by scope.",
+                    "httpMethod": "GET",
+                    "id": "compute.targetVpnGateways.aggregatedList",
+                    "parameterOrder": [
+                        "project"
+                    ],
+                    "parameters": {
+                        "filter": {
+                            "description": "Optional. Filter expression for filtering listed resources.",
+                            "location": "query",
+                            "type": "string"
+                        },
+                        "maxResults": {
+                            "default": "500",
+                            "description": "Optional. Maximum count of results to be returned. Maximum value is 500 and default value is 500.",
+                            "format": "uint32",
+                            "location": "query",
+                            "maximum": "500",
+                            "minimum": "0",
+                            "type": "integer"
+                        },
+                        "pageToken": {
+                            "description": "Optional. Tag returned by a previous list request truncated by maxResults. Used to continue a previous list request.",
+                            "location": "query",
+                            "type": "string"
+                        },
+                        "project": {
+                            "description": "Project ID for this request.",
+                            "location": "path",
+                            "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
+                            "required": true,
+                            "type": "string"
+                        }
+                    },
+                    "path": "{project}/aggregated/targetVpnGateways",
+                    "response": {
+                        "$ref": "TargetVpnGatewayAggregatedList"
+                    },
+                    "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/compute",
+                        "https://www.googleapis.com/auth/compute.readonly"
+                    ]
+                },
+                "delete": {
+                    "description": "Deletes the specified TargetVpnGateway resource.",
+                    "httpMethod": "DELETE",
+                    "id": "compute.targetVpnGateways.delete",
+                    "parameterOrder": [
+                        "project",
+                        "region",
+                        "targetVpnGateway"
+                    ],
+                    "parameters": {
+                        "project": {
+                            "description": "Project ID for this request.",
+                            "location": "path",
+                            "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
+                            "required": true,
+                            "type": "string"
+                        },
+                        "region": {
+                            "description": "The name of the region for this request.",
+                            "location": "path",
+                            "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
+                            "required": true,
+                            "type": "string"
+                        },
+                        "targetVpnGateway": {
+                            "description": "Name of the TargetVpnGateway resource to delete.",
+                            "location": "path",
+                            "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
+                            "required": true,
+                            "type": "string"
+                        }
+                    },
+                    "path": "{project}/regions/{region}/targetVpnGateways/{targetVpnGateway}",
+                    "response": {
+                        "$ref": "Operation"
+                    },
+                    "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/compute"
+                    ]
+                },
+                "get": {
+                    "description": "Returns the specified TargetVpnGateway resource.",
+                    "httpMethod": "GET",
+                    "id": "compute.targetVpnGateways.get",
+                    "parameterOrder": [
+                        "project",
+                        "region",
+                        "targetVpnGateway"
+                    ],
+                    "parameters": {
+                        "project": {
+                            "description": "Project ID for this request.",
+                            "location": "path",
+                            "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
+                            "required": true,
+                            "type": "string"
+                        },
+                        "region": {
+                            "description": "The name of the region for this request.",
+                            "location": "path",
+                            "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
+                            "required": true,
+                            "type": "string"
+                        },
+                        "targetVpnGateway": {
+                            "description": "Name of the TargetVpnGateway resource to return.",
+                            "location": "path",
+                            "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
+                            "required": true,
+                            "type": "string"
+                        }
+                    },
+                    "path": "{project}/regions/{region}/targetVpnGateways/{targetVpnGateway}",
+                    "response": {
+                        "$ref": "TargetVpnGateway"
+                    },
+                    "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/compute",
+                        "https://www.googleapis.com/auth/compute.readonly"
+                    ]
+                },
+                "insert": {
+                    "description": "Creates a TargetVpnGateway resource in the specified project and region using the data included in the request.",
+                    "httpMethod": "POST",
+                    "id": "compute.targetVpnGateways.insert",
+                    "parameterOrder": [
+                        "project",
+                        "region"
+                    ],
+                    "parameters": {
+                        "project": {
+                            "description": "Project ID for this request.",
+                            "location": "path",
+                            "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
+                            "required": true,
+                            "type": "string"
+                        },
+                        "region": {
+                            "description": "The name of the region for this request.",
+                            "location": "path",
+                            "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
+                            "required": true,
+                            "type": "string"
+                        }
+                    },
+                    "path": "{project}/regions/{region}/targetVpnGateways",
+                    "request": {
+                        "$ref": "TargetVpnGateway"
+                    },
+                    "response": {
+                        "$ref": "Operation"
+                    },
+                    "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/compute"
+                    ]
+                },
+                "list": {
+                    "description": "Retrieves the list of TargetVpnGateway resources available to the specified project and region.",
+                    "httpMethod": "GET",
+                    "id": "compute.targetVpnGateways.list",
+                    "parameterOrder": [
+                        "project",
+                        "region"
+                    ],
+                    "parameters": {
+                        "filter": {
+                            "description": "Optional. Filter expression for filtering listed resources.",
+                            "location": "query",
+                            "type": "string"
+                        },
+                        "maxResults": {
+                            "default": "500",
+                            "description": "Optional. Maximum count of results to be returned. Maximum value is 500 and default value is 500.",
+                            "format": "uint32",
+                            "location": "query",
+                            "maximum": "500",
+                            "minimum": "0",
+                            "type": "integer"
+                        },
+                        "pageToken": {
+                            "description": "Optional. Tag returned by a previous list request truncated by maxResults. Used to continue a previous list request.",
+                            "location": "query",
+                            "type": "string"
+                        },
+                        "project": {
+                            "description": "Project ID for this request.",
+                            "location": "path",
+                            "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
+                            "required": true,
+                            "type": "string"
+                        },
+                        "region": {
+                            "description": "The name of the region for this request.",
+                            "location": "path",
+                            "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
+                            "required": true,
+                            "type": "string"
+                        }
+                    },
+                    "path": "{project}/regions/{region}/targetVpnGateways",
+                    "response": {
+                        "$ref": "TargetVpnGatewayList"
+                    },
+                    "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/compute",
+                        "https://www.googleapis.com/auth/compute.readonly"
+                    ]
+                }
+            }
+        },
         "urlMaps": {
             "methods": {
                 "delete": {
                     "description": "Deletes the specified UrlMap resource.",
                     "httpMethod": "DELETE",
                     "id": "compute.urlMaps.delete",
                     "parameterOrder": [
                         "project",
                         "urlMap"
                     ],
@@ skipping 84 matching lines @@
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "list": {
                     "description": "Retrieves the list of UrlMap resources available to the specified project.",
                     "httpMethod": "GET",
                     "id": "compute.urlMaps.list",
                     "parameterOrder": [
                         "project"
                     ],
+                    "parameters": {
+                        "filter": {
+                            "description": "Optional. Filter expression for filtering listed resources.",
+                            "location": "query",
+                            "type": "string"
+                        },
+                        "maxResults": {
+                            "default": "500",
+                            "description": "Optional. Maximum count of results to be returned. Maximum value is 500 and default value is 500.",
+                            "format": "uint32",
+                            "location": "query",
+                            "maximum": "500",
+                            "minimum": "0",
+                            "type": "integer"
+                        },
+                        "pageToken": {
+                            "description": "Optional. Tag returned by a previous list request truncated by maxResults. Used to continue a previous list request.",
+                            "location": "query",
+                            "type": "string"
+                        },
+                        "project": {
+                            "description": "Name of the project scoping this request.",
+                            "location": "path",
+                            "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
+                            "required": true,
+                            "type": "string"
+                        }
+                    },
+                    "path": "{project}/global/urlMaps",
+                    "response": {
+                        "$ref": "UrlMapList"
+                    },
+                    "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/compute",
+                        "https://www.googleapis.com/auth/compute.readonly"
+                    ]
+                },
+                "patch": {
+                    "description": "Update the entire content of the UrlMap resource. This method supports patch semantics.",
+                    "httpMethod": "PATCH",
+                    "id": "compute.urlMaps.patch",
+                    "parameterOrder": [
+                        "project",
+                        "urlMap"
+                    ],
+                    "parameters": {
+                        "project": {
+                            "description": "Name of the project scoping this request.",
+                            "location": "path",
+                            "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
+                            "required": true,
+                            "type": "string"
+                        },
+                        "urlMap": {
+                            "description": "Name of the UrlMap resource to update.",
+                            "location": "path",
+                            "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
+                            "required": true,
+                            "type": "string"
+                        }
+                    },
+                    "path": "{project}/global/urlMaps/{urlMap}",
+                    "request": {
+                        "$ref": "UrlMap"
+                    },
+                    "response": {
+                        "$ref": "Operation"
+                    },
+                    "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/compute"
+                    ]
+                },
+                "update": {
+                    "description": "Update the entire content of the UrlMap resource.",
+                    "httpMethod": "PUT",
+                    "id": "compute.urlMaps.update",
+                    "parameterOrder": [
+                        "project",
+                        "urlMap"
+                    ],
+                    "parameters": {
+                        "project": {
+                            "description": "Name of the project scoping this request.",
+                            "location": "path",
+                            "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
+                            "required": true,
+                            "type": "string"
+                        },
+                        "urlMap": {
+                            "description": "Name of the UrlMap resource to update.",
+                            "location": "path",
+                            "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
+                            "required": true,
+                            "type": "string"
+                        }
+                    },
+                    "path": "{project}/global/urlMaps/{urlMap}",
+                    "request": {
+                        "$ref": "UrlMap"
+                    },
+                    "response": {
+                        "$ref": "Operation"
+                    },
+                    "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/compute"
+                    ]
+                },
+                "validate": {
+                    "description": "Run static validation for the UrlMap. In particular, the tests of the provided UrlMap will be run. Calling this method does NOT create the UrlMap.",
+                    "httpMethod": "POST",
+                    "id": "compute.urlMaps.validate",
+                    "parameterOrder": [
+                        "project",
+                        "urlMap"
+                    ],
+                    "parameters": {
+                        "project": {
+                            "description": "Name of the project scoping this request.",
+                            "location": "path",
+                            "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
+                            "required": true,
+                            "type": "string"
+                        },
+                        "urlMap": {
+                            "description": "Name of the UrlMap resource to be validated as.",
+                            "location": "path",
+                            "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
+                            "required": true,
+                            "type": "string"
+                        }
+                    },
+                    "path": "{project}/global/urlMaps/{urlMap}/validate",
+                    "request": {
+                        "$ref": "UrlMapsValidateRequest"
+                    },
+                    "response": {
+                        "$ref": "UrlMapsValidateResponse"
+                    },
+                    "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/compute"
+                    ]
+                }
+            }
+        },
+        "vpnTunnels": {
+            "methods": {
+                "aggregatedList": {
+                    "description": "Retrieves the list of VPN tunnels grouped by scope.",
+                    "httpMethod": "GET",
+                    "id": "compute.vpnTunnels.aggregatedList",
+                    "parameterOrder": [
+                        "project"
+                    ],
                     "parameters": {
                         "filter": {
                             "description": "Optional. Filter expression for filtering listed resources.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
                             "description": "Optional. Maximum count of results to be returned. Maximum value is 500 and default value is 500.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Optional. Tag returned by a previous list request truncated by maxResults. Used to continue a previous list request.",
                             "location": "query",
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         }
                     },
-                    "path": "{project}/global/urlMaps",
+                    "path": "{project}/aggregated/vpnTunnels",
                     "response": {
-                        "$ref": "UrlMapList"
+                        "$ref": "VpnTunnelAggregatedList"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute",
                         "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 },
-                "patch": {
-                    "description": "Update the entire content of the UrlMap resource. This method supports patch semantics.",
-                    "httpMethod": "PATCH",
-                    "id": "compute.urlMaps.patch",
+                "delete": {
+                    "description": "Deletes the specified VpnTunnel resource.",
+                    "httpMethod": "DELETE",
+                    "id": "compute.vpnTunnels.delete",
                     "parameterOrder": [
                         "project",
-                        "urlMap"
+                        "region",
+                        "vpnTunnel"
                     ],
                     "parameters": {
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
-                        "urlMap": {
-                            "description": "Name of the UrlMap resource to update.",
+                        "region": {
+                            "description": "The name of the region for this request.",
+                            "location": "path",
+                            "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
+                            "required": true,
+                            "type": "string"
+                        },
+                        "vpnTunnel": {
+                            "description": "Name of the VpnTunnel resource to delete.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
-                    "path": "{project}/global/urlMaps/{urlMap}",
-                    "request": {
-                        "$ref": "UrlMap"
-                    },
+                    "path": "{project}/regions/{region}/vpnTunnels/{vpnTunnel}",
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
-                "update": {
-                    "description": "Update the entire content of the UrlMap resource.",
-                    "httpMethod": "PUT",
-                    "id": "compute.urlMaps.update",
+                "get": {
+                    "description": "Returns the specified VpnTunnel resource.",
+                    "httpMethod": "GET",
+                    "id": "compute.vpnTunnels.get",
                     "parameterOrder": [
                         "project",
-                        "urlMap"
+                        "region",
+                        "vpnTunnel"
                     ],
                     "parameters": {
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
-                        "urlMap": {
-                            "description": "Name of the UrlMap resource to update.",
+                        "region": {
+                            "description": "The name of the region for this request.",
+                            "location": "path",
+                            "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
+                            "required": true,
+                            "type": "string"
+                        },
+                        "vpnTunnel": {
+                            "description": "Name of the VpnTunnel resource to return.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
-                    "path": "{project}/global/urlMaps/{urlMap}",
+                    "path": "{project}/regions/{region}/vpnTunnels/{vpnTunnel}",
+                    "response": {
+                        "$ref": "VpnTunnel"
+                    },
+                    "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform",
+                        "https://www.googleapis.com/auth/compute",
+                        "https://www.googleapis.com/auth/compute.readonly"
+                    ]
+                },
+                "insert": {
+                    "description": "Creates a VpnTunnel resource in the specified project and region using the data included in the request.",
+                    "httpMethod": "POST",
+                    "id": "compute.vpnTunnels.insert",
+                    "parameterOrder": [
+                        "project",
+                        "region"
+                    ],
+                    "parameters": {
+                        "project": {
+                            "description": "Project ID for this request.",
+                            "location": "path",
+                            "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
+                            "required": true,
+                            "type": "string"
+                        },
+                        "region": {
+                            "description": "The name of the region for this request.",
+                            "location": "path",
+                            "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
+                            "required": true,
+                            "type": "string"
+                        }
+                    },
+                    "path": "{project}/regions/{region}/vpnTunnels",
                     "request": {
-                        "$ref": "UrlMap"
+                        "$ref": "VpnTunnel"
                     },
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
-                "validate": {
-                    "description": "Run static validation for the UrlMap. In particular, the tests of the provided UrlMap will be run. Calling this method does NOT create the UrlMap.",
-                    "httpMethod": "POST",
-                    "id": "compute.urlMaps.validate",
+                "list": {
+                    "description": "Retrieves the list of VpnTunnel resources contained in the specified project and region.",
+                    "httpMethod": "GET",
+                    "id": "compute.vpnTunnels.list",
                     "parameterOrder": [
                         "project",
-                        "urlMap"
+                        "region"
                     ],
                     "parameters": {
+                        "filter": {
+                            "description": "Optional. Filter expression for filtering listed resources.",
+                            "location": "query",
+                            "type": "string"
+                        },
+                        "maxResults": {
+                            "default": "500",
+                            "description": "Optional. Maximum count of results to be returned. Maximum value is 500 and default value is 500.",
+                            "format": "uint32",
+                            "location": "query",
+                            "maximum": "500",
+                            "minimum": "0",
+                            "type": "integer"
+                        },
+                        "pageToken": {
+                            "description": "Optional. Tag returned by a previous list request truncated by maxResults. Used to continue a previous list request.",
+                            "location": "query",
+                            "type": "string"
+                        },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
-                        "urlMap": {
-                            "description": "Name of the UrlMap resource to be validated as.",
+                        "region": {
+                            "description": "The name of the region for this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
-                    "path": "{project}/global/urlMaps/{urlMap}/validate",
-                    "request": {
-                        "$ref": "UrlMapsValidateRequest"
-                    },
+                    "path": "{project}/regions/{region}/vpnTunnels",
                     "response": {
-                        "$ref": "UrlMapsValidateResponse"
+                        "$ref": "VpnTunnelList"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
-                        "https://www.googleapis.com/auth/compute"
+                        "https://www.googleapis.com/auth/compute",
+                        "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 }
             }
         },
         "zoneOperations": {
             "methods": {
                 "delete": {
                     "description": "Deletes the specified zone-specific operation resource.",
                     "httpMethod": "DELETE",
                     "id": "compute.zoneOperations.delete",
                     "parameterOrder": [
                         "project",
                         "zone",
                         "operation"
                     ],
                     "parameters": {
                         "operation": {
                             "description": "Name of the operation resource to delete.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "zone": {
                             "description": "Name of the zone scoping this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
@@ skipping 17 matching lines @@
                     ],
                     "parameters": {
                         "operation": {
                             "description": "Name of the operation resource to return.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "zone": {
                             "description": "Name of the zone scoping this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
@@ skipping 32 matching lines @@
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Optional. Tag returned by a previous list request truncated by maxResults. Used to continue a previous list request.",
                             "location": "query",
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "zone": {
                             "description": "Name of the zone scoping this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
@@ skipping 17 matching lines @@
                 "get": {
                     "description": "Returns the specified zone resource.",
                     "httpMethod": "GET",
                     "id": "compute.zones.get",
                     "parameterOrder": [
                         "project",
                         "zone"
                     ],
                     "parameters": {
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         },
                         "zone": {
                             "description": "Name of the zone resource to return.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
@@ skipping 31 matching lines @@
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Optional. Tag returned by a previous list request truncated by maxResults. Used to continue a previous list request.",
                             "location": "query",
                             "type": "string"
                         },
                         "project": {
-                            "description": "Name of the project scoping this request.",
+                            "description": "Project ID for this request.",
                             "location": "path",
                             "pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?))",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/zones",
                     "response": {
                         "$ref": "ZoneList"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute",
                         "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 }
             }
         }
     },
-    "revision": "20150128",
+    "revision": "20150326",
     "rootUrl": "https://www.googleapis.com/",
     "schemas": {
         "AccessConfig": {
             "description": "An access configuration attached to an instance's network interface.",
             "id": "AccessConfig",
             "properties": {
                 "kind": {
                     "default": "compute#accessConfig",
-                    "description": "Type of the resource.",
+                    "description": "[Output Only] Type of the resource. Always compute#accessConfig for access configs.",
                     "type": "string"
                 },
                 "name": {
                     "description": "Name of this access configuration.",
                     "type": "string"
                 },
                 "natIP": {
-                    "description": "An external IP address associated with this instance. Specify an unused static IP address available to the project. If not specified, the external IP will be drawn from a shared ephemeral pool.",
+                    "description": "An external IP address associated with this instance. Specify an unused static external IP address available to the project or leave this field undefined to use an IP from a shared ephemeral IP address pool. If you specify a static external IP address, it must live in the same region as the zone of the instance.",
                     "type": "string"
                 },
                 "type": {
                     "default": "ONE_TO_ONE_NAT",
-                    "description": "Type of configuration. Must be set to \"ONE_TO_ONE_NAT\". This configures port-for-port NAT to the internet.",
+                    "description": "The type of configuration. The default and only option is ONE_TO_ONE_NAT.",
                     "enum": [
                         "ONE_TO_ONE_NAT"
                     ],
                     "enumDescriptions": [
                         ""
                     ],
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Address": {
             "description": "A reserved address resource.",
             "id": "Address",
             "properties": {
                 "address": {
-                    "description": "The IP address represented by this resource.",
+                    "description": "The static external IP address represented by this resource.",
                     "type": "string"
                 },
                 "creationTimestamp": {
-                    "description": "Creation timestamp in RFC3339 text format (output only).",
+                    "description": "[Output Only] Creation timestamp in RFC3339 text format.",
                     "type": "string"
                 },
                 "description": {
                     "description": "An optional textual description of the resource; provided by the client when the resource is created.",
                     "type": "string"
                 },
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "format": "uint64",
                     "type": "string"
                 },
                 "kind": {
                     "default": "compute#address",
-                    "description": "Type of the resource.",
+                    "description": "[Output Only] Type of the resource. Always compute#address for addresses.",
                     "type": "string"
                 },
                 "name": {
                     "annotations": {
                         "required": [
                             "compute.addresses.insert"
                         ]
                     },
-                    "description": "Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035.",
+                    "description": "Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.",
                     "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                     "type": "string"
                 },
                 "region": {
-                    "description": "URL of the region where the regional address resides (output only). This field is not applicable to global addresses.",
+                    "description": "[Output Only] URL of the region where the regional address resides. This field is not applicable to global addresses.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for the resource (output only).",
+                    "description": "[Output Only] Server defined URL for the resource.",
                     "type": "string"
                 },
                 "status": {
-                    "description": "The status of the address (output only).",
+                    "description": "[Output Only] The status of the address, which can be either IN_USE or RESERVED. An address that is RESERVED is currently reserved and available to use. An IN_USE address is currently being used by another resource and is not available.",
                     "enum": [
                         "IN_USE",
                         "RESERVED"
                     ],
                     "enumDescriptions": [
                         "",
                         ""
                     ],
                     "type": "string"
                 },
                 "users": {
-                    "description": "The resources that are using this address resource.",
+                    "description": "[Output Only] The URLs of the resources that are using this address.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
         "AddressAggregatedList": {
             "id": "AddressAggregatedList",
             "properties": {
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "type": "string"
                 },
                 "items": {
                     "additionalProperties": {
                         "$ref": "AddressesScopedList",
-                        "description": "Name of the scope containing this set of addresses."
+                        "description": "[Output Only] Name of the scope containing this set of addresses."
                     },
-                    "description": "A map of scoped address lists.",
+                    "description": "[Output Only] A map of scoped address lists.",
                     "type": "object"
                 },
                 "kind": {
                     "default": "compute#addressAggregatedList",
-                    "description": "Type of resource.",
+                    "description": "[Output Only] Type of resource. Always compute#addressAggregatedList for aggregated lists of addresses.",
                     "type": "string"
                 },
                 "nextPageToken": {
-                    "description": "A token used to continue a truncated list request (output only).",
+                    "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for this resource (output only).",
+                    "description": "[Output Only] Server defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "AddressList": {
             "description": "Contains a list of address resources.",
             "id": "AddressList",
             "properties": {
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "type": "string"
                 },
                 "items": {
-                    "description": "A list of Address resources.",
+                    "description": "[Output Only] A list of Address resources.",
                     "items": {
                         "$ref": "Address"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "compute#addressList",
-                    "description": "Type of resource.",
+                    "description": "[Output Only] Type of resource. Always compute#addressList for lists of addresses.",
                     "type": "string"
                 },
                 "nextPageToken": {
-                    "description": "A token used to continue a truncated list request (output only).",
+                    "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for the resource (output only).",
+                    "description": "[Output Only] Server defined URL for the resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "AddressesScopedList": {
             "id": "AddressesScopedList",
             "properties": {
                 "addresses": {
-                    "description": "List of addresses contained in this scope.",
+                    "description": "[Output Only] List of addresses contained in this scope.",
                     "items": {
                         "$ref": "Address"
                     },
                     "type": "array"
                 },
                 "warning": {
-                    "description": "Informational warning which replaces the list of addresses when the list is empty.",
+                    "description": "[Output Only] Informational warning which replaces the list of addresses when the list is empty.",
                     "properties": {
                         "code": {
-                            "description": "The warning type identifier for this warning.",
+                            "description": "[Output Only] The warning type identifier for this warning.",
                             "enum": [
                                 "DEPRECATED_RESOURCE_USED",
                                 "DISK_SIZE_LARGER_THAN_IMAGE_SIZE",
                                 "INJECTED_KERNELS_DEPRECATED",
                                 "NEXT_HOP_ADDRESS_NOT_ASSIGNED",
                                 "NEXT_HOP_CANNOT_IP_FORWARD",
                                 "NEXT_HOP_INSTANCE_NOT_FOUND",
                                 "NEXT_HOP_INSTANCE_NOT_ON_NETWORK",
                                 "NEXT_HOP_NOT_RUNNING",
                                 "NO_RESULTS_ON_PAGE",
                                 "REQUIRED_TOS_AGREEMENT",
                                 "RESOURCE_NOT_DELETED",
+                                "SINGLE_INSTANCE_PROPERTY_TEMPLATE",
                                 "UNREACHABLE"
                             ],
                             "enumDescriptions": [
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
+                                "",
                                 ""
                             ],
                             "type": "string"
                         },
                         "data": {
-                            "description": "Metadata for this warning in 'key: value' format.",
+                            "description": "[Output Only] Metadata for this warning in key: value format.",
                             "items": {
                                 "properties": {
                                     "key": {
-                                        "description": "A key for the warning data.",
+                                        "description": "[Output Only] A key for the warning data.",
                                         "type": "string"
                                     },
                                     "value": {
-                                        "description": "A warning data value corresponding to the key.",
+                                        "description": "[Output Only] A warning data value corresponding to the key.",
                                         "type": "string"
                                     }
                                 },
                                 "type": "object"
                             },
                             "type": "array"
                         },
                         "message": {
-                            "description": "Optional human-readable details for this warning.",
+                            "description": "[Output Only] Optional human-readable details for this warning.",
                             "type": "string"
                         }
                     },
                     "type": "object"
                 }
             },
             "type": "object"
         },
         "AttachedDisk": {
             "description": "An instance-attached disk resource.",
             "id": "AttachedDisk",
             "properties": {
                 "autoDelete": {
-                    "description": "Whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance).",
+                    "description": "Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance).",
                     "type": "boolean"
                 },
                 "boot": {
-                    "description": "Indicates that this is a boot disk. VM will use the first partition of the disk for its root filesystem.",
+                    "description": "Indicates that this is a boot disk. The virtual machine will use the first partition of the disk for its root filesystem.",
                     "type": "boolean"
                 },
                 "deviceName": {
-                    "description": "Persistent disk only; must be unique within the instance when specified. This represents a unique device name that is reflected into the /dev/ tree of a Linux operating system running within the instance. If not specified, a default will be chosen by the system.",
+                    "description": "Specifies a unique device name of your choice that is reflected into the /dev/ tree of a Linux operating system running within the instance. This name can be used to reference the device for mounting, resizing, and so on, from within the instance.\n\nIf not specified, the server chooses a default device name to apply to this disk, in the form persistent-disks-x, where x is a number assigned by Google Compute Engine. This field is only applicable for persistent disks.",
                     "type": "string"
                 },
                 "index": {
-                    "description": "A zero-based index to assign to this disk, where 0 is reserved for the boot disk. If not specified, the server will choose an appropriate value (output only).",
+                    "description": "Assigns a zero-based index to this disk, where 0 is reserved for the boot disk. For example, if you have many disks attached to an instance, each disk would have a unique index number. If not specified, the server will choose an appropriate value.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "initializeParams": {
                     "$ref": "AttachedDiskInitializeParams",
-                    "description": "Initialization parameters."
+                    "description": "[Input Only] Specifies the parameters for a new disk that will be created alongside the new instance. Use initialization parameters to create boot disks or local SSDs attached to the new instance.\n\nThis property is mutually exclusive with the source property; you can only define one or the other, but not both."
                 },
                 "interface": {
                     "enum": [
                         "NVME",
                         "SCSI"
                     ],
                     "enumDescriptions": [
                         "",
                         ""
                     ],
                     "type": "string"
                 },
                 "kind": {
                     "default": "compute#attachedDisk",
-                    "description": "Type of the resource.",
+                    "description": "[Output Only] Type of the resource. Always compute#attachedDisk for attached disks.",
                     "type": "string"
                 },
                 "licenses": {
-                    "description": "Public visible licenses.",
+                    "description": "[Output Only] Any valid publicly visible licenses.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "mode": {
-                    "description": "The mode in which to attach this disk, either \"READ_WRITE\" or \"READ_ONLY\".",
+                    "description": "The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode.",
                     "enum": [
                         "READ_ONLY",
                         "READ_WRITE"
                     ],
                     "enumDescriptions": [
                         "",
                         ""
                     ],
                     "type": "string"
                 },
                 "source": {
-                    "description": "Persistent disk only; the URL of the persistent disk resource.",
+                    "description": "Specifies a valid partial or full URL to an existing Persistent Disk resource. This field is only applicable for persistent disks.",
                     "type": "string"
                 },
                 "type": {
                     "annotations": {
                         "required": [
                             "compute.instances.insert"
                         ]
                     },
-                    "description": "Type of the disk, either \"SCRATCH\" or \"PERSISTENT\". Note that persistent disks must be created before you can specify them here.",
+                    "description": "Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT.",
                     "enum": [
                         "PERSISTENT",
                         "SCRATCH"
                     ],
                     "enumDescriptions": [
                         "",
                         ""
                     ],
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "AttachedDiskInitializeParams": {
-            "description": "Initialization parameters for the new disk (input-only). Can only be specified on the boot disk or local SSDs. Mutually exclusive with 'source'.",
+            "description": "[Input Only] Specifies the parameters for a new disk that will be created alongside the new instance. Use initialization parameters to create boot disks or local SSDs attached to the new instance.\n\nThis property is mutually exclusive with the source property; you can only define one or the other, but not both.",
             "id": "AttachedDiskInitializeParams",
             "properties": {
                 "diskName": {
-                    "description": "Name of the disk (when not provided defaults to the name of the instance).",
+                    "description": "Specifies the disk name. If not specified, the default is to use the name of the instance.",
                     "type": "string"
                 },
                 "diskSizeGb": {
-                    "description": "Size of the disk in base-2 GB.",
+                    "description": "Specifies the size of the disk in base-2 GB.",
                     "format": "int64",
                     "type": "string"
                 },
                 "diskType": {
-                    "description": "URL of the disk type resource describing which disk type to use to create the disk; provided by the client when the disk is created.",
+                    "description": "Specifies the disk type to use to create the instance. If not specified, the default is pd-standard, specified using the full URL. For example:\n\nhttps://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/pd-standard \n\nOther values include pd-ssd and local-ssd. If you define this field, you can provide either the full or partial URL. For example, the following are valid values:  \n- https://www.googleapis.com/compute/v1/projects/project/zones/zone/diskTypes/diskType \n- projects/project/zones/zone/diskTypes/diskType \n- zones/zone/diskTypes/diskType",
                     "type": "string"
                 },
                 "sourceImage": {
-                    "description": "The source image used to create this disk.",
+                    "description": "A source image used to create the disk. You can provide a private (custom) image, and Compute Engine will use the corresponding image from your project. For example:\n\nglobal/images/my-private-image \n\nOr you can provide an image from a publicly-available project. For example, to use a Debian image from the debian-cloud project, make sure to include the project in the URL:\n\nprojects/debian-cloud/global/images/debian-7-wheezy-vYYYYMMDD \n\nwhere vYYYYMMDD is the image version. The fully-qualified URL will also work in both cases.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Backend": {
             "description": "Message containing information of one individual backend.",
             "id": "Backend",
             "properties": {
                 "balancingMode": {
@@ skipping 173 matching lines @@
                 },
                 "deprecated": {
                     "description": "An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to DEPRECATED.",
                     "type": "string"
                 },
                 "obsolete": {
                     "description": "An optional RFC3339 timestamp on or after which the deprecation state of this resource will be changed to OBSOLETE.",
                     "type": "string"
                 },
                 "replacement": {
-                    "description": "A URL of the suggested replacement for the deprecated resource. The deprecated resource and its replacement must be resources of the same kind.",
+                    "description": "The URL of the suggested replacement for a deprecated resource. The suggested replacement resource must be the same kind of resource as the deprecated resource.",
                     "type": "string"
                 },
                 "state": {
-                    "description": "The deprecation state. Can be \"DEPRECATED\", \"OBSOLETE\", or \"DELETED\". Operations which create a new resource using a \"DEPRECATED\" resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. New uses of \"OBSOLETE\" or \"DELETED\" resources will result in an error.",
+                    "description": "The deprecation state of this resource. This can be DEPRECATED, OBSOLETE, or DELETED. Operations which create a new resource using a DEPRECATED resource will return successfully, but with a warning indicating the deprecated resource and recommending its replacement. Operations which use OBSOLETE or DELETED resources will be rejected and result in an error.",
                     "enum": [
                         "DELETED",
                         "DEPRECATED",
                         "OBSOLETE"
                     ],
                     "enumDescriptions": [
                         "",
                         "",
                         ""
                     ],
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Disk": {
-            "description": "A persistent disk resource.",
+            "description": "A Disk resource.",
             "id": "Disk",
             "properties": {
                 "creationTimestamp": {
-                    "description": "Creation timestamp in RFC3339 text format (output only).",
+                    "description": "[Output Only] Creation timestamp in RFC3339 text format.",
                     "type": "string"
                 },
                 "description": {
                     "description": "An optional textual description of the resource; provided by the client when the resource is created.",
                     "type": "string"
                 },
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "format": "uint64",
                     "type": "string"
                 },
                 "kind": {
                     "default": "compute#disk",
-                    "description": "Type of the resource.",
+                    "description": "[Output Only] Type of the resource. Always compute#disk for disks.",
                     "type": "string"
                 },
                 "licenses": {
-                    "description": "Public visible licenses.",
+                    "description": "Any applicable publicly visible licenses.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "name": {
                     "annotations": {
                         "required": [
                             "compute.disks.insert"
                         ]
                     },
-                    "description": "Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035.",
+                    "description": "Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.",
                     "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                     "type": "string"
                 },
                 "options": {
                     "description": "Internal use only.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for the resource (output only).",
+                    "description": "[Output Only] Server-defined fully-qualified URL for this resource.",
                     "type": "string"
                 },
                 "sizeGb": {
-                    "description": "Size of the persistent disk, specified in GB. This parameter is optional when creating a disk from a disk image or a snapshot, otherwise it is required.",
+                    "description": "Size of the persistent disk, specified in GB. You can specify this field when creating a persistent disk using the sourceImage or sourceSnapshot parameter, or specify it alone to create an empty persistent disk.\n\nIf you specify this field along with sourceImage or sourceSnapshot, the value of sizeGb must not be less than the size of the sourceImage or the size of the snapshot.",
                     "format": "int64",
                     "type": "string"
                 },
                 "sourceImage": {
-                    "description": "The source image used to create this disk.",
+                    "description": "The source image used to create this disk. If the source image is deleted from the system, this field will not be set, even if an image with the same name has been re-created.\n\nWhen creating a disk, you can provide a private (custom) image using the following input, and Compute Engine will use the corresponding image from your project. For example:\n\nglobal/images/my-private-image \n\nOr you can provide an image from a publicly-available project. For example, to use a Debian image from the debian-cloud project, make sure to include the project in the URL:\n\nprojects/debian-cloud/global/images/debian-7-wheezy-vYYYYMMDD \n\nwhere vYYYYMMDD is the image version. The fully-qualified URL will also work in both cases.",
                     "type": "string"
                 },
                 "sourceImageId": {
-                    "description": "The 'id' value of the image used to create this disk. This value may be used to determine whether the disk was created from the current or a previous instance of a given image.",
+                    "description": "The ID value of the image used to create this disk. This value identifies the exact image that was used to create this persistent disk. For example, if you created the persistent disk from an image that was later deleted and recreated under the same name, the source image ID would identify the exact version of the image that was used.",
                     "type": "string"
                 },
                 "sourceSnapshot": {
-                    "description": "The source snapshot used to create this disk.",
+                    "description": "The source snapshot used to create this disk. You can provide this as a partial or full URL to the resource. For example, the following are valid values:  \n- https://www.googleapis.com/compute/v1/projects/project/global/snapshots/snapshot \n- projects/project/global/snapshots/snapshot \n- global/snapshots/snapshot",
                     "type": "string"
                 },
                 "sourceSnapshotId": {
-                    "description": "The 'id' value of the snapshot used to create this disk. This value may be used to determine whether the disk was created from the current or a previous instance of a given disk snapshot.",
+                    "description": "[Output Only] The unique ID of the snapshot used to create this disk. This value identifies the exact snapshot that was used to create this persistent disk. For example, if you created the persistent disk from a snapshot that was later deleted and recreated under the same name, the source snapshot ID would identify the exact version of the snapshot that was used.",
                     "type": "string"
                 },
                 "status": {
-                    "description": "The status of disk creation (output only).",
+                    "description": "[Output Only] The status of disk creation. Applicable statuses includes: CREATING, FAILED, READY, RESTORING.",
                     "enum": [
                         "CREATING",
                         "FAILED",
                         "READY",
                         "RESTORING"
                     ],
                     "enumDescriptions": [
                         "",
                         "",
                         "",
                         ""
                     ],
                     "type": "string"
                 },
                 "type": {
                     "description": "URL of the disk type resource describing which disk type to use to create the disk; provided by the client when the disk is created.",
                     "type": "string"
                 },
                 "zone": {
-                    "description": "URL of the zone where the disk resides (output only).",
+                    "description": "[Output Only] URL of the zone where the disk resides.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "DiskAggregatedList": {
             "id": "DiskAggregatedList",
             "properties": {
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "type": "string"
                 },
                 "items": {
                     "additionalProperties": {
                         "$ref": "DisksScopedList",
-                        "description": "Name of the scope containing this set of disks."
+                        "description": "[Output Only] Name of the scope containing this set of disks."
                     },
-                    "description": "A map of scoped disk lists.",
+                    "description": "[Output Only] A map of scoped disk lists.",
                     "type": "object"
                 },
                 "kind": {
                     "default": "compute#diskAggregatedList",
-                    "description": "Type of resource.",
+                    "description": "[Output Only] Type of resource. Always compute#diskAggregatedList for aggregated lists of persistent disks.",
                     "type": "string"
                 },
                 "nextPageToken": {
-                    "description": "A token used to continue a truncated list request (output only).",
+                    "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for this resource (output only).",
+                    "description": "[Output Only] Server defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "DiskList": {
-            "description": "Contains a list of persistent disk resources.",
+            "description": "A list of Disk resources.",
             "id": "DiskList",
             "properties": {
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "type": "string"
                 },
                 "items": {
-                    "description": "A list of Disk resources.",
+                    "description": "[Output Only] A list of persistent disks.",
                     "items": {
                         "$ref": "Disk"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "compute#diskList",
-                    "description": "Type of resource.",
+                    "description": "[Output Only] Type of resource. Always compute#diskList for lists of disks.",
                     "type": "string"
                 },
                 "nextPageToken": {
-                    "description": "A token used to continue a truncated list request (output only).",
+                    "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for this resource (output only).",
+                    "description": "[Output Only] Server defined URL for this resource.",
                     "type": "string"
                 }
             },
+            "type": "object"
+        },
+        "DiskMoveRequest": {
+            "id": "DiskMoveRequest",
+            "properties": {
+                "destinationZone": {
+                    "description": "The URL of the destination zone to move the disk to. This can be a full or partial URL. For example, the following are all valid URLs to a zone:  \n- https://www.googleapis.com/compute/v1/projects/project/zones/zone \n- projects/project/zones/zone \n- zones/zone",
+                    "type": "string"
+                },
+                "targetDisk": {
+                    "description": "The URL of the target disk to move. This can be a full or partial URL. For example, the following are all valid URLs to a disk:  \n- https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk \n- projects/project/zones/zone/disks/disk \n- zones/zone/disks/disk",
+                    "type": "string"
+                }
+            },
             "type": "object"
         },
         "DiskType": {
             "description": "A disk type resource.",
             "id": "DiskType",
             "properties": {
                 "creationTimestamp": {
-                    "description": "Creation timestamp in RFC3339 text format (output only).",
+                    "description": "[Output Only] Creation timestamp in RFC3339 text format.",
                     "type": "string"
                 },
                 "defaultDiskSizeGb": {
-                    "description": "Server defined default disk size in gb (output only).",
+                    "description": "[Output Only] Server defined default disk size in GB.",
                     "format": "int64",
                     "type": "string"
                 },
                 "deprecated": {
                     "$ref": "DeprecationStatus",
-                    "description": "The deprecation status associated with this disk type."
+                    "description": "[Output Only] The deprecation status associated with this disk type."
                 },
                 "description": {
-                    "description": "An optional textual description of the resource.",
+                    "description": "[Output Only] An optional textual description of the resource.",
                     "type": "string"
                 },
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "format": "uint64",
                     "type": "string"
                 },
                 "kind": {
                     "default": "compute#diskType",
-                    "description": "Type of the resource.",
+                    "description": "[Output Only] Type of the resource. Always compute#diskType for disk types.",
                     "type": "string"
                 },
                 "name": {
-                    "description": "Name of the resource.",
+                    "description": "[Output Only] Name of the resource.",
                     "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for the resource (output only).",
+                    "description": "[Output Only] Server defined URL for the resource.",
                     "type": "string"
                 },
                 "validDiskSize": {
-                    "description": "An optional textual descroption of the valid disk size, e.g., \"10GB-10TB\".",
+                    "description": "[Output Only] An optional textual description of the valid disk size, such as \"10GB-10TB\".",
                     "type": "string"
                 },
                 "zone": {
-                    "description": "Url of the zone where the disk type resides (output only).",
+                    "description": "[Output Only] URL of the zone where the disk type resides.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "DiskTypeAggregatedList": {
             "id": "DiskTypeAggregatedList",
             "properties": {
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "type": "string"
                 },
                 "items": {
                     "additionalProperties": {
                         "$ref": "DiskTypesScopedList",
-                        "description": "Name of the scope containing this set of disk types."
+                        "description": "[Output Only] Name of the scope containing this set of disk types."
                     },
-                    "description": "A map of scoped disk type lists.",
+                    "description": "[Output Only] A map of scoped disk type lists.",
                     "type": "object"
                 },
                 "kind": {
                     "default": "compute#diskTypeAggregatedList",
-                    "description": "Type of resource.",
+                    "description": "[Output Only] Type of resource. Always compute#diskTypeAggregatedList.",
                     "type": "string"
                 },
                 "nextPageToken": {
-                    "description": "A token used to continue a truncated list request (output only).",
+                    "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for this resource (output only).",
+                    "description": "[Output Only] Server defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "DiskTypeList": {
             "description": "Contains a list of disk type resources.",
             "id": "DiskTypeList",
             "properties": {
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "type": "string"
                 },
                 "items": {
-                    "description": "A list of DiskType resources.",
+                    "description": "[Output Only] A list of Disk Type resources.",
                     "items": {
                         "$ref": "DiskType"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "compute#diskTypeList",
-                    "description": "Type of resource.",
+                    "description": "[Output Only] Type of resource. Always compute#diskTypeList for disk types.",
                     "type": "string"
                 },
                 "nextPageToken": {
-                    "description": "A token used to continue a truncated list request (output only).",
+                    "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for this resource (output only).",
+                    "description": "[Output Only] Server defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "DiskTypesScopedList": {
             "id": "DiskTypesScopedList",
             "properties": {
                 "diskTypes": {
-                    "description": "List of disk types contained in this scope.",
+                    "description": "[Output Only] List of disk types contained in this scope.",
                     "items": {
                         "$ref": "DiskType"
                     },
                     "type": "array"
                 },
                 "warning": {
-                    "description": "Informational warning which replaces the list of disk types when the list is empty.",
+                    "description": "[Output Only] Informational warning which replaces the list of disk types when the list is empty.",
                     "properties": {
                         "code": {
-                            "description": "The warning type identifier for this warning.",
+                            "description": "[Output Only] The warning type identifier for this warning.",
                             "enum": [
                                 "DEPRECATED_RESOURCE_USED",
                                 "DISK_SIZE_LARGER_THAN_IMAGE_SIZE",
                                 "INJECTED_KERNELS_DEPRECATED",
                                 "NEXT_HOP_ADDRESS_NOT_ASSIGNED",
                                 "NEXT_HOP_CANNOT_IP_FORWARD",
                                 "NEXT_HOP_INSTANCE_NOT_FOUND",
                                 "NEXT_HOP_INSTANCE_NOT_ON_NETWORK",
                                 "NEXT_HOP_NOT_RUNNING",
                                 "NO_RESULTS_ON_PAGE",
                                 "REQUIRED_TOS_AGREEMENT",
                                 "RESOURCE_NOT_DELETED",
+                                "SINGLE_INSTANCE_PROPERTY_TEMPLATE",
                                 "UNREACHABLE"
                             ],
                             "enumDescriptions": [
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
+                                "",
                                 ""
                             ],
                             "type": "string"
                         },
                         "data": {
-                            "description": "Metadata for this warning in 'key: value' format.",
+                            "description": "[Output Only] Metadata for this warning in key: value format.",
                             "items": {
                                 "properties": {
                                     "key": {
-                                        "description": "A key for the warning data.",
+                                        "description": "[Output Only] A key for the warning data.",
                                         "type": "string"
                                     },
                                     "value": {
-                                        "description": "A warning data value corresponding to the key.",
+                                        "description": "[Output Only] A warning data value corresponding to the key.",
                                         "type": "string"
                                     }
                                 },
                                 "type": "object"
                             },
                             "type": "array"
                         },
                         "message": {
-                            "description": "Optional human-readable details for this warning.",
+                            "description": "[Output Only] Optional human-readable details for this warning.",
                             "type": "string"
                         }
                     },
                     "type": "object"
                 }
             },
             "type": "object"
         },
         "DisksScopedList": {
             "id": "DisksScopedList",
             "properties": {
                 "disks": {
-                    "description": "List of disks contained in this scope.",
+                    "description": "[Output Only] List of disks contained in this scope.",
                     "items": {
                         "$ref": "Disk"
                     },
                     "type": "array"
                 },
                 "warning": {
-                    "description": "Informational warning which replaces the list of disks when the list is empty.",
+                    "description": "[Output Only] Informational warning which replaces the list of disks when the list is empty.",
                     "properties": {
                         "code": {
-                            "description": "The warning type identifier for this warning.",
+                            "description": "[Output Only] The warning type identifier for this warning.",
                             "enum": [
                                 "DEPRECATED_RESOURCE_USED",
                                 "DISK_SIZE_LARGER_THAN_IMAGE_SIZE",
                                 "INJECTED_KERNELS_DEPRECATED",
                                 "NEXT_HOP_ADDRESS_NOT_ASSIGNED",
                                 "NEXT_HOP_CANNOT_IP_FORWARD",
                                 "NEXT_HOP_INSTANCE_NOT_FOUND",
                                 "NEXT_HOP_INSTANCE_NOT_ON_NETWORK",
                                 "NEXT_HOP_NOT_RUNNING",
                                 "NO_RESULTS_ON_PAGE",
                                 "REQUIRED_TOS_AGREEMENT",
                                 "RESOURCE_NOT_DELETED",
+                                "SINGLE_INSTANCE_PROPERTY_TEMPLATE",
                                 "UNREACHABLE"
                             ],
                             "enumDescriptions": [
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
+                                "",
                                 ""
                             ],
                             "type": "string"
                         },
                         "data": {
-                            "description": "Metadata for this warning in 'key: value' format.",
+                            "description": "[Output Only] Metadata for this warning in key: value format.",
                             "items": {
                                 "properties": {
                                     "key": {
-                                        "description": "A key for the warning data.",
+                                        "description": "[Output Only] A key for the warning data.",
                                         "type": "string"
                                     },
                                     "value": {
-                                        "description": "A warning data value corresponding to the key.",
+                                        "description": "[Output Only] A warning data value corresponding to the key.",
                                         "type": "string"
                                     }
                                 },
                                 "type": "object"
                             },
                             "type": "array"
                         },
                         "message": {
-                            "description": "Optional human-readable details for this warning.",
+                            "description": "[Output Only] Optional human-readable details for this warning.",
                             "type": "string"
                         }
                     },
                     "type": "object"
                 }
             },
             "type": "object"
         },
         "Firewall": {
-            "description": "A firewall resource.",
+            "description": "A Firewall resource.",
             "id": "Firewall",
             "properties": {
                 "allowed": {
                     "description": "The list of rules specified by this firewall. Each rule specifies a protocol and port-range tuple that describes a permitted connection.",
                     "items": {
                         "properties": {
                             "IPProtocol": {
-                                "description": "Required; this is the IP protocol that is allowed for this rule. This can either be one of the following well known protocol strings [\"tcp\", \"udp\", \"icmp\", \"esp\", \"ah\", \"sctp\"], or the IP protocol number.",
+                                "description": "The IP protocol that is allowed for this rule. The protocol type is required when creating a firewall. This value can either be one of the following well known protocol strings (tcp, udp, icmp, esp, ah, sctp), or the IP protocol number.",
                                 "type": "string"
                             },
                             "ports": {
-                                "description": "An optional list of ports which are allowed. It is an error to specify this for any protocol that isn't UDP or TCP. Each entry must be either an integer or a range. If not specified, connections through any port are allowed.\n\nExample inputs include: [\"22\"], [\"80\",\"443\"] and [\"12345-12349\"].",
+                                "description": "An optional list of ports which are allowed. This field is only applicable for UDP or TCP protocol. Each entry must be either an integer or a range. If not specified, connections through any port are allowed\n\nExample inputs include: [\"22\"], [\"80\",\"443\"], and [\"12345-12349\"].",
                                 "items": {
                                     "type": "string"
                                 },
                                 "type": "array"
                             }
                         },
                         "type": "object"
                     },
                     "type": "array"
                 },
                 "creationTimestamp": {
-                    "description": "Creation timestamp in RFC3339 text format (output only).",
+                    "description": "[Output Only] Creation timestamp in RFC3339text format.",
                     "type": "string"
                 },
                 "description": {
                     "description": "An optional textual description of the resource; provided by the client when the resource is created.",
                     "type": "string"
                 },
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "format": "uint64",
                     "type": "string"
                 },
                 "kind": {
                     "default": "compute#firewall",
-                    "description": "Type of the resource.",
+                    "description": "[Output Ony] Type of the resource. Always compute#firewall for firewall rules.",
                     "type": "string"
                 },
                 "name": {
                     "annotations": {
                         "required": [
                             "compute.firewalls.insert",
                             "compute.firewalls.patch"
                         ]
                     },
-                    "description": "Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035.",
+                    "description": "Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.",
                     "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                     "type": "string"
                 },
                 "network": {
-                    "description": "URL of the network to which this firewall is applied; provided by the client when the firewall is created.",
+                    "description": "URL of the network resource for this firewall rule. This field is required for creating an instance but optional when creating a firewall rule. If not specified when creating a firewall rule, the default network is used:\nglobal/networks/default\nIf you choose to specify this property, you can specify the network as a full or partial URL. For example, the following are all valid URLs:  \n- https://www.googleapis.com/compute/v1/projects/myproject/global/networks/my-network \n- projects/myproject/global/networks/my-network \n- global/networks/default",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for the resource (output only).",
+                    "description": "[Output Only] Server defined URL for the resource.",
                     "type": "string"
                 },
                 "sourceRanges": {
-                    "description": "A list of IP address blocks expressed in CIDR format which this rule applies to. One or both of sourceRanges and sourceTags may be set; an inbound connection is allowed if either the range or the tag of the source matches.",
+                    "description": "The IP address blocks that this rule applies to, expressed in CIDR format. One or both of sourceRanges and sourceTags may be set.\n\nIf both properties are set, an inbound connection is allowed if the range or the tag of the source matches the sourceRanges OR matches the sourceTags property; the connection does not need to match both properties.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "sourceTags": {
-                    "description": "A list of instance tags which this rule applies to. One or both of sourceRanges and sourceTags may be set; an inbound connection is allowed if either the range or the tag of the source matches.",
+                    "description": "A list of instance tags which this rule applies to. One or both of sourceRanges and sourceTags may be set.\n\nIf both properties are set, an inbound connection is allowed if the range or the tag of the source matches the sourceRanges OR matches the sourceTags property; the connection does not need to match both properties.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "targetTags": {
-                    "description": "A list of instance tags indicating sets of instances located on network which may make network connections as specified in allowed. If no targetTags are specified, the firewall rule applies to all instances on the specified network.",
+                    "description": "A list of instance tags indicating sets of instances located on network which may make network connections as specified in allowed[]. If no targetTags are specified, the firewall rule applies to all instances on the specified network.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
         "FirewallList": {
-            "description": "Contains a list of firewall resources.",
+            "description": "Contains a list of Firewall resources.",
             "id": "FirewallList",
             "properties": {
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "type": "string"
                 },
                 "items": {
-                    "description": "A list of Firewall resources.",
+                    "description": "[Output Only] A list of Firewall resources.",
                     "items": {
                         "$ref": "Firewall"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "compute#firewallList",
-                    "description": "Type of resource.",
+                    "description": "[Output Only] Type of resource. Always compute#firewallList for lists of firewalls.",
                     "type": "string"
                 },
                 "nextPageToken": {
-                    "description": "A token used to continue a truncated list request (output only).",
+                    "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for this resource (output only).",
+                    "description": "[Output Only] Server defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "ForwardingRule": {
             "description": "A ForwardingRule resource. A ForwardingRule resource specifies which pool of target VMs to forward a packet to if it matches the given [IPAddress, IPProtocol, portRange] tuple.",
             "id": "ForwardingRule",
             "properties": {
                 "IPAddress": {
@@ skipping 129 matching lines @@
                     "description": "List of forwarding rules contained in this scope.",
                     "items": {
                         "$ref": "ForwardingRule"
                     },
                     "type": "array"
                 },
                 "warning": {
                     "description": "Informational warning which replaces the list of forwarding rules when the list is empty.",
                     "properties": {
                         "code": {
-                            "description": "The warning type identifier for this warning.",
+                            "description": "[Output Only] The warning type identifier for this warning.",
                             "enum": [
                                 "DEPRECATED_RESOURCE_USED",
                                 "DISK_SIZE_LARGER_THAN_IMAGE_SIZE",
                                 "INJECTED_KERNELS_DEPRECATED",
                                 "NEXT_HOP_ADDRESS_NOT_ASSIGNED",
                                 "NEXT_HOP_CANNOT_IP_FORWARD",
                                 "NEXT_HOP_INSTANCE_NOT_FOUND",
                                 "NEXT_HOP_INSTANCE_NOT_ON_NETWORK",
                                 "NEXT_HOP_NOT_RUNNING",
                                 "NO_RESULTS_ON_PAGE",
                                 "REQUIRED_TOS_AGREEMENT",
                                 "RESOURCE_NOT_DELETED",
+                                "SINGLE_INSTANCE_PROPERTY_TEMPLATE",
                                 "UNREACHABLE"
                             ],
                             "enumDescriptions": [
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
+                                "",
                                 ""
                             ],
                             "type": "string"
                         },
                         "data": {
-                            "description": "Metadata for this warning in 'key: value' format.",
+                            "description": "[Output Only] Metadata for this warning in key: value format.",
                             "items": {
                                 "properties": {
                                     "key": {
-                                        "description": "A key for the warning data.",
+                                        "description": "[Output Only] A key for the warning data.",
                                         "type": "string"
                                     },
                                     "value": {
-                                        "description": "A warning data value corresponding to the key.",
+                                        "description": "[Output Only] A warning data value corresponding to the key.",
                                         "type": "string"
                                     }
                                 },
                                 "type": "object"
                             },
                             "type": "array"
                         },
                         "message": {
-                            "description": "Optional human-readable details for this warning.",
+                            "description": "[Output Only] Optional human-readable details for this warning.",
                             "type": "string"
                         }
                     },
                     "type": "object"
                 }
             },
             "type": "object"
         },
         "HealthCheckReference": {
             "id": "HealthCheckReference",
@@ skipping 148 matching lines @@
                     "type": "string"
                 },
                 "selfLink": {
                     "description": "Server defined URL for this resource (output only).",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Image": {
-            "description": "A disk image resource.",
+            "description": "An Image resource.",
             "id": "Image",
             "properties": {
                 "archiveSizeBytes": {
                     "description": "Size of the image tar.gz archive stored in Google Cloud Storage (in bytes).",
                     "format": "int64",
                     "type": "string"
                 },
                 "creationTimestamp": {
-                    "description": "Creation timestamp in RFC3339 text format (output only).",
+                    "description": "[Output Only] Creation timestamp in RFC3339 text format.",
                     "type": "string"
                 },
                 "deprecated": {
                     "$ref": "DeprecationStatus",
                     "description": "The deprecation status associated with this image."
                 },
                 "description": {
                     "description": "Textual description of the resource; provided by the client when the resource is created.",
                     "type": "string"
                 },
                 "diskSizeGb": {
-                    "description": "Size of the image when restored onto a disk (in GiB).",
+                    "description": "Size of the image when restored onto a persistent disk (in GB).",
                     "format": "int64",
                     "type": "string"
                 },
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "format": "uint64",
                     "type": "string"
                 },
                 "kind": {
                     "default": "compute#image",
-                    "description": "Type of the resource.",
+                    "description": "[Output Only] Type of the resource. Always compute#image for images.",
                     "type": "string"
                 },
                 "licenses": {
-                    "description": "Public visible licenses.",
+                    "description": "Any applicable publicly visible licenses.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "name": {
                     "annotations": {
                         "required": [
                             "compute.images.insert"
                         ]
                     },
-                    "description": "Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035.",
+                    "description": "Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.",
                     "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                     "type": "string"
                 },
                 "rawDisk": {
-                    "description": "The raw disk image parameters.",
+                    "description": "The parameters of the raw disk image.",
                     "properties": {
                         "containerType": {
-                            "description": "The format used to encode and transmit the block device. Should be TAR. This is just a container and transmission format and not a runtime format. Provided by the client when the disk image is created.",
+                            "description": "The format used to encode and transmit the block device, which should be TAR. This is just a container and transmission format and not a runtime format. Provided by the client when the disk image is created.",
                             "enum": [
                                 "TAR"
                             ],
                             "enumDescriptions": [
                                 ""
                             ],
                             "type": "string"
                         },
                         "sha1Checksum": {
                             "description": "An optional SHA1 checksum of the disk image before unpackaging; provided by the client when the disk image is created.",
                             "pattern": "[a-f0-9]{40}",
                             "type": "string"
                         },
                         "source": {
                             "annotations": {
                                 "required": [
                                     "compute.images.insert"
                                 ]
                             },
-                            "description": "The full Google Cloud Storage URL where the disk image is stored; provided by the client when the disk image is created.",
+                            "description": "The full Google Cloud Storage URL where the disk image is stored. You must provide either this property or the sourceDisk property but not both.",
                             "type": "string"
                         }
                     },
                     "type": "object"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for the resource (output only).",
+                    "description": "[Output Only] Server defined URL for the resource.",
                     "type": "string"
                 },
                 "sourceDisk": {
-                    "description": "The source disk used to create this image.",
+                    "description": "URL of the The source disk used to create this image. This can be a full or valid partial URL. You must provide either this property or the rawDisk.source property but not both to create an image. For example, the following are valid values:  \n- https://www.googleapis.com/compute/v1/projects/project/zones/zone/disk/disk \n- projects/project/zones/zone/disk/disk \n- zones/zone/disks/disk",
                     "type": "string"
                 },
                 "sourceDiskId": {
-                    "description": "The 'id' value of the disk used to create this image. This value may be used to determine whether the image was taken from the current or a previous instance of a given disk name.",
+                    "description": "The ID value of the disk used to create this image. This value may be used to determine whether the image was taken from the current or a previous instance of a given disk name.",
                     "type": "string"
                 },
                 "sourceType": {
                     "default": "RAW",
-                    "description": "Must be \"RAW\"; provided by the client when the disk image is created.",
+                    "description": "The type of the image used to create this disk. The default and only value is RAW",
                     "enum": [
                         "RAW"
                     ],
                     "enumDescriptions": [
                         ""
                     ],
                     "type": "string"
                 },
                 "status": {
-                    "description": "Status of the image (output only). It will be one of the following READY - after image has been successfully created and is ready for use FAILED - if creating the image fails for some reason PENDING - the image creation is in progress An image can be used to create other resources suck as instances only after the image has been successfully created and the status is set to READY.",
+                    "description": "[Output Only] The status of the image. An image can be used to create other resources, such as instances, only after the image has been successfully created and the status is set to READY. Possible values are FAILED, PENDING, or READY.",
                     "enum": [
                         "FAILED",
                         "PENDING",
                         "READY"
                     ],
                     "enumDescriptions": [
                         "",
                         "",
                         ""
                     ],
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "ImageList": {
-            "description": "Contains a list of disk image resources.",
+            "description": "Contains a list of Image resources.",
             "id": "ImageList",
             "properties": {
                 "id": {
                     "description": "Unique identifier for the resource; defined by the server (output only).",
                     "type": "string"
                 },
                 "items": {
                     "description": "A list of Image resources.",
                     "items": {
                         "$ref": "Image"
@@ skipping 10 matching lines @@
                     "type": "string"
                 },
                 "selfLink": {
                     "description": "Server defined URL for this resource (output only).",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Instance": {
-            "description": "An instance resource.",
+            "description": "An Instance resource.",
             "id": "Instance",
             "properties": {
                 "canIpForward": {
-                    "description": "Allows this instance to send packets with source IP addresses other than its own and receive packets with destination IP addresses other than its own. If this instance will be used as an IP gateway or it will be set as the next-hop in a Route resource, say true. If unsure, leave this set to false.",
+                    "description": "Allows this instance to send and receive packets with non-matching destination or source IPs. This is required if you plan to use this instance to forward routes. For more information, see Enabling IP Forwarding.",
                     "type": "boolean"
                 },
+                "cpuPlatform": {
+                    "description": "[Output Only] The CPU platform used by this instance.",
+                    "type": "string"
+                },
                 "creationTimestamp": {
-                    "description": "Creation timestamp in RFC3339 text format (output only).",
+                    "description": "[Output Only] Creation timestamp in RFC3339 text format.",
                     "type": "string"
                 },
                 "description": {
                     "description": "An optional textual description of the resource; provided by the client when the resource is created.",
                     "type": "string"
                 },
                 "disks": {
                     "description": "Array of disks associated with this instance. Persistent disks must be created before you can assign them.",
                     "items": {
                         "$ref": "AttachedDisk"
                     },
                     "type": "array"
                 },
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "format": "uint64",
                     "type": "string"
                 },
                 "kind": {
                     "default": "compute#instance",
-                    "description": "Type of the resource.",
+                    "description": "[Output Only] Type of the resource. Always compute#instance for instances.",
                     "type": "string"
                 },
                 "machineType": {
                     "annotations": {
                         "required": [
                             "compute.instances.insert"
                         ]
                     },
-                    "description": "URL of the machine type resource describing which machine type to use to host the instance; provided by the client when the instance is created.",
+                    "description": "Full or partial URL of the machine type resource to use for this instance. This is provided by the client when the instance is created. For example, the following is a valid partial url:\n\nzones/zone/machineTypes/machine-type",
                     "type": "string"
                 },
                 "metadata": {
                     "$ref": "Metadata",
-                    "description": "Metadata key/value pairs assigned to this instance. Consists of custom metadata or predefined keys; see Instance documentation for more information."
+                    "description": "The metadata key/value pairs assigned to this instance. This includes custom metadata and predefined keys."
                 },
                 "name": {
-                    "annotations": {
-                        "required": [
-                            "compute.instances.insert"
-                        ]
-                    },
-                    "description": "Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035.",
-                    "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
+                    "description": "Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.",
                     "type": "string"
                 },
                 "networkInterfaces": {
-                    "description": "Array of configurations for this interface. This specifies how this interface is configured to interact with other network services, such as connecting to the internet. Currently, ONE_TO_ONE_NAT is the only access config supported. If there are no accessConfigs specified, then this instance will have no external internet access.",
+                    "description": "An array of configurations for this interface. This specifies how this interface is configured to interact with other network services, such as connecting to the internet.",
                     "items": {
                         "$ref": "NetworkInterface"
                     },
                     "type": "array"
                 },
                 "scheduling": {
                     "$ref": "Scheduling",
                     "description": "Scheduling options for this instance."
                 },
                 "selfLink": {
-                    "description": "Server defined URL for this resource (output only).",
+                    "description": "[Output Only] Server defined URL for this resource.",
                     "type": "string"
                 },
                 "serviceAccounts": {
-                    "description": "A list of service accounts each with specified scopes, for which access tokens are to be made available to the instance through metadata queries.",
+                    "description": "A list of service accounts, with their specified scopes, authorized for this instance. Service accounts generate access tokens that can be accessed through the metadata server and used to authenticate applications on the instance. See Authenticating from Google Compute Engine for more information.",
                     "items": {
                         "$ref": "ServiceAccount"
                     },
                     "type": "array"
                 },
                 "status": {
-                    "description": "Instance status. One of the following values: \"PROVISIONING\", \"STAGING\", \"RUNNING\", \"STOPPING\", \"STOPPED\", \"TERMINATED\" (output only).",
+                    "description": "[Output Only] The status of the instance. One of the following values: PROVISIONING, STAGING, RUNNING, STOPPING, STOPPED, TERMINATED.",
                     "enum": [
                         "PROVISIONING",
                         "RUNNING",
                         "STAGING",
                         "STOPPED",
                         "STOPPING",
                         "TERMINATED"
                     ],
                     "enumDescriptions": [
                         "",
                         "",
                         "",
                         "",
                         "",
                         ""
                     ],
                     "type": "string"
                 },
                 "statusMessage": {
-                    "description": "An optional, human-readable explanation of the status (output only).",
+                    "description": "[Output Only] An optional, human-readable explanation of the status.",
                     "type": "string"
                 },
                 "tags": {
                     "$ref": "Tags",
-                    "description": "A list of tags to be applied to this instance. Used to identify valid sources or targets for network firewalls. Provided by the client on instance creation. The tags can be later modified by the setTags method. Each tag within the list must comply with RFC1035."
+                    "description": "A list of tags to appy to this instance. Tags are used to identify valid sources or targets for network firewalls and are specified by the client during instance creation. The tags can be later modified by the setTags method. Each tag within the list must comply with RFC1035."
                 },
                 "zone": {
-                    "description": "URL of the zone where the instance resides (output only).",
+                    "description": "[Output Only] URL of the zone where the instance resides.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "InstanceAggregatedList": {
             "id": "InstanceAggregatedList",
             "properties": {
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "type": "string"
                 },
                 "items": {
                     "additionalProperties": {
                         "$ref": "InstancesScopedList",
                         "description": "Name of the scope containing this set of instances."
                     },
-                    "description": "A map of scoped instance lists.",
+                    "description": "[Output Only] A map of scoped instance lists.",
                     "type": "object"
                 },
                 "kind": {
                     "default": "compute#instanceAggregatedList",
-                    "description": "Type of resource.",
+                    "description": "[Output Only] Type of resource. Always compute#instanceAggregatedList for aggregated lists of Instance resources.",
                     "type": "string"
                 },
                 "nextPageToken": {
-                    "description": "A token used to continue a truncated list request (output only).",
+                    "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for this resource (output only).",
+                    "description": "[Output Only] Server defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "InstanceList": {
             "description": "Contains a list of instance resources.",
             "id": "InstanceList",
             "properties": {
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "type": "string"
                 },
                 "items": {
-                    "description": "A list of Instance resources.",
+                    "description": "[Output Only] A list of Instance resources.",
                     "items": {
                         "$ref": "Instance"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "compute#instanceList",
-                    "description": "Type of resource.",
+                    "description": "[Output Only] Type of resource. Always compute#instanceList for lists of Instance resources.",
                     "type": "string"
                 },
                 "nextPageToken": {
-                    "description": "A token used to continue a truncated list request (output only).",
+                    "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for this resource (output only).",
+                    "description": "[Output Only] Server defined URL for this resource.",
                     "type": "string"
                 }
             },
+            "type": "object"
+        },
+        "InstanceMoveRequest": {
+            "id": "InstanceMoveRequest",
+            "properties": {
+                "destinationZone": {
+                    "description": "The URL of the destination zone to move the instance to. This can be a full or partial URL. For example, the following are all valid URLs to a zone:  \n- https://www.googleapis.com/compute/v1/projects/project/zones/zone \n- projects/project/zones/zone \n- zones/zone",
+                    "type": "string"
+                },
+                "targetInstance": {
+                    "description": "The URL of the target instance to move. This can be a full or partial URL. For example, the following are all valid URLs to an instance:  \n- https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance \n- projects/project/zones/zone/instances/instance \n- zones/zone/instances/instance",
+                    "type": "string"
+                }
+            },
             "type": "object"
         },
         "InstanceProperties": {
             "description": "",
             "id": "InstanceProperties",
             "properties": {
                 "canIpForward": {
                     "description": "Allows instances created based on this template to send packets with source IP addresses other than their own and receive packets with destination IP addresses other than their own. If these instances will be used as an IP gateway or it will be set as the next-hop in a Route resource, say true. If unsure, leave this set to false.",
                     "type": "boolean"
                 },
@@ skipping 126 matching lines @@
                     "description": "Server defined URL for this resource (output only).",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "InstancesScopedList": {
             "id": "InstancesScopedList",
             "properties": {
                 "instances": {
-                    "description": "List of instances contained in this scope.",
+                    "description": "[Output Only] List of instances contained in this scope.",
                     "items": {
                         "$ref": "Instance"
                     },
                     "type": "array"
                 },
                 "warning": {
-                    "description": "Informational warning which replaces the list of instances when the list is empty.",
+                    "description": "[Output Only] Informational warning which replaces the list of instances when the list is empty.",
                     "properties": {
                         "code": {
-                            "description": "The warning type identifier for this warning.",
+                            "description": "[Output Only] The warning type identifier for this warning.",
                             "enum": [
                                 "DEPRECATED_RESOURCE_USED",
                                 "DISK_SIZE_LARGER_THAN_IMAGE_SIZE",
                                 "INJECTED_KERNELS_DEPRECATED",
                                 "NEXT_HOP_ADDRESS_NOT_ASSIGNED",
                                 "NEXT_HOP_CANNOT_IP_FORWARD",
                                 "NEXT_HOP_INSTANCE_NOT_FOUND",
                                 "NEXT_HOP_INSTANCE_NOT_ON_NETWORK",
                                 "NEXT_HOP_NOT_RUNNING",
                                 "NO_RESULTS_ON_PAGE",
                                 "REQUIRED_TOS_AGREEMENT",
                                 "RESOURCE_NOT_DELETED",
+                                "SINGLE_INSTANCE_PROPERTY_TEMPLATE",
                                 "UNREACHABLE"
                             ],
                             "enumDescriptions": [
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
+                                "",
                                 ""
                             ],
                             "type": "string"
                         },
                         "data": {
-                            "description": "Metadata for this warning in 'key: value' format.",
+                            "description": "[Output Only] Metadata for this warning in key: value format.",
                             "items": {
                                 "properties": {
                                     "key": {
-                                        "description": "A key for the warning data.",
+                                        "description": "[Output Only] A key for the warning data.",
                                         "type": "string"
                                     },
                                     "value": {
-                                        "description": "A warning data value corresponding to the key.",
+                                        "description": "[Output Only] A warning data value corresponding to the key.",
                                         "type": "string"
                                     }
                                 },
                                 "type": "object"
                             },
                             "type": "array"
                         },
                         "message": {
-                            "description": "Optional human-readable details for this warning.",
+                            "description": "[Output Only] Optional human-readable details for this warning.",
                             "type": "string"
                         }
                     },
                     "type": "object"
                 }
             },
             "type": "object"
         },
         "License": {
             "description": "A license resource.",
             "id": "License",
             "properties": {
                 "chargesUseFee": {
                     "description": "If true, the customer will be charged license fee for running software that contains this license on an instance.",
                     "type": "boolean"
                 },
                 "kind": {
                     "default": "compute#license",
-                    "description": "Type of resource.",
+                    "description": "[Output Only] Type of resource. Always compute#license for licenses.",
                     "type": "string"
                 },
                 "name": {
                     "annotations": {
                         "required": [
                             "compute.images.insert"
                         ]
                     },
-                    "description": "Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035.",
+                    "description": "Name of the resource. The name must be 1-63 characters long, and comply with RCF1035.",
                     "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for the resource (output only).",
+                    "description": "[Output Only] Server defined URL for the resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "MachineType": {
-            "description": "A machine type resource.",
+            "description": "A Machine Type resource.",
             "id": "MachineType",
             "properties": {
                 "creationTimestamp": {
                     "description": "[Output Only] Creation timestamp in RFC3339 text format.",
                     "type": "string"
                 },
                 "deprecated": {
                     "$ref": "DeprecationStatus",
-                    "description": "The deprecation status associated with this machine type."
+                    "description": "[Output Only] The deprecation status associated with this machine type."
                 },
                 "description": {
-                    "description": "An optional textual description of the resource.",
+                    "description": "[Output Only] An optional textual description of the resource.",
                     "type": "string"
                 },
                 "guestCpus": {
-                    "description": "Count of CPUs exposed to the instance.",
+                    "description": "[Output Only] The tumber of CPUs exposed to the instance.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "id": {
                     "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "format": "uint64",
                     "type": "string"
                 },
                 "imageSpaceGb": {
-                    "description": "Space allotted for the image, defined in GB.",
+                    "description": "[Deprecated] This property is deprecated and will never be populated with any relevant values.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "kind": {
                     "default": "compute#machineType",
                     "description": "Type of the resource.",
                     "type": "string"
                 },
                 "maximumPersistentDisks": {
-                    "description": "Maximum persistent disks allowed.",
+                    "description": "[Output Only] Maximum persistent disks allowed.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "maximumPersistentDisksSizeGb": {
-                    "description": "Maximum total persistent disks size (GB) allowed.",
+                    "description": "[Output Only] Maximum total persistent disks size (GB) allowed.",
                     "format": "int64",
                     "type": "string"
                 },
                 "memoryMb": {
-                    "description": "Physical memory assigned to the instance, defined in MB.",
+                    "description": "[Output Only] The amount of physical memory available to the instance, defined in MB.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "name": {
-                    "description": "Name of the resource.",
+                    "description": "[Output Only] Name of the resource.",
                     "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                     "type": "string"
                 },
                 "scratchDisks": {
-                    "description": "List of extended scratch disks assigned to the instance.",
+                    "description": "[Output Only] List of extended scratch disks assigned to the instance.",
                     "items": {
                         "properties": {
                             "diskGb": {
                                 "description": "Size of the scratch disk, defined in GB.",
                                 "format": "int32",
                                 "type": "integer"
                             }
                         },
                         "type": "object"
                     },
@@ skipping 13 matching lines @@
         "MachineTypeAggregatedList": {
             "id": "MachineTypeAggregatedList",
             "properties": {
                 "id": {
                     "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "type": "string"
                 },
                 "items": {
                     "additionalProperties": {
                         "$ref": "MachineTypesScopedList",
-                        "description": "Name of the scope containing this set of machine types."
+                        "description": "[Output Only] Name of the scope containing this set of machine types."
                     },
-                    "description": "A map of scoped machine type lists.",
+                    "description": "[Output Only] A map of scoped machine type lists.",
                     "type": "object"
                 },
                 "kind": {
                     "default": "compute#machineTypeAggregatedList",
-                    "description": "Type of resource.",
+                    "description": "[Output Only] Type of resource. Always compute#machineTypeAggregatedList for aggregated lists of machine types.",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for this resource (output only).",
+                    "description": "[Output Only] Server defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "MachineTypeList": {
-            "description": "Contains a list of machine type resources.",
+            "description": "Contains a list of Machine Type resources.",
             "id": "MachineTypeList",
             "properties": {
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "type": "string"
                 },
                 "items": {
-                    "description": "A list of MachineType resources.",
+                    "description": "[Output Only] A list of Machine Type resources.",
                     "items": {
                         "$ref": "MachineType"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "compute#machineTypeList",
-                    "description": "Type of resource.",
+                    "description": "[Output Only] Type of resource. Always compute#machineTypeList for lists of machine types.",
                     "type": "string"
                 },
                 "nextPageToken": {
-                    "description": "A token used to continue a truncated list request (output only).",
+                    "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for this resource (output only).",
+                    "description": "[Output Only] Server defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "MachineTypesScopedList": {
             "id": "MachineTypesScopedList",
             "properties": {
                 "machineTypes": {
-                    "description": "List of machine types contained in this scope.",
+                    "description": "[Output Only] List of machine types contained in this scope.",
                     "items": {
                         "$ref": "MachineType"
                     },
                     "type": "array"
                 },
                 "warning": {
-                    "description": "An informational warning that appears when the machine types list is empty.",
+                    "description": "[Output Only] An informational warning that appears when the machine types list is empty.",
                     "properties": {
                         "code": {
-                            "description": "The warning type identifier for this warning.",
+                            "description": "[Output Only] The warning type identifier for this warning.",
                             "enum": [
                                 "DEPRECATED_RESOURCE_USED",
                                 "DISK_SIZE_LARGER_THAN_IMAGE_SIZE",
                                 "INJECTED_KERNELS_DEPRECATED",
                                 "NEXT_HOP_ADDRESS_NOT_ASSIGNED",
                                 "NEXT_HOP_CANNOT_IP_FORWARD",
                                 "NEXT_HOP_INSTANCE_NOT_FOUND",
                                 "NEXT_HOP_INSTANCE_NOT_ON_NETWORK",
                                 "NEXT_HOP_NOT_RUNNING",
                                 "NO_RESULTS_ON_PAGE",
                                 "REQUIRED_TOS_AGREEMENT",
                                 "RESOURCE_NOT_DELETED",
+                                "SINGLE_INSTANCE_PROPERTY_TEMPLATE",
                                 "UNREACHABLE"
                             ],
                             "enumDescriptions": [
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
+                                "",
                                 ""
                             ],
                             "type": "string"
                         },
                         "data": {
-                            "description": "Metadata for this warning in 'key: value' format.",
+                            "description": "[Output Only] Metadata for this warning in key: value format.",
                             "items": {
                                 "properties": {
                                     "key": {
-                                        "description": "A key for the warning data.",
+                                        "description": "[Output Only] A key for the warning data.",
                                         "type": "string"
                                     },
                                     "value": {
-                                        "description": "A warning data value corresponding to the key.",
+                                        "description": "[Output Only] A warning data value corresponding to the key.",
                                         "type": "string"
                                     }
                                 },
                                 "type": "object"
                             },
                             "type": "array"
                         },
                         "message": {
-                            "description": "Optional human-readable details for this warning.",
+                            "description": "[Output Only] Optional human-readable details for this warning.",
                             "type": "string"
                         }
                     },
                     "type": "object"
                 }
             },
             "type": "object"
         },
         "Metadata": {
             "description": "A metadata key/value entry.",
             "id": "Metadata",
             "properties": {
                 "fingerprint": {
-                    "description": "Fingerprint of this resource. A hash of the metadata's contents. This field is used for optimistic locking. An up-to-date metadata fingerprint must be provided in order to modify metadata.",
+                    "description": "Specifies a fingerprint for this request, which is essentially a hash of the metadata's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update metadata. You must always provide an up-to-date fingerprint hash in order to update or change metadata.",
                     "format": "byte",
                     "type": "string"
                 },
                 "items": {
                     "description": "Array of key/value pairs. The total size of all keys and values must be less than 512 KB.",
                     "items": {
                         "properties": {
                             "key": {
                                 "annotations": {
                                     "required": [
@@ skipping 15 matching lines @@
                                 "description": "Value for the metadata entry. These are free-form strings, and only have meaning as interpreted by the image running in the instance. The only restriction placed on values is that their size must be less than or equal to 32768 bytes.",
                                 "type": "string"
                             }
                         },
                         "type": "object"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "compute#metadata",
-                    "description": "Type of the resource.",
+                    "description": "[Output Only] Type of the resource. Always compute#metadata for metadata.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Network": {
             "description": "A network resource.",
             "id": "Network",
             "properties": {
                 "IPv4Range": {
                     "annotations": {
                         "required": [
                             "compute.networks.insert"
                         ]
                     },
-                    "description": "Required; The range of internal addresses that are legal on this network. This range is a CIDR specification, for example: 192.168.0.0/16. Provided by the client when the network is created.",
+                    "description": "The range of internal addresses that are legal on this network. This range is a CIDR specification, for example: 192.168.0.0/16. Provided by the client when the network is created.",
                     "pattern": "[0-9]{1,3}(?:\\.[0-9]{1,3}){3}/[0-9]{1,2}",
                     "type": "string"
                 },
                 "creationTimestamp": {
-                    "description": "Creation timestamp in RFC3339 text format (output only).",
+                    "description": "[Output Only] Creation timestamp in RFC3339 text format.",
                     "type": "string"
                 },
                 "description": {
                     "description": "An optional textual description of the resource; provided by the client when the resource is created.",
                     "type": "string"
                 },
                 "gatewayIPv4": {
-                    "description": "An optional address that is used for default routing to other networks. This must be within the range specified by IPv4Range, and is typically the first usable address in that range. If not specified, the default value is the first usable address in IPv4Range.",
+                    "description": "A gateway address for default routing to other networks. This value is read only and is selected by the Google Compute Engine, typically as the first usable address in the IPv4Range.",
                     "pattern": "[0-9]{1,3}(?:\\.[0-9]{1,3}){3}",
                     "type": "string"
                 },
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "format": "uint64",
                     "type": "string"
                 },
                 "kind": {
                     "default": "compute#network",
-                    "description": "Type of the resource.",
+                    "description": "[Output Only] Type of the resource. Always compute#network for networks.",
                     "type": "string"
                 },
                 "name": {
                     "annotations": {
                         "required": [
                             "compute.networks.insert"
                         ]
                     },
-                    "description": "Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035.",
+                    "description": "Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.",
                     "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for the resource (output only).",
+                    "description": "[Output Only] Server defined URL for the resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "NetworkInterface": {
             "description": "A network interface resource attached to an instance.",
             "id": "NetworkInterface",
             "properties": {
                 "accessConfigs": {
-                    "description": "Array of configurations for this interface. This specifies how this interface is configured to interact with other network services, such as connecting to the internet. Currently, ONE_TO_ONE_NAT is the only access config supported. If there are no accessConfigs specified, then this instance will have no external internet access.",
+                    "description": "An array of configurations for this interface. Currently, <codeONE_TO_ONE_NAT is the only access config supported. If there are no accessConfigs specified, then this instance will have no external internet access.",
                     "items": {
                         "$ref": "AccessConfig"
                     },
                     "type": "array"
                 },
                 "name": {
-                    "description": "Name of the network interface, determined by the server; for network devices, these are e.g. eth0, eth1, etc. (output only).",
+                    "description": "[Output Only] The name of the network interface, generated by the server. For network devices, these are eth0, eth1, etc.",
                     "type": "string"
                 },
                 "network": {
                     "annotations": {
                         "required": [
                             "compute.instances.insert"
                         ]
                     },
-                    "description": "URL of the network resource attached to this interface.",
+                    "description": "URL of the network resource for this instance. This is required for creating an instance but optional when creating a firewall rule. If not specified when creating a firewall rule, the default network is used:\n\nglobal/networks/default \n\nIf you specify this property, you can specify the network as a full or partial URL. For example, the following are all valid URLs:  \n- https://www.googleapis.com/compute/v1/projects/project/global/networks/network \n- projects/project/global/networks/network \n- global/networks/default",
                     "type": "string"
                 },
                 "networkIP": {
-                    "description": "An optional IPV4 internal network address assigned to the instance for this network interface (output only).",
+                    "description": "[Output Only] An optional IPV4 internal network address assigned to the instance for this network interface.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "NetworkList": {
-            "description": "Contains a list of network resources.",
+            "description": "Contains a list of Network resources.",
             "id": "NetworkList",
             "properties": {
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "type": "string"
                 },
                 "items": {
-                    "description": "A list of Network resources.",
+                    "description": "[Output Only] A list of Network resources.",
                     "items": {
                         "$ref": "Network"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "compute#networkList",
-                    "description": "Type of resource.",
+                    "description": "[Output Only] Type of resource. Always compute#networkList for lists of networks.",
                     "type": "string"
                 },
                 "nextPageToken": {
-                    "description": "A token used to continue a truncated list request (output only).",
+                    "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for this resource (output only).",
+                    "description": "[Output Only] Server defined URL for this resource .",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Operation": {
             "description": "An operation resource, used to manage asynchronous API requests.",
             "id": "Operation",
             "properties": {
                 "clientOperationId": {
+                    "description": "[Output Only] An optional identifier specified by the client when the mutation was initiated. Must be unique for all operation resources in the project",
                     "type": "string"
                 },
                 "creationTimestamp": {
-                    "description": "[Output Only] Creation timestamp in RFC3339 text format (output only).",
+                    "description": "[Output Only] Creation timestamp in RFC3339 text format.",
                     "type": "string"
                 },
                 "endTime": {
+                    "description": "[Output Only] The time that this operation was completed. This is in RFC3339 text format.",
                     "type": "string"
                 },
                 "error": {
-                    "description": "[Output Only] If errors occurred during processing of this operation, this field will be populated.",
+                    "description": "[Output Only] If errors are generated during processing of the operation, this field will be populated.",
                     "properties": {
                         "errors": {
                             "description": "[Output Only] The array of errors encountered while processing this operation.",
                             "items": {
                                 "properties": {
                                     "code": {
                                         "description": "[Output Only] The error type identifier for this error.",
                                         "type": "string"
                                     },
                                     "location": {
                                         "description": "[Output Only] Indicates the field in the request which caused the error. This property is optional.",
                                         "type": "string"
                                     },
                                     "message": {
                                         "description": "[Output Only] An optional, human-readable error message.",
                                         "type": "string"
                                     }
                                 },
                                 "type": "object"
                             },
                             "type": "array"
                         }
                     },
                     "type": "object"
                 },
                 "httpErrorMessage": {
+                    "description": "[Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as NOT FOUND.",
                     "type": "string"
                 },
                 "httpErrorStatusCode": {
+                    "description": "[Output Only] If the operation fails, this field contains the HTTP error message that was returned, such as 404.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "id": {
                     "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "format": "uint64",
                     "type": "string"
                 },
                 "insertTime": {
-                    "description": "[Output Only] The time that this operation was requested. This is in RFC 3339 format.",
+                    "description": "[Output Only] The time that this operation was requested. This is in RFC3339 text format.",
                     "type": "string"
                 },
                 "kind": {
                     "default": "compute#operation",
-                    "description": "[Output Only] Type of the resource. Always kind#operation for Operation resources.",
+                    "description": "[Output Only] Type of the resource. Always compute#Operation for Operation resources.",
                     "type": "string"
                 },
                 "name": {
-                    "description": "[Output Only] Name of the resource (output only).",
+                    "description": "[Output Only] Name of the resource.",
                     "type": "string"
                 },
                 "operationType": {
+                    "description": "[Output Only] Type of the operation, such as insert, update, and delete.",
                     "type": "string"
                 },
                 "progress": {
+                    "description": "[Output Only] An optional progress indicator that ranges from 0 to 100. There is no requirement that this be linear or support any granularity of operations. This should not be used to guess at when the operation will be complete. This number should be monotonically increasing as the operation progresses.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "region": {
-                    "description": "[Output Only] URL of the region where the operation resides (output only).",
+                    "description": "[Output Only] URL of the region where the operation resides. Only applicable for regional resources.",
                     "type": "string"
                 },
                 "selfLink": {
                     "description": "[Output Only] Server defined URL for the resource.",
                     "type": "string"
                 },
                 "startTime": {
-                    "description": "[Output Only] The time that this operation was started by the server. This is in RFC 3339 format.",
+                    "description": "[Output Only] The time that this operation was started by the server. This is in RFC3339 text format.",
                     "type": "string"
                 },
                 "status": {
-                    "description": "[Output Only] Status of the operation. Can be one of the following: \"PENDING\", \"RUNNING\", or \"DONE\".",
+                    "description": "[Output Only] Status of the operation. Can be one of the following: PENDING, RUNNING, or DONE.",
                     "enum": [
                         "DONE",
                         "PENDING",
                         "RUNNING"
                     ],
                     "enumDescriptions": [
                         "",
                         "",
                         ""
                     ],
                     "type": "string"
                 },
                 "statusMessage": {
                     "description": "[Output Only] An optional textual description of the current status of the operation.",
                     "type": "string"
                 },
                 "targetId": {
-                    "description": "[Output Only] Unique target id which identifies a particular incarnation of the target.",
+                    "description": "[Output Only] Unique target ID which identifies a particular incarnation of the target.",
                     "format": "uint64",
                     "type": "string"
                 },
                 "targetLink": {
-                    "description": "[Output Only] URL of the resource the operation is mutating (output only).",
+                    "description": "[Output Only] URL of the resource the operation is mutating.",
                     "type": "string"
                 },
                 "user": {
+                    "description": "[Output Only] User who requested the operation, for example: user@example.com.",
                     "type": "string"
                 },
                 "warnings": {
+                    "description": "[Output Only] If warning messages are generated during processing of the operation, this field will be populated.",
                     "items": {
                         "properties": {
                             "code": {
-                                "description": "The warning type identifier for this warning.",
+                                "description": "[Output Only] The warning type identifier for this warning.",
                                 "enum": [
                                     "DEPRECATED_RESOURCE_USED",
                                     "DISK_SIZE_LARGER_THAN_IMAGE_SIZE",
                                     "INJECTED_KERNELS_DEPRECATED",
                                     "NEXT_HOP_ADDRESS_NOT_ASSIGNED",
                                     "NEXT_HOP_CANNOT_IP_FORWARD",
                                     "NEXT_HOP_INSTANCE_NOT_FOUND",
                                     "NEXT_HOP_INSTANCE_NOT_ON_NETWORK",
                                     "NEXT_HOP_NOT_RUNNING",
                                     "NO_RESULTS_ON_PAGE",
                                     "REQUIRED_TOS_AGREEMENT",
                                     "RESOURCE_NOT_DELETED",
+                                    "SINGLE_INSTANCE_PROPERTY_TEMPLATE",
                                     "UNREACHABLE"
                                 ],
                                 "enumDescriptions": [
                                     "",
                                     "",
                                     "",
                                     "",
                                     "",
                                     "",
                                     "",
                                     "",
                                     "",
                                     "",
                                     "",
+                                    "",
                                     ""
                                 ],
                                 "type": "string"
                             },
                             "data": {
-                                "description": "Metadata for this warning in 'key: value' format.",
+                                "description": "[Output Only] Metadata for this warning in key: value format.",
                                 "items": {
                                     "properties": {
                                         "key": {
-                                            "description": "A key for the warning data.",
+                                            "description": "[Output Only] A key for the warning data.",
                                             "type": "string"
                                         },
                                         "value": {
-                                            "description": "A warning data value corresponding to the key.",
+                                            "description": "[Output Only] A warning data value corresponding to the key.",
                                             "type": "string"
                                         }
                                     },
                                     "type": "object"
                                 },
                                 "type": "array"
                             },
                             "message": {
-                                "description": "Optional human-readable details for this warning.",
+                                "description": "[Output Only] Optional human-readable details for this warning.",
                                 "type": "string"
                             }
                         },
                         "type": "object"
                     },
                     "type": "array"
                 },
                 "zone": {
-                    "description": "[Output Only] URL of the zone where the operation resides (output only).",
+                    "description": "[Output Only] URL of the zone where the operation resides.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "OperationAggregatedList": {
             "id": "OperationAggregatedList",
             "properties": {
                 "id": {
                     "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "type": "string"
                 },
                 "items": {
                     "additionalProperties": {
                         "$ref": "OperationsScopedList",
                         "description": "[Output Only] Name of the scope containing this set of operations."
                     },
                     "description": "[Output Only] A map of scoped operation lists.",
                     "type": "object"
                 },
                 "kind": {
                     "default": "compute#operationAggregatedList",
-                    "description": "Type of resource.",
+                    "description": "[Output Only] Type of resource. Always compute#operationAggregatedList for aggregated lists of operations.",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
                     "description": "[Output Only] Server defined URL for this resource.",
                     "type": "string"
                 }
@@ skipping 10 matching lines @@
                 },
                 "items": {
                     "description": "[Output Only] The operation resources.",
                     "items": {
                         "$ref": "Operation"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "compute#operationList",
-                    "description": "Type of resource. Always compute#operations for Operations resource.",
+                    "description": "[Output Only] Type of resource. Always compute#operations for Operations resource.",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "[Output Only] A token used to continue a truncate.",
                     "type": "string"
                 },
                 "selfLink": {
                     "description": "[Output Only] Server defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "OperationsScopedList": {
             "id": "OperationsScopedList",
             "properties": {
                 "operations": {
                     "description": "[Output Only] List of operations contained in this scope.",
                     "items": {
                         "$ref": "Operation"
                     },
                     "type": "array"
                 },
                 "warning": {
                     "description": "[Output Only] Informational warning which replaces the list of operations when the list is empty.",
                     "properties": {
                         "code": {
-                            "description": "The warning type identifier for this warning.",
+                            "description": "[Output Only] The warning type identifier for this warning.",
                             "enum": [
                                 "DEPRECATED_RESOURCE_USED",
                                 "DISK_SIZE_LARGER_THAN_IMAGE_SIZE",
                                 "INJECTED_KERNELS_DEPRECATED",
                                 "NEXT_HOP_ADDRESS_NOT_ASSIGNED",
                                 "NEXT_HOP_CANNOT_IP_FORWARD",
                                 "NEXT_HOP_INSTANCE_NOT_FOUND",
                                 "NEXT_HOP_INSTANCE_NOT_ON_NETWORK",
                                 "NEXT_HOP_NOT_RUNNING",
                                 "NO_RESULTS_ON_PAGE",
                                 "REQUIRED_TOS_AGREEMENT",
                                 "RESOURCE_NOT_DELETED",
+                                "SINGLE_INSTANCE_PROPERTY_TEMPLATE",
                                 "UNREACHABLE"
                             ],
                             "enumDescriptions": [
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
+                                "",
                                 ""
                             ],
                             "type": "string"
                         },
                         "data": {
-                            "description": "Metadata for this warning in 'key: value' format.",
+                            "description": "[Output Only] Metadata for this warning in key: value format.",
                             "items": {
                                 "properties": {
                                     "key": {
-                                        "description": "A key for the warning data.",
+                                        "description": "[Output Only] A key for the warning data.",
                                         "type": "string"
                                     },
                                     "value": {
-                                        "description": "A warning data value corresponding to the key.",
+                                        "description": "[Output Only] A warning data value corresponding to the key.",
                                         "type": "string"
                                     }
                                 },
                                 "type": "object"
                             },
                             "type": "array"
                         },
                         "message": {
-                            "description": "Optional human-readable details for this warning.",
+                            "description": "[Output Only] Optional human-readable details for this warning.",
                             "type": "string"
                         }
                     },
                     "type": "object"
                 }
             },
             "type": "object"
         },
         "PathMatcher": {
             "description": "A matcher for the path portion of the URL. The BackendService from the longest-matched rule will serve the URL. If no rule was matched, the default_service will be used.",
@@ skipping 32 matching lines @@
                     "type": "array"
                 },
                 "service": {
                     "description": "The URL of the BackendService resource if this rule is matched.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Project": {
-            "description": "A project resource. Projects can be created only in the APIs Console. Unless marked otherwise, values can only be modified in the console.",
+            "description": "A Project resource. Projects can only be created in the Google Developers Console. Unless marked otherwise, values can only be modified in the console.",
             "id": "Project",
             "properties": {
                 "commonInstanceMetadata": {
                     "$ref": "Metadata",
-                    "description": "Metadata key/value pairs available to all instances contained in this project."
+                    "description": "Metadata key/value pairs available to all instances contained in this project. See Custom metadata for more information."
                 },
                 "creationTimestamp": {
-                    "description": "Creation timestamp in RFC3339 text format (output only).",
+                    "description": "[Output Only] Creation timestamp in RFC3339 text format.",
                     "type": "string"
                 },
                 "description": {
                     "description": "An optional textual description of the resource.",
                     "type": "string"
                 },
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "format": "uint64",
                     "type": "string"
                 },
                 "kind": {
                     "default": "compute#project",
-                    "description": "Type of the resource.",
+                    "description": "[Output Only] Type of the resource. Always compute#project for projects.",
                     "type": "string"
                 },
                 "name": {
                     "description": "Name of the resource.",
                     "type": "string"
                 },
                 "quotas": {
-                    "description": "Quotas assigned to this project.",
+                    "description": "[Output Only] Quotas assigned to this project.",
                     "items": {
                         "$ref": "Quota"
                     },
                     "type": "array"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for the resource (output only).",
+                    "description": "[Output Only] Server defined URL for the resource.",
                     "type": "string"
                 },
                 "usageExportLocation": {
                     "$ref": "UsageExportLocation",
                     "description": "The location in Cloud Storage and naming method of the daily usage report."
                 }
             },
             "type": "object"
         },
         "Quota": {
             "description": "A quotas entry.",
             "id": "Quota",
             "properties": {
                 "limit": {
-                    "description": "Quota limit for this metric.",
+                    "description": "[Output Only] Quota limit for this metric.",
                     "format": "double",
                     "type": "number"
                 },
                 "metric": {
-                    "description": "Name of the quota metric.",
+                    "description": "[Output Only] Name of the quota metric.",
                     "enum": [
                         "BACKEND_SERVICES",
                         "CPUS",
-                        "DISKS",
                         "DISKS_TOTAL_GB",
-                        "EPHEMERAL_ADDRESSES",
                         "FIREWALLS",
                         "FORWARDING_RULES",
                         "HEALTH_CHECKS",
                         "IMAGES",
-                        "IMAGES_TOTAL_GB",
                         "INSTANCES",
                         "IN_USE_ADDRESSES",
-                        "KERNELS",
-                        "KERNELS_TOTAL_GB",
                         "LOCAL_SSD_TOTAL_GB",
                         "NETWORKS",
-                        "OPERATIONS",
                         "ROUTES",
                         "SNAPSHOTS",
                         "SSD_TOTAL_GB",
                         "STATIC_ADDRESSES",
                         "TARGET_HTTP_PROXIES",
                         "TARGET_INSTANCES",
                         "TARGET_POOLS",
                         "URL_MAPS"
                     ],
                     "enumDescriptions": [
                         "",
                         "",
                         "",
                         "",
                         "",
                         "",
                         "",
                         "",
                         "",
                         "",
                         "",
                         "",
                         "",
                         "",
                         "",
                         "",
                         "",
                         "",
-                        "",
-                        "",
-                        "",
-                        "",
-                        "",
-                        "",
                         ""
                     ],
                     "type": "string"
                 },
                 "usage": {
-                    "description": "Current usage of this metric.",
+                    "description": "[Output Only] Current usage of this metric.",
                     "format": "double",
                     "type": "number"
                 }
             },
             "type": "object"
         },
         "Region": {
             "description": "Region resource.",
             "id": "Region",
             "properties": {
                 "creationTimestamp": {
-                    "description": "Creation timestamp in RFC3339 text format (output only).",
+                    "description": "[Output Only] Creation timestamp in RFC3339 text format.",
                     "type": "string"
                 },
                 "deprecated": {
                     "$ref": "DeprecationStatus",
-                    "description": "The deprecation status associated with this region."
+                    "description": "[Output Only] The deprecation status associated with this region."
                 },
                 "description": {
-                    "description": "Textual description of the resource.",
+                    "description": "[Output Only] Textual description of the resource.",
                     "type": "string"
                 },
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource; defined by the server .",
                     "format": "uint64",
                     "type": "string"
                 },
                 "kind": {
                     "default": "compute#region",
-                    "description": "Type of the resource.",
+                    "description": "[Output Only] Type of the resource. Always compute#region for regions.",
                     "type": "string"
                 },
                 "name": {
-                    "description": "Name of the resource.",
+                    "description": "[Output Only] Name of the resource.",
                     "type": "string"
                 },
                 "quotas": {
-                    "description": "Quotas assigned to this region.",
+                    "description": "[Output Only] Quotas assigned to this region.",
                     "items": {
                         "$ref": "Quota"
                     },
                     "type": "array"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for the resource (output only).",
+                    "description": "[Output Only] Server defined URL for the resource.",
                     "type": "string"
                 },
                 "status": {
-                    "description": "Status of the region, \"UP\" or \"DOWN\".",
+                    "description": "[Output Only] Status of the region, either UP or DOWN.",
                     "enum": [
                         "DOWN",
                         "UP"
                     ],
                     "enumDescriptions": [
                         "",
                         ""
                     ],
                     "type": "string"
                 },
                 "zones": {
-                    "description": "A list of zones homed in this region, in the form of resource URLs.",
+                    "description": "[Output Only] A list of zones available in this region, in the form of resource URLs.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
         "RegionList": {
             "description": "Contains a list of region resources.",
             "id": "RegionList",
             "properties": {
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "type": "string"
                 },
                 "items": {
-                    "description": "A list of Region resources.",
+                    "description": "[Output Only] A list of Region resources.",
                     "items": {
                         "$ref": "Region"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "compute#regionList",
-                    "description": "Type of resource.",
+                    "description": "[Output Only] Type of resource. Always compute#regionList for lists of regions.",
                     "type": "string"
                 },
                 "nextPageToken": {
-                    "description": "A token used to continue a truncated list request (output only).",
+                    "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for this resource (output only).",
+                    "description": "[Output Only] Server defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "ResourceGroupReference": {
             "id": "ResourceGroupReference",
             "properties": {
                 "group": {
                     "description": "A URI referencing one of the resource views listed in the backend service.",
@@ skipping 61 matching lines @@
                     "type": "string"
                 },
                 "nextHopIp": {
                     "description": "The network IP address of an instance that should handle matching packets.",
                     "type": "string"
                 },
                 "nextHopNetwork": {
                     "description": "The URL of the local network if it should handle matching packets.",
                     "type": "string"
                 },
+                "nextHopVpnTunnel": {
+                    "description": "The URL to a VpnTunnel that should handle matching packets.",
+                    "type": "string"
+                },
                 "priority": {
                     "annotations": {
                         "required": [
                             "compute.routes.insert"
                         ]
                     },
                     "description": "Breaks ties between Routes of equal specificity. Routes with smaller values win when tied with routes with larger values.",
                     "format": "uint32",
                     "type": "integer"
                 },
@@ skipping 11 matching lines @@
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "warnings": {
                     "description": "If potential misconfigurations are detected for this route, this field will be populated with warning messages.",
                     "items": {
                         "properties": {
                             "code": {
-                                "description": "The warning type identifier for this warning.",
+                                "description": "[Output Only] The warning type identifier for this warning.",
                                 "enum": [
                                     "DEPRECATED_RESOURCE_USED",
                                     "DISK_SIZE_LARGER_THAN_IMAGE_SIZE",
                                     "INJECTED_KERNELS_DEPRECATED",
                                     "NEXT_HOP_ADDRESS_NOT_ASSIGNED",
                                     "NEXT_HOP_CANNOT_IP_FORWARD",
                                     "NEXT_HOP_INSTANCE_NOT_FOUND",
                                     "NEXT_HOP_INSTANCE_NOT_ON_NETWORK",
                                     "NEXT_HOP_NOT_RUNNING",
                                     "NO_RESULTS_ON_PAGE",
                                     "REQUIRED_TOS_AGREEMENT",
                                     "RESOURCE_NOT_DELETED",
+                                    "SINGLE_INSTANCE_PROPERTY_TEMPLATE",
                                     "UNREACHABLE"
                                 ],
                                 "enumDescriptions": [
                                     "",
                                     "",
                                     "",
                                     "",
                                     "",
                                     "",
                                     "",
                                     "",
                                     "",
                                     "",
                                     "",
+                                    "",
                                     ""
                                 ],
                                 "type": "string"
                             },
                             "data": {
-                                "description": "Metadata for this warning in 'key: value' format.",
+                                "description": "[Output Only] Metadata for this warning in key: value format.",
                                 "items": {
                                     "properties": {
                                         "key": {
-                                            "description": "A key for the warning data.",
+                                            "description": "[Output Only] A key for the warning data.",
                                             "type": "string"
                                         },
                                         "value": {
-                                            "description": "A warning data value corresponding to the key.",
+                                            "description": "[Output Only] A warning data value corresponding to the key.",
                                             "type": "string"
                                         }
                                     },
                                     "type": "object"
                                 },
                                 "type": "array"
                             },
                             "message": {
-                                "description": "Optional human-readable details for this warning.",
+                                "description": "[Output Only] Optional human-readable details for this warning.",
                                 "type": "string"
                             }
                         },
                         "type": "object"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
@@ skipping 22 matching lines @@
                     "type": "string"
                 },
                 "selfLink": {
                     "description": "Server defined URL for this resource (output only).",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Scheduling": {
-            "description": "Scheduling options for an Instance.",
+            "description": "Sets the scheduling options for an Instance.",
             "id": "Scheduling",
             "properties": {
                 "automaticRestart": {
-                    "description": "Whether the Instance should be automatically restarted whenever it is terminated by Compute Engine (not terminated by user).",
+                    "description": "Specifies whether the instance should be automatically restarted if it is terminated by Compute Engine (not terminated by a user).",
                     "type": "boolean"
                 },
                 "onHostMaintenance": {
-                    "description": "How the instance should behave when the host machine undergoes maintenance that may temporarily impact instance performance.",
+                    "description": "Defines the maintenance behavior for this instance. The default behavior is MIGRATE. For more information, see Setting maintenance behavior.",
                     "enum": [
                         "MIGRATE",
                         "TERMINATE"
                     ],
                     "enumDescriptions": [
                         "",
                         ""
                     ],
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "SerialPortOutput": {
-            "description": "An instance serial console output.",
+            "description": "An instance's serial console output.",
             "id": "SerialPortOutput",
             "properties": {
                 "contents": {
-                    "description": "The contents of the console output.",
+                    "description": "[Output Only] The contents of the console output.",
                     "type": "string"
                 },
                 "kind": {
                     "default": "compute#serialPortOutput",
-                    "description": "Type of the resource.",
+                    "description": "[Output Only] Type of the resource. Always compute#serialPortOutput for serial port output.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for the resource (output only).",
+                    "description": "[Output Only] Server defined URL for the resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "ServiceAccount": {
             "description": "A service account.",
             "id": "ServiceAccount",
             "properties": {
                 "email": {
@@ skipping 128 matching lines @@
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Tags": {
             "description": "A set of instance tags.",
             "id": "Tags",
             "properties": {
                 "fingerprint": {
-                    "description": "Fingerprint of this resource. A hash of the tags stored in this object. This field is used optimistic locking. An up-to-date tags fingerprint must be provided in order to modify tags.",
+                    "description": "Specifies a fingerprint for this request, which is essentially a hash of the metadata's contents and used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update metadata. You must always provide an up-to-date fingerprint hash in order to update or change metadata.\n\nTo see the latest fingerprint, make get() request to the instance.",
                     "format": "byte",
                     "type": "string"
                 },
                 "items": {
                     "description": "An array of tags. Each tag must be 1-63 characters long, and comply with RFC1035.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 }
@@ skipping 190 matching lines @@
                     "description": "List of target instances contained in this scope.",
                     "items": {
                         "$ref": "TargetInstance"
                     },
                     "type": "array"
                 },
                 "warning": {
                     "description": "Informational warning which replaces the list of addresses when the list is empty.",
                     "properties": {
                         "code": {
-                            "description": "The warning type identifier for this warning.",
+                            "description": "[Output Only] The warning type identifier for this warning.",
                             "enum": [
                                 "DEPRECATED_RESOURCE_USED",
                                 "DISK_SIZE_LARGER_THAN_IMAGE_SIZE",
                                 "INJECTED_KERNELS_DEPRECATED",
                                 "NEXT_HOP_ADDRESS_NOT_ASSIGNED",
                                 "NEXT_HOP_CANNOT_IP_FORWARD",
                                 "NEXT_HOP_INSTANCE_NOT_FOUND",
                                 "NEXT_HOP_INSTANCE_NOT_ON_NETWORK",
                                 "NEXT_HOP_NOT_RUNNING",
                                 "NO_RESULTS_ON_PAGE",
                                 "REQUIRED_TOS_AGREEMENT",
                                 "RESOURCE_NOT_DELETED",
+                                "SINGLE_INSTANCE_PROPERTY_TEMPLATE",
                                 "UNREACHABLE"
                             ],
                             "enumDescriptions": [
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
+                                "",
                                 ""
                             ],
                             "type": "string"
                         },
                         "data": {
-                            "description": "Metadata for this warning in 'key: value' format.",
+                            "description": "[Output Only] Metadata for this warning in key: value format.",
                             "items": {
                                 "properties": {
                                     "key": {
-                                        "description": "A key for the warning data.",
+                                        "description": "[Output Only] A key for the warning data.",
                                         "type": "string"
                                     },
                                     "value": {
-                                        "description": "A warning data value corresponding to the key.",
+                                        "description": "[Output Only] A warning data value corresponding to the key.",
                                         "type": "string"
                                     }
                                 },
                                 "type": "object"
                             },
                             "type": "array"
                         },
                         "message": {
-                            "description": "Optional human-readable details for this warning.",
+                            "description": "[Output Only] Optional human-readable details for this warning.",
                             "type": "string"
                         }
                     },
                     "type": "object"
                 }
             },
             "type": "object"
         },
         "TargetPool": {
             "description": "A TargetPool resource. This resource defines a pool of VMs, associated HttpHealthCheck resources, and the fallback TargetPool.",
@@ skipping 208 matching lines @@
                     "description": "List of target pools contained in this scope.",
                     "items": {
                         "$ref": "TargetPool"
                     },
                     "type": "array"
                 },
                 "warning": {
                     "description": "Informational warning which replaces the list of addresses when the list is empty.",
                     "properties": {
                         "code": {
-                            "description": "The warning type identifier for this warning.",
+                            "description": "[Output Only] The warning type identifier for this warning.",
                             "enum": [
                                 "DEPRECATED_RESOURCE_USED",
                                 "DISK_SIZE_LARGER_THAN_IMAGE_SIZE",
+                                "INJECTED_KERNELS_DEPRECATED",
+                                "NEXT_HOP_ADDRESS_NOT_ASSIGNED",
+                                "NEXT_HOP_CANNOT_IP_FORWARD",
+                                "NEXT_HOP_INSTANCE_NOT_FOUND",
+                                "NEXT_HOP_INSTANCE_NOT_ON_NETWORK",
+                                "NEXT_HOP_NOT_RUNNING",
+                                "NO_RESULTS_ON_PAGE",
+                                "REQUIRED_TOS_AGREEMENT",
+                                "RESOURCE_NOT_DELETED",
+                                "SINGLE_INSTANCE_PROPERTY_TEMPLATE",
+                                "UNREACHABLE"
+                            ],
+                            "enumDescriptions": [
+                                "",
+                                "",
+                                "",
+                                "",
+                                "",
+                                "",
+                                "",
+                                "",
+                                "",
+                                "",
+                                "",
+                                "",
+                                ""
+                            ],
+                            "type": "string"
+                        },
+                        "data": {
+                            "description": "[Output Only] Metadata for this warning in key: value format.",
+                            "items": {
+                                "properties": {
+                                    "key": {
+                                        "description": "[Output Only] A key for the warning data.",
+                                        "type": "string"
+                                    },
+                                    "value": {
+                                        "description": "[Output Only] A warning data value corresponding to the key.",
+                                        "type": "string"
+                                    }
+                                },
+                                "type": "object"
+                            },
+                            "type": "array"
+                        },
+                        "message": {
+                            "description": "[Output Only] Optional human-readable details for this warning.",
+                            "type": "string"
+                        }
+                    },
+                    "type": "object"
+                }
+            },
+            "type": "object"
+        },
+        "TargetReference": {
+            "id": "TargetReference",
+            "properties": {
+                "target": {
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
+        "TargetVpnGateway": {
+            "id": "TargetVpnGateway",
+            "properties": {
+                "creationTimestamp": {
+                    "description": "[Output Only] Creation timestamp in RFC3339 text format.",
+                    "type": "string"
+                },
+                "description": {
+                    "description": "An optional textual description of the resource. Provided by the client when the resource is created.",
+                    "type": "string"
+                },
+                "forwardingRules": {
+                    "description": "[Output Only] A list of URLs to the ForwardingRule resources. ForwardingRules are created using compute.forwardingRules.insert and associated to a VPN gateway.",
+                    "items": {
+                        "type": "string"
+                    },
+                    "type": "array"
+                },
+                "id": {
+                    "description": "[Output Only] Unique identifier for the resource. Defined by the server.",
+                    "format": "uint64",
+                    "type": "string"
+                },
+                "kind": {
+                    "default": "compute#targetVpnGateway",
+                    "description": "[Output Only] Type of resource. Always compute#targetVpnGateway for target VPN gateways.",
+                    "type": "string"
+                },
+                "name": {
+                    "annotations": {
+                        "required": [
+                            "compute.targetVpnGateways.insert"
+                        ]
+                    },
+                    "description": "Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long and comply with RFC1035.",
+                    "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
+                    "type": "string"
+                },
+                "network": {
+                    "annotations": {
+                        "required": [
+                            "compute.targetVpnGateways.insert"
+                        ]
+                    },
+                    "description": "URL of the network to which this VPN gateway is attached. Provided by the client when the VPN gateway is created.",
+                    "type": "string"
+                },
+                "region": {
+                    "description": "[Output Only] URL of the region where the target VPN gateway resides.",
+                    "type": "string"
+                },
+                "selfLink": {
+                    "description": "[Output Only] Server-defined URL for the resource.",
+                    "type": "string"
+                },
+                "status": {
+                    "description": "[Output Only] The status of the VPN gateway.",
+                    "enum": [
+                        "CREATING",
+                        "DELETING",
+                        "FAILED",
+                        "READY"
+                    ],
+                    "enumDescriptions": [
+                        "",
+                        "",
+                        "",
+                        ""
+                    ],
+                    "type": "string"
+                },
+                "tunnels": {
+                    "description": "[Output Only] A list of URLs to VpnTunnel resources. VpnTunnels are created using compute.vpntunnels.insert and associated to a VPN gateway.",
+                    "items": {
+                        "type": "string"
+                    },
+                    "type": "array"
+                }
+            },
+            "type": "object"
+        },
+        "TargetVpnGatewayAggregatedList": {
+            "id": "TargetVpnGatewayAggregatedList",
+            "properties": {
+                "id": {
+                    "description": "[Output Only] Unique identifier for the resource. Defined by the server.",
+                    "type": "string"
+                },
+                "items": {
+                    "additionalProperties": {
+                        "$ref": "TargetVpnGatewaysScopedList",
+                        "description": "[Output Only] Name of the scope containing this set of target vpn gateways."
+                    },
+                    "description": "A map of scoped target vpn gateway lists.",
+                    "type": "object"
+                },
+                "kind": {
+                    "default": "compute#targetVpnGatewayAggregatedList",
+                    "description": "[Output Only] Type of resource. Always compute#targetVpnGateway for target VPN gateways.",
+                    "type": "string"
+                },
+                "nextPageToken": {
+                    "description": "[Output Only] A token used to continue a truncated list request.",
+                    "type": "string"
+                },
+                "selfLink": {
+                    "description": "[Output Only] Server-defined URL for the resource.",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
+        "TargetVpnGatewayList": {
+            "description": "Contains a list of TargetVpnGateway resources.",
+            "id": "TargetVpnGatewayList",
+            "properties": {
+                "id": {
+                    "description": "[Output Only] Unique identifier for the resource. Defined by the server.",
+                    "type": "string"
+                },
+                "items": {
+                    "description": "[Output Only] A list of TargetVpnGateway resources.",
+                    "items": {
+                        "$ref": "TargetVpnGateway"
+                    },
+                    "type": "array"
+                },
+                "kind": {
+                    "default": "compute#targetVpnGatewayList",
+                    "description": "[Output Only] Type of resource. Always compute#targetVpnGateway for target VPN gateways.",
+                    "type": "string"
+                },
+                "nextPageToken": {
+                    "description": "[Output Only] A token used to continue a truncated list request.",
+                    "type": "string"
+                },
+                "selfLink": {
+                    "description": "[Output Only] Server-defined URL for the resource.",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
+        "TargetVpnGatewaysScopedList": {
+            "id": "TargetVpnGatewaysScopedList",
+            "properties": {
+                "targetVpnGateways": {
+                    "description": "[Output Only] List of target vpn gateways contained in this scope.",
+                    "items": {
+                        "$ref": "TargetVpnGateway"
+                    },
+                    "type": "array"
+                },
+                "warning": {
+                    "description": "[Output Only] Informational warning which replaces the list of addresses when the list is empty.",
+                    "properties": {
+                        "code": {
+                            "description": "[Output Only] The warning type identifier for this warning.",
+                            "enum": [
+                                "DEPRECATED_RESOURCE_USED",
+                                "DISK_SIZE_LARGER_THAN_IMAGE_SIZE",
                                 "INJECTED_KERNELS_DEPRECATED",
                                 "NEXT_HOP_ADDRESS_NOT_ASSIGNED",
                                 "NEXT_HOP_CANNOT_IP_FORWARD",
                                 "NEXT_HOP_INSTANCE_NOT_FOUND",
                                 "NEXT_HOP_INSTANCE_NOT_ON_NETWORK",
                                 "NEXT_HOP_NOT_RUNNING",
                                 "NO_RESULTS_ON_PAGE",
                                 "REQUIRED_TOS_AGREEMENT",
                                 "RESOURCE_NOT_DELETED",
+                                "SINGLE_INSTANCE_PROPERTY_TEMPLATE",
                                 "UNREACHABLE"
                             ],
                             "enumDescriptions": [
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
+                                "",
                                 ""
                             ],
                             "type": "string"
                         },
                         "data": {
-                            "description": "Metadata for this warning in 'key: value' format.",
+                            "description": "[Output Only] Metadata for this warning in key: value format.",
                             "items": {
                                 "properties": {
                                     "key": {
-                                        "description": "A key for the warning data.",
+                                        "description": "[Output Only] A key for the warning data.",
                                         "type": "string"
                                     },
                                     "value": {
-                                        "description": "A warning data value corresponding to the key.",
+                                        "description": "[Output Only] A warning data value corresponding to the key.",
                                         "type": "string"
                                     }
                                 },
                                 "type": "object"
                             },
                             "type": "array"
                         },
                         "message": {
-                            "description": "Optional human-readable details for this warning.",
+                            "description": "[Output Only] Optional human-readable details for this warning.",
                             "type": "string"
                         }
                     },
                     "type": "object"
                 }
             },
             "type": "object"
         },
-        "TargetReference": {
-            "id": "TargetReference",
-            "properties": {
-                "target": {
-                    "type": "string"
-                }
-            },
-            "type": "object"
-        },
         "TestFailure": {
             "id": "TestFailure",
             "properties": {
                 "actualService": {
                     "type": "string"
                 },
                 "expectedService": {
                     "type": "string"
                 },
                 "host": {
@@ skipping 176 matching lines @@
                     "$ref": "UrlMapValidationResult"
                 }
             },
             "type": "object"
         },
         "UsageExportLocation": {
             "description": "The location in Cloud Storage and naming method of the daily usage report. Contains bucket_name and report_name prefix.",
             "id": "UsageExportLocation",
             "properties": {
                 "bucketName": {
-                    "description": "The name of an existing bucket in Cloud Storage where the usage report object is stored. The Google Service Account is granted write access to this bucket. This is simply the bucket name, with no \"gs://\" or \"https://storage.googleapis.com/\" in front of it.",
+                    "description": "The name of an existing bucket in Cloud Storage where the usage report object is stored. The Google Service Account is granted write access to this bucket. This is just the bucket name, with no gs:// or https://storage.googleapis.com/ in front of it.",
                     "type": "string"
                 },
                 "reportNamePrefix": {
-                    "description": "An optional prefix for the name of the usage report object stored in bucket_name. If not supplied, defaults to \"usage_\". The report is stored as a CSV file named _gce_.csv. where  is the day of the usage according to Pacific Time. The prefix should conform to Cloud Storage object naming conventions.",
-                    "type": "string"
+                    "description": "An optional prefix for the name of the usage report object stored in bucketName. If not supplied, defaults to usage. The report is stored as a CSV file named report_name_prefix_gce_YYYYMMDD.csv where YYYYMMDD is the day of the usage according to Pacific Time. If you supply a prefix, it should conform to Cloud Storage object naming conventions.",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
+        "VpnTunnel": {
+            "id": "VpnTunnel",
+            "properties": {
+                "creationTimestamp": {
+                    "description": "[Output Only] Creation timestamp in RFC3339 text format.",
+                    "type": "string"
+                },
+                "description": {
+                    "description": "An optional textual description of the resource. Provided by the client when the resource is created.",
+                    "type": "string"
+                },
+                "detailedStatus": {
+                    "description": "[Output Only] Detailed status message for the VPN tunnel.",
+                    "type": "string"
+                },
+                "id": {
+                    "description": "[Output Only] Unique identifier for the resource. Defined by the server.",
+                    "format": "uint64",
+                    "type": "string"
+                },
+                "ikeNetworks": {
+                    "description": "IKE networks to use when establishing the VPN tunnel with peer VPN gateway. The value should be a CIDR formatted string, for example: 192.168.0.0/16. The ranges should be disjoint.",
+                    "items": {
+                        "type": "string"
+                    },
+                    "type": "array"
+                },
+                "ikeVersion": {
+                    "description": "IKE protocol version to use when establishing the VPN tunnel with peer VPN gateway. Acceptable IKE versions are 1 or 2. Default version is 2.",
+                    "format": "int32",
+                    "type": "integer"
+                },
+                "kind": {
+                    "default": "compute#vpnTunnel",
+                    "description": "[Output Only] Type of resource. Always compute#vpnTunnel for VPN tunnels.",
+                    "type": "string"
+                },
+                "name": {
+                    "annotations": {
+                        "required": [
+                            "compute.vpnTunnels.insert"
+                        ]
+                    },
+                    "description": "Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long and comply with RFC1035.",
+                    "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
+                    "type": "string"
+                },
+                "peerIp": {
+                    "description": "IP address of the peer VPN gateway.",
+                    "type": "string"
+                },
+                "region": {
+                    "description": "[Output Only] URL of the region where the VPN tunnel resides.",
+                    "type": "string"
+                },
+                "selfLink": {
+                    "description": "[Output Only] Server defined URL for the resource.",
+                    "type": "string"
+                },
+                "sharedSecret": {
+                    "description": "Shared secret used to set the secure session between the GCE VPN gateway and the peer VPN gateway.",
+                    "type": "string"
+                },
+                "sharedSecretHash": {
+                    "description": "Hash of the shared secret.",
+                    "type": "string"
+                },
+                "status": {
+                    "description": "[Output Only] The status of the VPN tunnel.",
+                    "enum": [
+                        "AUTHORIZATION_ERROR",
+                        "DEPROVISIONING",
+                        "ESTABLISHED",
+                        "FAILED",
+                        "FIRST_HANDSHAKE",
+                        "NEGOTIATION_FAILURE",
+                        "NETWORK_ERROR",
+                        "PROVISIONING",
+                        "WAITING_FOR_FULL_CONFIG"
+                    ],
+                    "enumDescriptions": [
+                        "",
+                        "",
+                        "",
+                        "",
+                        "",
+                        "",
+                        "",
+                        "",
+                        ""
+                    ],
+                    "type": "string"
+                },
+                "targetVpnGateway": {
+                    "annotations": {
+                        "required": [
+                            "compute.vpnTunnels.insert"
+                        ]
+                    },
+                    "description": "URL of the VPN gateway to which this VPN tunnel is associated. Provided by the client when the VPN tunnel is created.",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
+        "VpnTunnelAggregatedList": {
+            "id": "VpnTunnelAggregatedList",
+            "properties": {
+                "id": {
+                    "description": "[Output Only] Unique identifier for the resource; defined by the server.",
+                    "type": "string"
+                },
+                "items": {
+                    "additionalProperties": {
+                        "$ref": "VpnTunnelsScopedList",
+                        "description": "Name of the scope containing this set of vpn tunnels."
+                    },
+                    "description": "[Output Only] A map of scoped vpn tunnel lists.",
+                    "type": "object"
+                },
+                "kind": {
+                    "default": "compute#vpnTunnelAggregatedList",
+                    "description": "[Output Only] Type of resource. Always compute#vpnTunnel for VPN tunnels.",
+                    "type": "string"
+                },
+                "nextPageToken": {
+                    "description": "[Output Only] A token used to continue a truncated list request.",
+                    "type": "string"
+                },
+                "selfLink": {
+                    "description": "[Output Only] Server defined URL for this resource.",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
+        "VpnTunnelList": {
+            "description": "Contains a list of VpnTunnel resources.",
+            "id": "VpnTunnelList",
+            "properties": {
+                "id": {
+                    "description": "[Output Only] Unique identifier for the resource; defined by the server.",
+                    "type": "string"
+                },
+                "items": {
+                    "description": "[Output Only] A list of VpnTunnel resources.",
+                    "items": {
+                        "$ref": "VpnTunnel"
+                    },
+                    "type": "array"
+                },
+                "kind": {
+                    "default": "compute#vpnTunnelList",
+                    "description": "[Output Only] Type of resource. Always compute#vpnTunnel for VPN tunnels.",
+                    "type": "string"
+                },
+                "nextPageToken": {
+                    "description": "[Output Only] A token used to continue a truncated list request.",
+                    "type": "string"
+                },
+                "selfLink": {
+                    "description": "[Output Only] Server-defined URL for the resource.",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
+        "VpnTunnelsScopedList": {
+            "id": "VpnTunnelsScopedList",
+            "properties": {
+                "vpnTunnels": {
+                    "description": "List of vpn tunnels contained in this scope.",
+                    "items": {
+                        "$ref": "VpnTunnel"
+                    },
+                    "type": "array"
+                },
+                "warning": {
+                    "description": "Informational warning which replaces the list of addresses when the list is empty.",
+                    "properties": {
+                        "code": {
+                            "description": "[Output Only] The warning type identifier for this warning.",
+                            "enum": [
+                                "DEPRECATED_RESOURCE_USED",
+                                "DISK_SIZE_LARGER_THAN_IMAGE_SIZE",
+                                "INJECTED_KERNELS_DEPRECATED",
+                                "NEXT_HOP_ADDRESS_NOT_ASSIGNED",
+                                "NEXT_HOP_CANNOT_IP_FORWARD",
+                                "NEXT_HOP_INSTANCE_NOT_FOUND",
+                                "NEXT_HOP_INSTANCE_NOT_ON_NETWORK",
+                                "NEXT_HOP_NOT_RUNNING",
+                                "NO_RESULTS_ON_PAGE",
+                                "REQUIRED_TOS_AGREEMENT",
+                                "RESOURCE_NOT_DELETED",
+                                "SINGLE_INSTANCE_PROPERTY_TEMPLATE",
+                                "UNREACHABLE"
+                            ],
+                            "enumDescriptions": [
+                                "",
+                                "",
+                                "",
+                                "",
+                                "",
+                                "",
+                                "",
+                                "",
+                                "",
+                                "",
+                                "",
+                                "",
+                                ""
+                            ],
+                            "type": "string"
+                        },
+                        "data": {
+                            "description": "[Output Only] Metadata for this warning in key: value format.",
+                            "items": {
+                                "properties": {
+                                    "key": {
+                                        "description": "[Output Only] A key for the warning data.",
+                                        "type": "string"
+                                    },
+                                    "value": {
+                                        "description": "[Output Only] A warning data value corresponding to the key.",
+                                        "type": "string"
+                                    }
+                                },
+                                "type": "object"
+                            },
+                            "type": "array"
+                        },
+                        "message": {
+                            "description": "[Output Only] Optional human-readable details for this warning.",
+                            "type": "string"
+                        }
+                    },
+                    "type": "object"
                 }
             },
             "type": "object"
         },
         "Zone": {
-            "description": "A zone resource.",
+            "description": "A Zone resource.",
             "id": "Zone",
             "properties": {
                 "creationTimestamp": {
-                    "description": "Creation timestamp in RFC3339 text format (output only).",
+                    "description": "[Output Only] Creation timestamp in RFC3339 text format.",
                     "type": "string"
                 },
                 "deprecated": {
                     "$ref": "DeprecationStatus",
-                    "description": "The deprecation status associated with this zone."
+                    "description": "[Output Only] The deprecation status associated with this zone."
                 },
                 "description": {
-                    "description": "Textual description of the resource.",
+                    "description": "[Output Only] Textual description of the resource.",
                     "type": "string"
                 },
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "format": "uint64",
                     "type": "string"
                 },
                 "kind": {
                     "default": "compute#zone",
-                    "description": "Type of the resource.",
+                    "description": "[Output Only] Type of the resource. Always kind#zone for zones.",
                     "type": "string"
                 },
                 "maintenanceWindows": {
-                    "description": "Scheduled maintenance windows for the zone. When the zone is in a maintenance window, all resources which reside in the zone will be unavailable.",
+                    "description": "[Output Only] Any scheduled maintenance windows for this zone. When the zone is in a maintenance window, all resources which reside in the zone will be unavailable. For more information, see Maintenance Windows",
                     "items": {
                         "properties": {
                             "beginTime": {
-                                "description": "Begin time of the maintenance window, in RFC 3339 format.",
+                                "description": "[Output Only] Starting time of the maintenance window, in RFC3339 format.",
                                 "type": "string"
                             },
                             "description": {
-                                "description": "Textual description of the maintenance window.",
+                                "description": "[Output Only] Textual description of the maintenance window.",
                                 "type": "string"
                             },
                             "endTime": {
-                                "description": "End time of the maintenance window, in RFC 3339 format.",
+                                "description": "[Output Only] Ending time of the maintenance window, in RFC3339 format.",
                                 "type": "string"
                             },
                             "name": {
-                                "description": "Name of the maintenance window.",
+                                "description": "[Output Only] Name of the maintenance window.",
                                 "type": "string"
                             }
                         },
                         "type": "object"
                     },
                     "type": "array"
                 },
                 "name": {
-                    "description": "Name of the resource.",
+                    "description": "[Output Only] Name of the resource.",
                     "type": "string"
                 },
                 "region": {
-                    "description": "Full URL reference to the region which hosts the zone (output only).",
+                    "description": "[Output Only] Full URL reference to the region which hosts the zone.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for the resource (output only).",
+                    "description": "[Output Only] Server defined URL for the resource.",
                     "type": "string"
                 },
                 "status": {
-                    "description": "Status of the zone. \"UP\" or \"DOWN\".",
+                    "description": "[Output Only] Status of the zone, either UP or DOWN.",
                     "enum": [
                         "DOWN",
                         "UP"
                     ],
                     "enumDescriptions": [
                         "",
                         ""
                     ],
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "ZoneList": {
             "description": "Contains a list of zone resources.",
             "id": "ZoneList",
             "properties": {
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "type": "string"
                 },
                 "items": {
-                    "description": "A list of Zone resources.",
+                    "description": "[Output Only] A list of Zone resources.",
                     "items": {
                         "$ref": "Zone"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "compute#zoneList",
                     "description": "Type of resource.",
                     "type": "string"
                 },
                 "nextPageToken": {
-                    "description": "A token used to continue a truncated list request (output only).",
+                    "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
                     "description": "Server defined URL for this resource (output only).",
                     "type": "string"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "compute/v1/projects/",
     "title": "Compute Engine API",
     "version": "v1"
 }