Api-roll 33: 2016-03-14

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": "\"bRFOOrZKfO9LweMbPqu0kcu6De8/c55dTQvv4NWDkglZO3_PlmckRzg\"",
+    "etag": "\"bRFOOrZKfO9LweMbPqu0kcu6De8/0HKk2qVFNFj4BfRYktkIsjDiv2o\"",
     "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 47 matching lines @@
             "methods": {
                 "aggregatedList": {
                     "description": "Retrieves an aggregated list of addresses.",
                     "httpMethod": "GET",
                     "id": "compute.addresses.aggregatedList",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 34 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"
                         },
                         "region": {
-                            "description": "The name of the region for this request.",
+                            "description": "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 20 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"
                         },
                         "region": {
-                            "description": "The name of the region for this request.",
+                            "description": "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"
                     },
@@ skipping 13 matching lines @@
                     ],
                     "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.",
+                            "description": "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"
                     },
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "list": {
-                    "description": "Retrieves a list of address resources contained within the specified region.",
+                    "description": "Retrieves a list of addresses contained within the specified region.",
                     "httpMethod": "GET",
                     "id": "compute.addresses.list",
                     "parameterOrder": [
                         "project",
                         "region"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "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.",
+                            "description": "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"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute",
                         "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 }
             }
         },
         "autoscalers": {
             "methods": {
                 "aggregatedList": {
                     "description": "Retrieves an aggregated list of autoscalers.",
                     "httpMethod": "GET",
                     "id": "compute.autoscalers.aggregatedList",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 10 matching lines @@
                     "response": {
                         "$ref": "AutoscalerAggregatedList"
                     },
                     "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 autoscaler resource.",
+                    "description": "Deletes the specified autoscaler.",
                     "httpMethod": "DELETE",
                     "id": "compute.autoscalers.delete",
                     "parameterOrder": [
                         "project",
                         "zone",
                         "autoscaler"
                     ],
                     "parameters": {
                         "autoscaler": {
-                            "description": "Name of the persistent autoscaler resource to delete.",
+                            "description": "Name of the autoscaler to delete.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "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": "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}/autoscalers/{autoscaler}",
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "get": {
-                    "description": "Returns the specified autoscaler resource.",
+                    "description": "Returns the specified autoscaler resource. Get a list of available autoscalers by making a list() request.",
                     "httpMethod": "GET",
                     "id": "compute.autoscalers.get",
                     "parameterOrder": [
                         "project",
                         "zone",
                         "autoscaler"
                     ],
                     "parameters": {
                         "autoscaler": {
-                            "description": "Name of the persistent autoscaler resource to return.",
+                            "description": "Name of the autoscaler to return.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "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": "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}/autoscalers/{autoscaler}",
                     "response": {
                         "$ref": "Autoscaler"
                     },
                     "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 autoscaler resource in the specified project using the data included in the request.",
+                    "description": "Creates an autoscaler in the specified project using the data included in the request.",
                     "httpMethod": "POST",
                     "id": "compute.autoscalers.insert",
                     "parameterOrder": [
                         "project",
                         "zone"
                     ],
                     "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"
                         },
                         "zone": {
-                            "description": "Name of the zone scoping this request.",
+                            "description": "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}/autoscalers",
                     "request": {
                         "$ref": "Autoscaler"
                     },
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "list": {
-                    "description": "Retrieves a list of autoscaler resources contained within the specified zone.",
+                    "description": "Retrieves a list of autoscalers contained within the specified zone.",
                     "httpMethod": "GET",
                     "id": "compute.autoscalers.list",
                     "parameterOrder": [
                         "project",
                         "zone"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "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"
                         },
                         "zone": {
-                            "description": "Name of the zone scoping this request.",
+                            "description": "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}/autoscalers",
                     "response": {
                         "$ref": "AutoscalerList"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute",
                         "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 },
                 "patch": {
-                    "description": "Updates an autoscaler resource in the specified project using the data included in the request. This method supports patch semantics.",
+                    "description": "Updates an autoscaler in the specified project using the data included in the request. This method supports patch semantics.",
                     "httpMethod": "PATCH",
                     "id": "compute.autoscalers.patch",
                     "parameterOrder": [
                         "project",
                         "zone",
                         "autoscaler"
                     ],
                     "parameters": {
                         "autoscaler": {
-                            "description": "Name of the autoscaler resource to update.",
+                            "description": "Name of the autoscaler to update.",
                             "location": "query",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "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": "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}/autoscalers",
                     "request": {
                         "$ref": "Autoscaler"
                     },
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "update": {
-                    "description": "Updates an autoscaler resource in the specified project using the data included in the request.",
+                    "description": "Updates an autoscaler in the specified project using the data included in the request.",
                     "httpMethod": "PUT",
                     "id": "compute.autoscalers.update",
                     "parameterOrder": [
                         "project",
                         "zone"
                     ],
                     "parameters": {
                         "autoscaler": {
-                            "description": "Name of the autoscaler resource to update.",
+                            "description": "Name of the autoscaler to update.",
                             "location": "query",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "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": "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}/autoscalers",
                     "request": {
                         "$ref": "Autoscaler"
                     },
@@ skipping 36 matching lines @@
                     "path": "{project}/global/backendServices/{backendService}",
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "get": {
-                    "description": "Returns the specified BackendService resource.",
+                    "description": "Returns the specified BackendService resource. Get a list of available backend services by making a list() request.",
                     "httpMethod": "GET",
                     "id": "compute.backendServices.get",
                     "parameterOrder": [
                         "project",
                         "backendService"
                     ],
                     "parameters": {
                         "backendService": {
                             "description": "Name of the BackendService resource to return.",
                             "location": "path",
@@ skipping 85 matching lines @@
                 },
                 "list": {
                     "description": "Retrieves the list of BackendService resources available to the specified project.",
                     "httpMethod": "GET",
                     "id": "compute.backendServices.list",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 86 matching lines @@
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 }
             }
         },
         "diskTypes": {
             "methods": {
                 "aggregatedList": {
-                    "description": "Retrieves an aggregated list of disk type resources.",
+                    "description": "Retrieves an aggregated list of disk types.",
                     "httpMethod": "GET",
                     "id": "compute.diskTypes.aggregatedList",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 10 matching lines @@
                     "response": {
                         "$ref": "DiskTypeAggregatedList"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute",
                         "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 },
                 "get": {
-                    "description": "Returns the specified disk type resource.",
+                    "description": "Returns the specified disk type. Get a list of available disk types by making a list() request.",
                     "httpMethod": "GET",
                     "id": "compute.diskTypes.get",
                     "parameterOrder": [
                         "project",
                         "zone",
                         "diskType"
                     ],
                     "parameters": {
                         "diskType": {
-                            "description": "Name of the disk type resource to return.",
+                            "description": "Name of the disk type to return.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "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,
@@ skipping 11 matching lines @@
                     "response": {
                         "$ref": "DiskType"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute",
                         "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 },
                 "list": {
-                    "description": "Retrieves a list of disk type resources available to the specified project.",
+                    "description": "Retrieves a list of disk types available to the specified project.",
                     "httpMethod": "GET",
                     "id": "compute.diskTypes.list",
                     "parameterOrder": [
                         "project",
                         "zone"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 29 matching lines @@
             "methods": {
                 "aggregatedList": {
                     "description": "Retrieves an aggregated list of persistent disks.",
                     "httpMethod": "GET",
                     "id": "compute.disks.aggregatedList",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 95 matching lines @@
                     "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 a specified persistent disk.",
+                    "description": "Returns a specified persistent disk. Get a list of available persistent disks by making a list() request.",
                     "httpMethod": "GET",
                     "id": "compute.disks.get",
                     "parameterOrder": [
                         "project",
                         "zone",
                         "disk"
                     ],
                     "parameters": {
                         "disk": {
                             "description": "Name of the persistent disk to return.",
@@ skipping 21 matching lines @@
                     "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 in the specified project using the data included in the request.",
+                    "description": "Creates a persistent disk in the specified project using the data in the request. You can create a disk with a sourceImage, a sourceSnapshot, or create an empty 200 GB data disk by omitting all properties. You can also create a disk that is larger than the default size by specifying the sizeGb property.",
                     "httpMethod": "POST",
                     "id": "compute.disks.insert",
                     "parameterOrder": [
                         "project",
                         "zone"
                     ],
                     "parameters": {
                         "project": {
                             "description": "Project ID for this request.",
                             "location": "path",
@@ skipping 29 matching lines @@
                 "list": {
                     "description": "Retrieves a list of persistent disks contained within the specified zone.",
                     "httpMethod": "GET",
                     "id": "compute.disks.list",
                     "parameterOrder": [
                         "project",
                         "zone"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 21 matching lines @@
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute",
                         "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 }
             }
         },
         "firewalls": {
             "methods": {
                 "delete": {
-                    "description": "Deletes the specified firewall resource.",
+                    "description": "Deletes the specified firewall.",
                     "httpMethod": "DELETE",
                     "id": "compute.firewalls.delete",
                     "parameterOrder": [
                         "project",
                         "firewall"
                     ],
                     "parameters": {
                         "firewall": {
-                            "description": "Name of the firewall resource to delete.",
+                            "description": "Name of the firewall rule to delete.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "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}/global/firewalls/{firewall}",
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "get": {
-                    "description": "Returns the specified firewall resource.",
+                    "description": "Returns the specified firewall.",
                     "httpMethod": "GET",
                     "id": "compute.firewalls.get",
                     "parameterOrder": [
                         "project",
                         "firewall"
                     ],
                     "parameters": {
                         "firewall": {
-                            "description": "Name of the firewall resource to return.",
+                            "description": "Name of the firewall rule to return.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "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}/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.",
+                    "description": "Creates a firewall rule in the specified project using the data included in the request.",
                     "httpMethod": "POST",
                     "id": "compute.firewalls.insert",
                     "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}/global/firewalls",
                     "request": {
                         "$ref": "Firewall"
                     },
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "list": {
-                    "description": "Retrieves the list of firewall resources available to the specified project.",
+                    "description": "Retrieves the list of firewall rules available to the specified project.",
                     "httpMethod": "GET",
                     "id": "compute.firewalls.list",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 10 matching lines @@
                     "response": {
                         "$ref": "FirewallList"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute",
                         "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 },
                 "patch": {
-                    "description": "Updates the specified firewall resource with the data included in the request. This method supports patch semantics.",
+                    "description": "Updates the specified firewall rule with the data included in the request. This method supports patch semantics.",
                     "httpMethod": "PATCH",
                     "id": "compute.firewalls.patch",
                     "parameterOrder": [
                         "project",
                         "firewall"
                     ],
                     "parameters": {
                         "firewall": {
-                            "description": "Name of the firewall resource to update.",
+                            "description": "Name of the firewall rule to update.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "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}/global/firewalls/{firewall}",
                     "request": {
                         "$ref": "Firewall"
                     },
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "update": {
-                    "description": "Updates the specified firewall resource with the data included in the request.",
+                    "description": "Updates the specified firewall rule with the data included in the request.",
                     "httpMethod": "PUT",
                     "id": "compute.firewalls.update",
                     "parameterOrder": [
                         "project",
                         "firewall"
                     ],
                     "parameters": {
                         "firewall": {
-                            "description": "Name of the firewall resource to update.",
+                            "description": "Name of the firewall rule to update.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "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,
@@ skipping 18 matching lines @@
             "methods": {
                 "aggregatedList": {
                     "description": "Retrieves an aggregated list of forwarding rules.",
                     "httpMethod": "GET",
                     "id": "compute.forwardingRules.aggregatedList",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 138 matching lines @@
                 "list": {
                     "description": "Retrieves a list of ForwardingRule resources available to the specified project and region.",
                     "httpMethod": "GET",
                     "id": "compute.forwardingRules.list",
                     "parameterOrder": [
                         "project",
                         "region"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 98 matching lines @@
                     "path": "{project}/global/addresses/{address}",
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "get": {
-                    "description": "Returns the specified address resource.",
+                    "description": "Returns the specified address resource. Get a list of available addresses by making a list() request.",
                     "httpMethod": "GET",
                     "id": "compute.globalAddresses.get",
                     "parameterOrder": [
                         "project",
                         "address"
                     ],
                     "parameters": {
                         "address": {
                             "description": "Name of the address resource to return.",
                             "location": "path",
@@ skipping 41 matching lines @@
                     },
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "list": {
-                    "description": "Retrieves a list of global address resources.",
+                    "description": "Retrieves a list of global addresses.",
                     "httpMethod": "GET",
                     "id": "compute.globalAddresses.list",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 47 matching lines @@
                     "path": "{project}/global/forwardingRules/{forwardingRule}",
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "get": {
-                    "description": "Returns the specified ForwardingRule resource.",
+                    "description": "Returns the specified ForwardingRule resource. Get a list of available forwarding rules by making a list() request.",
                     "httpMethod": "GET",
                     "id": "compute.globalForwardingRules.get",
                     "parameterOrder": [
                         "project",
                         "forwardingRule"
                     ],
                     "parameters": {
                         "forwardingRule": {
                             "description": "Name of the ForwardingRule resource to return.",
                             "location": "path",
@@ skipping 49 matching lines @@
                 },
                 "list": {
                     "description": "Retrieves a list of ForwardingRule resources available to the specified project.",
                     "httpMethod": "GET",
                     "id": "compute.globalForwardingRules.list",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 58 matching lines @@
             "methods": {
                 "aggregatedList": {
                     "description": "Retrieves an aggregated list of all operations.",
                     "httpMethod": "GET",
                     "id": "compute.globalOperations.aggregatedList",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 40 matching lines @@
                             "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 Operations resource.",
+                    "description": "Retrieves the specified Operations resource. Get a list of operations by making a list() request.",
                     "httpMethod": "GET",
                     "id": "compute.globalOperations.get",
                     "parameterOrder": [
                         "project",
                         "operation"
                     ],
                     "parameters": {
                         "operation": {
                             "description": "Name of the Operations resource to return.",
                             "location": "path",
@@ skipping 21 matching lines @@
                 },
                 "list": {
                     "description": "Retrieves a list of Operation resources contained within the specified project.",
                     "httpMethod": "GET",
                     "id": "compute.globalOperations.list",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 47 matching lines @@
                     "path": "{project}/global/httpHealthChecks/{httpHealthCheck}",
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "get": {
-                    "description": "Returns the specified HttpHealthCheck resource.",
+                    "description": "Returns the specified HttpHealthCheck resource. Get a list of available HTTP health checks by making a list() request.",
                     "httpMethod": "GET",
                     "id": "compute.httpHealthChecks.get",
                     "parameterOrder": [
                         "project",
                         "httpHealthCheck"
                     ],
                     "parameters": {
                         "httpHealthCheck": {
                             "description": "Name of the HttpHealthCheck resource to return.",
                             "location": "path",
@@ skipping 49 matching lines @@
                 },
                 "list": {
                     "description": "Retrieves the list of HttpHealthCheck resources available to the specified project.",
                     "httpMethod": "GET",
                     "id": "compute.httpHealthChecks.list",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 119 matching lines @@
                     "path": "{project}/global/httpsHealthChecks/{httpsHealthCheck}",
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "get": {
-                    "description": "Returns the specified HttpsHealthCheck resource.",
+                    "description": "Returns the specified HttpsHealthCheck resource. Get a list of available HTTPS health checks by making a list() request.",
                     "httpMethod": "GET",
                     "id": "compute.httpsHealthChecks.get",
                     "parameterOrder": [
                         "project",
                         "httpsHealthCheck"
                     ],
                     "parameters": {
                         "httpsHealthCheck": {
                             "description": "Name of the HttpsHealthCheck resource to return.",
                             "location": "path",
@@ skipping 49 matching lines @@
                 },
                 "list": {
                     "description": "Retrieves the list of HttpsHealthCheck resources available to the specified project.",
                     "httpMethod": "GET",
                     "id": "compute.httpsHealthChecks.list",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 86 matching lines @@
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 }
             }
         },
         "images": {
             "methods": {
                 "delete": {
-                    "description": "Deletes the specified image resource.",
+                    "description": "Deletes the specified image.",
                     "httpMethod": "DELETE",
                     "id": "compute.images.delete",
                     "parameterOrder": [
                         "project",
                         "image"
                     ],
                     "parameters": {
                         "image": {
                             "description": "Name of the image resource to delete.",
                             "location": "path",
@@ skipping 48 matching lines @@
                     },
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "get": {
-                    "description": "Returns the specified image resource.",
+                    "description": "Returns the specified image. Get a list of available images by making a list() request.",
                     "httpMethod": "GET",
                     "id": "compute.images.get",
                     "parameterOrder": [
                         "project",
                         "image"
                     ],
                     "parameters": {
                         "image": {
                             "description": "Name of the image resource to return.",
                             "location": "path",
@@ skipping 13 matching lines @@
                     "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.",
+                    "description": "Creates an image in the specified project using the data included in the request.",
                     "httpMethod": "POST",
                     "id": "compute.images.insert",
                     "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])?))",
@@ skipping 18 matching lines @@
                 },
                 "list": {
                     "description": "Retrieves the list of private images available to the specified project. Private images are images you create that belong to your project. This method does not get any images that belong to other projects, including publicly-available images, like Debian 7. If you want to get a list of publicly-available images, use this method to make a request to the respective image project, such as debian-cloud or windows-cloud.\n\nSee Accessing images for more information.",
                     "httpMethod": "GET",
                     "id": "compute.images.list",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 64 matching lines @@
                 },
                 "aggregatedList": {
                     "description": "Retrieves the list of managed instance groups and groups them by zone.",
                     "httpMethod": "GET",
                     "id": "compute.instanceGroupManagers.aggregatedList",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 91 matching lines @@
                     },
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "get": {
-                    "description": "Returns all of the details about the specified managed instance group.",
+                    "description": "Returns all of the details about the specified managed instance group. Get a list of available managed instance groups by making a list() request.",
                     "httpMethod": "GET",
                     "id": "compute.instanceGroupManagers.get",
                     "parameterOrder": [
                         "project",
                         "zone",
                         "instanceGroupManager"
                     ],
                     "parameters": {
                         "instanceGroupManager": {
                             "description": "The name of the managed instance group.",
@@ skipping 63 matching lines @@
                 "list": {
                     "description": "Retrieves a list of managed instance groups that are contained within the specified project and zone.",
                     "httpMethod": "GET",
                     "id": "compute.instanceGroupManagers.list",
                     "parameterOrder": [
                         "project",
                         "zone"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 233 matching lines @@
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 }
             }
         },
         "instanceGroups": {
             "methods": {
                 "addInstances": {
-                    "description": "Adds a list of instances to the specified instance group. Read  Adding instances for more information.",
+                    "description": "Adds a list of instances to the specified instance group. All of the instances in the instance group must be in the same network/subnetwork. Read  Adding instances for more information.",
                     "httpMethod": "POST",
                     "id": "compute.instanceGroups.addInstances",
                     "parameterOrder": [
                         "project",
                         "zone",
                         "instanceGroup"
                     ],
                     "parameters": {
                         "instanceGroup": {
                             "description": "The name of the instance group where you are adding instances.",
@@ skipping 29 matching lines @@
                 },
                 "aggregatedList": {
                     "description": "Retrieves the list of instance groups and sorts them by zone.",
                     "httpMethod": "GET",
                     "id": "compute.instanceGroups.aggregatedList",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 49 matching lines @@
                     "path": "{project}/zones/{zone}/instanceGroups/{instanceGroup}",
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "get": {
-                    "description": "Returns the specified instance group resource.",
+                    "description": "Returns the specified instance group. Get a list of available instance groups by making a list() request.",
                     "httpMethod": "GET",
                     "id": "compute.instanceGroups.get",
                     "parameterOrder": [
                         "project",
                         "zone",
                         "instanceGroup"
                     ],
                     "parameters": {
                         "instanceGroup": {
                             "description": "The name of the instance group.",
@@ skipping 63 matching lines @@
                 "list": {
                     "description": "Retrieves the list of instance groups that are located in the specified project and zone.",
                     "httpMethod": "GET",
                     "id": "compute.instanceGroups.list",
                     "parameterOrder": [
                         "project",
                         "zone"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 26 matching lines @@
                     "description": "Lists the instances in the specified instance group.",
                     "httpMethod": "POST",
                     "id": "compute.instanceGroups.listInstances",
                     "parameterOrder": [
                         "project",
                         "zone",
                         "instanceGroup"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "instanceGroup": {
                             "description": "The name of the instance group from which you want to generate a list of included instances.",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 107 matching lines @@
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 }
             }
         },
         "instanceTemplates": {
             "methods": {
                 "delete": {
-                    "description": "Deletes the specified instance template.",
+                    "description": "Deletes the specified instance template. If you delete an instance template that is being referenced from another instance group, the instance group will not be able to create or recreate virtual machine instances. Deleting an instance template is permanent and cannot be undone.",
                     "httpMethod": "DELETE",
                     "id": "compute.instanceTemplates.delete",
                     "parameterOrder": [
                         "project",
                         "instanceTemplate"
                     ],
                     "parameters": {
                         "instanceTemplate": {
                             "description": "The name of the instance template to delete.",
                             "location": "path",
@@ skipping 12 matching lines @@
                     "path": "{project}/global/instanceTemplates/{instanceTemplate}",
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "get": {
-                    "description": "Returns the specified instance template resource.",
+                    "description": "Returns the specified instance template. Get a list of available instance templates by making a list() request.",
                     "httpMethod": "GET",
                     "id": "compute.instanceTemplates.get",
                     "parameterOrder": [
                         "project",
                         "instanceTemplate"
                     ],
                     "parameters": {
                         "instanceTemplate": {
                             "description": "The name of the instance template.",
                             "location": "path",
@@ skipping 49 matching lines @@
                 },
                 "list": {
                     "description": "Retrieves a list of instance templates that are contained within the specified project and zone.",
                     "httpMethod": "GET",
                     "id": "compute.instanceTemplates.list",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 65 matching lines @@
                     },
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "aggregatedList": {
-                    "description": "Retrieves aggregated list of instance resources.",
+                    "description": "Retrieves aggregated list of instances.",
                     "httpMethod": "GET",
                     "id": "compute.instances.aggregatedList",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 20 matching lines @@
                     "description": "Attaches a Disk resource to an instance.",
                     "httpMethod": "POST",
                     "id": "compute.instances.attachDisk",
                     "parameterOrder": [
                         "project",
                         "zone",
                         "instance"
                     ],
                     "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"
                         },
                         "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,
@@ skipping 158 matching lines @@
                     "path": "{project}/zones/{zone}/instances/{instance}/detachDisk",
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "get": {
-                    "description": "Returns the specified instance resource.",
+                    "description": "Returns the specified Instance resource. Get a list of available instances by making a list() request.",
                     "httpMethod": "GET",
                     "id": "compute.instances.get",
                     "parameterOrder": [
                         "project",
                         "zone",
                         "instance"
                     ],
                     "parameters": {
                         "instance": {
                             "description": "Name of the instance resource to return.",
@@ skipping 108 matching lines @@
                     },
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "list": {
-                    "description": "Retrieves the list of instance resources contained within the specified zone.",
+                    "description": "Retrieves the list of instances contained within the specified zone.",
                     "httpMethod": "GET",
                     "id": "compute.instances.list",
                     "parameterOrder": [
                         "project",
                         "zone"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 376 matching lines @@
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 }
             }
         },
         "licenses": {
             "methods": {
                 "get": {
-                    "description": "Returns the specified license resource.",
+                    "description": "Returns the specified License resource. Get a list of available licenses by making a list() request.",
                     "httpMethod": "GET",
                     "id": "compute.licenses.get",
                     "parameterOrder": [
                         "project",
                         "license"
                     ],
                     "parameters": {
                         "license": {
-                            "description": "Name of the license resource to return.",
+                            "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": "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"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute",
                         "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 }
             }
         },
         "machineTypes": {
             "methods": {
                 "aggregatedList": {
-                    "description": "Retrieves an aggregated list of machine type resources.",
+                    "description": "Retrieves an aggregated list of machine types.",
                     "httpMethod": "GET",
                     "id": "compute.machineTypes.aggregatedList",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 10 matching lines @@
                     "response": {
                         "$ref": "MachineTypeAggregatedList"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute",
                         "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 },
                 "get": {
-                    "description": "Returns the specified machine type resource.",
+                    "description": "Returns the specified machine type. Get a list of available machine types by making a list() request.",
                     "httpMethod": "GET",
                     "id": "compute.machineTypes.get",
                     "parameterOrder": [
                         "project",
                         "zone",
                         "machineType"
                     ],
                     "parameters": {
                         "machineType": {
-                            "description": "Name of the machine type resource to return.",
+                            "description": "Name of the machine type to return.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "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,
@@ skipping 11 matching lines @@
                     "response": {
                         "$ref": "MachineType"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute",
                         "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 },
                 "list": {
-                    "description": "Retrieves a list of machine type resources available to the specified project.",
+                    "description": "Retrieves a list of machine types available to the specified project.",
                     "httpMethod": "GET",
                     "id": "compute.machineTypes.list",
                     "parameterOrder": [
                         "project",
                         "zone"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 21 matching lines @@
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute",
                         "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 }
             }
         },
         "networks": {
             "methods": {
                 "delete": {
-                    "description": "Deletes the specified network resource.",
+                    "description": "Deletes the specified network.",
                     "httpMethod": "DELETE",
                     "id": "compute.networks.delete",
                     "parameterOrder": [
                         "project",
                         "network"
                     ],
                     "parameters": {
                         "network": {
-                            "description": "Name of the network resource to delete.",
+                            "description": "Name of the network to delete.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "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}/global/networks/{network}",
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "get": {
-                    "description": "Returns the specified network resource.",
+                    "description": "Returns the specified network. Get a list of available networks by making a list() request.",
                     "httpMethod": "GET",
                     "id": "compute.networks.get",
                     "parameterOrder": [
                         "project",
                         "network"
                     ],
                     "parameters": {
                         "network": {
-                            "description": "Name of the network resource to return.",
+                            "description": "Name of the network to return.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "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}/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.",
+                    "description": "Creates a network in the specified project using the data included in the request.",
                     "httpMethod": "POST",
                     "id": "compute.networks.insert",
                     "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}/global/networks",
                     "request": {
                         "$ref": "Network"
                     },
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "list": {
-                    "description": "Retrieves the list of network resources available to the specified project.",
+                    "description": "Retrieves the list of networks available to the specified project.",
                     "httpMethod": "GET",
                     "id": "compute.networks.list",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 14 matching lines @@
                         "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.",
+                    "description": "Returns the specified Project resource.",
                     "httpMethod": "GET",
                     "id": "compute.projects.get",
                     "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])?))",
@@ skipping 148 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"
                         },
                         "region": {
-                            "description": "Name of the region scoping this request.",
+                            "description": "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}/operations/{operation}",
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
@@ skipping 17 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"
                         },
                         "region": {
-                            "description": "Name of the region scoping this request.",
+                            "description": "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}/operations/{operation}",
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute",
                         "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 },
                 "list": {
                     "description": "Retrieves a list of Operation resources contained within the specified region.",
                     "httpMethod": "GET",
                     "id": "compute.regionOperations.list",
                     "parameterOrder": [
                         "project",
                         "region"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "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": "Name of the region scoping this request.",
+                            "description": "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}/operations",
                     "response": {
                         "$ref": "OperationList"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute",
                         "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 }
             }
         },
         "regions": {
             "methods": {
                 "get": {
-                    "description": "Returns the specified region resource.",
+                    "description": "Returns the specified Region resource. Get a list of available regions by making a list() request.",
                     "httpMethod": "GET",
                     "id": "compute.regions.get",
                     "parameterOrder": [
                         "project",
                         "region"
                     ],
                     "parameters": {
                         "project": {
                             "description": "Project ID for this request.",
                             "location": "path",
@@ skipping 21 matching lines @@
                 },
                 "list": {
                     "description": "Retrieves the list of region resources available to the specified project.",
                     "httpMethod": "GET",
                     "id": "compute.regions.list",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 14 matching lines @@
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute",
                         "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 }
             }
         },
         "routes": {
             "methods": {
                 "delete": {
-                    "description": "Deletes the specified route resource.",
+                    "description": "Deletes the specified Route resource.",
                     "httpMethod": "DELETE",
                     "id": "compute.routes.delete",
                     "parameterOrder": [
                         "project",
                         "route"
                     ],
                     "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"
                         },
                         "route": {
-                            "description": "Name of the route resource to delete.",
+                            "description": "Name of the Route resource to delete.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/global/routes/{route}",
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "get": {
-                    "description": "Returns the specified route resource.",
+                    "description": "Returns the specified Route resource. Get a list of available routes by making a list() request.",
                     "httpMethod": "GET",
                     "id": "compute.routes.get",
                     "parameterOrder": [
                         "project",
                         "route"
                     ],
                     "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"
                         },
                         "route": {
-                            "description": "Name of the route resource to return.",
+                            "description": "Name of the Route resource to return.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/global/routes/{route}",
                     "response": {
                         "$ref": "Route"
                     },
                     "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 route resource in the specified project using the data included in the request.",
+                    "description": "Creates a Route resource in the specified project using the data included in the request.",
                     "httpMethod": "POST",
                     "id": "compute.routes.insert",
                     "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}/global/routes",
                     "request": {
                         "$ref": "Route"
                     },
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "list": {
-                    "description": "Retrieves the list of route resources available to the specified project.",
+                    "description": "Retrieves the list of Route resources available to the specified project.",
                     "httpMethod": "GET",
                     "id": "compute.routes.list",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 47 matching lines @@
                     "path": "{project}/global/snapshots/{snapshot}",
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "get": {
-                    "description": "Returns the specified Snapshot resource.",
+                    "description": "Returns the specified Snapshot resource. Get a list of available snapshots by making a list() request.",
                     "httpMethod": "GET",
                     "id": "compute.snapshots.get",
                     "parameterOrder": [
                         "project",
                         "snapshot"
                     ],
                     "parameters": {
                         "project": {
                             "description": "Project ID for this request.",
                             "location": "path",
@@ skipping 21 matching lines @@
                 },
                 "list": {
                     "description": "Retrieves the list of Snapshot resources contained within the specified project.",
                     "httpMethod": "GET",
                     "id": "compute.snapshots.list",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 47 matching lines @@
                     "path": "{project}/global/sslCertificates/{sslCertificate}",
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "get": {
-                    "description": "Returns the specified SslCertificate resource.",
+                    "description": "Returns the specified SslCertificate resource. Get a list of available SSL certificates by making a list() request.",
                     "httpMethod": "GET",
                     "id": "compute.sslCertificates.get",
                     "parameterOrder": [
                         "project",
                         "sslCertificate"
                     ],
                     "parameters": {
                         "project": {
                             "description": "Project ID for this request.",
                             "location": "path",
@@ skipping 49 matching lines @@
                 },
                 "list": {
                     "description": "Retrieves the list of SslCertificate resources available to the specified project.",
                     "httpMethod": "GET",
                     "id": "compute.sslCertificates.list",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 22 matching lines @@
             "methods": {
                 "aggregatedList": {
                     "description": "Retrieves an aggregated list of subnetworks.",
                     "httpMethod": "GET",
                     "id": "compute.subnetworks.aggregatedList",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 51 matching lines @@
                     "path": "{project}/regions/{region}/subnetworks/{subnetwork}",
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "get": {
-                    "description": "Returns the specified subnetwork.",
+                    "description": "Returns the specified subnetwork. Get a list of available subnetworks by making a list() request.",
                     "httpMethod": "GET",
                     "id": "compute.subnetworks.get",
                     "parameterOrder": [
                         "project",
                         "region",
                         "subnetwork"
                     ],
                     "parameters": {
                         "project": {
                             "description": "Project ID for this request.",
@@ skipping 66 matching lines @@
                 "list": {
                     "description": "Retrieves a list of subnetworks available to the specified project.",
                     "httpMethod": "GET",
                     "id": "compute.subnetworks.list",
                     "parameterOrder": [
                         "project",
                         "region"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 54 matching lines @@
                     "path": "{project}/global/targetHttpProxies/{targetHttpProxy}",
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "get": {
-                    "description": "Returns the specified TargetHttpProxy resource.",
+                    "description": "Returns the specified TargetHttpProxy resource. Get a list of available target HTTP proxies by making a list() request.",
                     "httpMethod": "GET",
                     "id": "compute.targetHttpProxies.get",
                     "parameterOrder": [
                         "project",
                         "targetHttpProxy"
                     ],
                     "parameters": {
                         "project": {
                             "description": "Project ID for this request.",
                             "location": "path",
@@ skipping 49 matching lines @@
                 },
                 "list": {
                     "description": "Retrieves the list of TargetHttpProxy resources available to the specified project.",
                     "httpMethod": "GET",
                     "id": "compute.targetHttpProxies.list",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 26 matching lines @@
                     ],
                     "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"
                         },
                         "targetHttpProxy": {
-                            "description": "Name of the TargetHttpProxy resource whose URL map is to be set.",
+                            "description": "Name of the TargetHttpProxy to set a URL map for.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/targetHttpProxies/{targetHttpProxy}/setUrlMap",
                     "request": {
                         "$ref": "UrlMapReference"
                     },
@@ skipping 36 matching lines @@
                     "path": "{project}/global/targetHttpsProxies/{targetHttpsProxy}",
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "get": {
-                    "description": "Returns the specified TargetHttpsProxy resource.",
+                    "description": "Returns the specified TargetHttpsProxy resource. Get a list of available target HTTPS proxies by making a list() request.",
                     "httpMethod": "GET",
                     "id": "compute.targetHttpsProxies.get",
                     "parameterOrder": [
                         "project",
                         "targetHttpsProxy"
                     ],
                     "parameters": {
                         "project": {
                             "description": "Project ID for this request.",
                             "location": "path",
@@ skipping 49 matching lines @@
                 },
                 "list": {
                     "description": "Retrieves the list of TargetHttpsProxy resources available to the specified project.",
                     "httpMethod": "GET",
                     "id": "compute.targetHttpsProxies.list",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 26 matching lines @@
                     ],
                     "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"
                         },
                         "targetHttpsProxy": {
-                            "description": "Name of the TargetHttpsProxy resource whose SSLCertificate is to be set.",
+                            "description": "Name of the TargetHttpsProxy resource to set an SslCertificates resource for.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/targetHttpsProxies/{targetHttpsProxy}/setSslCertificates",
                     "request": {
                         "$ref": "TargetHttpsProxiesSetSslCertificatesRequest"
                     },
@@ skipping 47 matching lines @@
             "methods": {
                 "aggregatedList": {
                     "description": "Retrieves an aggregated list of target instances.",
                     "httpMethod": "GET",
                     "id": "compute.targetInstances.aggregatedList",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 51 matching lines @@
                     "path": "{project}/zones/{zone}/targetInstances/{targetInstance}",
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "get": {
-                    "description": "Returns the specified TargetInstance resource.",
+                    "description": "Returns the specified TargetInstance resource. Get a list of available target instances by making a list() request.",
                     "httpMethod": "GET",
                     "id": "compute.targetInstances.get",
                     "parameterOrder": [
                         "project",
                         "zone",
                         "targetInstance"
                     ],
                     "parameters": {
                         "project": {
                             "description": "Project ID for this request.",
@@ skipping 66 matching lines @@
                 "list": {
                     "description": "Retrieves a list of TargetInstance resources available to the specified project and zone.",
                     "httpMethod": "GET",
                     "id": "compute.targetInstances.list",
                     "parameterOrder": [
                         "project",
                         "zone"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 21 matching lines @@
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute",
                         "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 }
             }
         },
         "targetPools": {
             "methods": {
                 "addHealthCheck": {
-                    "description": "Adds health check URL to targetPool.",
+                    "description": "Adds health check URLs to a target pool.",
                     "httpMethod": "POST",
                     "id": "compute.targetPools.addHealthCheck",
                     "parameterOrder": [
                         "project",
                         "region",
                         "targetPool"
                     ],
                     "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": "Name of the region scoping this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "targetPool": {
-                            "description": "Name of the TargetPool resource to which health_check_url is to be added.",
+                            "description": "Name of the target pool to add a health check to.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/regions/{region}/targetPools/{targetPool}/addHealthCheck",
                     "request": {
                         "$ref": "TargetPoolsAddHealthCheckRequest"
                     },
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "addInstance": {
-                    "description": "Adds instance URL to targetPool.",
+                    "description": "Adds an instance to a target pool.",
                     "httpMethod": "POST",
                     "id": "compute.targetPools.addInstance",
                     "parameterOrder": [
                         "project",
                         "region",
                         "targetPool"
                     ],
                     "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": "Name of the region scoping this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "targetPool": {
-                            "description": "Name of the TargetPool resource to which instance_url is to be added.",
+                            "description": "Name of the TargetPool resource to add instances to.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/regions/{region}/targetPools/{targetPool}/addInstance",
                     "request": {
                         "$ref": "TargetPoolsAddInstanceRequest"
                     },
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "aggregatedList": {
                     "description": "Retrieves an aggregated list of target pools.",
                     "httpMethod": "GET",
                     "id": "compute.targetPools.aggregatedList",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 10 matching lines @@
                     "response": {
                         "$ref": "TargetPoolAggregatedList"
                     },
                     "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 TargetPool resource.",
+                    "description": "Deletes the specified target pool.",
                     "httpMethod": "DELETE",
                     "id": "compute.targetPools.delete",
                     "parameterOrder": [
                         "project",
                         "region",
                         "targetPool"
                     ],
                     "parameters": {
                         "project": {
                             "description": "Project ID for this request.",
@@ skipping 20 matching lines @@
                     "path": "{project}/regions/{region}/targetPools/{targetPool}",
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "get": {
-                    "description": "Returns the specified TargetPool resource.",
+                    "description": "Returns the specified target pool. Get a list of available target pools by making a list() request.",
                     "httpMethod": "GET",
                     "id": "compute.targetPools.get",
                     "parameterOrder": [
                         "project",
                         "region",
                         "targetPool"
                     ],
                     "parameters": {
                         "project": {
                             "description": "Project ID for this request.",
@@ skipping 21 matching lines @@
                     "response": {
                         "$ref": "TargetPool"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute",
                         "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 },
                 "getHealth": {
-                    "description": "Gets the most recent health check results for each IP for the given instance that is referenced by the given TargetPool.",
+                    "description": "Gets the most recent health check results for each IP for the instance that is referenced by the given target pool.",
                     "httpMethod": "POST",
                     "id": "compute.targetPools.getHealth",
                     "parameterOrder": [
                         "project",
                         "region",
                         "targetPool"
                     ],
                     "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": "Name of the region scoping this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
@@ skipping 14 matching lines @@
                     "response": {
                         "$ref": "TargetPoolInstanceHealth"
                     },
                     "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 TargetPool resource in the specified project and region using the data included in the request.",
+                    "description": "Creates a target pool in the specified project and region using the data included in the request.",
                     "httpMethod": "POST",
                     "id": "compute.targetPools.insert",
                     "parameterOrder": [
                         "project",
                         "region"
                     ],
                     "parameters": {
                         "project": {
                             "description": "Project ID for this request.",
                             "location": "path",
@@ skipping 15 matching lines @@
                     },
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "list": {
-                    "description": "Retrieves a list of TargetPool resources available to the specified project and region.",
+                    "description": "Retrieves a list of target pools available to the specified project and region.",
                     "httpMethod": "GET",
                     "id": "compute.targetPools.list",
                     "parameterOrder": [
                         "project",
                         "region"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 17 matching lines @@
                     "response": {
                         "$ref": "TargetPoolList"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute",
                         "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 },
                 "removeHealthCheck": {
-                    "description": "Removes health check URL from targetPool.",
+                    "description": "Removes health check URL from a target pool.",
                     "httpMethod": "POST",
                     "id": "compute.targetPools.removeHealthCheck",
                     "parameterOrder": [
                         "project",
                         "region",
                         "targetPool"
                     ],
                     "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": "Name of the region scoping this request.",
+                            "description": "Name of the region for this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "targetPool": {
-                            "description": "Name of the TargetPool resource to which health_check_url is to be removed.",
+                            "description": "Name of the target pool to remove health checks from.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/regions/{region}/targetPools/{targetPool}/removeHealthCheck",
                     "request": {
                         "$ref": "TargetPoolsRemoveHealthCheckRequest"
                     },
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "removeInstance": {
-                    "description": "Removes instance URL from targetPool.",
+                    "description": "Removes instance URL from a target pool.",
                     "httpMethod": "POST",
                     "id": "compute.targetPools.removeInstance",
                     "parameterOrder": [
                         "project",
                         "region",
                         "targetPool"
                     ],
                     "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": "Name of the region scoping this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "targetPool": {
-                            "description": "Name of the TargetPool resource to which instance_url is to be removed.",
+                            "description": "Name of the TargetPool resource to remove instances from.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/regions/{region}/targetPools/{targetPool}/removeInstance",
                     "request": {
                         "$ref": "TargetPoolsRemoveInstanceRequest"
                     },
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "setBackup": {
-                    "description": "Changes backup pool configurations.",
+                    "description": "Changes a backup target pool's configurations.",
                     "httpMethod": "POST",
                     "id": "compute.targetPools.setBackup",
                     "parameterOrder": [
                         "project",
                         "region",
                         "targetPool"
                     ],
                     "parameters": {
                         "failoverRatio": {
-                            "description": "New failoverRatio value for the containing target pool.",
+                            "description": "New failoverRatio value for the target pool.",
                             "format": "float",
                             "location": "query",
                             "type": "number"
                         },
                         "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": "Name of the region scoping this request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         },
                         "targetPool": {
-                            "description": "Name of the TargetPool resource for which the backup is to be set.",
+                            "description": "Name of the TargetPool resource to set a backup pool for.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/regions/{region}/targetPools/{targetPool}/setBackup",
                     "request": {
                         "$ref": "TargetReference"
                     },
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 }
             }
         },
         "targetVpnGateways": {
             "methods": {
                 "aggregatedList": {
-                    "description": "Retrieves an aggregated list of target VPN gateways .",
+                    "description": "Retrieves an aggregated list of target VPN gateways.",
                     "httpMethod": "GET",
                     "id": "compute.targetVpnGateways.aggregatedList",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 10 matching lines @@
                     "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.",
+                    "description": "Deletes the specified target VPN gateway.",
                     "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.",
+                            "description": "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.",
+                            "description": "Name of the target VPN gateway 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.",
+                    "description": "Returns the specified target VPN gateway. Get a list of available target VPN gateways by making a list() request.",
                     "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.",
+                            "description": "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.",
+                            "description": "Name of the target VPN gateway 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.",
+                    "description": "Creates a target VPN gateway 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.",
+                            "description": "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 a list of TargetVpnGateway resources available to the specified project and region.",
+                    "description": "Retrieves a list of target VPN gateways available to the specified project and region.",
                     "httpMethod": "GET",
                     "id": "compute.targetVpnGateways.list",
                     "parameterOrder": [
                         "project",
                         "region"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "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.",
+                            "description": "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"
                     },
@@ skipping 34 matching lines @@
                     "path": "{project}/global/urlMaps/{urlMap}",
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "get": {
-                    "description": "Returns the specified UrlMap resource.",
+                    "description": "Returns the specified UrlMap resource. Get a list of available URL maps by making a list() request.",
                     "httpMethod": "GET",
                     "id": "compute.urlMaps.get",
                     "parameterOrder": [
                         "project",
                         "urlMap"
                     ],
                     "parameters": {
                         "project": {
                             "description": "Project ID for this request.",
                             "location": "path",
@@ skipping 49 matching lines @@
                 },
                 "list": {
                     "description": "Retrieves the list of UrlMap resources available to the specified project.",
                     "httpMethod": "GET",
                     "id": "compute.urlMaps.list",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 130 matching lines @@
             "methods": {
                 "aggregatedList": {
                     "description": "Retrieves an aggregated list of VPN tunnels.",
                     "httpMethod": "GET",
                     "id": "compute.vpnTunnels.aggregatedList",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 27 matching lines @@
                     ],
                     "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.",
+                            "description": "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}/regions/{region}/vpnTunnels/{vpnTunnel}",
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "get": {
-                    "description": "Returns the specified VpnTunnel resource.",
+                    "description": "Returns the specified VpnTunnel resource. Get a list of available VPN tunnels by making a list() request.",
                     "httpMethod": "GET",
                     "id": "compute.vpnTunnels.get",
                     "parameterOrder": [
                         "project",
                         "region",
                         "vpnTunnel"
                     ],
                     "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.",
+                            "description": "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,
@@ skipping 20 matching lines @@
                     ],
                     "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.",
+                            "description": "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": "VpnTunnel"
                     },
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
                     ]
                 },
                 "list": {
                     "description": "Retrieves a list of VpnTunnel resources contained in the specified project and region.",
                     "httpMethod": "GET",
                     "id": "compute.vpnTunnels.list",
                     "parameterOrder": [
                         "project",
                         "region"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "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.",
+                            "description": "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",
                     "response": {
                         "$ref": "VpnTunnelList"
                     },
@@ skipping 25 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": "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}/operations/{operation}",
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute"
@@ skipping 17 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": "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}/operations/{operation}",
                     "response": {
                         "$ref": "Operation"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute",
                         "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 },
                 "list": {
                     "description": "Retrieves a list of Operation resources contained within the specified zone.",
                     "httpMethod": "GET",
                     "id": "compute.zoneOperations.list",
                     "parameterOrder": [
                         "project",
                         "zone"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "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"
                         },
                         "zone": {
-                            "description": "Name of the zone scoping this request.",
+                            "description": "Name of the zone for request.",
                             "location": "path",
                             "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{project}/zones/{zone}/operations",
                     "response": {
                         "$ref": "OperationList"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute",
                         "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 }
             }
         },
         "zones": {
             "methods": {
                 "get": {
-                    "description": "Returns the specified zone resource.",
+                    "description": "Returns the specified Zone resource. Get a list of available zones by making a list() request.",
                     "httpMethod": "GET",
                     "id": "compute.zones.get",
                     "parameterOrder": [
                         "project",
                         "zone"
                     ],
                     "parameters": {
                         "project": {
                             "description": "Project ID for this request.",
                             "location": "path",
@@ skipping 13 matching lines @@
                     "response": {
                         "$ref": "Zone"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute",
                         "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 },
                 "list": {
-                    "description": "Retrieves the list of zone resources available to the specified project.",
+                    "description": "Retrieves the list of Zone resources available to the specified project.",
                     "httpMethod": "GET",
                     "id": "compute.zones.list",
                     "parameterOrder": [
                         "project"
                     ],
                     "parameters": {
                         "filter": {
-                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions meaning that resources must match all expressions to pass the filters.",
+                            "description": "Sets a filter expression for filtering listed resources, in the form filter={expression}. Your {expression} must be in the format: field_name comparison_string literal_string.\n\nThe field_name is the name of the field you want to compare. Only atomic field types are supported (string, number, boolean). The comparison_string must be either eq (equals) or ne (not equals). The literal_string is the string value to filter to. The literal value must be valid for the type of field you are filtering by (string, number, boolean). For string fields, the literal value is interpreted as a regular expression using RE2 syntax. The literal value must match the entire field.\n\nFor example, to filter for instances that do not have a name of example-instance, you would use filter=name ne example-instance.\n\nCompute Engine Beta API Only: If you use filtering in the Beta API, you can also filter on nested fields. For example, you could filter on instances that have set the scheduling.automaticRestart field to true. In particular, use filtering on nested fields to take advantage of instance labels to organize and filter results based on label values.\n\nThe Beta API also supports filtering on multiple expressions by providing each separate expression within parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us-central1-f). Multiple expressions are treated as AND expressions, meaning that resources must match all expressions to pass the filters.",
                             "location": "query",
                             "type": "string"
                         },
                         "maxResults": {
                             "default": "500",
-                            "description": "The maximum number of results per page that Compute Engine should return. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
+                            "description": "The maximum number of results per page that should be returned. If the number of available results is larger than maxResults, Compute Engine returns a nextPageToken that can be used to get the next page of results in subsequent list requests.",
                             "format": "uint32",
                             "location": "query",
                             "maximum": "500",
                             "minimum": "0",
                             "type": "integer"
                         },
                         "pageToken": {
                             "description": "Specifies a page token to use. Set pageToken to the nextPageToken returned by a previous list request to get the next page of results.",
                             "location": "query",
                             "type": "string"
@@ skipping 12 matching lines @@
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute",
                         "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 }
             }
         }
     },
-    "revision": "20160120",
+    "revision": "20160302",
     "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": "[Output Only] Type of the resource. Always compute#accessConfig for access configs.",
                     "type": "string"
@@ skipping 45 matching lines @@
                     "default": "compute#address",
                     "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. 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.",
+                    "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": "[Output Only] URL of the region where the regional address resides. This field is not applicable to global addresses.",
                     "type": "string"
                 },
                 "selfLink": {
                     "description": "[Output Only] Server-defined URL for the resource.",
                     "type": "string"
@@ skipping 45 matching lines @@
                     "type": "string"
                 },
                 "selfLink": {
                     "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "AddressList": {
-            "description": "Contains a list of address resources.",
+            "description": "Contains a list of addresses.",
             "id": "AddressList",
             "properties": {
                 "id": {
                     "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.",
                     "type": "string"
                 },
                 "items": {
-                    "description": "[Output Only] A list of Address resources.",
+                    "description": "[Output Only] A list of addresses.",
                     "items": {
                         "$ref": "Address"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "compute#addressList",
                     "description": "[Output Only] Type of resource. Always compute#addressList for lists of addresses.",
                     "type": "string"
                 },
@@ skipping 17 matching lines @@
                         "$ref": "Address"
                     },
                     "type": "array"
                 },
                 "warning": {
                     "description": "[Output Only] Informational warning which replaces the list of addresses when the list is empty.",
                     "properties": {
                         "code": {
                             "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.",
                             "enum": [
+                                "CLEANUP_FAILED",
                                 "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",
                                 "NOT_CRITICAL_ERROR",
                                 "NO_RESULTS_ON_PAGE",
                                 "REQUIRED_TOS_AGREEMENT",
                                 "RESOURCE_NOT_DELETED",
                                 "SINGLE_INSTANCE_PROPERTY_TEMPLATE",
                                 "UNREACHABLE"
                             ],
                             "enumDescriptions": [
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
+                                "",
                                 ""
                             ],
                             "type": "string"
                         },
                         "data": {
                             "description": "[Output Only] Metadata about this warning in key: value format. For example:\n\"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" }",
                             "items": {
                                 "properties": {
                                     "key": {
-                                        "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource, and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).",
+                                        "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).",
                                         "type": "string"
                                     },
                                     "value": {
                                         "description": "[Output Only] A warning data value corresponding to the key.",
                                         "type": "string"
                                     }
                                 },
                                 "type": "object"
                             },
                             "type": "array"
@@ skipping 27 matching lines @@
                 "index": {
                     "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": "[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": {
-                    "description": "Specifies the disk interface to use for attaching this disk, either SCSI or NVME. The default is SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.",
+                    "description": "Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and the request will fail if you attempt to attach a persistent disk in any other format than SCSI. Local SSDs can use either NVME or SCSI. For performance characteristics of SCSI over NVMe, see Local SSD performance.",
                     "enum": [
                         "NVME",
                         "SCSI"
                     ],
                     "enumDescriptions": [
                         "",
                         ""
                     ],
                     "type": "string"
                 },
@@ skipping 63 matching lines @@
                     "type": "string"
                 },
                 "sourceImage": {
                     "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"
         },
         "Autoscaler": {
+            "description": "Represents an Autoscaler resource. Autoscalers allow you to automatically scale virtual machine instances in managed instance groups according to an autoscaling policy that you define. For more information, read Autoscaling Groups of Instances.",
             "id": "Autoscaler",
             "properties": {
                 "autoscalingPolicy": {
                     "$ref": "AutoscalingPolicy",
-                    "description": "Autoscaling configuration."
+                    "description": "The configuration parameters for the autoscaling algorithm. You can define one or more of the policies for an autoscaler: cpuUtilization, customMetricUtilizations, and loadBalancingUtilization.\n\nIf none of these are specified, the default will be to autoscale based on cpuUtilization to 0.8 or 80%."
                 },
                 "creationTimestamp": {
                     "description": "[Output Only] Creation timestamp in RFC3339 text format.",
                     "type": "string"
                 },
                 "description": {
                     "description": "An optional description of this resource. Provide this property when you create the resource.",
                     "type": "string"
                 },
                 "id": {
                     "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.",
                     "format": "uint64",
                     "type": "string"
                 },
                 "kind": {
                     "default": "compute#autoscaler",
-                    "description": "Type of the resource.",
+                    "description": "[Output Only] Type of the resource. Always compute#autoscaler for autoscalers.",
                     "type": "string"
                 },
                 "name": {
                     "annotations": {
                         "required": [
                             "compute.instanceGroups.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. 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": "[Output Only] Server-defined URL for the resource.",
                     "type": "string"
                 },
                 "target": {
-                    "description": "URL of Instance Group Manager or Replica Pool which will be controlled by Autoscaler.",
+                    "description": "URL of the managed instance group that this autoscaler will scale.",
                     "type": "string"
                 },
                 "zone": {
                     "description": "[Output Only] URL of the zone where the instance group resides.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "AutoscalerAggregatedList": {
             "id": "AutoscalerAggregatedList",
             "properties": {
                 "id": {
                     "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.",
                     "type": "string"
                 },
                 "items": {
                     "additionalProperties": {
                         "$ref": "AutoscalersScopedList",
-                        "description": "Name of the scope containing this set of autoscalers."
+                        "description": "[Output Only] Name of the scope containing this set of autoscalers."
                     },
                     "description": "A map of scoped autoscaler lists.",
                     "type": "object"
                 },
                 "kind": {
                     "default": "compute#autoscalerAggregatedList",
-                    "description": "Type of resource.",
+                    "description": "[Output Only] Type of resource. Always compute#autoscalerAggregatedList for aggregated lists of autoscalers.",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.",
                     "type": "string"
                 },
                 "selfLink": {
                     "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "AutoscalerList": {
-            "description": "Contains a list of persistent autoscaler resources.",
+            "description": "Contains a list of Autoscaler resources.",
             "id": "AutoscalerList",
             "properties": {
                 "id": {
                     "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.",
                     "type": "string"
                 },
                 "items": {
                     "description": "A list of Autoscaler resources.",
                     "items": {
                         "$ref": "Autoscaler"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "compute#autoscalerList",
-                    "description": "Type of resource.",
+                    "description": "[Output Only] Type of resource. Always compute#autoscalerList for lists of autoscalers.",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.",
                     "type": "string"
                 },
                 "selfLink": {
                     "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "AutoscalersScopedList": {
             "id": "AutoscalersScopedList",
             "properties": {
                 "autoscalers": {
-                    "description": "List of autoscalers contained in this scope.",
+                    "description": "[Output Only] List of autoscalers contained in this scope.",
                     "items": {
                         "$ref": "Autoscaler"
                     },
                     "type": "array"
                 },
                 "warning": {
-                    "description": "Informational warning which replaces the list of autoscalers when the list is empty.",
+                    "description": "[Output Only] Informational warning which replaces the list of autoscalers when the list is empty.",
                     "properties": {
                         "code": {
                             "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.",
                             "enum": [
+                                "CLEANUP_FAILED",
                                 "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",
                                 "NOT_CRITICAL_ERROR",
                                 "NO_RESULTS_ON_PAGE",
                                 "REQUIRED_TOS_AGREEMENT",
                                 "RESOURCE_NOT_DELETED",
                                 "SINGLE_INSTANCE_PROPERTY_TEMPLATE",
                                 "UNREACHABLE"
                             ],
                             "enumDescriptions": [
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
+                                "",
                                 ""
                             ],
                             "type": "string"
                         },
                         "data": {
                             "description": "[Output Only] Metadata about this warning in key: value format. For example:\n\"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" }",
                             "items": {
                                 "properties": {
                                     "key": {
-                                        "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource, and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).",
+                                        "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).",
                                         "type": "string"
                                     },
                                     "value": {
                                         "description": "[Output Only] A warning data value corresponding to the key.",
                                         "type": "string"
                                     }
                                 },
                                 "type": "object"
                             },
                             "type": "array"
                         },
                         "message": {
                             "description": "[Output Only] A human-readable description of the warning code.",
                             "type": "string"
                         }
                     },
                     "type": "object"
                 }
             },
             "type": "object"
         },
         "AutoscalingPolicy": {
             "description": "Cloud Autoscaler policy.",
             "id": "AutoscalingPolicy",
             "properties": {
                 "coolDownPeriodSec": {
-                    "description": "The number of seconds that the Autoscaler should wait between two succeeding changes to the number of virtual machines. You should define an interval that is at least as long as the initialization time of a virtual machine and the time it may take for replica pool to create the virtual machine. The default is 60 seconds.",
+                    "description": "The number of seconds that the autoscaler should wait before it starts collecting information from a new instance. This prevents the autoscaler from collecting information when the instance is initializing, during which the collected usage would not be reliable. The default time autoscaler waits is 60 seconds.\n\nVirtual machine initialization times might vary because of numerous factors. We recommend that you test how long an instance may take to initialize. To do this, create an instance and time the startup process.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "cpuUtilization": {
                     "$ref": "AutoscalingPolicyCpuUtilization",
-                    "description": "TODO(jbartosik): Add support for scaling based on muliple utilization metrics (take max recommendation). Exactly one utilization policy should be provided. Configuration parameters of CPU based autoscaling policy."
+                    "description": "Defines the CPU utilization policy that allows the autoscaler to scale based on the average CPU utilization of a managed instance group."
                 },
                 "customMetricUtilizations": {
-                    "description": "Configuration parameters of autoscaling based on custom metric.",
+                    "description": "Configuration parameters of autoscaling based on a custom metric.",
                     "items": {
                         "$ref": "AutoscalingPolicyCustomMetricUtilization"
                     },
                     "type": "array"
                 },
                 "loadBalancingUtilization": {
                     "$ref": "AutoscalingPolicyLoadBalancingUtilization",
                     "description": "Configuration parameters of autoscaling based on load balancer."
                 },
                 "maxNumReplicas": {
-                    "description": "The maximum number of replicas that the Autoscaler can scale up to. This field is required for config to be effective. Maximum number of replicas should be not lower than minimal number of replicas. Absolute limit for this value is defined in Autoscaler backend.",
+                    "description": "The maximum number of instances that the autoscaler can scale up to. This is required when creating or updating an autoscaler. The maximum number of replicas should not be lower than minimal number of replicas.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "minNumReplicas": {
-                    "description": "The minimum number of replicas that the Autoscaler can scale down to. Can't be less than 0. If not provided Autoscaler will choose default value depending on maximal number of replicas.",
+                    "description": "The minimum number of replicas that the autoscaler can scale down to. This cannot be less than 0. If not provided, autoscaler will choose a default value depending on maximum number of instances allowed.",
                     "format": "int32",
                     "type": "integer"
                 }
             },
             "type": "object"
         },
         "AutoscalingPolicyCpuUtilization": {
             "description": "CPU utilization policy.",
             "id": "AutoscalingPolicyCpuUtilization",
             "properties": {
                 "utilizationTarget": {
-                    "description": "The target utilization that the Autoscaler should maintain. It is represented as a fraction of used cores. For example: 6 cores used in 8-core VM are represented here as 0.75. Must be a float value between (0, 1]. If not defined, the default is 0.8.",
+                    "description": "The target CPU utilization that the autoscaler should maintain. Must be a float value in the range (0, 1]. If not specified, the default is 0.8.\n\nIf the CPU level is below the target utilization, the autoscaler scales down the number of instances until it reaches the minimum number of instances you specified or until the average CPU of your instances reaches the target utilization.\n\nIf the average CPU is above the target utilization, the autoscaler scales up until it reaches the maximum number of instances you specified or until the average utilization reaches the target utilization.",
                     "format": "double",
                     "type": "number"
                 }
             },
             "type": "object"
         },
         "AutoscalingPolicyCustomMetricUtilization": {
             "description": "Custom utilization metric policy.",
             "id": "AutoscalingPolicyCustomMetricUtilization",
             "properties": {
                 "metric": {
-                    "description": "Identifier of the metric. It should be a Cloud Monitoring metric. The metric can not have negative values. The metric should be an utilization metric (increasing number of VMs handling requests x times should reduce average value of the metric roughly x times). For example you could use: compute.googleapis.com/instance/network/received_bytes_count.",
+                    "description": "The identifier of the Cloud Monitoring metric. The metric cannot have negative values and should be a utilization metric, which means that the number of virtual machines handling requests should increase or decrease proportionally to the metric. The metric must also have a label of compute.googleapis.com/resource_id with the value of the instance's unique ID, although this alone does not guarantee that the metric is valid.\n\nFor example, the following is a valid metric:\ncompute.googleapis.com/instance/network/received_bytes_count\n\n\nThe following is not a valid metric because it does not increase or decrease based on usage:\ncompute.googleapis.com/instance/cpu/reserved_cores",
                     "type": "string"
                 },
                 "utilizationTarget": {
-                    "description": "Target value of the metric which Autoscaler should maintain. Must be a positive value.",
+                    "description": "Target value of the metric which autoscaler should maintain. Must be a positive value.",
                     "format": "double",
                     "type": "number"
                 },
                 "utilizationTargetType": {
-                    "description": "Defines type in which utilization_target is expressed.",
+                    "description": "Defines how target utilization value is expressed for a Cloud Monitoring metric. Either GAUGE, DELTA_PER_SECOND, or DELTA_PER_MINUTE. If not specified, the default is GAUGE.",
                     "enum": [
                         "DELTA_PER_MINUTE",
                         "DELTA_PER_SECOND",
                         "GAUGE"
                     ],
                     "enumDescriptions": [
                         "",
                         "",
                         ""
                     ],
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "AutoscalingPolicyLoadBalancingUtilization": {
-            "description": "Load balancing utilization policy.",
+            "description": "Configuration parameters of autoscaling based on load balancing.",
             "id": "AutoscalingPolicyLoadBalancingUtilization",
             "properties": {
                 "utilizationTarget": {
-                    "description": "Fraction of backend capacity utilization (set in HTTP load balancing configuration) that Autoscaler should maintain. Must be a positive float value. If not defined, the default is 0.8. For example if your maxRatePerInstance capacity (in HTTP Load Balancing configuration) is set at 10 and you would like to keep number of instances such that each instance receives 7 QPS on average, set this to 0.7.",
+                    "description": "Fraction of backend capacity utilization (set in HTTP(s) load balancing configuration) that autoscaler should maintain. Must be a positive float value. If not defined, the default is 0.8.",
                     "format": "double",
                     "type": "number"
                 }
             },
             "type": "object"
         },
         "Backend": {
             "description": "Message containing information of one individual backend.",
             "id": "Backend",
             "properties": {
                 "balancingMode": {
-                    "description": "Specifies the balancing mode for this backend. The default is UTILIZATION but available values are UTILIZATION and RATE.",
+                    "description": "Specifies the balancing mode for this backend. For global HTTP(S) load balancing, the default is UTILIZATION. Valid values are UTILIZATION and RATE.",
                     "enum": [
                         "RATE",
                         "UTILIZATION"
                     ],
                     "enumDescriptions": [
                         "",
                         ""
                     ],
                     "type": "string"
                 },
                 "capacityScaler": {
                     "description": "A multiplier applied to the group's maximum servicing capacity (either UTILIZATION or RATE). Default value is 1, which means the group will serve up to 100% of its configured CPU or RPS (depending on balancingMode). A setting of 0 means the group is completely drained, offering 0% of its available CPU or RPS. Valid range is [0.0,1.0].",
                     "format": "float",
                     "type": "number"
                 },
                 "description": {
                     "description": "An optional description of this resource. Provide this property when you create the resource.",
                     "type": "string"
                 },
                 "group": {
                     "description": "The fully-qualified URL of a zonal Instance Group resource. This instance group defines the list of instances that serve traffic. Member virtual machine instances from each instance group must live in the same zone as the instance group itself. No two backends in a backend service are allowed to use same Instance Group resource.\n\nNote that you must specify an Instance Group resource using the fully-qualified URL, rather than a partial URL.",
                     "type": "string"
                 },
                 "maxRate": {
-                    "description": "The max requests per second (RPS) of the group. Can be used with either balancing mode, but required if RATE mode. For RATE mode, either maxRate or maxRatePerInstance must be set.",
+                    "description": "The max requests per second (RPS) of the group. Can be used with either RATE or UTILIZATION balancing modes, but required if RATE mode. For RATE mode, either maxRate or maxRatePerInstance must be set.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "maxRatePerInstance": {
-                    "description": "The max requests per second (RPS) that a single backed instance can handle. This is used to calculate the capacity of the group. Can be used in either balancing mode. For RATE mode, either maxRate or maxRatePerInstance must be set.",
+                    "description": "The max requests per second (RPS) that a single backend instance can handle.This is used to calculate the capacity of the group. Can be used in either balancing mode. For RATE mode, either maxRate or maxRatePerInstance must be set.",
                     "format": "float",
                     "type": "number"
                 },
                 "maxUtilization": {
                     "description": "Used when balancingMode is UTILIZATION. This ratio defines the CPU utilization target for the group. The default is 0.8. Valid range is [0.0, 1.0].",
                     "format": "float",
                     "type": "number"
                 }
             },
             "type": "object"
@@ skipping 43 matching lines @@
                     "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"
                 },
                 "port": {
                     "description": "Deprecated in favor of portName. The TCP port to connect on the backend. The default value is 80.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "portName": {
-                    "description": "Name of backend port. The same name should appear in the resource views referenced by this service. Required.",
+                    "description": "Name of backend port. The same name should appear in the instance groups referenced by this service. Required.",
                     "type": "string"
                 },
                 "protocol": {
+                    "description": "The protocol this BackendService uses to communicate with backends.\n\nPossible values are HTTP, HTTPS, HTTP2, TCP and SSL.",
                     "enum": [
                         "HTTP",
                         "HTTPS"
                     ],
                     "enumDescriptions": [
                         "",
                         ""
                     ],
                     "type": "string"
                 },
                 "selfLink": {
                     "description": "[Output Only] Server-defined URL for the resource.",
                     "type": "string"
                 },
                 "timeoutSec": {
-                    "description": "How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds. Valid range is [1, 86400].",
+                    "description": "How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds.",
                     "format": "int32",
                     "type": "integer"
                 }
             },
             "type": "object"
         },
         "BackendServiceGroupHealth": {
             "id": "BackendServiceGroupHealth",
             "properties": {
                 "healthStatus": {
@@ skipping 102 matching lines @@
                 },
                 "lastAttachTimestamp": {
                     "description": "[Output Only] Last attach timestamp in RFC3339 text format.",
                     "type": "string"
                 },
                 "lastDetachTimestamp": {
                     "description": "[Output Only] Last detach timestamp in RFC3339 text format.",
                     "type": "string"
                 },
                 "licenses": {
-                    "description": "Any applicable publicly visible licenses.",
+                    "description": "[Output Only] 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. 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.",
+                    "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": "[Output Only] Server-defined fully-qualified URL for this resource.",
                     "type": "string"
                 },
                 "sizeGb": {
                     "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. 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.",
+                    "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.\n\nYou can also specify the latest image for a private image family by replacing the image name suffix with family/family-name. For example:\n\nglobal/images/family/my-private-family \n\nOr you can specify an image family from a publicly-available project. For example, to use the latest Debian 7 from the debian-cloud project, make sure to include the project in the URL:\n\nprojects/debian-cloud/global/images/family/debian-7",
                     "type": "string"
                 },
                 "sourceImageId": {
-                    "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.",
+                    "description": "[Output Only] 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. 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": "[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": "[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.",
+                    "description": "URL of the disk type resource describing which disk type to use to create the disk. Provide this when creating the disk.",
                     "type": "string"
                 },
                 "users": {
-                    "description": "Links to the users of the disk (attached instances) in form: project/zones/zone/instances/instance",
+                    "description": "[Output Only] Links to the users of the disk (attached instances) in form: project/zones/zone/instances/instance",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "zone": {
                     "description": "[Output Only] URL of the zone where the disk resides.",
                     "type": "string"
                 }
             },
@@ skipping 58 matching lines @@
                     "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",
+                    "description": "The URL of the destination zone to move the disk. 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.",
+            "description": "A DiskType resource.",
             "id": "DiskType",
             "properties": {
                 "creationTimestamp": {
                     "description": "[Output Only] Creation timestamp in RFC3339 text format.",
                     "type": "string"
                 },
                 "defaultDiskSizeGb": {
                     "description": "[Output Only] Server-defined default disk size in GB.",
                     "format": "int64",
                     "type": "string"
@@ skipping 61 matching lines @@
                     "type": "string"
                 },
                 "selfLink": {
                     "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "DiskTypeList": {
-            "description": "Contains a list of disk type resources.",
+            "description": "Contains a list of disk types.",
             "id": "DiskTypeList",
             "properties": {
                 "id": {
                     "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.",
                     "type": "string"
                 },
                 "items": {
                     "description": "[Output Only] A list of Disk Type resources.",
                     "items": {
                         "$ref": "DiskType"
@@ skipping 25 matching lines @@
                         "$ref": "DiskType"
                     },
                     "type": "array"
                 },
                 "warning": {
                     "description": "[Output Only] Informational warning which replaces the list of disk types when the list is empty.",
                     "properties": {
                         "code": {
                             "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.",
                             "enum": [
+                                "CLEANUP_FAILED",
                                 "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",
                                 "NOT_CRITICAL_ERROR",
                                 "NO_RESULTS_ON_PAGE",
                                 "REQUIRED_TOS_AGREEMENT",
                                 "RESOURCE_NOT_DELETED",
                                 "SINGLE_INSTANCE_PROPERTY_TEMPLATE",
                                 "UNREACHABLE"
                             ],
                             "enumDescriptions": [
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
+                                "",
                                 ""
                             ],
                             "type": "string"
                         },
                         "data": {
                             "description": "[Output Only] Metadata about this warning in key: value format. For example:\n\"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" }",
                             "items": {
                                 "properties": {
                                     "key": {
-                                        "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource, and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).",
+                                        "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).",
                                         "type": "string"
                                     },
                                     "value": {
                                         "description": "[Output Only] A warning data value corresponding to the key.",
                                         "type": "string"
                                     }
                                 },
                                 "type": "object"
                             },
                             "type": "array"
@@ skipping 17 matching lines @@
                         "$ref": "Disk"
                     },
                     "type": "array"
                 },
                 "warning": {
                     "description": "[Output Only] Informational warning which replaces the list of disks when the list is empty.",
                     "properties": {
                         "code": {
                             "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.",
                             "enum": [
+                                "CLEANUP_FAILED",
                                 "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",
                                 "NOT_CRITICAL_ERROR",
                                 "NO_RESULTS_ON_PAGE",
                                 "REQUIRED_TOS_AGREEMENT",
                                 "RESOURCE_NOT_DELETED",
                                 "SINGLE_INSTANCE_PROPERTY_TEMPLATE",
                                 "UNREACHABLE"
                             ],
                             "enumDescriptions": [
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
+                                "",
                                 ""
                             ],
                             "type": "string"
                         },
                         "data": {
                             "description": "[Output Only] Metadata about this warning in key: value format. For example:\n\"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" }",
                             "items": {
                                 "properties": {
                                     "key": {
-                                        "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource, and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).",
+                                        "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).",
                                         "type": "string"
                                     },
                                     "value": {
                                         "description": "[Output Only] A warning data value corresponding to the key.",
                                         "type": "string"
                                     }
                                 },
                                 "type": "object"
                             },
                             "type": "array"
                         },
                         "message": {
                             "description": "[Output Only] A human-readable description of the warning code.",
                             "type": "string"
                         }
                     },
                     "type": "object"
                 }
             },
             "type": "object"
         },
         "Firewall": {
-            "description": "A Firewall resource.",
+            "description": "Represents 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": "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.",
+                                "description": "The IP protocol that is allowed for this rule. The protocol type is required when creating a firewall rule. 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. 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"
                             }
                         },
@@ skipping 56 matching lines @@
                     "description": "A list of instance tags indicating sets of instances located in the network that 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 firewalls.",
             "id": "FirewallList",
             "properties": {
                 "id": {
                     "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.",
                     "type": "string"
                 },
                 "items": {
                     "description": "[Output Only] A list of Firewall resources.",
                     "items": {
                         "$ref": "Firewall"
@@ skipping 94 matching lines @@
                 "items": {
                     "additionalProperties": {
                         "$ref": "ForwardingRulesScopedList",
                         "description": "Name of the scope containing this set of addresses."
                     },
                     "description": "A map of scoped forwarding rule lists.",
                     "type": "object"
                 },
                 "kind": {
                     "default": "compute#forwardingRuleAggregatedList",
-                    "description": "Type of resource.",
+                    "description": "[Output Only] Type of resource. Always compute#forwardingRuleAggregatedList for lists of forwarding rules.",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.",
                     "type": "string"
                 },
                 "selfLink": {
                     "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
@@ skipping 40 matching lines @@
                         "$ref": "ForwardingRule"
                     },
                     "type": "array"
                 },
                 "warning": {
                     "description": "Informational warning which replaces the list of forwarding rules when the list is empty.",
                     "properties": {
                         "code": {
                             "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.",
                             "enum": [
+                                "CLEANUP_FAILED",
                                 "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",
                                 "NOT_CRITICAL_ERROR",
                                 "NO_RESULTS_ON_PAGE",
                                 "REQUIRED_TOS_AGREEMENT",
                                 "RESOURCE_NOT_DELETED",
                                 "SINGLE_INSTANCE_PROPERTY_TEMPLATE",
                                 "UNREACHABLE"
                             ],
                             "enumDescriptions": [
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
+                                "",
                                 ""
                             ],
                             "type": "string"
                         },
                         "data": {
                             "description": "[Output Only] Metadata about this warning in key: value format. For example:\n\"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" }",
                             "items": {
                                 "properties": {
                                     "key": {
-                                        "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource, and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).",
+                                        "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).",
                                         "type": "string"
                                     },
                                     "value": {
                                         "description": "[Output Only] A warning data value corresponding to the key.",
                                         "type": "string"
                                     }
                                 },
                                 "type": "object"
                             },
                             "type": "array"
                         },
                         "message": {
                             "description": "[Output Only] A human-readable description of the warning code.",
                             "type": "string"
                         }
                     },
                     "type": "object"
                 }
             },
             "type": "object"
         },
         "HealthCheckReference": {
+            "description": "A full or valid partial URL to a health check. For example, the following are valid URLs:  \n- https://www.googleapis.com/compute/beta/projects/project-id/global/httpHealthChecks/health-check \n- projects/project-id/global/httpHealthChecks/health-check \n- global/httpHealthChecks/health-check",
             "id": "HealthCheckReference",
             "properties": {
                 "healthCheck": {
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "HealthStatus": {
             "id": "HealthStatus",
@@ skipping 74 matching lines @@
                     "description": "The value of the host header in the HTTP health check request. If left empty (default value), the public IP on behalf of which this health check is performed will be used.",
                     "type": "string"
                 },
                 "id": {
                     "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.",
                     "format": "uint64",
                     "type": "string"
                 },
                 "kind": {
                     "default": "compute#httpHealthCheck",
-                    "description": "Type of the resource.",
+                    "description": "[Output Only] Type of the resource. Always compute#httpHealthCheck for HTTP health checks.",
                     "type": "string"
                 },
                 "name": {
                     "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"
                 },
                 "port": {
                     "description": "The TCP port number for the HTTP health check request. The default value is 80.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "requestPath": {
-                    "description": "The request path of the HTTP health check request. The default value is \"/\".",
+                    "description": "The request path of the HTTP health check request. The default value is /.",
                     "type": "string"
                 },
                 "selfLink": {
                     "description": "[Output Only] Server-defined URL for the resource.",
                     "type": "string"
                 },
                 "timeoutSec": {
                     "description": "How long (in seconds) to wait before claiming failure. The default value is 5 seconds. It is invalid for timeoutSec to have greater value than checkIntervalSec.",
                     "format": "int32",
                     "type": "integer"
@@ skipping 252 matching lines @@
                         "",
                         "",
                         ""
                     ],
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "ImageList": {
-            "description": "Contains a list of Image resources.",
+            "description": "Contains a list of images.",
             "id": "ImageList",
             "properties": {
                 "id": {
                     "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.",
                     "type": "string"
                 },
                 "items": {
                     "description": "[Output Only] A list of Image resources.",
                     "items": {
                         "$ref": "Image"
@@ skipping 52 matching lines @@
                     "default": "compute#instance",
                     "description": "[Output Only] Type of the resource. Always compute#instance for instances.",
                     "type": "string"
                 },
                 "machineType": {
                     "annotations": {
                         "required": [
                             "compute.instances.insert"
                         ]
                     },
-                    "description": "Full or partial URL of the machine type resource to use for this instance, in the format: zones/zone/machineTypes/ machine-type. This is provided by the client when the instance is created. For example, the following is a valid partial url to a predefined machine type:\n\nzones/us-central1-f/machineTypes/n1-standard-1 \n\nTo create a custom machine type, provide a URL to a machine type in the following format, where CPUS is 1 or an even number up to 32 (2, 4, 6, ... 24, etc), and MEMORY is the total memory for this instance. Memory must be a multiple of 256 MB and must be supplied in MB (e.g. 5 GB of memory is 5120 MB):\n\nzones/zone/machineTypes/custom-CPUS-MEMORY \n\nFor example: zones/us-central1-f/machineTypes/custom-4-5120 \n\nFor a full list of restrictions, read the Specifications for custom machine types.",
+                    "description": "Full or partial URL of the machine type resource to use for this instance, in the format: zones/zone/machineTypes/machine-type. This is provided by the client when the instance is created. For example, the following is a valid partial url to a predefined machine type:\n\nzones/us-central1-f/machineTypes/n1-standard-1 \n\nTo create a custom machine type, provide a URL to a machine type in the following format, where CPUS is 1 or an even number up to 32 (2, 4, 6, ... 24, etc), and MEMORY is the total memory for this instance. Memory must be a multiple of 256 MB and must be supplied in MB (e.g. 5 GB of memory is 5120 MB):\n\nzones/zone/machineTypes/custom-CPUS-MEMORY \n\nFor example: zones/us-central1-f/machineTypes/custom-4-5120 \n\nFor a full list of restrictions, read the Specifications for custom machine types.",
                     "type": "string"
                 },
                 "metadata": {
                     "$ref": "Metadata",
                     "description": "The metadata key/value pairs assigned to this instance. This includes custom metadata and predefined keys."
                 },
                 "name": {
                     "description": "The name of the resource, provided by the client when initially creating the resource. The resource 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"
                 },
@@ skipping 42 matching lines @@
                         ""
                     ],
                     "type": "string"
                 },
                 "statusMessage": {
                     "description": "[Output Only] An optional, human-readable explanation of the status.",
                     "type": "string"
                 },
                 "tags": {
                     "$ref": "Tags",
-                    "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."
+                    "description": "A list of tags to apply 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": "[Output Only] URL of the zone where the instance resides.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "InstanceAggregatedList": {
             "id": "InstanceAggregatedList",
             "properties": {
                 "id": {
                     "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.",
                     "type": "string"
                 },
                 "items": {
                     "additionalProperties": {
                         "$ref": "InstancesScopedList",
-                        "description": "Name of the scope containing this set of instances."
+                        "description": "[Output Only] Name of the scope containing this set of instances."
                     },
                     "description": "[Output Only] A map of scoped instance lists.",
                     "type": "object"
                 },
                 "kind": {
                     "default": "compute#instanceAggregatedList",
                     "description": "[Output Only] Type of resource. Always compute#instanceAggregatedList for aggregated lists of Instance resources.",
                     "type": "string"
                 },
                 "nextPageToken": {
@@ skipping 44 matching lines @@
                     "type": "string"
                 },
                 "namedPorts": {
                     "description": "Assigns a name to a port number. For example: {name: \"http\", port: 80}\n\nThis allows the system to reference ports by the assigned name instead of a port number. Named ports can also contain multiple ports. For example: [{name: \"http\", port: 80},{name: \"http\", port: 8080}] \n\nNamed ports apply to all instances in this instance group.",
                     "items": {
                         "$ref": "NamedPort"
                     },
                     "type": "array"
                 },
                 "network": {
-                    "description": "[Output Only] The URL of the network to which all instances in the instance group belong.",
+                    "description": "The URL of the network to which all instances in the instance group belong.",
                     "type": "string"
                 },
                 "selfLink": {
                     "description": "[Output Only] The URL for this instance group. The server generates this URL.",
                     "type": "string"
                 },
                 "size": {
                     "description": "[Output Only] The total number of instances in the instance group.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "subnetwork": {
-                    "description": "[Output Only] The URL of the subnetwork to which all instances in the instance group belong.",
+                    "description": "The URL of the subnetwork to which all instances in the instance group belong.",
                     "type": "string"
                 },
                 "zone": {
                     "description": "[Output Only] The URL of the zone where the instance group is located.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "InstanceGroupAggregatedList": {
@@ skipping 52 matching lines @@
                     "type": "string"
                 },
                 "selfLink": {
                     "description": "[Output Only] The URL for this resource type. The server generates this URL.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "InstanceGroupManager": {
-            "description": "InstanceGroupManagers\n\nNext available tag: 20",
             "id": "InstanceGroupManager",
             "properties": {
                 "baseInstanceName": {
                     "annotations": {
                         "required": [
                             "compute.instanceGroupManagers.insert"
                         ]
                     },
                     "description": "The base instance name to use for instances in this group. The value must be 1-58 characters long. Instances are named by appending a hyphen and a random four-character string to the base instance name. The base instance name must comply with RFC1035.",
                     "pattern": "[a-z][-a-z0-9]{0,57}",
@@ skipping 248 matching lines @@
                         "$ref": "InstanceGroupManager"
                     },
                     "type": "array"
                 },
                 "warning": {
                     "description": "[Output Only] The warning that replaces the list of managed instance groups when the list is empty.",
                     "properties": {
                         "code": {
                             "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.",
                             "enum": [
+                                "CLEANUP_FAILED",
                                 "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",
                                 "NOT_CRITICAL_ERROR",
                                 "NO_RESULTS_ON_PAGE",
                                 "REQUIRED_TOS_AGREEMENT",
                                 "RESOURCE_NOT_DELETED",
                                 "SINGLE_INSTANCE_PROPERTY_TEMPLATE",
                                 "UNREACHABLE"
                             ],
                             "enumDescriptions": [
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
+                                "",
                                 ""
                             ],
                             "type": "string"
                         },
                         "data": {
                             "description": "[Output Only] Metadata about this warning in key: value format. For example:\n\"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" }",
                             "items": {
                                 "properties": {
                                     "key": {
-                                        "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource, and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).",
+                                        "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).",
                                         "type": "string"
                                     },
                                     "value": {
                                         "description": "[Output Only] A warning data value corresponding to the key.",
                                         "type": "string"
                                     }
                                 },
                                 "type": "object"
                             },
                             "type": "array"
@@ skipping 119 matching lines @@
                         "$ref": "InstanceGroup"
                     },
                     "type": "array"
                 },
                 "warning": {
                     "description": "[Output Only] An informational warning that replaces the list of instance groups when the list is empty.",
                     "properties": {
                         "code": {
                             "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.",
                             "enum": [
+                                "CLEANUP_FAILED",
                                 "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",
                                 "NOT_CRITICAL_ERROR",
                                 "NO_RESULTS_ON_PAGE",
                                 "REQUIRED_TOS_AGREEMENT",
                                 "RESOURCE_NOT_DELETED",
                                 "SINGLE_INSTANCE_PROPERTY_TEMPLATE",
                                 "UNREACHABLE"
                             ],
                             "enumDescriptions": [
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
+                                "",
                                 ""
                             ],
                             "type": "string"
                         },
                         "data": {
                             "description": "[Output Only] Metadata about this warning in key: value format. For example:\n\"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" }",
                             "items": {
                                 "properties": {
                                     "key": {
-                                        "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource, and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).",
+                                        "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).",
                                         "type": "string"
                                     },
                                     "value": {
                                         "description": "[Output Only] A warning data value corresponding to the key.",
                                         "type": "string"
                                     }
                                 },
                                 "type": "object"
                             },
                             "type": "array"
@@ skipping 20 matching lines @@
                     "description": "The list of named ports to set for this instance group.",
                     "items": {
                         "$ref": "NamedPort"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
         "InstanceList": {
-            "description": "Contains a list of instance resources.",
+            "description": "Contains a list of instances.",
             "id": "InstanceList",
             "properties": {
                 "id": {
                     "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.",
                     "type": "string"
                 },
                 "items": {
-                    "description": "[Output Only] A list of Instance resources.",
+                    "description": "[Output Only] A list of instances.",
                     "items": {
                         "$ref": "Instance"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "compute#instanceList",
                     "description": "[Output Only] Type of resource. Always compute#instanceList for lists of Instance resources.",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.",
                     "type": "string"
                 },
                 "selfLink": {
                     "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",
+                    "description": "The URL of the destination zone to move the instance. 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": {
@@ skipping 187 matching lines @@
                         "$ref": "Instance"
                     },
                     "type": "array"
                 },
                 "warning": {
                     "description": "[Output Only] Informational warning which replaces the list of instances when the list is empty.",
                     "properties": {
                         "code": {
                             "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.",
                             "enum": [
+                                "CLEANUP_FAILED",
                                 "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",
                                 "NOT_CRITICAL_ERROR",
                                 "NO_RESULTS_ON_PAGE",
                                 "REQUIRED_TOS_AGREEMENT",
                                 "RESOURCE_NOT_DELETED",
                                 "SINGLE_INSTANCE_PROPERTY_TEMPLATE",
                                 "UNREACHABLE"
                             ],
                             "enumDescriptions": [
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
+                                "",
                                 ""
                             ],
                             "type": "string"
                         },
                         "data": {
                             "description": "[Output Only] Metadata about this warning in key: value format. For example:\n\"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" }",
                             "items": {
                                 "properties": {
                                     "key": {
-                                        "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource, and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).",
+                                        "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).",
                                         "type": "string"
                                     },
                                     "value": {
                                         "description": "[Output Only] A warning data value corresponding to the key.",
                                         "type": "string"
                                     }
                                 },
                                 "type": "object"
                             },
                             "type": "array"
@@ skipping 154 matching lines @@
                     "type": "string"
                 },
                 "selfLink": {
                     "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 types.",
             "id": "MachineTypeList",
             "properties": {
                 "id": {
                     "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.",
                     "type": "string"
                 },
                 "items": {
                     "description": "[Output Only] A list of Machine Type resources.",
                     "items": {
                         "$ref": "MachineType"
@@ skipping 25 matching lines @@
                         "$ref": "MachineType"
                     },
                     "type": "array"
                 },
                 "warning": {
                     "description": "[Output Only] An informational warning that appears when the machine types list is empty.",
                     "properties": {
                         "code": {
                             "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.",
                             "enum": [
+                                "CLEANUP_FAILED",
                                 "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",
                                 "NOT_CRITICAL_ERROR",
                                 "NO_RESULTS_ON_PAGE",
                                 "REQUIRED_TOS_AGREEMENT",
                                 "RESOURCE_NOT_DELETED",
                                 "SINGLE_INSTANCE_PROPERTY_TEMPLATE",
                                 "UNREACHABLE"
                             ],
                             "enumDescriptions": [
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
+                                "",
                                 ""
                             ],
                             "type": "string"
                         },
                         "data": {
                             "description": "[Output Only] Metadata about this warning in key: value format. For example:\n\"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" }",
                             "items": {
                                 "properties": {
                                     "key": {
-                                        "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource, and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).",
+                                        "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).",
                                         "type": "string"
                                     },
                                     "value": {
                                         "description": "[Output Only] A warning data value corresponding to the key.",
                                         "type": "string"
                                     }
                                 },
                                 "type": "object"
                             },
                             "type": "array"
@@ skipping 81 matching lines @@
                     "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.",
+                                        "description": "[Output Only] Indicates the field in the request that 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"
@@ skipping 61 matching lines @@
                 },
                 "port": {
                     "description": "The port number, which can be a value between 1 and 65535.",
                     "format": "int32",
                     "type": "integer"
                 }
             },
             "type": "object"
         },
         "Network": {
-            "description": "A network resource.",
+            "description": "Represents a Network resource. Read Networks and Firewalls for more information.",
             "id": "Network",
             "properties": {
                 "IPv4Range": {
                     "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"
                 },
                 "autoCreateSubnetworks": {
                     "description": "When set to true, the network is created in \"auto subnet mode\". When set to false, the network is in \"custom subnet mode\".\n\nIn \"auto subnet mode\", a newly created network is assigned the default CIDR of 10.128.0.0/9 and it automatically creates one subnetwork per region.",
                     "type": "boolean"
@@ skipping 74 matching lines @@
                     "type": "string"
                 },
                 "subnetwork": {
                     "description": "The URL of the Subnetwork resource for this instance. If the network resource is in legacy mode, do not provide this property. If the network is in auto subnet mode, providing the subnetwork is optional. If the network is in custom subnet mode, then this field should be specified. If you specify this property, you can specify the subnetwork as a full or partial URL. For example, the following are all valid URLs:  \n- https://www.googleapis.com/compute/v1/projects/project/zones/zone/subnetworks/subnetwork \n- zones/zone/subnetworks/subnetwork",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "NetworkList": {
-            "description": "Contains a list of Network resources.",
+            "description": "Contains a list of networks.",
             "id": "NetworkList",
             "properties": {
                 "id": {
                     "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.",
                     "type": "string"
                 },
                 "items": {
                     "description": "[Output Only] A list of Network resources.",
                     "items": {
                         "$ref": "Network"
@@ skipping 14 matching lines @@
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Operation": {
             "description": "An Operation resource, used to manage asynchronous API requests.",
             "id": "Operation",
             "properties": {
                 "clientOperationId": {
-                    "description": "[Output Only] A unique client ID generated by the server.",
+                    "description": "[Output Only] Reserved for future use.",
                     "type": "string"
                 },
                 "creationTimestamp": {
                     "description": "[Output Only] Creation timestamp in RFC3339 text format.",
                     "type": "string"
                 },
                 "description": {
                     "description": "[Output Only] A textual description of the operation, which is set when the operation is created.",
                     "type": "string"
                 },
                 "endTime": {
                     "description": "[Output Only] The time that this operation was completed. This value is in RFC3339 text format.",
                     "type": "string"
                 },
                 "error": {
                     "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.",
+                                        "description": "[Output Only] Indicates the field in the request that 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"
@@ skipping 14 matching lines @@
                     "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.",
                     "format": "uint64",
                     "type": "string"
                 },
                 "insertTime": {
                     "description": "[Output Only] The time that this operation was requested. This value is in RFC3339 text format.",
                     "type": "string"
                 },
                 "kind": {
                     "default": "compute#operation",
-                    "description": "[Output Only] Type of the resource. Always compute#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.",
                     "type": "string"
                 },
                 "operationType": {
-                    "description": "[Output Only] The type of operation, which can be insert, update, or delete.",
+                    "description": "[Output Only] The type of operation, such as insert, update, or delete, and so on.",
                     "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 when the operation will be complete. This number should monotonically increase as the operation progresses.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "region": {
-                    "description": "[Output Only] URL of the region where the operation resides. Only available when performing regional operations.",
+                    "description": "[Output Only] The URL of the region where the operation resides. Only available when performing regional operations.",
                     "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 value is in RFC3339 text format.",
                     "type": "string"
                 },
@@ skipping 14 matching lines @@
                 "statusMessage": {
                     "description": "[Output Only] An optional textual description of the current status of the operation.",
                     "type": "string"
                 },
                 "targetId": {
                     "description": "[Output Only] The unique target ID, which identifies a specific incarnation of the target resource.",
                     "format": "uint64",
                     "type": "string"
                 },
                 "targetLink": {
-                    "description": "[Output Only] The URL of the resource that the operation is modifying.",
+                    "description": "[Output Only] The URL of the resource that the operation modifies.",
                     "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": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.",
                                 "enum": [
+                                    "CLEANUP_FAILED",
                                     "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",
                                     "NOT_CRITICAL_ERROR",
                                     "NO_RESULTS_ON_PAGE",
                                     "REQUIRED_TOS_AGREEMENT",
                                     "RESOURCE_NOT_DELETED",
                                     "SINGLE_INSTANCE_PROPERTY_TEMPLATE",
                                     "UNREACHABLE"
                                 ],
                                 "enumDescriptions": [
                                     "",
                                     "",
                                     "",
                                     "",
                                     "",
                                     "",
                                     "",
                                     "",
                                     "",
                                     "",
                                     "",
                                     "",
                                     "",
+                                    "",
                                     ""
                                 ],
                                 "type": "string"
                             },
                             "data": {
                                 "description": "[Output Only] Metadata about this warning in key: value format. For example:\n\"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" }",
                                 "items": {
                                     "properties": {
                                         "key": {
-                                            "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource, and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).",
+                                            "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).",
                                             "type": "string"
                                         },
                                         "value": {
                                             "description": "[Output Only] A warning data value corresponding to the key.",
                                             "type": "string"
                                         }
                                     },
                                     "type": "object"
                                 },
                                 "type": "array"
                             },
                             "message": {
                                 "description": "[Output Only] A human-readable description of the warning code.",
                                 "type": "string"
                             }
                         },
                         "type": "object"
                     },
                     "type": "array"
                 },
                 "zone": {
-                    "description": "[Output Only] URL of the zone where the operation resides. Only available when performing per-zone operations.",
+                    "description": "[Output Only] The URL of the zone where the operation resides. Only available when performing per-zone operations.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "OperationAggregatedList": {
             "id": "OperationAggregatedList",
             "properties": {
                 "id": {
                     "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.",
@@ skipping 25 matching lines @@
         },
         "OperationList": {
             "description": "Contains a list of Operation resources.",
             "id": "OperationList",
             "properties": {
                 "id": {
                     "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.",
                     "type": "string"
                 },
                 "items": {
-                    "description": "[Output Only] The Operation resources.",
+                    "description": "[Output Only] A list of Operation resources.",
                     "items": {
                         "$ref": "Operation"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "compute#operationList",
                     "description": "[Output Only] Type of resource. Always compute#operations for Operations resource.",
                     "type": "string"
                 },
@@ skipping 17 matching lines @@
                         "$ref": "Operation"
                     },
                     "type": "array"
                 },
                 "warning": {
                     "description": "[Output Only] Informational warning which replaces the list of operations when the list is empty.",
                     "properties": {
                         "code": {
                             "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.",
                             "enum": [
+                                "CLEANUP_FAILED",
                                 "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",
                                 "NOT_CRITICAL_ERROR",
                                 "NO_RESULTS_ON_PAGE",
                                 "REQUIRED_TOS_AGREEMENT",
                                 "RESOURCE_NOT_DELETED",
                                 "SINGLE_INSTANCE_PROPERTY_TEMPLATE",
                                 "UNREACHABLE"
                             ],
                             "enumDescriptions": [
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
+                                "",
                                 ""
                             ],
                             "type": "string"
                         },
                         "data": {
                             "description": "[Output Only] Metadata about this warning in key: value format. For example:\n\"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" }",
                             "items": {
                                 "properties": {
                                     "key": {
-                                        "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource, and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).",
+                                        "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).",
                                         "type": "string"
                                     },
                                     "value": {
                                         "description": "[Output Only] A warning data value corresponding to the key.",
                                         "type": "string"
                                     }
                                 },
                                 "type": "object"
                             },
                             "type": "array"
@@ skipping 46 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 only be created in the Google Developers Console. Unless marked otherwise, values can only be modified in the console.",
+            "description": "A Project resource. Projects can only be created in the Google Cloud Platform 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. See Custom metadata for more information."
                 },
                 "creationTimestamp": {
                     "description": "[Output Only] Creation timestamp in RFC3339 text format.",
                     "type": "string"
                 },
@@ skipping 219 matching lines @@
             "id": "ResourceGroupReference",
             "properties": {
                 "group": {
                     "description": "A URI referencing one of the resource views listed in the backend service.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Route": {
-            "description": "The route resource. A Route is a rule that specifies how certain packets should be handled by the virtual network. Routes are associated with instances by tags and the set of Routes for a particular instance is called its routing table. For each packet leaving a instance, the system searches that instance's routing table for a single best matching Route. Routes match packets by destination IP address, preferring smaller or more specific ranges over larger ones. If there is a tie, the system selects the Route with the smallest priority value. If there is still a tie, it uses the layer three and four packet headers to select just one of the remaining matching Routes. The packet is then forwarded as specified by the nextHop field of the winning Route -- either to another instance destination, a instance gateway or a Google Compute Engien-operated gateway. Packets that do not match any Route in the sending instance's routing table are dropped.",
+            "description": "Represents a Route resource. A route specifies how certain packets should be handled by the network. Routes are associated with instances by tags and the set of routes for a particular instance is called its routing table.\n\nFor each packet leaving a instance, the system searches that instance's routing table for a single best matching route. Routes match packets by destination IP address, preferring smaller or more specific ranges over larger ones. If there is a tie, the system selects the route with the smallest priority value. If there is still a tie, it uses the layer three and four packet headers to select just one of the remaining matching routes. The packet is then forwarded as specified by the nextHop field of the winning route - either to another instance destination, a instance gateway or a Google Compute Engine-operated gateway.\n\nPackets that do not match any route in the sending instance's routing table are dropped.",
             "id": "Route",
             "properties": {
                 "creationTimestamp": {
                     "description": "[Output Only] Creation timestamp in RFC3339 text format.",
                     "type": "string"
                 },
                 "description": {
                     "description": "An optional description of this resource. Provide this property when you create the resource.",
                     "type": "string"
                 },
@@ skipping 15 matching lines @@
                     "default": "compute#route",
                     "description": "[Output Only] Type of this resource. Always compute#routes for Route resources.",
                     "type": "string"
                 },
                 "name": {
                     "annotations": {
                         "required": [
                             "compute.routes.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. 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.",
+                    "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": {
                     "annotations": {
                         "required": [
                             "compute.routes.insert"
                         ]
                     },
                     "description": "Fully-qualified URL of the network that this route applies to.",
@@ skipping 45 matching lines @@
                     },
                     "type": "array"
                 },
                 "warnings": {
                     "description": "[Output Only] If potential misconfigurations are detected for this route, this field will be populated with warning messages.",
                     "items": {
                         "properties": {
                             "code": {
                                 "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.",
                                 "enum": [
+                                    "CLEANUP_FAILED",
                                     "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",
                                     "NOT_CRITICAL_ERROR",
                                     "NO_RESULTS_ON_PAGE",
                                     "REQUIRED_TOS_AGREEMENT",
                                     "RESOURCE_NOT_DELETED",
                                     "SINGLE_INSTANCE_PROPERTY_TEMPLATE",
                                     "UNREACHABLE"
                                 ],
                                 "enumDescriptions": [
                                     "",
                                     "",
                                     "",
                                     "",
                                     "",
                                     "",
                                     "",
                                     "",
                                     "",
                                     "",
                                     "",
                                     "",
                                     "",
+                                    "",
                                     ""
                                 ],
                                 "type": "string"
                             },
                             "data": {
                                 "description": "[Output Only] Metadata about this warning in key: value format. For example:\n\"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" }",
                                 "items": {
                                     "properties": {
                                         "key": {
-                                            "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource, and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).",
+                                            "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).",
                                             "type": "string"
                                         },
                                         "value": {
                                             "description": "[Output Only] A warning data value corresponding to the key.",
                                             "type": "string"
                                         }
                                     },
                                     "type": "object"
                                 },
                                 "type": "array"
                             },
                             "message": {
                                 "description": "[Output Only] A human-readable description of the warning code.",
                                 "type": "string"
                             }
                         },
                         "type": "object"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
         "RouteList": {
-            "description": "Contains a list of route resources.",
+            "description": "Contains a list of Route resources.",
             "id": "RouteList",
             "properties": {
                 "id": {
                     "description": "[Output Only] Unique identifier for the resource. Defined by the server.",
                     "type": "string"
                 },
                 "items": {
                     "description": "[Output Only] A list of Route resources.",
                     "items": {
                         "$ref": "Route"
@@ skipping 18 matching lines @@
         },
         "Scheduling": {
             "description": "Sets the scheduling options for an Instance.",
             "id": "Scheduling",
             "properties": {
                 "automaticRestart": {
                     "description": "Specifies whether the instance should be automatically restarted if it is terminated by Compute Engine (not terminated by a user). You can only set the automatic restart option for standard instances. Preemptible instances cannot be automatically restarted.",
                     "type": "boolean"
                 },
                 "onHostMaintenance": {
-                    "description": "Defines the maintenance behavior for this instance. For standard instances, the default behavior is MIGRATE. For preemptible instances, the default and only possible behavior is TERMINATE. For more information, see Setting maintenance behavior.",
+                    "description": "Defines the maintenance behavior for this instance. For standard instances, the default behavior is MIGRATE. For preemptible instances, the default and only possible behavior is TERMINATE. For more information, see Setting Instance Scheduling Options.",
                     "enum": [
                         "MIGRATE",
                         "TERMINATE"
                     ],
                     "enumDescriptions": [
                         "",
                         ""
                     ],
                     "type": "string"
                 },
@@ skipping 63 matching lines @@
                     "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.",
                     "format": "uint64",
                     "type": "string"
                 },
                 "kind": {
                     "default": "compute#snapshot",
                     "description": "[Output Only] Type of the resource. Always compute#snapshot for Snapshot resources.",
                     "type": "string"
                 },
                 "licenses": {
-                    "description": "Public visible licenses.",
+                    "description": "[Output Only] A list of public visible licenses that apply to this snapshot. This can be because the original image had licenses attached (such as a Windows image).",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "name": {
                     "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": "[Output Only] Server-defined URL for the resource.",
                     "type": "string"
                 },
                 "sourceDisk": {
                     "description": "[Output Only] The source disk used to create this snapshot.",
                     "type": "string"
                 },
                 "sourceDiskId": {
                     "description": "[Output Only] The ID value of the disk used to create this snapshot. This value may be used to determine whether the snapshot was taken from the current or a previous instance of a given disk name.",
                     "type": "string"
                 },
                 "status": {
-                    "description": "[Output Only] The status of the snapshot.",
+                    "description": "[Output Only] The status of the snapshot. This can be CREATING, DELETING, FAILED, READY, or UPLOADING.",
                     "enum": [
                         "CREATING",
                         "DELETING",
                         "FAILED",
                         "READY",
                         "UPLOADING"
                     ],
                     "enumDescriptions": [
                         "",
                         "",
                         "",
                         "",
                         ""
                     ],
                     "type": "string"
                 },
                 "storageBytes": {
                     "description": "[Output Only] A size of the the storage used by the snapshot. As snapshots share storage, this number is expected to change with snapshot creation/deletion.",
                     "format": "int64",
                     "type": "string"
                 },
                 "storageBytesStatus": {
-                    "description": "[Output Only] An indicator whether storageBytes is in a stable state or it is being adjusted as a result of shared storage reallocation.",
+                    "description": "[Output Only] An indicator whether storageBytes is in a stable state or it is being adjusted as a result of shared storage reallocation. This status can either be UPDATING, meaning the size of the snapshot is being updated, or UP_TO_DATE, meaning the size of the snapshot is up-to-date.",
                     "enum": [
                         "UPDATING",
                         "UP_TO_DATE"
                     ],
                     "enumDescriptions": [
                         "",
                         ""
                     ],
                     "type": "string"
                 }
@@ skipping 225 matching lines @@
                         "$ref": "Subnetwork"
                     },
                     "type": "array"
                 },
                 "warning": {
                     "description": "An informational warning that appears when the list of addresses is empty.",
                     "properties": {
                         "code": {
                             "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.",
                             "enum": [
+                                "CLEANUP_FAILED",
                                 "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",
                                 "NOT_CRITICAL_ERROR",
                                 "NO_RESULTS_ON_PAGE",
                                 "REQUIRED_TOS_AGREEMENT",
                                 "RESOURCE_NOT_DELETED",
                                 "SINGLE_INSTANCE_PROPERTY_TEMPLATE",
                                 "UNREACHABLE"
                             ],
                             "enumDescriptions": [
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
+                                "",
                                 ""
                             ],
                             "type": "string"
                         },
                         "data": {
                             "description": "[Output Only] Metadata about this warning in key: value format. For example:\n\"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" }",
                             "items": {
                                 "properties": {
                                     "key": {
-                                        "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource, and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).",
+                                        "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).",
                                         "type": "string"
                                     },
                                     "value": {
                                         "description": "[Output Only] A warning data value corresponding to the key.",
                                         "type": "string"
                                     }
                                 },
                                 "type": "object"
                             },
                             "type": "array"
@@ skipping 43 matching lines @@
                     "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.",
                     "format": "uint64",
                     "type": "string"
                 },
                 "kind": {
                     "default": "compute#targetHttpProxy",
                     "description": "[Output Only] Type of resource. Always compute#targetHttpProxy for target HTTP proxies.",
                     "type": "string"
                 },
                 "name": {
-                    "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.",
+                    "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": "[Output Only] Server-defined URL for the resource.",
                     "type": "string"
                 },
                 "urlMap": {
                     "description": "URL to the UrlMap resource that defines the mapping from URL to the BackendService.",
                     "type": "string"
@@ skipping 11 matching lines @@
                 },
                 "items": {
                     "description": "A list of TargetHttpProxy resources.",
                     "items": {
                         "$ref": "TargetHttpProxy"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "compute#targetHttpProxyList",
-                    "description": "Type of resource. Always compute#targetHttpProxyList for lists of Target HTTP proxies.",
+                    "description": "Type of resource. Always compute#targetHttpProxyList for lists of target HTTP proxies.",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.",
                     "type": "string"
                 },
                 "selfLink": {
                     "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "TargetHttpsProxiesSetSslCertificatesRequest": {
             "id": "TargetHttpsProxiesSetSslCertificatesRequest",
             "properties": {
                 "sslCertificates": {
-                    "description": "New set of URLs to SslCertificate resources to associate with this TargetHttpProxy. Currently exactly one ssl certificate must be specified.",
+                    "description": "New set of SslCertificate resources to associate with this TargetHttpsProxy resource. Currently exactly one SslCertificate resource must be specified.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
         "TargetHttpsProxy": {
             "description": "A TargetHttpsProxy resource. This resource defines an HTTPS proxy.",
             "id": "TargetHttpsProxy",
             "properties": {
                 "creationTimestamp": {
                     "description": "[Output Only] Creation timestamp in RFC3339 text format.",
                     "type": "string"
                 },
                 "description": {
                     "description": "An optional description of this resource. Provide this property when you create the resource.",
                     "type": "string"
                 },
                 "id": {
                     "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.",
                     "format": "uint64",
                     "type": "string"
                 },
                 "kind": {
                     "default": "compute#targetHttpsProxy",
-                    "description": "[Output Only] Type of the resource. Always compute#targetHttpsProxy for target HTTPS proxies.",
+                    "description": "[Output Only] Type of resource. Always compute#targetHttpsProxy for target HTTPS proxies.",
                     "type": "string"
                 },
                 "name": {
                     "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": "[Output Only] Server-defined URL for the resource.",
                     "type": "string"
                 },
                 "sslCertificates": {
-                    "description": "URLs to SslCertificate resources that are used to authenticate connections between users and the load balancer. Currently exactly one SSL certificate must be specified.",
+                    "description": "URLs to SslCertificate resources that are used to authenticate connections between users and the load balancer. Currently, exactly one SSL certificate must be specified.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "urlMap": {
-                    "description": "URL to the UrlMap resource that defines the mapping from URL to the BackendService.",
+                    "description": "A fully-qualified or valid partial URL to the UrlMap resource that defines the mapping from URL to the BackendService. For example, the following are all valid URLs for specifying a URL map:  \n- https://www.googleapis.compute/v1/projects/project/global/urlMaps/url-map \n- projects/project/global/urlMaps/url-map \n- global/urlMaps/url-map",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "TargetHttpsProxyList": {
             "description": "Contains a list of TargetHttpsProxy resources.",
             "id": "TargetHttpsProxyList",
             "properties": {
                 "id": {
                     "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.",
                     "type": "string"
                 },
                 "items": {
                     "description": "A list of TargetHttpsProxy resources.",
                     "items": {
                         "$ref": "TargetHttpsProxy"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "compute#targetHttpsProxyList",
-                    "description": "Type of resource.",
+                    "description": "Type of resource. Always compute#targetHttpsProxyList for lists of target HTTPS proxies.",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.",
                     "type": "string"
                 },
                 "selfLink": {
                     "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
@@ skipping 11 matching lines @@
                 "description": {
                     "description": "An optional description of this resource. Provide this property when you create the resource.",
                     "type": "string"
                 },
                 "id": {
                     "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.",
                     "format": "uint64",
                     "type": "string"
                 },
                 "instance": {
-                    "description": "The URL to the instance that terminates the relevant traffic.",
+                    "description": "A URL to the virtual machine instance that handles traffic for this target instance. When creating a target instance, you can provide the fully-qualified URL or a valid partial URL to the desired virtual machine. For example, the following are all valid URLs: \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"
                 },
                 "kind": {
                     "default": "compute#targetInstance",
                     "description": "[Output Only] The type of the resource. Always compute#targetInstance for target instances.",
                     "type": "string"
                 },
                 "name": {
                     "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])?",
@@ skipping 91 matching lines @@
                         "$ref": "TargetInstance"
                     },
                     "type": "array"
                 },
                 "warning": {
                     "description": "Informational warning which replaces the list of addresses when the list is empty.",
                     "properties": {
                         "code": {
                             "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.",
                             "enum": [
+                                "CLEANUP_FAILED",
                                 "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",
                                 "NOT_CRITICAL_ERROR",
                                 "NO_RESULTS_ON_PAGE",
                                 "REQUIRED_TOS_AGREEMENT",
                                 "RESOURCE_NOT_DELETED",
                                 "SINGLE_INSTANCE_PROPERTY_TEMPLATE",
                                 "UNREACHABLE"
                             ],
                             "enumDescriptions": [
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
+                                "",
                                 ""
                             ],
                             "type": "string"
                         },
                         "data": {
                             "description": "[Output Only] Metadata about this warning in key: value format. For example:\n\"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" }",
                             "items": {
                                 "properties": {
                                     "key": {
-                                        "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource, and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).",
+                                        "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).",
                                         "type": "string"
                                     },
                                     "value": {
                                         "description": "[Output Only] A warning data value corresponding to the key.",
                                         "type": "string"
                                     }
                                 },
                                 "type": "object"
                             },
                             "type": "array"
                         },
                         "message": {
                             "description": "[Output Only] A human-readable description of the warning code.",
                             "type": "string"
                         }
                     },
                     "type": "object"
                 }
             },
             "type": "object"
         },
         "TargetPool": {
-            "description": "A TargetPool resource. This resource defines a pool of instances, associated HttpHealthCheck resources, and the fallback TargetPool.",
+            "description": "A TargetPool resource. This resource defines a pool of instances, associated HttpHealthCheck resources, and the fallback target pool.",
             "id": "TargetPool",
             "properties": {
                 "backupPool": {
                     "description": "This field is applicable only when the containing target pool is serving a forwarding rule as the primary pool, and its failoverRatio field is properly set to a value between [0, 1].\n\nbackupPool and failoverRatio together define the fallback behavior of the primary target pool: if the ratio of the healthy instances in the primary pool is at or below failoverRatio, traffic arriving at the load-balanced IP will be directed to the backup pool.\n\nIn case where failoverRatio and backupPool are not set, or all the instances in the backup pool are unhealthy, the traffic will be directed back to the primary pool in the \"force\" mode, where traffic will be spread to the healthy instances with the best effort, or to all instances when no instance is healthy.",
                     "type": "string"
                 },
                 "creationTimestamp": {
                     "description": "[Output Only] Creation timestamp in RFC3339 text format.",
                     "type": "string"
                 },
@@ skipping 12 matching lines @@
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "id": {
                     "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.",
                     "format": "uint64",
                     "type": "string"
                 },
                 "instances": {
-                    "description": "A list of resource URLs to the member virtual machines serving this pool. They must live in zones contained in the same region as this pool.",
+                    "description": "A list of resource URLs to the virtual machine instances serving this pool. They must live in zones contained in the same region as this pool.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "compute#targetPool",
                     "description": "[Output Only] Type of the resource. Always compute#targetPool for target pools.",
                     "type": "string"
                 },
@@ skipping 32 matching lines @@
             "properties": {
                 "id": {
                     "description": "[Output Only] Unique identifier for the resource. Defined by the server.",
                     "type": "string"
                 },
                 "items": {
                     "additionalProperties": {
                         "$ref": "TargetPoolsScopedList",
                         "description": "Name of the scope containing this set of target pools."
                     },
-                    "description": "A map of scoped target pool lists.",
+                    "description": "[Output Only] A map of scoped target pool lists.",
                     "type": "object"
                 },
                 "kind": {
                     "default": "compute#targetPoolAggregatedList",
-                    "description": "Type of resource.",
+                    "description": "[Output Only] Type of resource. Always compute#targetPoolAggregatedList for aggregated lists of target pools.",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.",
                     "type": "string"
                 },
                 "selfLink": {
                     "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "TargetPoolInstanceHealth": {
             "id": "TargetPoolInstanceHealth",
             "properties": {
                 "healthStatus": {
                     "items": {
                         "$ref": "HealthStatus"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "compute#targetPoolInstanceHealth",
-                    "description": "Type of resource.",
+                    "description": "[Output Only] Type of resource. Always compute#targetPoolInstanceHealth when checking the health of an instance.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "TargetPoolList": {
             "description": "Contains a list of TargetPool resources.",
             "id": "TargetPoolList",
             "properties": {
                 "id": {
                     "description": "[Output Only] Unique identifier for the resource. Defined by the server.",
                     "type": "string"
                 },
                 "items": {
                     "description": "A list of TargetPool resources.",
                     "items": {
                         "$ref": "TargetPool"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "compute#targetPoolList",
-                    "description": "Type of resource.",
+                    "description": "[Output Only] Type of resource. Always compute#targetPoolList for lists of target pools.",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "[Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.",
                     "type": "string"
                 },
                 "selfLink": {
                     "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "TargetPoolsAddHealthCheckRequest": {
             "id": "TargetPoolsAddHealthCheckRequest",
             "properties": {
                 "healthChecks": {
-                    "description": "Health check URLs to be added to targetPool.",
+                    "description": "A list of HttpHealthCheck resources to add to the target pool.",
                     "items": {
                         "$ref": "HealthCheckReference"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
         "TargetPoolsAddInstanceRequest": {
             "id": "TargetPoolsAddInstanceRequest",
             "properties": {
                 "instances": {
-                    "description": "URLs of the instances to be added to targetPool.",
+                    "description": "A full or partial URL to an instance to add to this target pool. This can be a full or partial URL. For example, the following are valid URLs:  \n- https://www.googleapis.com/compute/v1/projects/project-id/zones/zone/instances/instance-name \n- projects/project-id/zones/zone/instances/instance-name \n- zones/zone/instances/instance-name",
                     "items": {
                         "$ref": "InstanceReference"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
         "TargetPoolsRemoveHealthCheckRequest": {
             "id": "TargetPoolsRemoveHealthCheckRequest",
             "properties": {
                 "healthChecks": {
-                    "description": "Health check URLs to be removed from targetPool.",
+                    "description": "Health check URL to be removed. This can be a full or valid partial URL. For example, the following are valid URLs:  \n- https://www.googleapis.com/compute/beta/projects/project/global/httpHealthChecks/health-check \n- projects/project/global/httpHealthChecks/health-check \n- global/httpHealthChecks/health-check",
                     "items": {
                         "$ref": "HealthCheckReference"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
         "TargetPoolsRemoveInstanceRequest": {
             "id": "TargetPoolsRemoveInstanceRequest",
             "properties": {
                 "instances": {
-                    "description": "URLs of the instances to be removed from targetPool.",
+                    "description": "URLs of the instances to be removed from target pool.",
                     "items": {
                         "$ref": "InstanceReference"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
         "TargetPoolsScopedList": {
             "id": "TargetPoolsScopedList",
             "properties": {
                 "targetPools": {
                     "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": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.",
                             "enum": [
+                                "CLEANUP_FAILED",
                                 "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",
                                 "NOT_CRITICAL_ERROR",
                                 "NO_RESULTS_ON_PAGE",
                                 "REQUIRED_TOS_AGREEMENT",
                                 "RESOURCE_NOT_DELETED",
                                 "SINGLE_INSTANCE_PROPERTY_TEMPLATE",
                                 "UNREACHABLE"
                             ],
                             "enumDescriptions": [
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
+                                "",
                                 ""
                             ],
                             "type": "string"
                         },
                         "data": {
                             "description": "[Output Only] Metadata about this warning in key: value format. For example:\n\"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" }",
                             "items": {
                                 "properties": {
                                     "key": {
-                                        "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource, and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).",
+                                        "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).",
                                         "type": "string"
                                     },
                                     "value": {
                                         "description": "[Output Only] A warning data value corresponding to the key.",
                                         "type": "string"
                                     }
                                 },
                                 "type": "object"
                             },
                             "type": "array"
@@ skipping 11 matching lines @@
         "TargetReference": {
             "id": "TargetReference",
             "properties": {
                 "target": {
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "TargetVpnGateway": {
+            "description": "Represents a Target VPN gateway resource.",
             "id": "TargetVpnGateway",
             "properties": {
                 "creationTimestamp": {
                     "description": "[Output Only] Creation timestamp in RFC3339 text format.",
                     "type": "string"
                 },
                 "description": {
                     "description": "An optional description of this resource. Provide this property when you create the resource.",
                     "type": "string"
                 },
@@ skipping 13 matching lines @@
                     "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. 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.",
+                    "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": {
                     "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.",
@@ skipping 17 matching lines @@
                     ],
                     "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.",
+                    "description": "[Output Only] A list of URLs to VpnTunnel resources. VpnTunnels are created using compute.vpntunnels.insert method and associated to a VPN gateway.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
         "TargetVpnGatewayAggregatedList": {
             "id": "TargetVpnGatewayAggregatedList",
             "properties": {
                 "id": {
                     "description": "[Output Only] The unique identifier for the resource. This identifier is 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": "[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": {
@@ skipping 47 matching lines @@
                         "$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] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.",
                             "enum": [
+                                "CLEANUP_FAILED",
                                 "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",
                                 "NOT_CRITICAL_ERROR",
                                 "NO_RESULTS_ON_PAGE",
                                 "REQUIRED_TOS_AGREEMENT",
                                 "RESOURCE_NOT_DELETED",
                                 "SINGLE_INSTANCE_PROPERTY_TEMPLATE",
                                 "UNREACHABLE"
                             ],
                             "enumDescriptions": [
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
+                                "",
                                 ""
                             ],
                             "type": "string"
                         },
                         "data": {
                             "description": "[Output Only] Metadata about this warning in key: value format. For example:\n\"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" }",
                             "items": {
                                 "properties": {
                                     "key": {
-                                        "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource, and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).",
+                                        "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).",
                                         "type": "string"
                                     },
                                     "value": {
                                         "description": "[Output Only] A warning data value corresponding to the key.",
                                         "type": "string"
                                     }
                                 },
                                 "type": "object"
                             },
                             "type": "array"
@@ skipping 250 matching lines @@
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "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. 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.",
+                    "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"
                 },
                 "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 Cloud 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": [
+                        "ALLOCATING_RESOURCES",
                         "AUTHORIZATION_ERROR",
                         "DEPROVISIONING",
                         "ESTABLISHED",
                         "FAILED",
                         "FIRST_HANDSHAKE",
                         "NEGOTIATION_FAILURE",
                         "NETWORK_ERROR",
                         "NO_INCOMING_PACKETS",
                         "PROVISIONING",
                         "REJECTED",
                         "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.",
+                    "description": "URL of the VPN gateway with 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] The unique identifier for the resource. This identifier is defined by the server.",
@@ skipping 63 matching lines @@
                         "$ref": "VpnTunnel"
                     },
                     "type": "array"
                 },
                 "warning": {
                     "description": "Informational warning which replaces the list of addresses when the list is empty.",
                     "properties": {
                         "code": {
                             "description": "[Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.",
                             "enum": [
+                                "CLEANUP_FAILED",
                                 "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",
                                 "NOT_CRITICAL_ERROR",
                                 "NO_RESULTS_ON_PAGE",
                                 "REQUIRED_TOS_AGREEMENT",
                                 "RESOURCE_NOT_DELETED",
                                 "SINGLE_INSTANCE_PROPERTY_TEMPLATE",
                                 "UNREACHABLE"
                             ],
                             "enumDescriptions": [
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
                                 "",
+                                "",
                                 ""
                             ],
                             "type": "string"
                         },
                         "data": {
                             "description": "[Output Only] Metadata about this warning in key: value format. For example:\n\"data\": [ { \"key\": \"scope\", \"value\": \"zones/us-east1-d\" }",
                             "items": {
                                 "properties": {
                                     "key": {
-                                        "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource, and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).",
+                                        "description": "[Output Only] A key that provides more detail on the warning being returned. For example, for warnings where there are no results in a list request for a particular zone, this key might be scope and the key value might be the zone name. Other examples might be a key indicating a deprecated resource and a suggested replacement, or a warning about invalid network settings (for example, if an instance attempts to perform IP forwarding but is not enabled for IP forwarding).",
                                         "type": "string"
                                     },
                                     "value": {
                                         "description": "[Output Only] A warning data value corresponding to the key.",
                                         "type": "string"
                                     }
                                 },
                                 "type": "object"
                             },
                             "type": "array"
@@ skipping 115 matching lines @@
                     "type": "string"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "compute/v1/projects/",
     "title": "Compute Engine API",
     "version": "v1"
 }