Api-roll 48: 2017-04-18

generated/googleapis_beta/lib/appengine/v1beta5.dart

Index: generated/googleapis_beta/lib/appengine/v1beta5.dart
diff --git a/generated/googleapis_beta/lib/appengine/v1beta5.dart b/generated/googleapis_beta/lib/appengine/v1beta5.dart
index 66e8bee443836bd10ce3b97fd2cf94afe1180c6a..14bc1e01ebf52227ac4d6e8bfe5f7d0f407f69e2 100644
--- a/generated/googleapis_beta/lib/appengine/v1beta5.dart
+++ b/generated/googleapis_beta/lib/appengine/v1beta5.dart
@@ -14,7 +14,10 @@ export 'package:_discoveryapis_commons/_discoveryapis_commons.dart' show
 
 const core.String USER_AGENT = 'dart-api-client appengine/v1beta5';
 
-/** Provisions and manages App Engine applications. */
+/**
+ * The App Engine Admin API enables developers to provision and manage their App
+ * Engine applications.
+ */
 class AppengineApi {
   /** View and manage your applications deployed on Google App Engine */
   static const AppengineAdminScope = "https://www.googleapis.com/auth/appengine.admin";
@@ -47,11 +50,12 @@ class AppsResourceApi {
 
   /**
    * Creates an App Engine application for a Google Cloud Platform project.
-   * Required fields: id - The ID of the target Cloud Platform project. location
-   * - The region (https://cloud.google.com/appengine/docs/locations) where you
-   * want the App Engine application located.For more information about App
-   * Engine applications, see Managing Projects, Applications, and Billing
-   * (https://cloud.google.com/appengine/docs/python/console/).
+   * Required fields:
+   * id - The ID of the target Cloud Platform project.
+   * location - The region (https://cloud.google.com/appengine/docs/locations)
+   * where you want the App Engine application located.For more information
+   * about App Engine applications, see Managing Projects, Applications, and
+   * Billing (https://cloud.google.com/appengine/docs/python/console/).
    *
    * [request] - The metadata request object.
    *
@@ -141,7 +145,8 @@ class AppsResourceApi {
 
   /**
    * Updates the specified Application resource. You can update the following
-   * fields: auth_domain
+   * fields:
+   * auth_domain
    * (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps#Application.FIELDS.auth_domain)
    * default_cookie_expiration
    * (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps#Application.FIELDS.default_cookie_expiration)
@@ -256,10 +261,10 @@ class AppsLocationsResourceApi {
    *
    * [filter] - The standard list filter.
    *
-   * [pageSize] - The standard list page size.
-   *
    * [pageToken] - The standard list page token.
    *
+   * [pageSize] - The standard list page size.
+   *
    * Completes with a [ListLocationsResponse].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
@@ -268,7 +273,7 @@ class AppsLocationsResourceApi {
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
-  async.Future<ListLocationsResponse> list(core.String appsId, {core.String filter, core.int pageSize, core.String pageToken}) {
+  async.Future<ListLocationsResponse> list(core.String appsId, {core.String filter, core.String pageToken, core.int pageSize}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
@@ -282,12 +287,12 @@ class AppsLocationsResourceApi {
     if (filter != null) {
       _queryParams["filter"] = [filter];
     }
-    if (pageSize != null) {
-      _queryParams["pageSize"] = ["${pageSize}"];
-    }
     if (pageToken != null) {
       _queryParams["pageToken"] = [pageToken];
     }
+    if (pageSize != null) {
+      _queryParams["pageSize"] = ["${pageSize}"];
+    }
 
     _url = 'v1beta5/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/locations';
 
@@ -366,11 +371,11 @@ class AppsOperationsResourceApi {
    *
    * [appsId] - Part of `name`. The name of the operation collection.
    *
-   * [filter] - The standard list filter.
+   * [pageToken] - The standard list page token.
    *
    * [pageSize] - The standard list page size.
    *
-   * [pageToken] - The standard list page token.
+   * [filter] - The standard list filter.
    *
    * Completes with a [ListOperationsResponse].
    *
@@ -380,7 +385,7 @@ class AppsOperationsResourceApi {
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
-  async.Future<ListOperationsResponse> list(core.String appsId, {core.String filter, core.int pageSize, core.String pageToken}) {
+  async.Future<ListOperationsResponse> list(core.String appsId, {core.String pageToken, core.int pageSize, core.String filter}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
@@ -391,14 +396,14 @@ class AppsOperationsResourceApi {
     if (appsId == null) {
       throw new core.ArgumentError("Parameter appsId is required.");
     }
-    if (filter != null) {
-      _queryParams["filter"] = [filter];
+    if (pageToken != null) {
+      _queryParams["pageToken"] = [pageToken];
     }
     if (pageSize != null) {
       _queryParams["pageSize"] = ["${pageSize}"];
     }
-    if (pageToken != null) {
-      _queryParams["pageToken"] = [pageToken];
+    if (filter != null) {
+      _queryParams["filter"] = [filter];
     }
 
     _url = 'v1beta5/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/operations';
@@ -522,10 +527,10 @@ class AppsServicesResourceApi {
    * [appsId] - Part of `name`. Name of the resource requested. Example:
    * apps/myapp.
    *
-   * [pageSize] - Maximum results to return per page.
-   *
    * [pageToken] - Continuation token for fetching the next page of results.
    *
+   * [pageSize] - Maximum results to return per page.
+   *
    * Completes with a [ListServicesResponse].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
@@ -534,7 +539,7 @@ class AppsServicesResourceApi {
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
-  async.Future<ListServicesResponse> list(core.String appsId, {core.int pageSize, core.String pageToken}) {
+  async.Future<ListServicesResponse> list(core.String appsId, {core.String pageToken, core.int pageSize}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
@@ -545,12 +550,12 @@ class AppsServicesResourceApi {
     if (appsId == null) {
       throw new core.ArgumentError("Parameter appsId is required.");
     }
-    if (pageSize != null) {
-      _queryParams["pageSize"] = ["${pageSize}"];
-    }
     if (pageToken != null) {
       _queryParams["pageToken"] = [pageToken];
     }
+    if (pageSize != null) {
+      _queryParams["pageSize"] = ["${pageSize}"];
+    }
 
     _url = 'v1beta5/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/services';
 
@@ -576,8 +581,6 @@ class AppsServicesResourceApi {
    *
    * [servicesId] - Part of `name`. See documentation of `appsId`.
    *
-   * [mask] - Standard field mask for the set of fields to be updated.
-   *
    * [migrateTraffic] - Set to true to gradually shift traffic to one or more
    * versions that you specify. By default, traffic is shifted immediately. For
    * gradual traffic migration, the target versions must be located within
@@ -592,6 +595,8 @@ class AppsServicesResourceApi {
    * Splitting Traffic
    * (https://cloud.google.com/appengine/docs/admin-api/migrating-splitting-traffic).
    *
+   * [mask] - Standard field mask for the set of fields to be updated.
+   *
    * Completes with a [Operation].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
@@ -600,7 +605,7 @@ class AppsServicesResourceApi {
    * 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> patch(Service request, core.String appsId, core.String servicesId, {core.String mask, core.bool migrateTraffic}) {
+  async.Future<Operation> patch(Service request, core.String appsId, core.String servicesId, {core.bool migrateTraffic, core.String mask}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
@@ -617,12 +622,12 @@ class AppsServicesResourceApi {
     if (servicesId == null) {
       throw new core.ArgumentError("Parameter servicesId is required.");
     }
-    if (mask != null) {
-      _queryParams["mask"] = [mask];
-    }
     if (migrateTraffic != null) {
       _queryParams["migrateTraffic"] = ["${migrateTraffic}"];
     }
+    if (mask != null) {
+      _queryParams["mask"] = [mask];
+    }
 
     _url = 'v1beta5/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/services/' + commons.Escaper.ecapeVariable('$servicesId');
 
@@ -816,15 +821,15 @@ class AppsServicesVersionsResourceApi {
    *
    * [servicesId] - Part of `name`. See documentation of `appsId`.
    *
+   * [pageToken] - Continuation token for fetching the next page of results.
+   *
+   * [pageSize] - Maximum results to return per page.
+   *
    * [view] - Controls the set of fields returned in the List response.
    * Possible string values are:
    * - "BASIC" : A BASIC.
    * - "FULL" : A FULL.
    *
-   * [pageSize] - Maximum results to return per page.
-   *
-   * [pageToken] - Continuation token for fetching the next page of results.
-   *
    * Completes with a [ListVersionsResponse].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
@@ -833,7 +838,7 @@ class AppsServicesVersionsResourceApi {
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
-  async.Future<ListVersionsResponse> list(core.String appsId, core.String servicesId, {core.String view, core.int pageSize, core.String pageToken}) {
+  async.Future<ListVersionsResponse> list(core.String appsId, core.String servicesId, {core.String pageToken, core.int pageSize, core.String view}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
@@ -847,14 +852,14 @@ class AppsServicesVersionsResourceApi {
     if (servicesId == null) {
       throw new core.ArgumentError("Parameter servicesId is required.");
     }
-    if (view != null) {
-      _queryParams["view"] = [view];
+    if (pageToken != null) {
+      _queryParams["pageToken"] = [pageToken];
     }
     if (pageSize != null) {
       _queryParams["pageSize"] = ["${pageSize}"];
     }
-    if (pageToken != null) {
-      _queryParams["pageToken"] = [pageToken];
+    if (view != null) {
+      _queryParams["view"] = [view];
     }
 
     _url = 'v1beta5/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/services/' + commons.Escaper.ecapeVariable('$servicesId') + '/versions';
@@ -872,18 +877,21 @@ class AppsServicesVersionsResourceApi {
   /**
    * Updates the specified Version resource. You can specify the following
    * fields depending on the App Engine environment and type of scaling that the
-   * version resource uses: serving_status
+   * version resource uses:
+   * serving_status
    * (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.serving_status):
-   * For Version resources that use basic scaling, manual scaling, or run in the
-   * App Engine flexible environment. instance_class
+   * For Version resources that use basic scaling, manual scaling, or run in
+   * the App Engine flexible environment.
+   * instance_class
    * (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.instance_class):
    * For Version resources that run in the App Engine standard environment.
    * automatic_scaling.min_idle_instances
    * (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.automatic_scaling):
-   * For Version resources that use automatic scaling and run in the App Engine
-   * standard environment. automatic_scaling.max_idle_instances
+   * For Version resources that use automatic scaling and run in the App  Engine
+   * standard environment.
+   * automatic_scaling.max_idle_instances
    * (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#Version.FIELDS.automatic_scaling):
-   * For Version resources that use automatic scaling and run in the App Engine
+   * For Version resources that use automatic scaling and run in the App  Engine
    * standard environment.
    *
    * [request] - The metadata request object.
@@ -1141,10 +1149,10 @@ class AppsServicesVersionsInstancesResourceApi {
    *
    * [versionsId] - Part of `name`. See documentation of `appsId`.
    *
-   * [pageSize] - Maximum results to return per page.
-   *
    * [pageToken] - Continuation token for fetching the next page of results.
    *
+   * [pageSize] - Maximum results to return per page.
+   *
    * Completes with a [ListInstancesResponse].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
@@ -1153,7 +1161,7 @@ class AppsServicesVersionsInstancesResourceApi {
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
-  async.Future<ListInstancesResponse> list(core.String appsId, core.String servicesId, core.String versionsId, {core.int pageSize, core.String pageToken}) {
+  async.Future<ListInstancesResponse> list(core.String appsId, core.String servicesId, core.String versionsId, {core.String pageToken, core.int pageSize}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
@@ -1170,12 +1178,12 @@ class AppsServicesVersionsInstancesResourceApi {
     if (versionsId == null) {
       throw new core.ArgumentError("Parameter versionsId is required.");
     }
-    if (pageSize != null) {
-      _queryParams["pageSize"] = ["${pageSize}"];
-    }
     if (pageToken != null) {
       _queryParams["pageToken"] = [pageToken];
     }
+    if (pageSize != null) {
+      _queryParams["pageSize"] = ["${pageSize}"];
+    }
 
     _url = 'v1beta5/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/services/' + commons.Escaper.ecapeVariable('$servicesId') + '/versions/' + commons.Escaper.ecapeVariable('$versionsId') + '/instances';
 
@@ -1203,18 +1211,26 @@ class ApiConfigHandler {
    * Action to take when users access resources that require authentication.
    * Defaults to redirect.
    * Possible string values are:
-   * - "AUTH_FAIL_ACTION_UNSPECIFIED" : A AUTH_FAIL_ACTION_UNSPECIFIED.
-   * - "AUTH_FAIL_ACTION_REDIRECT" : A AUTH_FAIL_ACTION_REDIRECT.
-   * - "AUTH_FAIL_ACTION_UNAUTHORIZED" : A AUTH_FAIL_ACTION_UNAUTHORIZED.
+   * - "AUTH_FAIL_ACTION_UNSPECIFIED" : Not specified. AUTH_FAIL_ACTION_REDIRECT
+   * is assumed.
+   * - "AUTH_FAIL_ACTION_REDIRECT" : Redirects user to "accounts.google.com".
+   * The user is redirected back to the application URL after signing in or
+   * creating an account.
+   * - "AUTH_FAIL_ACTION_UNAUTHORIZED" : Rejects request with an401 HTTP status
+   * code and an error message.
    */
   core.String authFailAction;
   /**
    * Level of login required to access this resource. Defaults to optional.
    * Possible string values are:
-   * - "LOGIN_UNSPECIFIED" : A LOGIN_UNSPECIFIED.
-   * - "LOGIN_OPTIONAL" : A LOGIN_OPTIONAL.
-   * - "LOGIN_ADMIN" : A LOGIN_ADMIN.
-   * - "LOGIN_REQUIRED" : A LOGIN_REQUIRED.
+   * - "LOGIN_UNSPECIFIED" : Not specified. LOGIN_OPTIONAL is assumed.
+   * - "LOGIN_OPTIONAL" : Does not require that the user is signed in.
+   * - "LOGIN_ADMIN" : If the user is not signed in, the auth_fail_action is
+   * taken. In addition, if the user is not an administrator for the
+   * application, they are given an error message regardless of
+   * auth_fail_action. If the user is an administrator, the handler proceeds.
+   * - "LOGIN_REQUIRED" : If the user has signed in, the handler proceeds
+   * normally. Otherwise, the action given in auth_fail_action is taken.
    */
   core.String login;
   /** Path to the script from the application root directory. */
@@ -1222,11 +1238,18 @@ class ApiConfigHandler {
   /**
    * Security (HTTPS) enforcement for this URL.
    * Possible string values are:
-   * - "SECURE_UNSPECIFIED" : A SECURE_UNSPECIFIED.
-   * - "SECURE_DEFAULT" : A SECURE_DEFAULT.
-   * - "SECURE_NEVER" : A SECURE_NEVER.
-   * - "SECURE_OPTIONAL" : A SECURE_OPTIONAL.
-   * - "SECURE_ALWAYS" : A SECURE_ALWAYS.
+   * - "SECURE_UNSPECIFIED" : Not specified.
+   * - "SECURE_DEFAULT" : Both HTTP and HTTPS requests with URLs that match the
+   * handler succeed without redirects. The application can examine the request
+   * to determine which protocol was used, and respond accordingly.
+   * - "SECURE_NEVER" : Requests for a URL that match this handler that use
+   * HTTPS are automatically redirected to the HTTP equivalent URL.
+   * - "SECURE_OPTIONAL" : Both HTTP and HTTPS requests with URLs that match the
+   * handler succeed without redirects. The application can examine the request
+   * to determine which protocol was used and respond accordingly.
+   * - "SECURE_ALWAYS" : Requests for a URL that match this handler that do not
+   * use HTTPS are automatically redirected to the HTTPS URL with the same path.
+   * Query parameters are reserved for the redirect.
    */
   core.String securityLevel;
   /** URL to serve the endpoint at. */
@@ -1660,8 +1683,9 @@ class CpuUtilization {
 /** Request message for Instances.DebugInstance. */
 class DebugInstanceRequest {
   /**
-   * Public SSH key to add to the instance. Examples: [USERNAME]:ssh-rsa
-   * [KEY_VALUE] [USERNAME] [USERNAME]:ssh-rsa [KEY_VALUE] google-ssh
+   * Public SSH key to add to the instance. Examples:
+   * [USERNAME]:ssh-rsa [KEY_VALUE] [USERNAME]
+   * [USERNAME]:ssh-rsa [KEY_VALUE] google-ssh
    * {"userName":"[USERNAME]","expireOn":"[EXPIRE_TIME]"}For more information,
    * see Adding and Removing SSH Keys
    * (https://cloud.google.com/compute/docs/instances/adding-removing-ssh-keys).
@@ -1827,11 +1851,12 @@ class ErrorHandler {
   /**
    * Error condition this handler applies to.
    * Possible string values are:
-   * - "ERROR_CODE_UNSPECIFIED" : A ERROR_CODE_UNSPECIFIED.
-   * - "ERROR_CODE_DEFAULT" : A ERROR_CODE_DEFAULT.
-   * - "ERROR_CODE_OVER_QUOTA" : A ERROR_CODE_OVER_QUOTA.
-   * - "ERROR_CODE_DOS_API_DENIAL" : A ERROR_CODE_DOS_API_DENIAL.
-   * - "ERROR_CODE_TIMEOUT" : A ERROR_CODE_TIMEOUT.
+   * - "ERROR_CODE_UNSPECIFIED" : Not specified. ERROR_CODE_DEFAULT is assumed.
+   * - "ERROR_CODE_DEFAULT" : All other error types.
+   * - "ERROR_CODE_OVER_QUOTA" : Application has exceeded a resource quota.
+   * - "ERROR_CODE_DOS_API_DENIAL" : Client blocked by the application's Denial
+   * of Service protection configuration.
+   * - "ERROR_CODE_TIMEOUT" : Deadline reached before the application responds.
    */
   core.String errorCode;
   /** MIME type of file. Defaults to text/html. */
@@ -1881,7 +1906,8 @@ class FileInfo {
   core.String sha1Sum;
   /**
    * URL source to use to fetch this file. Must be a URL to a resource in Google
-   * Cloud Storage in the form 'http(s)://storage.googleapis.com//'.
+   * Cloud Storage in the form
+   * 'http(s)://storage.googleapis.com/<bucket>/<object>'.
    */
   core.String sourceUrl;
 
@@ -2064,9 +2090,9 @@ class Instance {
   /**
    * Availability of the instance.@OutputOnly
    * Possible string values are:
-   * - "UNSPECIFIED" : A UNSPECIFIED.
-   * - "RESIDENT" : A RESIDENT.
-   * - "DYNAMIC" : A DYNAMIC.
+   * - "UNSPECIFIED"
+   * - "RESIDENT"
+   * - "DYNAMIC"
    */
   core.String availability;
   /** Average latency (ms) over the last minute.@OutputOnly */
@@ -2551,16 +2577,17 @@ class Network {
    * Google Cloud Platform sub-network where the virtual machines are created.
    * Specify the short name, not the resource path.If a subnetwork name is
    * specified, a network name will also be required unless it is for the
-   * default network. If the network the VM instance is being created in is a
-   * Legacy network, then the IP address is allocated from the IPv4Range. If the
-   * network the VM instance is being created in is an auto Subnet Mode Network,
-   * then only network name should be specified (not the subnetwork_name) and
-   * the IP address is created from the IPCidrRange of the subnetwork that
-   * exists in that zone for that network. If the network the VM instance is
-   * being created in is a custom Subnet Mode Network, then the subnetwork_name
-   * must be specified and the IP address is created from the IPCidrRange of the
-   * subnetwork.If specified, the subnetwork must exist in the same region as
-   * the Flex app.
+   * default network.
+   * If the network the VM instance is being created in is a Legacy network,
+   * then the IP address is allocated from the IPv4Range.
+   * If the network the VM instance is being created in is an auto Subnet Mode
+   * Network, then only network name should be specified (not the
+   * subnetwork_name) and the IP address is created from the IPCidrRange of the
+   * subnetwork that exists in that zone for that network.
+   * If the network the VM instance is being created in is a custom Subnet Mode
+   * Network, then the subnetwork_name must be specified and the IP address is
+   * created from the IPCidrRange of the subnetwork.If specified, the subnetwork
+   * must exist in the same region as the Flex app.
    */
   core.String subnetworkName;
 
@@ -3368,36 +3395,38 @@ class StaticFilesHandler {
 /**
  * The Status type defines a logical error model that is suitable for different
  * programming environments, including REST APIs and RPC APIs. It is used by
- * gRPC (https://github.com/grpc). The error model is designed to be: Simple to
- * use and understand for most users Flexible enough to meet unexpected
- * needsOverviewThe Status message contains three pieces of data: error code,
- * error message, and error details. The error code should be an enum value of
- * google.rpc.Code, but it may accept additional error codes if needed. The
- * error message should be a developer-facing English message that helps
- * developers understand and resolve the error. If a localized user-facing error
- * message is needed, put the localized message in the error details or localize
- * it in the client. The optional error details may contain arbitrary
- * information about the error. There is a predefined set of error detail types
- * in the package google.rpc which can be used for common error
- * conditions.Language mappingThe Status message is the logical representation
- * of the error model, but it is not necessarily the actual wire format. When
- * the Status message is exposed in different client libraries and different
- * wire protocols, it can be mapped differently. For example, it will likely be
- * mapped to some exceptions in Java, but more likely mapped to some error codes
- * in C.Other usesThe error model and the Status message can be used in a
- * variety of environments, either with or without APIs, to provide a consistent
- * developer experience across different environments.Example uses of this error
- * model include: Partial errors. If a service needs to return partial errors to
- * the client, it may embed the Status in the normal response to indicate the
- * partial errors. Workflow errors. A typical workflow has multiple steps. Each
- * step may have a Status message for error reporting purpose. Batch operations.
- * If a client uses batch request and batch response, the Status message should
- * be used directly inside batch response, one for each error sub-response.
+ * gRPC (https://github.com/grpc). The error model is designed to be:
+ * Simple to use and understand for most users
+ * Flexible enough to meet unexpected needsOverviewThe Status message contains
+ * three pieces of data: error code, error message, and error details. The error
+ * code should be an enum value of google.rpc.Code, but it may accept additional
+ * error codes if needed. The error message should be a developer-facing English
+ * message that helps developers understand and resolve the error. If a
+ * localized user-facing error message is needed, put the localized message in
+ * the error details or localize it in the client. The optional error details
+ * may contain arbitrary information about the error. There is a predefined set
+ * of error detail types in the package google.rpc which can be used for common
+ * error conditions.Language mappingThe Status message is the logical
+ * representation of the error model, but it is not necessarily the actual wire
+ * format. When the Status message is exposed in different client libraries and
+ * different wire protocols, it can be mapped differently. For example, it will
+ * likely be mapped to some exceptions in Java, but more likely mapped to some
+ * error codes in C.Other usesThe error model and the Status message can be used
+ * in a variety of environments, either with or without APIs, to provide a
+ * consistent developer experience across different environments.Example uses of
+ * this error model include:
+ * Partial errors. If a service needs to return partial errors to the client, it
+ * may embed the Status in the normal response to indicate the partial errors.
+ * Workflow errors. A typical workflow has multiple steps. Each step may have a
+ * Status message for error reporting purpose.
+ * Batch operations. If a client uses batch request and batch response, the
+ * Status message should be used directly inside batch response, one for each
+ * error sub-response.
  * Asynchronous operations. If an API call embeds asynchronous operation results
  * in its response, the status of those operations should be represented
- * directly using the Status message. Logging. If some API errors are stored in
- * logs, the message Status could be used directly after any stripping needed
- * for security/privacy reasons.
+ * directly using the Status message.
+ * Logging. If some API errors are stored in logs, the message Status could be
+ * used directly after any stripping needed for security/privacy reasons.
  */
 class Status {
   /** The status code, which should be an enum value of google.rpc.Code. */
@@ -3466,9 +3495,12 @@ class TrafficSplit {
    * selection algorithm will be stable for either type until allocations are
    * changed.
    * Possible string values are:
-   * - "UNSPECIFIED" : A UNSPECIFIED.
-   * - "COOKIE" : A COOKIE.
-   * - "IP" : A IP.
+   * - "UNSPECIFIED" : Diversion method unspecified.
+   * - "COOKIE" : Diversion based on a specially named cookie, "GOOGAPPUID." The
+   * cookie must be set by the application itself or else no diversion will
+   * occur.
+   * - "IP" : Diversion based on applying the modulus operation to a fingerprint
+   * of the IP address.
    */
   core.String shardBy;
 
@@ -3555,30 +3587,38 @@ class UrlMap {
    * Action to take when users access resources that require authentication.
    * Defaults to redirect.
    * Possible string values are:
-   * - "AUTH_FAIL_ACTION_UNSPECIFIED" : A AUTH_FAIL_ACTION_UNSPECIFIED.
-   * - "AUTH_FAIL_ACTION_REDIRECT" : A AUTH_FAIL_ACTION_REDIRECT.
-   * - "AUTH_FAIL_ACTION_UNAUTHORIZED" : A AUTH_FAIL_ACTION_UNAUTHORIZED.
+   * - "AUTH_FAIL_ACTION_UNSPECIFIED" : Not specified. AUTH_FAIL_ACTION_REDIRECT
+   * is assumed.
+   * - "AUTH_FAIL_ACTION_REDIRECT" : Redirects user to "accounts.google.com".
+   * The user is redirected back to the application URL after signing in or
+   * creating an account.
+   * - "AUTH_FAIL_ACTION_UNAUTHORIZED" : Rejects request with an401 HTTP status
+   * code and an error message.
    */
   core.String authFailAction;
   /**
    * Level of login required to access this resource.
    * Possible string values are:
-   * - "LOGIN_UNSPECIFIED" : A LOGIN_UNSPECIFIED.
-   * - "LOGIN_OPTIONAL" : A LOGIN_OPTIONAL.
-   * - "LOGIN_ADMIN" : A LOGIN_ADMIN.
-   * - "LOGIN_REQUIRED" : A LOGIN_REQUIRED.
+   * - "LOGIN_UNSPECIFIED" : Not specified. LOGIN_OPTIONAL is assumed.
+   * - "LOGIN_OPTIONAL" : Does not require that the user is signed in.
+   * - "LOGIN_ADMIN" : If the user is not signed in, the auth_fail_action is
+   * taken. In addition, if the user is not an administrator for the
+   * application, they are given an error message regardless of
+   * auth_fail_action. If the user is an administrator, the handler proceeds.
+   * - "LOGIN_REQUIRED" : If the user has signed in, the handler proceeds
+   * normally. Otherwise, the action given in auth_fail_action is taken.
    */
   core.String login;
   /**
    * 30x code to use when performing redirects for the secure field. Defaults to
    * 302.
    * Possible string values are:
-   * - "REDIRECT_HTTP_RESPONSE_CODE_UNSPECIFIED" : A
-   * REDIRECT_HTTP_RESPONSE_CODE_UNSPECIFIED.
-   * - "REDIRECT_HTTP_RESPONSE_CODE_301" : A REDIRECT_HTTP_RESPONSE_CODE_301.
-   * - "REDIRECT_HTTP_RESPONSE_CODE_302" : A REDIRECT_HTTP_RESPONSE_CODE_302.
-   * - "REDIRECT_HTTP_RESPONSE_CODE_303" : A REDIRECT_HTTP_RESPONSE_CODE_303.
-   * - "REDIRECT_HTTP_RESPONSE_CODE_307" : A REDIRECT_HTTP_RESPONSE_CODE_307.
+   * - "REDIRECT_HTTP_RESPONSE_CODE_UNSPECIFIED" : Not specified. 302 is
+   * assumed.
+   * - "REDIRECT_HTTP_RESPONSE_CODE_301" : 301 Moved Permanently code.
+   * - "REDIRECT_HTTP_RESPONSE_CODE_302" : 302 Moved Temporarily code.
+   * - "REDIRECT_HTTP_RESPONSE_CODE_303" : 303 See Other code.
+   * - "REDIRECT_HTTP_RESPONSE_CODE_307" : 307 Temporary Redirect code.
    */
   core.String redirectHttpResponseCode;
   /** Executes a script to handle the request that matches this URL pattern. */
@@ -3586,11 +3626,18 @@ class UrlMap {
   /**
    * Security (HTTPS) enforcement for this URL.
    * Possible string values are:
-   * - "SECURE_UNSPECIFIED" : A SECURE_UNSPECIFIED.
-   * - "SECURE_DEFAULT" : A SECURE_DEFAULT.
-   * - "SECURE_NEVER" : A SECURE_NEVER.
-   * - "SECURE_OPTIONAL" : A SECURE_OPTIONAL.
-   * - "SECURE_ALWAYS" : A SECURE_ALWAYS.
+   * - "SECURE_UNSPECIFIED" : Not specified.
+   * - "SECURE_DEFAULT" : Both HTTP and HTTPS requests with URLs that match the
+   * handler succeed without redirects. The application can examine the request
+   * to determine which protocol was used, and respond accordingly.
+   * - "SECURE_NEVER" : Requests for a URL that match this handler that use
+   * HTTPS are automatically redirected to the HTTP equivalent URL.
+   * - "SECURE_OPTIONAL" : Both HTTP and HTTPS requests with URLs that match the
+   * handler succeed without redirects. The application can examine the request
+   * to determine which protocol was used and respond accordingly.
+   * - "SECURE_ALWAYS" : Requests for a URL that match this handler that do not
+   * use HTTPS are automatically redirected to the HTTPS URL with the same path.
+   * Query parameters are reserved for the redirect.
    */
   core.String securityLevel;
   /** Returns the contents of a file, such as an image, as the response. */
@@ -3757,9 +3804,9 @@ class Version {
   core.List<core.String> inboundServices;
   /**
    * Instance class that is used to run this version. Valid values are:
-   * AutomaticScaling: F1, F2, F4, F4_1G ManualScaling or BasicScaling: B1, B2,
-   * B4, B8, B4_1GDefaults to F1 for AutomaticScaling and B1 for ManualScaling
-   * or BasicScaling.
+   * AutomaticScaling: F1, F2, F4, F4_1G
+   * ManualScaling or BasicScaling: B1, B2, B4, B8, B4_1GDefaults to F1 for
+   * AutomaticScaling and B1 for ManualScaling or BasicScaling.
    */
   core.String instanceClass;
   /**
@@ -3794,9 +3841,12 @@ class Version {
    * status create instances and can be billed.SERVING_STATUS_UNSPECIFIED is an
    * invalid value. Defaults to SERVING.
    * Possible string values are:
-   * - "SERVING_STATUS_UNSPECIFIED" : A SERVING_STATUS_UNSPECIFIED.
-   * - "SERVING" : A SERVING.
-   * - "STOPPED" : A STOPPED.
+   * - "SERVING_STATUS_UNSPECIFIED" : Not specified.
+   * - "SERVING" : Currently serving. Instances are created according to the
+   * scaling settings of the version.
+   * - "STOPPED" : Disabled from serving. No instances will be created and the
+   * scaling settings are ignored until the state of the version changes to
+   * SERVING.
    */
   core.String servingStatus;
   /** Whether multiple requests can be dispatched to this version at once. */