Api-roll 33: 2016-03-14

generated/googleapis/lib/compute/v1.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis.compute.v1;
 
 import 'dart:core' as core;
 import 'dart:async' as async;
 import 'dart:convert' as convert;
 
 import 'package:_discoveryapis_commons/_discoveryapis_commons.dart' as commons;
 import 'package:crypto/crypto.dart' as crypto;
@@ skipping 89 matching lines @@
    * field_name comparison_string literal_string.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [AddressAggregatedList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 36 matching lines @@
 
   /**
    * Deletes the specified address resource.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [region] - The name of the region for this request.
+   * [region] - Name of the region for this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * [address] - Name of the address resource to delete.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [Operation].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
@@ skipping 32 matching lines @@
 
   /**
    * Returns the specified address resource.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [region] - The name of the region for this request.
+   * [region] - Name of the region for this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * [address] - Name of the address resource to return.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [Address].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
@@ skipping 35 matching lines @@
    * included in the request.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [region] - The name of the region for this request.
+   * [region] - Name of the region for this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [Operation].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
@@ skipping 21 matching lines @@
                                        "POST",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Retrieves a list of address resources contained within the specified
-   * region.
+   * Retrieves a list of addresses contained within the specified region.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [region] - The name of the region for this request.
+   * [region] - Name of the region for this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * [filter] - 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.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [AddressList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 60 matching lines @@
    * field_name comparison_string literal_string.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [AutoscalerAggregatedList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 28 matching lines @@
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new AutoscalerAggregatedList.fromJson(data));
   }
 
   /**
-   * Deletes the specified autoscaler resource.
+   * Deletes the specified autoscaler.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [zone] - Name of the zone scoping this request.
+   * [zone] - Name of the zone for this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
-   * [autoscaler] - Name of the persistent autoscaler resource to delete.
+   * [autoscaler] - Name of the autoscaler to delete.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [Operation].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
@@ skipping 21 matching lines @@
                                        "DELETE",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Returns the specified autoscaler resource.
+   * Returns the specified autoscaler resource. Get a list of available
+   * autoscalers by making a list() request.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [zone] - Name of the zone scoping this request.
+   * [zone] - Name of the zone for this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
-   * [autoscaler] - Name of the persistent autoscaler resource to return.
+   * [autoscaler] - Name of the autoscaler to return.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [Autoscaler].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
@@ skipping 21 matching lines @@
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Autoscaler.fromJson(data));
   }
 
   /**
-   * Creates an autoscaler resource in the specified project using the data
-   * included in the request.
+   * Creates an autoscaler in the specified project using the data included in
+   * the request.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [zone] - Name of the zone scoping this request.
+   * [zone] - Name of the zone for this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [Operation].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
@@ skipping 21 matching lines @@
                                        "POST",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Retrieves a list of autoscaler resources contained within the specified
-   * zone.
+   * Retrieves a list of autoscalers contained within the specified zone.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [zone] - Name of the zone scoping this request.
+   * [zone] - Name of the zone for this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * [filter] - 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.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [AutoscalerList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 31 matching lines @@
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new AutoscalerList.fromJson(data));
   }
 
   /**
-   * Updates an autoscaler resource in the specified project using the data
-   * included in the request. This method supports patch semantics.
+   * Updates an autoscaler in the specified project using the data included in
+   * the request. This method supports patch semantics.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [zone] - Name of the zone scoping this request.
+   * [zone] - Name of the zone for this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
-   * [autoscaler] - Name of the autoscaler resource to update.
+   * [autoscaler] - Name of the autoscaler to update.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [Operation].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
@@ skipping 25 matching lines @@
                                        "PATCH",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Updates an autoscaler resource in the specified project using the data
-   * included in the request.
+   * Updates an autoscaler in the specified project using the data included in
+   * the request.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [zone] - Name of the zone scoping this request.
+   * [zone] - Name of the zone for this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
-   * [autoscaler] - Name of the autoscaler resource to update.
+   * [autoscaler] - Name of the autoscaler to update.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [Operation].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
@@ skipping 80 matching lines @@
                                        "DELETE",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Returns the specified BackendService resource.
+   * Returns the specified BackendService resource. Get a list of available
+   * backend services by making a list() request.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [backendService] - Name of the BackendService resource to return.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
@@ skipping 149 matching lines @@
    * field_name comparison_string literal_string.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [BackendServiceList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 146 matching lines @@
 }
 
 
 class DiskTypesResourceApi {
   final commons.ApiRequester _requester;
 
   DiskTypesResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
-   * Retrieves an aggregated list of disk type resources.
+   * Retrieves an aggregated list of disk types.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [filter] - 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.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [DiskTypeAggregatedList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 28 matching lines @@
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new DiskTypeAggregatedList.fromJson(data));
   }
 
   /**
-   * Returns the specified disk type resource.
+   * Returns the specified disk type. Get a list of available disk types by
+   * making a list() request.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [zone] - The name of the zone for this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
-   * [diskType] - Name of the disk type resource to return.
+   * [diskType] - Name of the disk type to return.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [DiskType].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
@@ skipping 21 matching lines @@
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new DiskType.fromJson(data));
   }
 
   /**
-   * Retrieves a list of disk type resources available to the specified project.
+   * Retrieves a list of disk types available to the specified project.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [zone] - The name of the zone for this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * [filter] - 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.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [DiskTypeList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 60 matching lines @@
    * field_name comparison_string literal_string.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [DiskAggregatedList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 142 matching lines @@
                                        "DELETE",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Returns a specified persistent disk.
+   * Returns a specified persistent disk. Get a list of available persistent
+   * disks by making a list() request.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [zone] - The name of the zone for this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
@@ skipping 32 matching lines @@
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Disk.fromJson(data));
   }
 
   /**
-   * Creates a persistent disk in the specified project using the data included
-   * in the request.
+   * 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.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [zone] - The name of the zone for this request.
@@ skipping 59 matching lines @@
    * field_name comparison_string literal_string.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [DiskList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 40 matching lines @@
 }
 
 
 class FirewallsResourceApi {
   final commons.ApiRequester _requester;
 
   FirewallsResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
-   * Deletes the specified firewall resource.
+   * Deletes the specified firewall.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [firewall] - Name of the firewall resource to delete.
+   * [firewall] - Name of the firewall rule to delete.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [Operation].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
@@ skipping 18 matching lines @@
                                        "DELETE",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Returns the specified firewall resource.
+   * Returns the specified firewall.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [firewall] - Name of the firewall resource to return.
+   * [firewall] - Name of the firewall rule to return.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [Firewall].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
@@ skipping 18 matching lines @@
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Firewall.fromJson(data));
   }
 
   /**
-   * Creates a firewall resource in the specified project using the data
-   * included in the request.
+   * Creates a firewall rule in the specified project using the data included in
+   * the request.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * Completes with a [Operation].
@@ skipping 25 matching lines @@
                                        "POST",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Retrieves the list of firewall resources available to the specified
-   * project.
+   * Retrieves the list of firewall rules available to the specified project.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [filter] - 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.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [FirewallList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 28 matching lines @@
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new FirewallList.fromJson(data));
   }
 
   /**
-   * Updates the specified firewall resource with the data included in the
-   * request. This method supports patch semantics.
+   * Updates the specified firewall rule with the data included in the request.
+   * This method supports patch semantics.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [firewall] - Name of the firewall resource to update.
+   * [firewall] - Name of the firewall rule to update.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [Operation].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
@@ skipping 21 matching lines @@
                                        "PATCH",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Updates the specified firewall resource with the data included in the
-   * request.
+   * Updates the specified firewall rule with the data included in the request.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [firewall] - Name of the firewall resource to update.
+   * [firewall] - Name of the firewall rule to update.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [Operation].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
@@ skipping 50 matching lines @@
    * field_name comparison_string literal_string.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [ForwardingRuleAggregatedList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 211 matching lines @@
    * field_name comparison_string literal_string.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [ForwardingRuleList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 147 matching lines @@
                                        "DELETE",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Returns the specified address resource.
+   * Returns the specified address resource. Get a list of available addresses
+   * by making a list() request.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [address] - Name of the address resource to return.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
@@ skipping 73 matching lines @@
                                        "POST",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Retrieves a list of global address resources.
+   * Retrieves a list of global addresses.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [filter] - 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.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [AddressList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 84 matching lines @@
                                        "DELETE",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Returns the specified ForwardingRule resource.
+   * Returns the specified ForwardingRule resource. Get a list of available
+   * forwarding rules by making a list() request.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [forwardingRule] - Name of the ForwardingRule resource to return.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
@@ skipping 94 matching lines @@
    * field_name comparison_string literal_string.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [ForwardingRuleList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 111 matching lines @@
    * field_name comparison_string literal_string.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [OperationAggregatedList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 75 matching lines @@
                                        "DELETE",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => null);
   }
 
   /**
-   * Retrieves the specified Operations resource.
+   * Retrieves the specified Operations resource. Get a list of operations by
+   * making a list() request.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [operation] - Name of the Operations resource to return.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
@@ skipping 47 matching lines @@
    * field_name comparison_string literal_string.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [OperationList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 84 matching lines @@
                                        "DELETE",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Returns the specified HttpHealthCheck resource.
+   * Returns the specified HttpHealthCheck resource. Get a list of available
+   * HTTP health checks by making a list() request.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [httpHealthCheck] - Name of the HttpHealthCheck resource to return.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
@@ skipping 94 matching lines @@
    * field_name comparison_string literal_string.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [HttpHealthCheckList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 190 matching lines @@
                                        "DELETE",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Returns the specified HttpsHealthCheck resource.
+   * Returns the specified HttpsHealthCheck resource. Get a list of available
+   * HTTPS health checks by making a list() request.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [httpsHealthCheck] - Name of the HttpsHealthCheck resource to return.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
@@ skipping 94 matching lines @@
    * field_name comparison_string literal_string.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [HttpsHealthCheckList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 143 matching lines @@
 }
 
 
 class ImagesResourceApi {
   final commons.ApiRequester _requester;
 
   ImagesResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
-   * Deletes the specified image resource.
+   * Deletes the specified image.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [image] - Name of the image resource to delete.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
@@ skipping 80 matching lines @@
                                        "POST",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Returns the specified image resource.
+   * Returns the specified image. Get a list of available images by making a
+   * list() request.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [image] - Name of the image resource to return.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
@@ skipping 26 matching lines @@
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Image.fromJson(data));
   }
 
   /**
-   * Creates an image resource in the specified project using the data included
-   * in the request.
+   * Creates an image in the specified project using the data included in the
+   * request.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * Completes with a [Operation].
@@ skipping 52 matching lines @@
    * field_name comparison_string literal_string.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [ImageList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 120 matching lines @@
    * field_name comparison_string literal_string.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [InstanceGroupManagerAggregatedList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 143 matching lines @@
                                        "POST",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Returns all of the details about the specified managed instance group.
+   * Returns all of the details about the specified managed instance group. Get
+   * a list of available managed instance groups by making a list() request.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [zone] - The name of the zone where the managed instance group is located.
    *
    * [instanceGroupManager] - The name of the managed instance group.
@@ skipping 110 matching lines @@
    * field_name comparison_string literal_string.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [InstanceGroupManagerList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 339 matching lines @@
 }
 
 
 class InstanceGroupsResourceApi {
   final commons.ApiRequester _requester;
 
   InstanceGroupsResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
-   * Adds a list of instances to the specified instance group. Read  Adding
-   * instances for more information.
+   * 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.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [zone] - The name of the zone where the instance group is located.
@@ skipping 56 matching lines @@
    * field_name comparison_string literal_string.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [InstanceGroupAggregatedList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 81 matching lines @@
                                        "DELETE",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Returns the specified instance group resource.
+   * Returns the specified instance group. Get a list of available instance
+   * groups by making a list() request.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [zone] - The name of the zone where the instance group is located.
    *
    * [instanceGroup] - The name of the instance group.
@@ skipping 105 matching lines @@
    * field_name comparison_string literal_string.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [InstanceGroupList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 58 matching lines @@
    * field_name comparison_string literal_string.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [InstanceGroupsListInstances].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 161 matching lines @@
 }
 
 
 class InstanceTemplatesResourceApi {
   final commons.ApiRequester _requester;
 
   InstanceTemplatesResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
-   * Deletes the specified instance template.
+   * 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.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [instanceTemplate] - The name of the instance template to delete.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
@@ skipping 26 matching lines @@
                                        "DELETE",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Returns the specified instance template resource.
+   * Returns the specified instance template. Get a list of available instance
+   * templates by making a list() request.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [instanceTemplate] - The name of the instance template.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
@@ skipping 96 matching lines @@
    * field_name comparison_string literal_string.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [InstanceTemplateList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 102 matching lines @@
                                        "POST",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Retrieves aggregated list of instance resources.
+   * Retrieves aggregated list of instances.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [filter] - 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.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [InstanceAggregatedList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 41 matching lines @@
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [zone] - The name of the zone for this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
-   * [instance] - Instance name.
+   * [instance] - The instance name for this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [Operation].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
@@ skipping 203 matching lines @@
                                        "POST",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Returns the specified instance resource.
+   * Returns the specified Instance resource. Get a list of available instances
+   * by making a list() request.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [zone] - The name of the zone for this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
@@ skipping 144 matching lines @@
                                        "POST",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Retrieves the list of instance resources contained within the specified
-   * zone.
+   * Retrieves the list of instances contained within the specified zone.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [zone] - The name of the zone for this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * [filter] - 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.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [InstanceList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 506 matching lines @@
 }
 
 
 class LicensesResourceApi {
   final commons.ApiRequester _requester;
 
   LicensesResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
-   * Returns the specified license resource.
+   * Returns the specified License resource. Get a list of available licenses by
+   * making a list() request.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [license] - Name of the license resource to return.
+   * [license] - Name of the License resource to return.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [License].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
@@ skipping 27 matching lines @@
 }
 
 
 class MachineTypesResourceApi {
   final commons.ApiRequester _requester;
 
   MachineTypesResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
-   * Retrieves an aggregated list of machine type resources.
+   * Retrieves an aggregated list of machine types.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [filter] - 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.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [MachineTypeAggregatedList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 28 matching lines @@
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new MachineTypeAggregatedList.fromJson(data));
   }
 
   /**
-   * Returns the specified machine type resource.
+   * Returns the specified machine type. Get a list of available machine types
+   * by making a list() request.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [zone] - The name of the zone for this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
-   * [machineType] - Name of the machine type resource to return.
+   * [machineType] - Name of the machine type to return.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [MachineType].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
@@ skipping 21 matching lines @@
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new MachineType.fromJson(data));
   }
 
   /**
-   * Retrieves a list of machine type resources available to the specified
-   * project.
+   * Retrieves a list of machine types available to the specified project.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [zone] - The name of the zone for this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * [filter] - 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.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [MachineTypeList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 40 matching lines @@
 }
 
 
 class NetworksResourceApi {
   final commons.ApiRequester _requester;
 
   NetworksResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
-   * Deletes the specified network resource.
+   * Deletes the specified network.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [network] - Name of the network resource to delete.
+   * [network] - Name of the network to delete.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [Operation].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
@@ skipping 18 matching lines @@
                                        "DELETE",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Returns the specified network resource.
+   * Returns the specified network. Get a list of available networks by making a
+   * list() request.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [network] - Name of the network resource to return.
+   * [network] - Name of the network to return.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [Network].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
@@ skipping 18 matching lines @@
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Network.fromJson(data));
   }
 
   /**
-   * Creates a network resource in the specified project using the data included
-   * in the request.
+   * Creates a network in the specified project using the data included in the
+   * request.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * Completes with a [Operation].
@@ skipping 25 matching lines @@
                                        "POST",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Retrieves the list of network resources available to the specified project.
+   * Retrieves the list of networks available to the specified project.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [filter] - 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.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [NetworkList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 37 matching lines @@
 }
 
 
 class ProjectsResourceApi {
   final commons.ApiRequester _requester;
 
   ProjectsResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
-   * Returns the specified project resource.
+   * Returns the specified Project resource.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * Completes with a [Project].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
@@ skipping 225 matching lines @@
 
   /**
    * Deletes the specified region-specific Operations resource.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [region] - Name of the region scoping this request.
+   * [region] - Name of the region for this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * [operation] - Name of the Operations resource to delete.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
@@ skipping 32 matching lines @@
 
   /**
    * Retrieves the specified region-specific Operations resource.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [region] - Name of the region scoping this request.
+   * [region] - Name of the region for this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * [operation] - Name of the Operations resource to return.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [Operation].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
@@ skipping 33 matching lines @@
   /**
    * Retrieves a list of Operation resources contained within the specified
    * region.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [region] - Name of the region scoping this request.
+   * [region] - Name of the region for this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * [filter] - 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.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [OperationList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 40 matching lines @@
 }
 
 
 class RegionsResourceApi {
   final commons.ApiRequester _requester;
 
   RegionsResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
-   * Returns the specified region resource.
+   * Returns the specified Region resource. Get a list of available regions by
+   * making a list() request.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [region] - Name of the region resource to return.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
@@ skipping 46 matching lines @@
    * field_name comparison_string literal_string.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [RegionList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 37 matching lines @@
 }
 
 
 class RoutesResourceApi {
   final commons.ApiRequester _requester;
 
   RoutesResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
-   * Deletes the specified route resource.
+   * Deletes the specified Route resource.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [route] - Name of the route resource to delete.
+   * [route] - Name of the Route resource to delete.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [Operation].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
@@ skipping 18 matching lines @@
                                        "DELETE",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Returns the specified route resource.
+   * Returns the specified Route resource. Get a list of available routes by
+   * making a list() request.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [route] - Name of the route resource to return.
+   * [route] - Name of the Route resource to return.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [Route].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
@@ skipping 18 matching lines @@
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Route.fromJson(data));
   }
 
   /**
-   * Creates a route resource in the specified project using the data included
+   * Creates a Route resource in the specified project using the data included
    * in the request.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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 26 matching lines @@
                                        "POST",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Retrieves the list of route resources available to the specified project.
+   * Retrieves the list of Route resources available to the specified project.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [filter] - 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.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [RouteList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 90 matching lines @@
                                        "DELETE",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Returns the specified Snapshot resource.
+   * Returns the specified Snapshot resource. Get a list of available snapshots
+   * by making a list() request.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [snapshot] - Name of the Snapshot resource to return.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
@@ skipping 47 matching lines @@
    * field_name comparison_string literal_string.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [SnapshotList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 84 matching lines @@
                                        "DELETE",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Returns the specified SslCertificate resource.
+   * Returns the specified SslCertificate resource. Get a list of available SSL
+   * certificates by making a list() request.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [sslCertificate] - Name of the SslCertificate resource to return.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
@@ skipping 94 matching lines @@
    * field_name comparison_string literal_string.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [SslCertificateList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 57 matching lines @@
    * field_name comparison_string literal_string.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [SubnetworkAggregatedList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 81 matching lines @@
                                        "DELETE",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Returns the specified subnetwork.
+   * Returns the specified subnetwork. Get a list of available subnetworks by
+   * making a list() request.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [region] - Name of the region scoping this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
@@ skipping 108 matching lines @@
    * field_name comparison_string literal_string.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [SubnetworkList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 87 matching lines @@
                                        "DELETE",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Returns the specified TargetHttpProxy resource.
+   * Returns the specified TargetHttpProxy resource. Get a list of available
+   * target HTTP proxies by making a list() request.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [targetHttpProxy] - Name of the TargetHttpProxy resource to return.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
@@ skipping 94 matching lines @@
    * field_name comparison_string literal_string.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [TargetHttpProxyList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 38 matching lines @@
    * Changes the URL map for TargetHttpProxy.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [targetHttpProxy] - Name of the TargetHttpProxy resource whose URL map is
-   * to be set.
+   * [targetHttpProxy] - Name of the TargetHttpProxy to set a URL map for.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [Operation].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
@@ skipping 77 matching lines @@
                                        "DELETE",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Returns the specified TargetHttpsProxy resource.
+   * Returns the specified TargetHttpsProxy resource. Get a list of available
+   * target HTTPS proxies by making a list() request.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [targetHttpsProxy] - Name of the TargetHttpsProxy resource to return.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
@@ skipping 94 matching lines @@
    * field_name comparison_string literal_string.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [TargetHttpsProxyList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 38 matching lines @@
    * Replaces SslCertificates for TargetHttpsProxy.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [targetHttpsProxy] - Name of the TargetHttpsProxy resource whose
-   * SSLCertificate is to be set.
+   * [targetHttpsProxy] - Name of the TargetHttpsProxy resource to set an
+   * SslCertificates resource for.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [Operation].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
@@ skipping 103 matching lines @@
    * field_name comparison_string literal_string.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [TargetInstanceAggregatedList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 81 matching lines @@
                                        "DELETE",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Returns the specified TargetInstance resource.
+   * Returns the specified TargetInstance resource. Get a list of available
+   * target instances by making a list() request.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [zone] - Name of the zone scoping this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
@@ skipping 109 matching lines @@
    * field_name comparison_string literal_string.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [TargetInstanceList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 40 matching lines @@
 }
 
 
 class TargetPoolsResourceApi {
   final commons.ApiRequester _requester;
 
   TargetPoolsResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
-   * Adds health check URL to targetPool.
+   * Adds health check URLs to a target pool.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
-   * [project] - null
+   * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [region] - Name of the region scoping this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
-   * [targetPool] - Name of the TargetPool resource to which health_check_url is
-   * to be added.
+   * [targetPool] - Name of the target pool to add a health check to.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [Operation].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
@@ skipping 24 matching lines @@
                                        "POST",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Adds instance URL to targetPool.
+   * Adds an instance to a target pool.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
-   * [project] - null
+   * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [region] - Name of the region scoping this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
-   * [targetPool] - Name of the TargetPool resource to which instance_url is to
-   * be added.
+   * [targetPool] - Name of the TargetPool resource to add instances to.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [Operation].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
@@ skipping 44 matching lines @@
    * field_name comparison_string literal_string.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [TargetPoolAggregatedList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 28 matching lines @@
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new TargetPoolAggregatedList.fromJson(data));
   }
 
   /**
-   * Deletes the specified TargetPool resource.
+   * Deletes the specified target pool.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [region] - Name of the region scoping this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
@@ skipping 32 matching lines @@
                                        "DELETE",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Returns the specified TargetPool resource.
+   * Returns the specified target pool. Get a list of available target pools by
+   * making a list() request.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [region] - Name of the region scoping this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
@@ skipping 32 matching lines @@
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new TargetPool.fromJson(data));
   }
 
   /**
-   * Gets the most recent health check results for each IP for the given
-   * instance that is referenced by the given TargetPool.
+   * Gets the most recent health check results for each IP for the instance that
+   * is referenced by the given target pool.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
-   * [project] - null
+   * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [region] - Name of the region scoping this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * [targetPool] - Name of the TargetPool resource to which the queried
    * instance belongs.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
@@ skipping 32 matching lines @@
                                        "POST",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new TargetPoolInstanceHealth.fromJson(data));
   }
 
   /**
-   * Creates a TargetPool resource in the specified project and region using the
-   * data included in the request.
+   * Creates a target pool in the specified project and region using the data
+   * included in the request.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [region] - Name of the region scoping this request.
@@ skipping 31 matching lines @@
                                        "POST",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Retrieves a list of TargetPool resources available to the specified project
-   * and region.
+   * Retrieves a list of target pools available to the specified project and
+   * region.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [region] - Name of the region scoping this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * [filter] - 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.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [TargetPoolList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 31 matching lines @@
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new TargetPoolList.fromJson(data));
   }
 
   /**
-   * Removes health check URL from targetPool.
+   * Removes health check URL from a target pool.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
-   * [project] - null
+   * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [region] - Name of the region scoping this request.
+   * [region] - Name of the region for this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
-   * [targetPool] - Name of the TargetPool resource to which health_check_url is
-   * to be removed.
+   * [targetPool] - Name of the target pool to remove health checks from.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [Operation].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
@@ skipping 24 matching lines @@
                                        "POST",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Removes instance URL from targetPool.
+   * Removes instance URL from a target pool.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
-   * [project] - null
+   * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [region] - Name of the region scoping this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
-   * [targetPool] - Name of the TargetPool resource to which instance_url is to
-   * be removed.
+   * [targetPool] - Name of the TargetPool resource to remove instances from.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [Operation].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
@@ skipping 24 matching lines @@
                                        "POST",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Changes backup pool configurations.
+   * Changes a backup target pool's configurations.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [region] - Name of the region scoping this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
-   * [targetPool] - Name of the TargetPool resource for which the backup is to
-   * be set.
+   * [targetPool] - Name of the TargetPool resource to set a backup pool for.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
-   * [failoverRatio] - New failoverRatio value for the containing target pool.
+   * [failoverRatio] - New failoverRatio value for the target pool.
    *
    * Completes with a [Operation].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
   async.Future<Operation> setBackup(TargetReference request, core.String project, core.String region, core.String targetPool, {core.double failoverRatio}) {
@@ skipping 35 matching lines @@
 }
 
 
 class TargetVpnGatewaysResourceApi {
   final commons.ApiRequester _requester;
 
   TargetVpnGatewaysResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
-   * Retrieves an aggregated list of target VPN gateways .
+   * Retrieves an aggregated list of target VPN gateways.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [filter] - 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.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [TargetVpnGatewayAggregatedList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 28 matching lines @@
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new TargetVpnGatewayAggregatedList.fromJson(data));
   }
 
   /**
-   * Deletes the specified TargetVpnGateway resource.
+   * Deletes the specified target VPN gateway.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [region] - The name of the region for this request.
+   * [region] - Name of the region for this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
-   * [targetVpnGateway] - Name of the TargetVpnGateway resource to delete.
+   * [targetVpnGateway] - Name of the target VPN gateway to delete.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [Operation].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
@@ skipping 21 matching lines @@
                                        "DELETE",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Returns the specified TargetVpnGateway resource.
+   * Returns the specified target VPN gateway. Get a list of available target
+   * VPN gateways by making a list() request.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [region] - The name of the region for this request.
+   * [region] - Name of the region for this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
-   * [targetVpnGateway] - Name of the TargetVpnGateway resource to return.
+   * [targetVpnGateway] - Name of the target VPN gateway to return.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [TargetVpnGateway].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
@@ skipping 21 matching lines @@
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new TargetVpnGateway.fromJson(data));
   }
 
   /**
-   * Creates a TargetVpnGateway resource in the specified project and region
-   * using the data included in the request.
+   * Creates a target VPN gateway in the specified project and region using the
+   * data included in the request.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [region] - The name of the region for this request.
+   * [region] - Name of the region for this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [Operation].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
@@ skipping 21 matching lines @@
                                        "POST",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Retrieves a list of TargetVpnGateway resources available to the specified
-   * project and region.
+   * Retrieves a list of target VPN gateways available to the specified project
+   * and region.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [region] - The name of the region for this request.
+   * [region] - Name of the region for this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * [filter] - 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.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [TargetVpnGatewayList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 87 matching lines @@
                                        "DELETE",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Returns the specified UrlMap resource.
+   * Returns the specified UrlMap resource. Get a list of available URL maps by
+   * making a list() request.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [urlMap] - Name of the UrlMap resource to return.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
@@ skipping 93 matching lines @@
    * field_name comparison_string literal_string.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [UrlMapList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 216 matching lines @@
    * field_name comparison_string literal_string.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [VpnTunnelAggregatedList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 36 matching lines @@
 
   /**
    * Deletes the specified VpnTunnel resource.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [region] - The name of the region for this request.
+   * [region] - Name of the region for this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * [vpnTunnel] - Name of the VpnTunnel resource to delete.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [Operation].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
@@ skipping 24 matching lines @@
                                        "DELETE",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
-   * Returns the specified VpnTunnel resource.
+   * Returns the specified VpnTunnel resource. Get a list of available VPN
+   * tunnels by making a list() request.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [region] - The name of the region for this request.
+   * [region] - Name of the region for this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * [vpnTunnel] - Name of the VpnTunnel resource to return.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [VpnTunnel].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
@@ skipping 35 matching lines @@
    * data included in the request.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [region] - The name of the region for this request.
+   * [region] - Name of the region for this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [Operation].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
@@ skipping 30 matching lines @@
   /**
    * Retrieves a list of VpnTunnel resources contained in the specified project
    * and region.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [region] - The name of the region for this request.
+   * [region] - Name of the region for this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * [filter] - 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.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [VpnTunnelList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 48 matching lines @@
 
   /**
    * Deletes the specified zone-specific Operations resource.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [zone] - Name of the zone scoping this request.
+   * [zone] - Name of the zone for this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * [operation] - Name of the Operations resource to delete.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
@@ skipping 32 matching lines @@
 
   /**
    * Retrieves the specified zone-specific Operations resource.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [zone] - Name of the zone scoping this request.
+   * [zone] - Name of the zone for this request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * [operation] - Name of the Operations resource to return.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * Completes with a [Operation].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
@@ skipping 33 matching lines @@
   /**
    * Retrieves a list of Operation resources contained within the specified
    * zone.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
-   * [zone] - Name of the zone scoping this request.
+   * [zone] - Name of the zone for request.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
    * [filter] - 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.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [OperationList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 40 matching lines @@
 }
 
 
 class ZonesResourceApi {
   final commons.ApiRequester _requester;
 
   ZonesResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
-   * Returns the specified zone resource.
+   * Returns the specified Zone resource. Get a list of available zones by
+   * making a list() request.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [zone] - Name of the zone resource to return.
    * Value must have pattern "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?".
    *
@@ skipping 26 matching lines @@
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Zone.fromJson(data));
   }
 
   /**
-   * Retrieves the list of zone resources available to the specified project.
+   * Retrieves the list of Zone resources available to the specified project.
    *
    * Request parameters:
    *
    * [project] - Project ID for this request.
    * Value must have 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])?))".
    *
    * [filter] - 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.
    *
    * The 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.
    *
-   * For example, filter=name ne example-instance.
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
    *
    * Compute 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.
    *
    * The 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
+   * expressions are treated as AND expressions, meaning that resources must
    * match all expressions to pass the filters.
    *
-   * [maxResults] - 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.
+   * [maxResults] - 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.
    * Value must be between "0" and "500".
    *
    * [pageToken] - Specifies a page token to use. Set pageToken to the
    * nextPageToken returned by a previous list request to get the next page of
    * results.
    *
    * Completes with a [ZoneList].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 111 matching lines @@
   /**
    * [Output Only] The unique identifier for the resource. This identifier is
    * defined by the server.
    */
   core.String id;
   /**
    * [Output Only] Type of the resource. Always compute#address for addresses.
    */
   core.String kind;
   /**
-   * Name of the resource; provided by the client when the resource is created.
+   * 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.
    */
   core.String name;
   /**
    * [Output Only] URL of the region where the regional address resides. This
@@ skipping 143 matching lines @@
     if (nextPageToken != null) {
       _json["nextPageToken"] = nextPageToken;
     }
     if (selfLink != null) {
       _json["selfLink"] = selfLink;
     }
     return _json;
   }
 }
 
-/** Contains a list of address resources. */
+/** Contains a list of addresses. */
 class AddressList {
   /**
    * [Output Only] The unique identifier for the resource. This identifier is
    * defined by the server.
    */
   core.String id;
-  /** [Output Only] A list of Address resources. */
+  /** [Output Only] A list of addresses. */
   core.List<Address> items;
   /**
    * [Output Only] Type of resource. Always compute#addressList for lists of
    * addresses.
    */
   core.String kind;
   /**
    * [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
@@ skipping 44 matching lines @@
     return _json;
   }
 }
 
 class AddressesScopedListWarningData {
   /**
    * [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).
+   * 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).
    */
   core.String key;
   /** [Output Only] A warning data value corresponding to the key. */
   core.String value;
 
   AddressesScopedListWarningData();
 
   AddressesScopedListWarningData.fromJson(core.Map _json) {
     if (_json.containsKey("key")) {
       key = _json["key"];
@@ skipping 17 matching lines @@
 
 /**
  * [Output Only] Informational warning which replaces the list of addresses when
  * the list is empty.
  */
 class AddressesScopedListWarning {
   /**
    * [Output Only] A warning code, if applicable. For example, Compute Engine
    * returns NO_RESULTS_ON_PAGE if there are no results in the response.
    * Possible string values are:
+   * - "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"
@@ skipping 106 matching lines @@
   /**
    * [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.
    *
    * This property is mutually exclusive with the source property; you can only
    * define one or the other, but not both.
    */
   AttachedDiskInitializeParams initializeParams;
   /**
-   * 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.
+   * 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.
    * Possible string values are:
    * - "NVME"
    * - "SCSI"
    */
   core.String interface;
   /**
    * [Output Only] Type of the resource. Always compute#attachedDisk for
    * attached disks.
    */
   core.String kind;
@@ skipping 175 matching lines @@
     if (diskType != null) {
       _json["diskType"] = diskType;
     }
     if (sourceImage != null) {
       _json["sourceImage"] = sourceImage;
     }
     return _json;
   }
 }
 
+/**
+ * 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.
+ */
 class Autoscaler {
-  /** Autoscaling configuration. */
+  /**
+   * The configuration parameters for the autoscaling algorithm. You can define
+   * one or more of the policies for an autoscaler: cpuUtilization,
+   * customMetricUtilizations, and loadBalancingUtilization.
+   *
+   * If none of these are specified, the default will be to autoscale based on
+   * cpuUtilization to 0.8 or 80%.
+   */
   AutoscalingPolicy autoscalingPolicy;
   /** [Output Only] Creation timestamp in RFC3339 text format. */
   core.String creationTimestamp;
   /**
    * An optional description of this resource. Provide this property when you
    * create the resource.
    */
   core.String description;
   /**
    * [Output Only] The unique identifier for the resource. This identifier is
    * defined by the server.
    */
   core.String id;
-  /** Type of the resource. */
+  /**
+   * [Output Only] Type of the resource. Always compute#autoscaler for
+   * autoscalers.
+   */
   core.String kind;
   /**
    * 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.
    */
   core.String name;
   /** [Output Only] Server-defined URL for the resource. */
   core.String selfLink;
-  /**
-   * URL of Instance Group Manager or Replica Pool which will be controlled by
-   * Autoscaler.
-   */
+  /** URL of the managed instance group that this autoscaler will scale. */
   core.String target;
   /** [Output Only] URL of the zone where the instance group resides. */
   core.String zone;
 
   Autoscaler();
 
   Autoscaler.fromJson(core.Map _json) {
     if (_json.containsKey("autoscalingPolicy")) {
       autoscalingPolicy = new AutoscalingPolicy.fromJson(_json["autoscalingPolicy"]);
     }
@@ skipping 57 matching lines @@
 }
 
 class AutoscalerAggregatedList {
   /**
    * [Output Only] The unique identifier for the resource. This identifier is
    * defined by the server.
    */
   core.String id;
   /** A map of scoped autoscaler lists. */
   core.Map<core.String, AutoscalersScopedList> items;
-  /** Type of resource. */
+  /**
+   * [Output Only] Type of resource. Always compute#autoscalerAggregatedList for
+   * aggregated lists of autoscalers.
+   */
   core.String kind;
   /**
    * [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.
    */
   core.String nextPageToken;
   /** [Output Only] Server-defined URL for this resource. */
@@ skipping 33 matching lines @@
     if (nextPageToken != null) {
       _json["nextPageToken"] = nextPageToken;
     }
     if (selfLink != null) {
       _json["selfLink"] = selfLink;
     }
     return _json;
   }
 }
 
-/** Contains a list of persistent autoscaler resources. */
+/** Contains a list of Autoscaler resources. */
 class AutoscalerList {
   /**
    * [Output Only] The unique identifier for the resource. This identifier is
    * defined by the server.
    */
   core.String id;
   /** A list of Autoscaler resources. */
   core.List<Autoscaler> items;
-  /** Type of resource. */
+  /**
+   * [Output Only] Type of resource. Always compute#autoscalerList for lists of
+   * autoscalers.
+   */
   core.String kind;
   /**
    * [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.
    */
   core.String nextPageToken;
   /** [Output Only] Server-defined URL for this resource. */
@@ skipping 39 matching lines @@
     return _json;
   }
 }
 
 class AutoscalersScopedListWarningData {
   /**
    * [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).
+   * 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).
    */
   core.String key;
   /** [Output Only] A warning data value corresponding to the key. */
   core.String value;
 
   AutoscalersScopedListWarningData();
 
   AutoscalersScopedListWarningData.fromJson(core.Map _json) {
     if (_json.containsKey("key")) {
       key = _json["key"];
     }
     if (_json.containsKey("value")) {
       value = _json["value"];
     }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (key != null) {
       _json["key"] = key;
     }
     if (value != null) {
       _json["value"] = value;
     }
     return _json;
   }
 }
 
 /**
- * Informational warning which replaces the list of autoscalers when the list is
- * empty.
+ * [Output Only] Informational warning which replaces the list of autoscalers
+ * when the list is empty.
  */
 class AutoscalersScopedListWarning {
   /**
    * [Output Only] A warning code, if applicable. For example, Compute Engine
    * returns NO_RESULTS_ON_PAGE if there are no results in the response.
    * Possible string values are:
+   * - "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"
@@ skipping 35 matching lines @@
       _json["data"] = data.map((value) => (value).toJson()).toList();
     }
     if (message != null) {
       _json["message"] = message;
     }
     return _json;
   }
 }
 
 class AutoscalersScopedList {
-  /** List of autoscalers contained in this scope. */
+  /** [Output Only] List of autoscalers contained in this scope. */
   core.List<Autoscaler> autoscalers;
   /**
-   * Informational warning which replaces the list of autoscalers when the list
-   * is empty.
+   * [Output Only] Informational warning which replaces the list of autoscalers
+   * when the list is empty.
    */
   AutoscalersScopedListWarning warning;
 
   AutoscalersScopedList();
 
   AutoscalersScopedList.fromJson(core.Map _json) {
     if (_json.containsKey("autoscalers")) {
       autoscalers = _json["autoscalers"].map((value) => new Autoscaler.fromJson(value)).toList();
     }
     if (_json.containsKey("warning")) {
       warning = new AutoscalersScopedListWarning.fromJson(_json["warning"]);
     }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (autoscalers != null) {
       _json["autoscalers"] = autoscalers.map((value) => (value).toJson()).toList();
     }
     if (warning != null) {
       _json["warning"] = (warning).toJson();
     }
     return _json;
   }
 }
 
 /** Cloud Autoscaler policy. */
 class AutoscalingPolicy {
   /**
-   * 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.
+   * 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.
+   *
+   * Virtual 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.
    */
   core.int coolDownPeriodSec;
   /**
-   * 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.
+   * Defines the CPU utilization policy that allows the autoscaler to scale
+   * based on the average CPU utilization of a managed instance group.
    */
   AutoscalingPolicyCpuUtilization cpuUtilization;
-  /** Configuration parameters of autoscaling based on custom metric. */
+  /** Configuration parameters of autoscaling based on a custom metric. */
   core.List<AutoscalingPolicyCustomMetricUtilization> customMetricUtilizations;
   /** Configuration parameters of autoscaling based on load balancer. */
   AutoscalingPolicyLoadBalancingUtilization loadBalancingUtilization;
   /**
-   * 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.
+   * 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.
    */
   core.int maxNumReplicas;
   /**
-   * 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.
+   * 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.
    */
   core.int minNumReplicas;
 
   AutoscalingPolicy();
 
   AutoscalingPolicy.fromJson(core.Map _json) {
     if (_json.containsKey("coolDownPeriodSec")) {
       coolDownPeriodSec = _json["coolDownPeriodSec"];
     }
     if (_json.containsKey("cpuUtilization")) {
@@ skipping 33 matching lines @@
     if (minNumReplicas != null) {
       _json["minNumReplicas"] = minNumReplicas;
     }
     return _json;
   }
 }
 
 /** CPU utilization policy. */
 class AutoscalingPolicyCpuUtilization {
   /**
-   * 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.
+   * 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.
+   *
+   * If 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.
+   *
+   * If 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.
    */
   core.double utilizationTarget;
 
   AutoscalingPolicyCpuUtilization();
 
   AutoscalingPolicyCpuUtilization.fromJson(core.Map _json) {
     if (_json.containsKey("utilizationTarget")) {
       utilizationTarget = _json["utilizationTarget"];
     }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (utilizationTarget != null) {
       _json["utilizationTarget"] = utilizationTarget;
     }
     return _json;
   }
 }
 
 /** Custom utilization metric policy. */
 class AutoscalingPolicyCustomMetricUtilization {
   /**
-   * 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.
+   * 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.
+   *
+   * For example, the following is a valid metric:
+   * compute.googleapis.com/instance/network/received_bytes_count
+   *
+   *
+   * The following is not a valid metric because it does not increase or
+   * decrease based on usage:
+   * compute.googleapis.com/instance/cpu/reserved_cores
    */
   core.String metric;
   /**
-   * Target value of the metric which Autoscaler should maintain. Must be a
+   * Target value of the metric which autoscaler should maintain. Must be a
    * positive value.
    */
   core.double utilizationTarget;
   /**
-   * Defines type in which utilization_target is expressed.
+   * 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.
    * Possible string values are:
    * - "DELTA_PER_MINUTE"
    * - "DELTA_PER_SECOND"
    * - "GAUGE"
    */
   core.String utilizationTargetType;
 
   AutoscalingPolicyCustomMetricUtilization();
 
   AutoscalingPolicyCustomMetricUtilization.fromJson(core.Map _json) {
@@ skipping 16 matching lines @@
     if (utilizationTarget != null) {
       _json["utilizationTarget"] = utilizationTarget;
     }
     if (utilizationTargetType != null) {
       _json["utilizationTargetType"] = utilizationTargetType;
     }
     return _json;
   }
 }
 
-/** Load balancing utilization policy. */
+/** Configuration parameters of autoscaling based on load balancing. */
 class AutoscalingPolicyLoadBalancingUtilization {
   /**
-   * 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.
+   * 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.
    */
   core.double utilizationTarget;
 
   AutoscalingPolicyLoadBalancingUtilization();
 
   AutoscalingPolicyLoadBalancingUtilization.fromJson(core.Map _json) {
     if (_json.containsKey("utilizationTarget")) {
       utilizationTarget = _json["utilizationTarget"];
     }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (utilizationTarget != null) {
       _json["utilizationTarget"] = utilizationTarget;
     }
     return _json;
   }
 }
 
 /** Message containing information of one individual backend. */
 class Backend {
   /**
-   * Specifies the balancing mode for this backend. The default is UTILIZATION
-   * but available values are UTILIZATION and RATE.
+   * Specifies the balancing mode for this backend. For global HTTP(S) load
+   * balancing, the default is UTILIZATION. Valid values are UTILIZATION and
+   * RATE.
    * Possible string values are:
    * - "RATE"
    * - "UTILIZATION"
    */
   core.String balancingMode;
   /**
    * 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
@@ skipping 11 matching lines @@
    * 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.
    *
    * Note that you must specify an Instance Group resource using the
    * fully-qualified URL, rather than a partial URL.
    */
   core.String group;
   /**
    * 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.
+   * RATE or UTILIZATION balancing modes, but required if RATE mode. For RATE
+   * mode, either maxRate or maxRatePerInstance must be set.
    */
   core.int maxRate;
   /**
-   * 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.
+   * 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.
    */
   core.double maxRatePerInstance;
   /**
    * 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].
    */
   core.double maxUtilization;
 
   Backend();
@@ skipping 102 matching lines @@
    * lowercase letter, or digit, except the last character, which cannot be a
    * dash.
    */
   core.String name;
   /**
    * Deprecated in favor of portName. The TCP port to connect on the backend.
    * The default value is 80.
    */
   core.int port;
   /**
-   * Name of backend port. The same name should appear in the resource views
+   * Name of backend port. The same name should appear in the instance groups
    * referenced by this service. Required.
    */
   core.String portName;
   /**
+   * The protocol this BackendService uses to communicate with backends.
    *
+   * Possible values are HTTP, HTTPS, HTTP2, TCP and SSL.
    * Possible string values are:
    * - "HTTP"
    * - "HTTPS"
    */
   core.String protocol;
   /** [Output Only] Server-defined URL for the resource. */
   core.String selfLink;
   /**
    * How many seconds to wait for the backend before considering it a failed
-   * request. Default is 30 seconds. Valid range is [1, 86400].
+   * request. Default is 30 seconds.
    */
   core.int timeoutSec;
 
   BackendService();
 
   BackendService.fromJson(core.Map _json) {
     if (_json.containsKey("backends")) {
       backends = _json["backends"].map((value) => new Backend.fromJson(value)).toList();
     }
     if (_json.containsKey("creationTimestamp")) {
@@ skipping 266 matching lines @@
    * [Output Only] The unique identifier for the resource. This identifier is
    * defined by the server.
    */
   core.String id;
   /** [Output Only] Type of the resource. Always compute#disk for disks. */
   core.String kind;
   /** [Output Only] Last attach timestamp in RFC3339 text format. */
   core.String lastAttachTimestamp;
   /** [Output Only] Last detach timestamp in RFC3339 text format. */
   core.String lastDetachTimestamp;
-  /** Any applicable publicly visible licenses. */
+  /** [Output Only] Any applicable publicly visible licenses. */
   core.List<core.String> licenses;
   /**
-   * Name of the resource; provided by the client when the resource is created.
+   * 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.
    */
   core.String name;
   /** Internal use only. */
   core.String options;
@@ skipping 21 matching lines @@
    * global/images/my-private-image
    *
    * Or 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:
    *
    * projects/debian-cloud/global/images/debian-7-wheezy-vYYYYMMDD
    *
    * where vYYYYMMDD is the image version. The fully-qualified URL will also
    * work in both cases.
+   *
+   * You can also specify the latest image for a private image family by
+   * replacing the image name suffix with family/family-name. For example:
+   *
+   * global/images/family/my-private-family
+   *
+   * Or 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:
+   *
+   * projects/debian-cloud/global/images/family/debian-7
    */
   core.String sourceImage;
   /**
-   * 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.
+   * [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.
    */
   core.String sourceImageId;
   /**
    * 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:
    * -
    * https://www.googleapis.com/compute/v1/projects/project/global/snapshots/snapshot
    * - projects/project/global/snapshots/snapshot
    * - global/snapshots/snapshot
@@ skipping 12 matching lines @@
    * CREATING, FAILED, READY, RESTORING.
    * Possible string values are:
    * - "CREATING"
    * - "FAILED"
    * - "READY"
    * - "RESTORING"
    */
   core.String status;
   /**
    * 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.
+   * the disk. Provide this when creating the disk.
    */
   core.String type;
   /**
-   * Links to the users of the disk (attached instances) in form:
+   * [Output Only] Links to the users of the disk (attached instances) in form:
    * project/zones/zone/instances/instance
    */
   core.List<core.String> users;
   /** [Output Only] URL of the zone where the disk resides. */
   core.String zone;
 
   Disk();
 
   Disk.fromJson(core.Map _json) {
     if (_json.containsKey("creationTimestamp")) {
@@ skipping 243 matching lines @@
     }
     if (selfLink != null) {
       _json["selfLink"] = selfLink;
     }
     return _json;
   }
 }
 
 class DiskMoveRequest {
   /**
-   * The URL of the destination zone to move the disk to. This can be a full or
+   * 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:
    * - https://www.googleapis.com/compute/v1/projects/project/zones/zone
    * - projects/project/zones/zone
    * - zones/zone
    */
   core.String destinationZone;
   /**
    * 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:
    * -
@@ skipping 19 matching lines @@
     if (destinationZone != null) {
       _json["destinationZone"] = destinationZone;
     }
     if (targetDisk != null) {
       _json["targetDisk"] = targetDisk;
     }
     return _json;
   }
 }
 
-/** A disk type resource. */
+/** A DiskType resource. */
 class DiskType {
   /** [Output Only] Creation timestamp in RFC3339 text format. */
   core.String creationTimestamp;
   /** [Output Only] Server-defined default disk size in GB. */
   core.String defaultDiskSizeGb;
   /** [Output Only] The deprecation status associated with this disk type. */
   DeprecationStatus deprecated;
   /** [Output Only] An optional description of this resource. */
   core.String description;
   /**
@@ skipping 143 matching lines @@
     if (nextPageToken != null) {
       _json["nextPageToken"] = nextPageToken;
     }
     if (selfLink != null) {
       _json["selfLink"] = selfLink;
     }
     return _json;
   }
 }
 
-/** Contains a list of disk type resources. */
+/** Contains a list of disk types. */
 class DiskTypeList {
   /**
    * [Output Only] The unique identifier for the resource. This identifier is
    * defined by the server.
    */
   core.String id;
   /** [Output Only] A list of Disk Type resources. */
   core.List<DiskType> items;
   /**
    * [Output Only] Type of resource. Always compute#diskTypeList for disk types.
@@ skipping 50 matching lines @@
     return _json;
   }
 }
 
 class DiskTypesScopedListWarningData {
   /**
    * [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).
+   * 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).
    */
   core.String key;
   /** [Output Only] A warning data value corresponding to the key. */
   core.String value;
 
   DiskTypesScopedListWarningData();
 
   DiskTypesScopedListWarningData.fromJson(core.Map _json) {
     if (_json.containsKey("key")) {
       key = _json["key"];
@@ skipping 17 matching lines @@
 
 /**
  * [Output Only] Informational warning which replaces the list of disk types
  * when the list is empty.
  */
 class DiskTypesScopedListWarning {
   /**
    * [Output Only] A warning code, if applicable. For example, Compute Engine
    * returns NO_RESULTS_ON_PAGE if there are no results in the response.
    * Possible string values are:
+   * - "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"
@@ skipping 72 matching lines @@
     return _json;
   }
 }
 
 class DisksScopedListWarningData {
   /**
    * [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).
+   * 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).
    */
   core.String key;
   /** [Output Only] A warning data value corresponding to the key. */
   core.String value;
 
   DisksScopedListWarningData();
 
   DisksScopedListWarningData.fromJson(core.Map _json) {
     if (_json.containsKey("key")) {
       key = _json["key"];
@@ skipping 17 matching lines @@
 
 /**
  * [Output Only] Informational warning which replaces the list of disks when the
  * list is empty.
  */
 class DisksScopedListWarning {
   /**
    * [Output Only] A warning code, if applicable. For example, Compute Engine
    * returns NO_RESULTS_ON_PAGE if there are no results in the response.
    * Possible string values are:
+   * - "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"
@@ skipping 69 matching lines @@
     if (warning != null) {
       _json["warning"] = (warning).toJson();
     }
     return _json;
   }
 }
 
 class FirewallAllowed {
   /**
    * 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
+   * 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.
    */
   core.String IPProtocol;
   /**
    * 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
    *
    * Example inputs include: ["22"], ["80","443"], and ["12345-12349"].
@@ skipping 16 matching lines @@
     if (IPProtocol != null) {
       _json["IPProtocol"] = IPProtocol;
     }
     if (ports != null) {
       _json["ports"] = ports;
     }
     return _json;
   }
 }
 
-/** A Firewall resource. */
+/** Represents a Firewall resource. */
 class Firewall {
   /**
    * The list of rules specified by this firewall. Each rule specifies a
    * protocol and port-range tuple that describes a permitted connection.
    */
   core.List<FirewallAllowed> allowed;
   /** [Output Only] Creation timestamp in RFC3339 text format. */
   core.String creationTimestamp;
   /**
    * An optional description of this resource. Provide this property when you
@@ skipping 130 matching lines @@
     if (sourceTags != null) {
       _json["sourceTags"] = sourceTags;
     }
     if (targetTags != null) {
       _json["targetTags"] = targetTags;
     }
     return _json;
   }
 }
 
-/** Contains a list of Firewall resources. */
+/** Contains a list of firewalls. */
 class FirewallList {
   /**
    * [Output Only] The unique identifier for the resource. This identifier is
    * defined by the server.
    */
   core.String id;
   /** [Output Only] A list of Firewall resources. */
   core.List<Firewall> items;
   /**
    * [Output Only] Type of resource. Always compute#firewallList for lists of
@@ skipping 206 matching lines @@
 }
 
 class ForwardingRuleAggregatedList {
   /**
    * [Output Only] The unique identifier for the resource. This identifier is
    * defined by the server.
    */
   core.String id;
   /** A map of scoped forwarding rule lists. */
   core.Map<core.String, ForwardingRulesScopedList> items;
-  /** Type of resource. */
+  /**
+   * [Output Only] Type of resource. Always compute#forwardingRuleAggregatedList
+   * for lists of forwarding rules.
+   */
   core.String kind;
   /**
    * [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.
    */
   core.String nextPageToken;
   /** [Output Only] Server-defined URL for this resource. */
@@ skipping 99 matching lines @@
     return _json;
   }
 }
 
 class ForwardingRulesScopedListWarningData {
   /**
    * [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).
+   * 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).
    */
   core.String key;
   /** [Output Only] A warning data value corresponding to the key. */
   core.String value;
 
   ForwardingRulesScopedListWarningData();
 
   ForwardingRulesScopedListWarningData.fromJson(core.Map _json) {
     if (_json.containsKey("key")) {
       key = _json["key"];
@@ skipping 17 matching lines @@
 
 /**
  * Informational warning which replaces the list of forwarding rules when the
  * list is empty.
  */
 class ForwardingRulesScopedListWarning {
   /**
    * [Output Only] A warning code, if applicable. For example, Compute Engine
    * returns NO_RESULTS_ON_PAGE if there are no results in the response.
    * Possible string values are:
+   * - "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"
@@ skipping 66 matching lines @@
     if (forwardingRules != null) {
       _json["forwardingRules"] = forwardingRules.map((value) => (value).toJson()).toList();
     }
     if (warning != null) {
       _json["warning"] = (warning).toJson();
     }
     return _json;
   }
 }
 
+/**
+ * A full or valid partial URL to a health check. For example, the following are
+ * valid URLs:
+ * -
+ * https://www.googleapis.com/compute/beta/projects/project-id/global/httpHealthChecks/health-check
+ * - projects/project-id/global/httpHealthChecks/health-check
+ * - global/httpHealthChecks/health-check
+ */
 class HealthCheckReference {
   core.String healthCheck;
 
   HealthCheckReference();
 
   HealthCheckReference.fromJson(core.Map _json) {
     if (_json.containsKey("healthCheck")) {
       healthCheck = _json["healthCheck"];
     }
   }
@@ skipping 134 matching lines @@
    * 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.
    */
   core.String host;
   /**
    * [Output Only] The unique identifier for the resource. This identifier is
    * defined by the server.
    */
   core.String id;
-  /** Type of the resource. */
+  /**
+   * [Output Only] Type of the resource. Always compute#httpHealthCheck for HTTP
+   * health checks.
+   */
   core.String kind;
   /**
    * 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.
    */
   core.String name;
   /**
    * The TCP port number for the HTTP health check request. The default value is
    * 80.
    */
   core.int port;
   /**
-   * The request path of the HTTP health check request. The default value is
-   * "/".
+   * The request path of the HTTP health check request. The default value is /.
    */
   core.String requestPath;
   /** [Output Only] Server-defined URL for the resource. */
   core.String selfLink;
   /**
    * 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.
    */
   core.int timeoutSec;
@@ skipping 594 matching lines @@
     if (sourceType != null) {
       _json["sourceType"] = sourceType;
     }
     if (status != null) {
       _json["status"] = status;
     }
     return _json;
   }
 }
 
-/** Contains a list of Image resources. */
+/** Contains a list of images. */
 class ImageList {
   /**
    * [Output Only] The unique identifier for the resource. This identifier is
    * defined by the server.
    */
   core.String id;
   /** [Output Only] A list of Image resources. */
   core.List<Image> items;
   /** Type of resource. */
   core.String kind;
@@ skipping 76 matching lines @@
    * [Output Only] The unique identifier for the resource. This identifier is
    * defined by the server.
    */
   core.String id;
   /**
    * [Output Only] Type of the resource. Always compute#instance for instances.
    */
   core.String kind;
   /**
    * 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
+   * 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:
    *
    * zones/us-central1-f/machineTypes/n1-standard-1
    *
    * To 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):
@@ skipping 49 matching lines @@
    * - "STOPPED"
    * - "STOPPING"
    * - "SUSPENDED"
    * - "SUSPENDING"
    * - "TERMINATED"
    */
   core.String status;
   /** [Output Only] An optional, human-readable explanation of the status. */
   core.String statusMessage;
   /**
-   * A list of tags to appy to this instance. Tags are used to identify valid
+   * 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.
    */
   Tags tags;
   /** [Output Only] URL of the zone where the instance resides. */
   core.String zone;
 
   Instance();
 
@@ skipping 222 matching lines @@
    * Assigns a name to a port number. For example: {name: "http", port: 80}
    *
    * This 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}]
    *
    * Named ports apply to all instances in this instance group.
    */
   core.List<NamedPort> namedPorts;
   /**
-   * [Output Only] The URL of the network to which all instances in the instance
-   * group belong.
+   * The URL of the network to which all instances in the instance group belong.
    */
   core.String network;
   /**
    * [Output Only] The URL for this instance group. The server generates this
    * URL.
    */
   core.String selfLink;
   /** [Output Only] The total number of instances in the instance group. */
   core.int size;
   /**
-   * [Output Only] The URL of the subnetwork to which all instances in the
-   * instance group belong.
+   * The URL of the subnetwork to which all instances in the instance group
+   * belong.
    */
   core.String subnetwork;
   /** [Output Only] The URL of the zone where the instance group is located. */
   core.String zone;
 
   InstanceGroup();
 
   InstanceGroup.fromJson(core.Map _json) {
     if (_json.containsKey("creationTimestamp")) {
       creationTimestamp = _json["creationTimestamp"];
@@ skipping 206 matching lines @@
     if (nextPageToken != null) {
       _json["nextPageToken"] = nextPageToken;
     }
     if (selfLink != null) {
       _json["selfLink"] = selfLink;
     }
     return _json;
   }
 }
 
-/**
- * InstanceGroupManagers
- *
- * Next available tag: 20
- */
 class InstanceGroupManager {
   /**
    * 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.
    */
   core.String baseInstanceName;
   /**
    * [Output Only] The creation timestamp for this managed instance group in
@@ skipping 496 matching lines @@
     return _json;
   }
 }
 
 class InstanceGroupManagersScopedListWarningData {
   /**
    * [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).
+   * 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).
    */
   core.String key;
   /** [Output Only] A warning data value corresponding to the key. */
   core.String value;
 
   InstanceGroupManagersScopedListWarningData();
 
   InstanceGroupManagersScopedListWarningData.fromJson(core.Map _json) {
     if (_json.containsKey("key")) {
       key = _json["key"];
@@ skipping 17 matching lines @@
 
 /**
  * [Output Only] The warning that replaces the list of managed instance groups
  * when the list is empty.
  */
 class InstanceGroupManagersScopedListWarning {
   /**
    * [Output Only] A warning code, if applicable. For example, Compute Engine
    * returns NO_RESULTS_ON_PAGE if there are no results in the response.
    * Possible string values are:
+   * - "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"
@@ skipping 288 matching lines @@
     return _json;
   }
 }
 
 class InstanceGroupsScopedListWarningData {
   /**
    * [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).
+   * 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).
    */
   core.String key;
   /** [Output Only] A warning data value corresponding to the key. */
   core.String value;
 
   InstanceGroupsScopedListWarningData();
 
   InstanceGroupsScopedListWarningData.fromJson(core.Map _json) {
     if (_json.containsKey("key")) {
       key = _json["key"];
@@ skipping 17 matching lines @@
 
 /**
  * [Output Only] An informational warning that replaces the list of instance
  * groups when the list is empty.
  */
 class InstanceGroupsScopedListWarning {
   /**
    * [Output Only] A warning code, if applicable. For example, Compute Engine
    * returns NO_RESULTS_ON_PAGE if there are no results in the response.
    * Possible string values are:
+   * - "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"
@@ skipping 111 matching lines @@
     if (fingerprint != null) {
       _json["fingerprint"] = fingerprint;
     }
     if (namedPorts != null) {
       _json["namedPorts"] = namedPorts.map((value) => (value).toJson()).toList();
     }
     return _json;
   }
 }
 
-/** Contains a list of instance resources. */
+/** Contains a list of instances. */
 class InstanceList {
   /**
    * [Output Only] The unique identifier for the resource. This identifier is
    * defined by the server.
    */
   core.String id;
-  /** [Output Only] A list of Instance resources. */
+  /** [Output Only] A list of instances. */
   core.List<Instance> items;
   /**
    * [Output Only] Type of resource. Always compute#instanceList for lists of
    * Instance resources.
    */
   core.String kind;
   /**
    * [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
@@ skipping 40 matching lines @@
     }
     if (selfLink != null) {
       _json["selfLink"] = selfLink;
     }
     return _json;
   }
 }
 
 class InstanceMoveRequest {
   /**
-   * 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:
+   * 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:
    * - https://www.googleapis.com/compute/v1/projects/project/zones/zone
    * - projects/project/zones/zone
    * - zones/zone
    */
   core.String destinationZone;
   /**
    * 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:
    * -
    * https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance
@@ skipping 372 matching lines @@
     return _json;
   }
 }
 
 class InstancesScopedListWarningData {
   /**
    * [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).
+   * 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).
    */
   core.String key;
   /** [Output Only] A warning data value corresponding to the key. */
   core.String value;
 
   InstancesScopedListWarningData();
 
   InstancesScopedListWarningData.fromJson(core.Map _json) {
     if (_json.containsKey("key")) {
       key = _json["key"];
@@ skipping 17 matching lines @@
 
 /**
  * [Output Only] Informational warning which replaces the list of instances when
  * the list is empty.
  */
 class InstancesScopedListWarning {
   /**
    * [Output Only] A warning code, if applicable. For example, Compute Engine
    * returns NO_RESULTS_ON_PAGE if there are no results in the response.
    * Possible string values are:
+   * - "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"
@@ skipping 375 matching lines @@
     if (nextPageToken != null) {
       _json["nextPageToken"] = nextPageToken;
     }
     if (selfLink != null) {
       _json["selfLink"] = selfLink;
     }
     return _json;
   }
 }
 
-/** Contains a list of Machine Type resources. */
+/** Contains a list of machine types. */
 class MachineTypeList {
   /**
    * [Output Only] The unique identifier for the resource. This identifier is
    * defined by the server.
    */
   core.String id;
   /** [Output Only] A list of Machine Type resources. */
   core.List<MachineType> items;
   /**
    * [Output Only] Type of resource. Always compute#machineTypeList for lists of
@@ skipping 51 matching lines @@
     return _json;
   }
 }
 
 class MachineTypesScopedListWarningData {
   /**
    * [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).
+   * 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).
    */
   core.String key;
   /** [Output Only] A warning data value corresponding to the key. */
   core.String value;
 
   MachineTypesScopedListWarningData();
 
   MachineTypesScopedListWarningData.fromJson(core.Map _json) {
     if (_json.containsKey("key")) {
       key = _json["key"];
@@ skipping 17 matching lines @@
 
 /**
  * [Output Only] An informational warning that appears when the machine types
  * list is empty.
  */
 class MachineTypesScopedListWarning {
   /**
    * [Output Only] A warning code, if applicable. For example, Compute Engine
    * returns NO_RESULTS_ON_PAGE if there are no results in the response.
    * Possible string values are:
+   * - "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"
@@ skipping 173 matching lines @@
       _json["lastAttempt"] = (lastAttempt).toJson();
     }
     return _json;
   }
 }
 
 class ManagedInstanceLastAttemptErrorsErrors {
   /** [Output Only] The error type identifier for this error. */
   core.String code;
   /**
-   * [Output Only] Indicates the field in the request which caused the error.
+   * [Output Only] Indicates the field in the request that caused the error.
    * This property is optional.
    */
   core.String location;
   /** [Output Only] An optional, human-readable error message. */
   core.String message;
 
   ManagedInstanceLastAttemptErrorsErrors();
 
   ManagedInstanceLastAttemptErrorsErrors.fromJson(core.Map _json) {
     if (_json.containsKey("code")) {
@@ skipping 195 matching lines @@
     if (name != null) {
       _json["name"] = name;
     }
     if (port != null) {
       _json["port"] = port;
     }
     return _json;
   }
 }
 
-/** A network resource. */
+/**
+ * Represents a Network resource. Read Networks and Firewalls for more
+ * information.
+ */
 class Network {
   /**
    * 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.
    */
   core.String IPv4Range;
   /**
    * When set to true, the network is created in "auto subnet mode". When set to
    * false, the network is in "custom subnet mode".
@@ skipping 193 matching lines @@
     if (networkIP != null) {
       _json["networkIP"] = networkIP;
     }
     if (subnetwork != null) {
       _json["subnetwork"] = subnetwork;
     }
     return _json;
   }
 }
 
-/** Contains a list of Network resources. */
+/** Contains a list of networks. */
 class NetworkList {
   /**
    * [Output Only] The unique identifier for the resource. This identifier is
    * defined by the server.
    */
   core.String id;
   /** [Output Only] A list of Network resources. */
   core.List<Network> items;
   /**
    * [Output Only] Type of resource. Always compute#networkList for lists of
@@ skipping 49 matching lines @@
       _json["selfLink"] = selfLink;
     }
     return _json;
   }
 }
 
 class OperationErrorErrors {
   /** [Output Only] The error type identifier for this error. */
   core.String code;
   /**
-   * [Output Only] Indicates the field in the request which caused the error.
+   * [Output Only] Indicates the field in the request that caused the error.
    * This property is optional.
    */
   core.String location;
   /** [Output Only] An optional, human-readable error message. */
   core.String message;
 
   OperationErrorErrors();
 
   OperationErrorErrors.fromJson(core.Map _json) {
     if (_json.containsKey("code")) {
@@ skipping 49 matching lines @@
     return _json;
   }
 }
 
 class OperationWarningsData {
   /**
    * [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).
+   * 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).
    */
   core.String key;
   /** [Output Only] A warning data value corresponding to the key. */
   core.String value;
 
   OperationWarningsData();
 
   OperationWarningsData.fromJson(core.Map _json) {
     if (_json.containsKey("key")) {
       key = _json["key"];
@@ skipping 13 matching lines @@
     }
     return _json;
   }
 }
 
 class OperationWarnings {
   /**
    * [Output Only] A warning code, if applicable. For example, Compute Engine
    * returns NO_RESULTS_ON_PAGE if there are no results in the response.
    * Possible string values are:
+   * - "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"
@@ skipping 36 matching lines @@
     }
     if (message != null) {
       _json["message"] = message;
     }
     return _json;
   }
 }
 
 /** An Operation resource, used to manage asynchronous API requests. */
 class Operation {
-  /** [Output Only] A unique client ID generated by the server. */
+  /** [Output Only] Reserved for future use. */
   core.String clientOperationId;
   /** [Output Only] Creation timestamp in RFC3339 text format. */
   core.String creationTimestamp;
   /**
    * [Output Only] A textual description of the operation, which is set when the
    * operation is created.
    */
   core.String description;
   /**
    * [Output Only] The time that this operation was completed. This value is in
@@ skipping 20 matching lines @@
    * [Output Only] The unique identifier for the resource. This identifier is
    * defined by the server.
    */
   core.String id;
   /**
    * [Output Only] The time that this operation was requested. This value is in
    * RFC3339 text format.
    */
   core.String insertTime;
   /**
-   * [Output Only] Type of the resource. Always compute#operation for Operation
+   * [Output Only] Type of the resource. Always compute#operation for operation
    * resources.
    */
   core.String kind;
   /** [Output Only] Name of the resource. */
   core.String name;
   /**
-   * [Output Only] The type of operation, which can be insert, update, or
-   * delete.
+   * [Output Only] The type of operation, such as insert, update, or delete, and
+   * so on.
    */
   core.String operationType;
   /**
    * [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.
    */
   core.int progress;
   /**
-   * [Output Only] URL of the region where the operation resides. Only available
-   * when performing regional operations.
+   * [Output Only] The URL of the region where the operation resides. Only
+   * available when performing regional operations.
    */
   core.String region;
   /** [Output Only] Server-defined URL for the resource. */
   core.String selfLink;
   /**
    * [Output Only] The time that this operation was started by the server. This
    * value is in RFC3339 text format.
    */
   core.String startTime;
   /**
    * [Output Only] The status of the operation, which can be one of the
    * following: PENDING, RUNNING, or DONE.
    * Possible string values are:
    * - "DONE"
    * - "PENDING"
    * - "RUNNING"
    */
   core.String status;
   /**
    * [Output Only] An optional textual description of the current status of the
    * operation.
    */
   core.String statusMessage;
   /**
    * [Output Only] The unique target ID, which identifies a specific incarnation
    * of the target resource.
    */
   core.String targetId;
-  /** [Output Only] The URL of the resource that the operation is modifying. */
+  /** [Output Only] The URL of the resource that the operation modifies. */
   core.String targetLink;
   /**
    * [Output Only] User who requested the operation, for example:
    * user@example.com.
    */
   core.String user;
   /**
    * [Output Only] If warning messages are generated during processing of the
    * operation, this field will be populated.
    */
   core.List<OperationWarnings> warnings;
   /**
-   * [Output Only] URL of the zone where the operation resides. Only available
-   * when performing per-zone operations.
+   * [Output Only] The URL of the zone where the operation resides. Only
+   * available when performing per-zone operations.
    */
   core.String zone;
 
   Operation();
 
   Operation.fromJson(core.Map _json) {
     if (_json.containsKey("clientOperationId")) {
       clientOperationId = _json["clientOperationId"];
     }
     if (_json.containsKey("creationTimestamp")) {
@@ skipping 204 matching lines @@
   }
 }
 
 /** Contains a list of Operation resources. */
 class OperationList {
   /**
    * [Output Only] The unique identifier for the resource. This identifier is
    * defined by the server.
    */
   core.String id;
-  /** [Output Only] The Operation resources. */
+  /** [Output Only] A list of Operation resources. */
   core.List<Operation> items;
   /**
    * [Output Only] Type of resource. Always compute#operations for Operations
    * resource.
    */
   core.String kind;
   /**
    * [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
@@ skipping 44 matching lines @@
     return _json;
   }
 }
 
 class OperationsScopedListWarningData {
   /**
    * [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).
+   * 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).
    */
   core.String key;
   /** [Output Only] A warning data value corresponding to the key. */
   core.String value;
 
   OperationsScopedListWarningData();
 
   OperationsScopedListWarningData.fromJson(core.Map _json) {
     if (_json.containsKey("key")) {
       key = _json["key"];
@@ skipping 17 matching lines @@
 
 /**
  * [Output Only] Informational warning which replaces the list of operations
  * when the list is empty.
  */
 class OperationsScopedListWarning {
   /**
    * [Output Only] A warning code, if applicable. For example, Compute Engine
    * returns NO_RESULTS_ON_PAGE if there are no results in the response.
    * Possible string values are:
+   * - "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"
@@ skipping 167 matching lines @@
       _json["paths"] = paths;
     }
     if (service != null) {
       _json["service"] = service;
     }
     return _json;
   }
 }
 
 /**
- * A Project resource. Projects can only be created in the Google Developers
+ * 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.
  */
 class Project {
   /**
    * Metadata key/value pairs available to all instances contained in this
    * project. See Custom metadata for more information.
    */
   Metadata commonInstanceMetadata;
   /** [Output Only] Creation timestamp in RFC3339 text format. */
   core.String creationTimestamp;
@@ skipping 359 matching lines @@
     return _json;
   }
 }
 
 class RouteWarningsData {
   /**
    * [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).
+   * 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).
    */
   core.String key;
   /** [Output Only] A warning data value corresponding to the key. */
   core.String value;
 
   RouteWarningsData();
 
   RouteWarningsData.fromJson(core.Map _json) {
     if (_json.containsKey("key")) {
       key = _json["key"];
@@ skipping 13 matching lines @@
     }
     return _json;
   }
 }
 
 class RouteWarnings {
   /**
    * [Output Only] A warning code, if applicable. For example, Compute Engine
    * returns NO_RESULTS_ON_PAGE if there are no results in the response.
    * Possible string values are:
+   * - "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"
@@ skipping 35 matching lines @@
       _json["data"] = data.map((value) => (value).toJson()).toList();
     }
     if (message != null) {
       _json["message"] = message;
     }
     return _json;
   }
 }
 
 /**
- * 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
+ * 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.
+ *
+ * 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
+ * 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.
+ * route - either to another instance destination, a instance gateway or a
+ * Google Compute Engine-operated gateway.
+ *
+ * Packets that do not match any route in the sending instance's routing table
+ * are dropped.
  */
 class Route {
   /** [Output Only] Creation timestamp in RFC3339 text format. */
   core.String creationTimestamp;
   /**
    * An optional description of this resource. Provide this property when you
    * create the resource.
    */
   core.String description;
   /** The destination range of outgoing packets that this route applies to. */
   core.String destRange;
   /**
    * [Output Only] The unique identifier for the resource. This identifier is
    * defined by the server.
    */
   core.String id;
   /**
    * [Output Only] Type of this resource. Always compute#routes for Route
    * resources.
    */
   core.String kind;
   /**
-   * Name of the resource; provided by the client when the resource is created.
+   * 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.
    */
   core.String name;
   /** Fully-qualified URL of the network that this route applies to. */
   core.String network;
@@ skipping 134 matching lines @@
     if (tags != null) {
       _json["tags"] = tags;
     }
     if (warnings != null) {
       _json["warnings"] = warnings.map((value) => (value).toJson()).toList();
     }
     return _json;
   }
 }
 
-/** Contains a list of route resources. */
+/** Contains a list of Route resources. */
 class RouteList {
   /**
    * [Output Only] Unique identifier for the resource. Defined by the server.
    */
   core.String id;
   /** [Output Only] A list of Route resources. */
   core.List<Route> items;
   /** Type of resource. */
   core.String kind;
   /**
@@ skipping 54 matching lines @@
    * 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.
    */
   core.bool automaticRestart;
   /**
    * 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.
+   * Instance Scheduling Options.
    * Possible string values are:
    * - "MIGRATE"
    * - "TERMINATE"
    */
   core.String onHostMaintenance;
   /** Whether the instance is preemptible. */
   core.bool preemptible;
 
   Scheduling();
 
@@ skipping 109 matching lines @@
   /**
    * [Output Only] The unique identifier for the resource. This identifier is
    * defined by the server.
    */
   core.String id;
   /**
    * [Output Only] Type of the resource. Always compute#snapshot for Snapshot
    * resources.
    */
   core.String kind;
-  /** Public visible licenses. */
+  /**
+   * [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).
+   */
   core.List<core.String> licenses;
   /**
    * 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.
    */
   core.String name;
   /** [Output Only] Server-defined URL for the resource. */
   core.String selfLink;
   /** [Output Only] The source disk used to create this snapshot. */
   core.String sourceDisk;
   /**
    * [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.
    */
   core.String sourceDiskId;
   /**
-   * [Output Only] The status of the snapshot.
+   * [Output Only] The status of the snapshot. This can be CREATING, DELETING,
+   * FAILED, READY, or UPLOADING.
    * Possible string values are:
    * - "CREATING"
    * - "DELETING"
    * - "FAILED"
    * - "READY"
    * - "UPLOADING"
    */
   core.String status;
   /**
    * [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.
    */
   core.String storageBytes;
   /**
    * [Output Only] An indicator whether storageBytes is in a stable state or it
-   * is being adjusted as a result of shared storage reallocation.
+   * 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.
    * Possible string values are:
    * - "UPDATING"
    * - "UP_TO_DATE"
    */
   core.String storageBytesStatus;
 
   Snapshot();
 
   Snapshot.fromJson(core.Map _json) {
     if (_json.containsKey("creationTimestamp")) {
@@ skipping 565 matching lines @@
     return _json;
   }
 }
 
 class SubnetworksScopedListWarningData {
   /**
    * [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).
+   * 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).
    */
   core.String key;
   /** [Output Only] A warning data value corresponding to the key. */
   core.String value;
 
   SubnetworksScopedListWarningData();
 
   SubnetworksScopedListWarningData.fromJson(core.Map _json) {
     if (_json.containsKey("key")) {
       key = _json["key"];
@@ skipping 16 matching lines @@
 }
 
 /**
  * An informational warning that appears when the list of addresses is empty.
  */
 class SubnetworksScopedListWarning {
   /**
    * [Output Only] A warning code, if applicable. For example, Compute Engine
    * returns NO_RESULTS_ON_PAGE if there are no results in the response.
    * Possible string values are:
+   * - "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"
@@ skipping 133 matching lines @@
    * [Output Only] The unique identifier for the resource. This identifier is
    * defined by the server.
    */
   core.String id;
   /**
    * [Output Only] Type of resource. Always compute#targetHttpProxy for target
    * HTTP proxies.
    */
   core.String kind;
   /**
-   * Name of the resource; provided by the client when the resource is created.
+   * 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.
    */
   core.String name;
   /** [Output Only] Server-defined URL for the resource. */
   core.String selfLink;
@@ skipping 59 matching lines @@
 /** A list of TargetHttpProxy resources. */
 class TargetHttpProxyList {
   /**
    * [Output Only] The unique identifier for the resource. This identifier is
    * defined by the server.
    */
   core.String id;
   /** A list of TargetHttpProxy resources. */
   core.List<TargetHttpProxy> items;
   /**
-   * Type of resource. Always compute#targetHttpProxyList for lists of Target
+   * Type of resource. Always compute#targetHttpProxyList for lists of target
    * HTTP proxies.
    */
   core.String kind;
   /**
    * [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.
    */
@@ skipping 37 matching lines @@
     }
     if (selfLink != null) {
       _json["selfLink"] = selfLink;
     }
     return _json;
   }
 }
 
 class TargetHttpsProxiesSetSslCertificatesRequest {
   /**
-   * New set of URLs to SslCertificate resources to associate with this
-   * TargetHttpProxy. Currently exactly one ssl certificate must be specified.
+   * New set of SslCertificate resources to associate with this TargetHttpsProxy
+   * resource. Currently exactly one SslCertificate resource must be specified.
    */
   core.List<core.String> sslCertificates;
 
   TargetHttpsProxiesSetSslCertificatesRequest();
 
   TargetHttpsProxiesSetSslCertificatesRequest.fromJson(core.Map _json) {
     if (_json.containsKey("sslCertificates")) {
       sslCertificates = _json["sslCertificates"];
     }
   }
@@ skipping 15 matching lines @@
    * An optional description of this resource. Provide this property when you
    * create the resource.
    */
   core.String description;
   /**
    * [Output Only] The unique identifier for the resource. This identifier is
    * defined by the server.
    */
   core.String id;
   /**
-   * [Output Only] Type of the resource. Always compute#targetHttpsProxy for
-   * target HTTPS proxies.
+   * [Output Only] Type of resource. Always compute#targetHttpsProxy for target
+   * HTTPS proxies.
    */
   core.String kind;
   /**
    * 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.
    */
   core.String name;
   /** [Output Only] Server-defined URL for the resource. */
   core.String selfLink;
   /**
    * URLs to SslCertificate resources that are used to authenticate connections
-   * between users and the load balancer. Currently exactly one SSL certificate
+   * between users and the load balancer. Currently, exactly one SSL certificate
    * must be specified.
    */
   core.List<core.String> sslCertificates;
   /**
-   * URL to the UrlMap resource that defines the mapping from URL to the
-   * BackendService.
+   * 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:
+   * - https://www.googleapis.compute/v1/projects/project/global/urlMaps/url-map
+   * - projects/project/global/urlMaps/url-map
+   * - global/urlMaps/url-map
    */
   core.String urlMap;
 
   TargetHttpsProxy();
 
   TargetHttpsProxy.fromJson(core.Map _json) {
     if (_json.containsKey("creationTimestamp")) {
       creationTimestamp = _json["creationTimestamp"];
     }
     if (_json.containsKey("description")) {
@@ skipping 51 matching lines @@
 
 /** Contains a list of TargetHttpsProxy resources. */
 class TargetHttpsProxyList {
   /**
    * [Output Only] The unique identifier for the resource. This identifier is
    * defined by the server.
    */
   core.String id;
   /** A list of TargetHttpsProxy resources. */
   core.List<TargetHttpsProxy> items;
-  /** Type of resource. */
+  /**
+   * Type of resource. Always compute#targetHttpsProxyList for lists of target
+   * HTTPS proxies.
+   */
   core.String kind;
   /**
    * [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.
    */
   core.String nextPageToken;
   /** [Output Only] Server-defined URL for this resource. */
@@ skipping 50 matching lines @@
   /**
    * An optional description of this resource. Provide this property when you
    * create the resource.
    */
   core.String description;
   /**
    * [Output Only] The unique identifier for the resource. This identifier is
    * defined by the server.
    */
   core.String id;
-  /** The URL to the instance that terminates the relevant traffic. */
+  /**
+   * 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:
+   * -
+   * https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance
+   * - projects/project/zones/zone/instances/instance
+   * - zones/zone/instances/instance
+   */
   core.String instance;
   /**
    * [Output Only] The type of the resource. Always compute#targetInstance for
    * target instances.
    */
   core.String kind;
   /**
    * 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
@@ skipping 203 matching lines @@
     return _json;
   }
 }
 
 class TargetInstancesScopedListWarningData {
   /**
    * [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).
+   * 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).
    */
   core.String key;
   /** [Output Only] A warning data value corresponding to the key. */
   core.String value;
 
   TargetInstancesScopedListWarningData();
 
   TargetInstancesScopedListWarningData.fromJson(core.Map _json) {
     if (_json.containsKey("key")) {
       key = _json["key"];
@@ skipping 17 matching lines @@
 
 /**
  * Informational warning which replaces the list of addresses when the list is
  * empty.
  */
 class TargetInstancesScopedListWarning {
   /**
    * [Output Only] A warning code, if applicable. For example, Compute Engine
    * returns NO_RESULTS_ON_PAGE if there are no results in the response.
    * Possible string values are:
+   * - "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"
@@ skipping 68 matching lines @@
     }
     if (warning != null) {
       _json["warning"] = (warning).toJson();
     }
     return _json;
   }
 }
 
 /**
  * A TargetPool resource. This resource defines a pool of instances, associated
- * HttpHealthCheck resources, and the fallback TargetPool.
+ * HttpHealthCheck resources, and the fallback target pool.
  */
 class TargetPool {
   /**
    * 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].
    *
    * backupPool 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
@@ skipping 35 matching lines @@
    * An empty list means all member instances will be considered healthy at all
    * times.
    */
   core.List<core.String> healthChecks;
   /**
    * [Output Only] The unique identifier for the resource. This identifier is
    * defined by the server.
    */
   core.String id;
   /**
-   * A list of resource URLs to the member virtual machines serving this pool.
+   * 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.
    */
   core.List<core.String> instances;
   /**
    * [Output Only] Type of the resource. Always compute#targetPool for target
    * pools.
    */
   core.String kind;
   /**
    * Name of the resource. Provided by the client when the resource is created.
@@ skipping 106 matching lines @@
     }
     return _json;
   }
 }
 
 class TargetPoolAggregatedList {
   /**
    * [Output Only] Unique identifier for the resource. Defined by the server.
    */
   core.String id;
-  /** A map of scoped target pool lists. */
+  /** [Output Only] A map of scoped target pool lists. */
   core.Map<core.String, TargetPoolsScopedList> items;
-  /** Type of resource. */
+  /**
+   * [Output Only] Type of resource. Always compute#targetPoolAggregatedList for
+   * aggregated lists of target pools.
+   */
   core.String kind;
   /**
    * [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.
    */
   core.String nextPageToken;
   /** [Output Only] Server-defined URL for this resource. */
@@ skipping 35 matching lines @@
     }
     if (selfLink != null) {
       _json["selfLink"] = selfLink;
     }
     return _json;
   }
 }
 
 class TargetPoolInstanceHealth {
   core.List<HealthStatus> healthStatus;
-  /** Type of resource. */
+  /**
+   * [Output Only] Type of resource. Always compute#targetPoolInstanceHealth
+   * when checking the health of an instance.
+   */
   core.String kind;
 
   TargetPoolInstanceHealth();
 
   TargetPoolInstanceHealth.fromJson(core.Map _json) {
     if (_json.containsKey("healthStatus")) {
       healthStatus = _json["healthStatus"].map((value) => new HealthStatus.fromJson(value)).toList();
     }
     if (_json.containsKey("kind")) {
       kind = _json["kind"];
@@ skipping 13 matching lines @@
 }
 
 /** Contains a list of TargetPool resources. */
 class TargetPoolList {
   /**
    * [Output Only] Unique identifier for the resource. Defined by the server.
    */
   core.String id;
   /** A list of TargetPool resources. */
   core.List<TargetPool> items;
-  /** Type of resource. */
+  /**
+   * [Output Only] Type of resource. Always compute#targetPoolList for lists of
+   * target pools.
+   */
   core.String kind;
   /**
    * [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.
    */
   core.String nextPageToken;
   /** [Output Only] Server-defined URL for this resource. */
@@ skipping 34 matching lines @@
       _json["nextPageToken"] = nextPageToken;
     }
     if (selfLink != null) {
       _json["selfLink"] = selfLink;
     }
     return _json;
   }
 }
 
 class TargetPoolsAddHealthCheckRequest {
-  /** Health check URLs to be added to targetPool. */
+  /** A list of HttpHealthCheck resources to add to the target pool. */
   core.List<HealthCheckReference> healthChecks;
 
   TargetPoolsAddHealthCheckRequest();
 
   TargetPoolsAddHealthCheckRequest.fromJson(core.Map _json) {
     if (_json.containsKey("healthChecks")) {
       healthChecks = _json["healthChecks"].map((value) => new HealthCheckReference.fromJson(value)).toList();
     }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (healthChecks != null) {
       _json["healthChecks"] = healthChecks.map((value) => (value).toJson()).toList();
     }
     return _json;
   }
 }
 
 class TargetPoolsAddInstanceRequest {
-  /** URLs of the instances to be added to targetPool. */
+  /**
+   * 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:
+   * -
+   * https://www.googleapis.com/compute/v1/projects/project-id/zones/zone/instances/instance-name
+   * - projects/project-id/zones/zone/instances/instance-name
+   * - zones/zone/instances/instance-name
+   */
   core.List<InstanceReference> instances;
 
   TargetPoolsAddInstanceRequest();
 
   TargetPoolsAddInstanceRequest.fromJson(core.Map _json) {
     if (_json.containsKey("instances")) {
       instances = _json["instances"].map((value) => new InstanceReference.fromJson(value)).toList();
     }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (instances != null) {
       _json["instances"] = instances.map((value) => (value).toJson()).toList();
     }
     return _json;
   }
 }
 
 class TargetPoolsRemoveHealthCheckRequest {
-  /** Health check URLs to be removed from targetPool. */
+  /**
+   * Health check URL to be removed. This can be a full or valid partial URL.
+   * For example, the following are valid URLs:
+   * -
+   * https://www.googleapis.com/compute/beta/projects/project/global/httpHealthChecks/health-check
+   * - projects/project/global/httpHealthChecks/health-check
+   * - global/httpHealthChecks/health-check
+   */
   core.List<HealthCheckReference> healthChecks;
 
   TargetPoolsRemoveHealthCheckRequest();
 
   TargetPoolsRemoveHealthCheckRequest.fromJson(core.Map _json) {
     if (_json.containsKey("healthChecks")) {
       healthChecks = _json["healthChecks"].map((value) => new HealthCheckReference.fromJson(value)).toList();
     }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (healthChecks != null) {
       _json["healthChecks"] = healthChecks.map((value) => (value).toJson()).toList();
     }
     return _json;
   }
 }
 
 class TargetPoolsRemoveInstanceRequest {
-  /** URLs of the instances to be removed from targetPool. */
+  /** URLs of the instances to be removed from target pool. */
   core.List<InstanceReference> instances;
 
   TargetPoolsRemoveInstanceRequest();
 
   TargetPoolsRemoveInstanceRequest.fromJson(core.Map _json) {
     if (_json.containsKey("instances")) {
       instances = _json["instances"].map((value) => new InstanceReference.fromJson(value)).toList();
     }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (instances != null) {
       _json["instances"] = instances.map((value) => (value).toJson()).toList();
     }
     return _json;
   }
 }
 
 class TargetPoolsScopedListWarningData {
   /**
    * [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).
+   * 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).
    */
   core.String key;
   /** [Output Only] A warning data value corresponding to the key. */
   core.String value;
 
   TargetPoolsScopedListWarningData();
 
   TargetPoolsScopedListWarningData.fromJson(core.Map _json) {
     if (_json.containsKey("key")) {
       key = _json["key"];
@@ skipping 17 matching lines @@
 
 /**
  * Informational warning which replaces the list of addresses when the list is
  * empty.
  */
 class TargetPoolsScopedListWarning {
   /**
    * [Output Only] A warning code, if applicable. For example, Compute Engine
    * returns NO_RESULTS_ON_PAGE if there are no results in the response.
    * Possible string values are:
+   * - "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"
@@ skipping 86 matching lines @@
 
   core.Map toJson() {
     var _json = new core.Map();
     if (target != null) {
       _json["target"] = target;
     }
     return _json;
   }
 }
 
+/** Represents a Target VPN gateway resource. */
 class TargetVpnGateway {
   /** [Output Only] Creation timestamp in RFC3339 text format. */
   core.String creationTimestamp;
   /**
    * An optional description of this resource. Provide this property when you
    * create the resource.
    */
   core.String description;
   /**
    * [Output Only] A list of URLs to the ForwardingRule resources.
    * ForwardingRules are created using compute.forwardingRules.insert and
    * associated to a VPN gateway.
    */
   core.List<core.String> forwardingRules;
   /**
    * [Output Only] The unique identifier for the resource. This identifier is
    * defined by the server.
    */
   core.String id;
   /**
    * [Output Only] Type of resource. Always compute#targetVpnGateway for target
    * VPN gateways.
    */
   core.String kind;
   /**
-   * Name of the resource; provided by the client when the resource is created.
+   * 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.
    */
   core.String name;
   /**
    * URL of the network to which this VPN gateway is attached. Provided by the
    * client when the VPN gateway is created.
    */
   core.String network;
   /** [Output Only] URL of the region where the target VPN gateway resides. */
   core.String region;
   /** [Output Only] Server-defined URL for the resource. */
   core.String selfLink;
   /**
    * [Output Only] The status of the VPN gateway.
    * Possible string values are:
    * - "CREATING"
    * - "DELETING"
    * - "FAILED"
    * - "READY"
    */
   core.String status;
   /**
    * [Output Only] A list of URLs to VpnTunnel resources. VpnTunnels are created
-   * using compute.vpntunnels.insert and associated to a VPN gateway.
+   * using compute.vpntunnels.insert method and associated to a VPN gateway.
    */
   core.List<core.String> tunnels;
 
   TargetVpnGateway();
 
   TargetVpnGateway.fromJson(core.Map _json) {
     if (_json.containsKey("creationTimestamp")) {
       creationTimestamp = _json["creationTimestamp"];
     }
     if (_json.containsKey("description")) {
@@ skipping 197 matching lines @@
     return _json;
   }
 }
 
 class TargetVpnGatewaysScopedListWarningData {
   /**
    * [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).
+   * 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).
    */
   core.String key;
   /** [Output Only] A warning data value corresponding to the key. */
   core.String value;
 
   TargetVpnGatewaysScopedListWarningData();
 
   TargetVpnGatewaysScopedListWarningData.fromJson(core.Map _json) {
     if (_json.containsKey("key")) {
       key = _json["key"];
@@ skipping 17 matching lines @@
 
 /**
  * [Output Only] Informational warning which replaces the list of addresses when
  * the list is empty.
  */
 class TargetVpnGatewaysScopedListWarning {
   /**
    * [Output Only] A warning code, if applicable. For example, Compute Engine
    * returns NO_RESULTS_ON_PAGE if there are no results in the response.
    * Possible string values are:
+   * - "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"
@@ skipping 538 matching lines @@
    * [Output Only] Type of resource. Always compute#vpnTunnel for VPN tunnels.
    */
   core.String kind;
   /**
    * Local traffic selector to use when establishing the VPN tunnel with peer
    * VPN gateway. The value should be a CIDR formatted string, for example:
    * 192.168.0.0/16. The ranges should be disjoint.
    */
   core.List<core.String> localTrafficSelector;
   /**
-   * Name of the resource; provided by the client when the resource is created.
+   * 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.
    */
   core.String name;
   /** IP address of the peer VPN gateway. */
   core.String peerIp;
   /** [Output Only] URL of the region where the VPN tunnel resides. */
   core.String region;
   /** [Output Only] Server-defined URL for the resource. */
   core.String selfLink;
   /**
    * Shared secret used to set the secure session between the Cloud VPN gateway
    * and the peer VPN gateway.
    */
   core.String sharedSecret;
   /** Hash of the shared secret. */
   core.String sharedSecretHash;
   /**
    * [Output Only] The status of the VPN tunnel.
    * Possible string values are:
+   * - "ALLOCATING_RESOURCES"
    * - "AUTHORIZATION_ERROR"
    * - "DEPROVISIONING"
    * - "ESTABLISHED"
    * - "FAILED"
    * - "FIRST_HANDSHAKE"
    * - "NEGOTIATION_FAILURE"
    * - "NETWORK_ERROR"
    * - "NO_INCOMING_PACKETS"
    * - "PROVISIONING"
    * - "REJECTED"
    * - "WAITING_FOR_FULL_CONFIG"
    */
   core.String status;
   /**
-   * URL of the VPN gateway to which this VPN tunnel is associated. Provided by
-   * the client when the VPN tunnel is created.
+   * URL of the VPN gateway with which this VPN tunnel is associated. Provided
+   * by the client when the VPN tunnel is created.
    */
   core.String targetVpnGateway;
 
   VpnTunnel();
 
   VpnTunnel.fromJson(core.Map _json) {
     if (_json.containsKey("creationTimestamp")) {
       creationTimestamp = _json["creationTimestamp"];
     }
     if (_json.containsKey("description")) {
@@ skipping 219 matching lines @@
     return _json;
   }
 }
 
 class VpnTunnelsScopedListWarningData {
   /**
    * [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).
+   * 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).
    */
   core.String key;
   /** [Output Only] A warning data value corresponding to the key. */
   core.String value;
 
   VpnTunnelsScopedListWarningData();
 
   VpnTunnelsScopedListWarningData.fromJson(core.Map _json) {
     if (_json.containsKey("key")) {
       key = _json["key"];
@@ skipping 17 matching lines @@
 
 /**
  * Informational warning which replaces the list of addresses when the list is
  * empty.
  */
 class VpnTunnelsScopedListWarning {
   /**
    * [Output Only] A warning code, if applicable. For example, Compute Engine
    * returns NO_RESULTS_ON_PAGE if there are no results in the response.
    * Possible string values are:
+   * - "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"
@@ skipping 282 matching lines @@
     }
     if (nextPageToken != null) {
       _json["nextPageToken"] = nextPageToken;
     }
     if (selfLink != null) {
       _json["selfLink"] = selfLink;
     }
     return _json;
   }
 }