Api-roll 48: 2017-04-18

generated/googleapis_beta/lib/appengine/v1beta5.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis_beta.appengine.v1beta5;
 
 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:http/http.dart' as http;
 
 export 'package:_discoveryapis_commons/_discoveryapis_commons.dart' show
     ApiRequestError, DetailedApiRequestError;
 
 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";
 
   /** View and manage your data across Google Cloud Platform services */
   static const CloudPlatformScope = "https://www.googleapis.com/auth/cloud-platform";
 
   /** View your data across Google Cloud Platform services */
   static const CloudPlatformReadOnlyScope = "https://www.googleapis.com/auth/cloud-platform.read-only";
 
@@ skipping 12 matching lines @@
 
   AppsLocationsResourceApi get locations => new AppsLocationsResourceApi(_requester);
   AppsOperationsResourceApi get operations => new AppsOperationsResourceApi(_requester);
   AppsServicesResourceApi get services => new AppsServicesResourceApi(_requester);
 
   AppsResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
    * 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.
    *
    * Request parameters:
    *
    * Completes with a [Operation].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
@@ skipping 69 matching lines @@
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Application.fromJson(data));
   }
 
   /**
    * 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)
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [appsId] - Part of `name`. Name of the Application resource to update.
    * Example: apps/myapp.
@@ skipping 94 matching lines @@
   /**
    * Lists information about the supported locations for this service.
    *
    * Request parameters:
    *
    * [appsId] - Part of `name`. The resource that owns the locations collection,
    * if applicable.
    *
    * [filter] - The standard list filter.
    *
+   * [pageToken] - The standard list page token.
+   *
    * [pageSize] - The standard list page size.
    *
-   * [pageToken] - The standard list page token.
-   *
    * Completes with a [ListLocationsResponse].
    *
    * 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<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;
     var _uploadOptions = null;
     var _downloadOptions = commons.DownloadOptions.Metadata;
     var _body = null;
 
     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];
-    }
 
     _url = 'v1beta5/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/locations';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 58 matching lines @@
   /**
    * Lists operations that match the specified filter in the request. If the
    * server doesn't support this method, it returns UNIMPLEMENTED.NOTE: the name
    * binding below allows API services to override the binding to use different
    * resource name schemes, such as users / * /operations.
    *
    * Request parameters:
    *
    * [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].
    *
    * 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<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;
     var _uploadOptions = null;
     var _downloadOptions = commons.DownloadOptions.Metadata;
     var _body = null;
 
     if (appsId == null) {
       throw new core.ArgumentError("Parameter appsId is required.");
     }
+    if (pageToken != null) {
+      _queryParams["pageToken"] = [pageToken];
+    }
+    if (pageSize != null) {
+      _queryParams["pageSize"] = ["${pageSize}"];
+    }
     if (filter != null) {
       _queryParams["filter"] = [filter];
     }
-    if (pageSize != null) {
-      _queryParams["pageSize"] = ["${pageSize}"];
-    }
-    if (pageToken != null) {
-      _queryParams["pageToken"] = [pageToken];
-    }
 
     _url = 'v1beta5/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/operations';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 102 matching lines @@
   }
 
   /**
    * Lists all the services in the application.
    *
    * Request parameters:
    *
    * [appsId] - Part of `name`. Name of the resource requested. Example:
    * apps/myapp.
    *
+   * [pageToken] - Continuation token for fetching the next page of results.
+   *
    * [pageSize] - Maximum results to return per page.
    *
-   * [pageToken] - Continuation token for fetching the next page of results.
-   *
    * Completes with a [ListServicesResponse].
    *
    * 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<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;
     var _uploadOptions = null;
     var _downloadOptions = commons.DownloadOptions.Metadata;
     var _body = null;
 
     if (appsId == null) {
       throw new core.ArgumentError("Parameter appsId is required.");
     }
+    if (pageToken != null) {
+      _queryParams["pageToken"] = [pageToken];
+    }
     if (pageSize != null) {
       _queryParams["pageSize"] = ["${pageSize}"];
     }
-    if (pageToken != null) {
-      _queryParams["pageToken"] = [pageToken];
-    }
 
     _url = 'v1beta5/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/services';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new ListServicesResponse.fromJson(data));
   }
 
   /**
    * Updates the configuration of the specified service.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [appsId] - Part of `name`. Name of the resource to update. Example:
    * apps/myapp/services/default.
    *
    * [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
    * instances that are configured for both warmup requests
    * (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#inboundservicetype)
    * and automatic scaling
    * (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services.versions#automaticscaling).
    * You must specify the shardBy
    * (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1beta5/apps.services#shardby)
    * field in the Service resource. Gradual traffic migration is not supported
    * in the App Engine flexible environment. For examples, see Migrating and
    * 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
    * 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> 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;
     var _uploadOptions = null;
     var _downloadOptions = commons.DownloadOptions.Metadata;
     var _body = null;
 
     if (request != null) {
       _body = convert.JSON.encode((request).toJson());
     }
     if (appsId == null) {
       throw new core.ArgumentError("Parameter appsId is required.");
     }
     if (servicesId == null) {
       throw new core.ArgumentError("Parameter servicesId is required.");
     }
+    if (migrateTraffic != null) {
+      _queryParams["migrateTraffic"] = ["${migrateTraffic}"];
+    }
     if (mask != null) {
       _queryParams["mask"] = [mask];
     }
-    if (migrateTraffic != null) {
-      _queryParams["migrateTraffic"] = ["${migrateTraffic}"];
-    }
 
     _url = 'v1beta5/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/services/' + commons.Escaper.ecapeVariable('$servicesId');
 
     var _response = _requester.request(_url,
                                        "PATCH",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 173 matching lines @@
   /**
    * Lists the versions of a service.
    *
    * Request parameters:
    *
    * [appsId] - Part of `name`. Name of the resource requested. Example:
    * apps/myapp/services/default.
    *
    * [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
    * 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<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;
     var _uploadOptions = null;
     var _downloadOptions = commons.DownloadOptions.Metadata;
     var _body = null;
 
     if (appsId == null) {
       throw new core.ArgumentError("Parameter appsId is required.");
     }
     if (servicesId == null) {
       throw new core.ArgumentError("Parameter servicesId is required.");
     }
+    if (pageToken != null) {
+      _queryParams["pageToken"] = [pageToken];
+    }
+    if (pageSize != null) {
+      _queryParams["pageSize"] = ["${pageSize}"];
+    }
     if (view != null) {
       _queryParams["view"] = [view];
     }
-    if (pageSize != null) {
-      _queryParams["pageSize"] = ["${pageSize}"];
-    }
-    if (pageToken != null) {
-      _queryParams["pageToken"] = [pageToken];
-    }
 
     _url = 'v1beta5/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/services/' + commons.Escaper.ecapeVariable('$servicesId') + '/versions';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new ListVersionsResponse.fromJson(data));
   }
 
   /**
    * 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.
    *
    * Request parameters:
    *
    * [appsId] - Part of `name`. Name of the resource to update. Example:
    * apps/myapp/services/default/versions/1.
    *
    * [servicesId] - Part of `name`. See documentation of `appsId`.
@@ skipping 237 matching lines @@
    *
    * Request parameters:
    *
    * [appsId] - Part of `name`. Name of the resource requested. Example:
    * apps/myapp/services/default/versions/v1.
    *
    * [servicesId] - Part of `name`. See documentation of `appsId`.
    *
    * [versionsId] - Part of `name`. See documentation of `appsId`.
    *
+   * [pageToken] - Continuation token for fetching the next page of results.
+   *
    * [pageSize] - Maximum results to return per page.
    *
-   * [pageToken] - Continuation token for fetching the next page of results.
-   *
    * Completes with a [ListInstancesResponse].
    *
    * 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<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;
     var _uploadOptions = null;
     var _downloadOptions = commons.DownloadOptions.Metadata;
     var _body = null;
 
     if (appsId == null) {
       throw new core.ArgumentError("Parameter appsId is required.");
     }
     if (servicesId == null) {
       throw new core.ArgumentError("Parameter servicesId is required.");
     }
     if (versionsId == null) {
       throw new core.ArgumentError("Parameter versionsId is required.");
     }
+    if (pageToken != null) {
+      _queryParams["pageToken"] = [pageToken];
+    }
     if (pageSize != null) {
       _queryParams["pageSize"] = ["${pageSize}"];
     }
-    if (pageToken != null) {
-      _queryParams["pageToken"] = [pageToken];
-    }
 
     _url = 'v1beta5/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/services/' + commons.Escaper.ecapeVariable('$servicesId') + '/versions/' + commons.Escaper.ecapeVariable('$versionsId') + '/instances';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new ListInstancesResponse.fromJson(data));
   }
 
 }
 
 
 
 /**
  * Google Cloud Endpoints
  * (https://cloud.google.com/appengine/docs/python/endpoints/) configuration for
  * API handlers.
  */
 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. */
   core.String script;
   /**
    * 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. */
   core.String url;
 
   ApiConfigHandler();
 
   ApiConfigHandler.fromJson(core.Map _json) {
     if (_json.containsKey("authFailAction")) {
       authFailAction = _json["authFailAction"];
@@ skipping 413 matching lines @@
     if (targetUtilization != null) {
       _json["targetUtilization"] = targetUtilization;
     }
     return _json;
   }
 }
 
 /** 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).
    */
   core.String sshKey;
 
   DebugInstanceRequest();
 
   DebugInstanceRequest.fromJson(core.Map _json) {
     if (_json.containsKey("sshKey")) {
@@ skipping 145 matching lines @@
     }
     return _json;
   }
 }
 
 /** Custom static error page to be served when an error occurs. */
 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. */
   core.String mimeType;
   /** Static file content to be served for this error. */
   core.String staticFile;
 
   ErrorHandler();
 
   ErrorHandler.fromJson(core.Map _json) {
@@ skipping 29 matching lines @@
  */
 class FileInfo {
   /**
    * The MIME type of the file.Defaults to the value from Google Cloud Storage.
    */
   core.String mimeType;
   /** The SHA1 hash of the file, in hex. */
   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;
 
   FileInfo();
 
   FileInfo.fromJson(core.Map _json) {
     if (_json.containsKey("mimeType")) {
       mimeType = _json["mimeType"];
     }
     if (_json.containsKey("sha1Sum")) {
@@ skipping 162 matching lines @@
 /**
  * An Instance resource is the computing unit that App Engine uses to
  * automatically scale an application.
  */
 class Instance {
   /** App Engine release this instance is running on.@OutputOnly */
   core.String appEngineRelease;
   /**
    * 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 */
   core.int averageLatency;
   /** Number of errors since this instance was started.@OutputOnly */
   core.int errors;
   /**
    * Relative name of the instance within the version. Example:
    * instance-1.@OutputOnly
    */
@@ skipping 464 matching lines @@
   core.String instanceTag;
   /**
    * Google Cloud Platform network where the virtual machines are created.
    * Specify the short name, not the resource path.Defaults to default.
    */
   core.String name;
   /**
    * 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;
 
   Network();
 
   Network.fromJson(core.Map _json) {
     if (_json.containsKey("forwardedPorts")) {
       forwardedPorts = _json["forwardedPorts"];
     }
     if (_json.containsKey("instanceTag")) {
@@ skipping 787 matching lines @@
     if (uploadPathRegex != null) {
       _json["uploadPathRegex"] = uploadPathRegex;
     }
     return _json;
   }
 }
 
 /**
  * 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. */
   core.int code;
   /**
    * A list of messages that carry the error details. There will be a common set
    * of message types for APIs to use.
    *
    * The values for Object must be JSON objects. It can consist of `num`,
    * `String`, `bool` and `null` as well as `Map` and `List` values.
@@ skipping 48 matching lines @@
    * service is deleted or their traffic allocation is removed. Allocations must
    * sum to 1. Up to two decimal place precision is supported for IP-based
    * splits and up to three decimal places is supported for cookie-based splits.
    */
   core.Map<core.String, core.double> allocations;
   /**
    * Mechanism used to determine which version a request is sent to. The traffic
    * 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;
 
   TrafficSplit();
 
   TrafficSplit.fromJson(core.Map _json) {
     if (_json.containsKey("allocations")) {
       allocations = _json["allocations"];
     }
     if (_json.containsKey("shardBy")) {
@@ skipping 66 matching lines @@
  * handle URLs by executing application code, or by serving static files
  * uploaded with the version, such as images, CSS, or JavaScript.
  */
 class UrlMap {
   /** Uses API Endpoints to handle requests. */
   ApiEndpointHandler apiEndpoint;
   /**
    * 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. */
   ScriptHandler script;
   /**
    * 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. */
   StaticFilesHandler staticFiles;
   /**
    * A URL prefix. Uses regular expression syntax, which means regexp special
    * characters must be escaped, but should not contain groupings. All URLs that
    * begin with this prefix are handled by this handler, using the portion of
    * the URL after the prefix as part of the file path.
    */
@@ skipping 146 matching lines @@
    * "default", "latest", and any name with the prefix "ah-".
    */
   core.String id;
   /**
    * Before an application can receive email or XMPP messages, the application
    * must be configured to enable the service.
    */
   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;
   /**
    * Configuration for third-party Python runtime libraries required by the
    * application.Only returned in GET requests if view=FULL is set.
    */
   core.List<Library> libraries;
   /**
    * A service with manual scaling runs continuously, allowing you to perform
    * complex initialization and rely on the state of its memory over time.
@@ skipping 14 matching lines @@
   core.String nobuildFilesRegex;
   /** Machine resources for this version. Only applicable for VM runtimes. */
   Resources resources;
   /** Desired runtime. Example: python27. */
   core.String runtime;
   /**
    * Current serving status of this version. Only the versions with a SERVING
    * 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. */
   core.bool threadsafe;
   /** Whether to deploy this version in a container on a virtual machine. */
   core.bool vm;
 
   Version();
 
   Version.fromJson(core.Map _json) {
@@ skipping 205 matching lines @@
     }
     if (sizeGb != null) {
       _json["sizeGb"] = sizeGb;
     }
     if (volumeType != null) {
       _json["volumeType"] = volumeType;
     }
     return _json;
   }
 }