Api-Roll 53: 2017-08-21

generated/googleapis/lib/appengine/v1.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis.appengine.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:http/http.dart' as http;
@@ skipping 278 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.
    *
+   * [pageSize] - The standard list page size.
+   *
    * [filter] - The standard list filter.
    *
    * [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
    * 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.String pageToken, core.int pageSize}) {
+  async.Future<ListLocationsResponse> list(core.String appsId, {core.int pageSize, core.String filter, core.String pageToken}) {
     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 (pageSize != null) {
+      _queryParams["pageSize"] = ["${pageSize}"];
+    }
     if (filter != null) {
       _queryParams["filter"] = [filter];
     }
     if (pageToken != null) {
       _queryParams["pageToken"] = [pageToken];
     }
-    if (pageSize != null) {
-      _queryParams["pageSize"] = ["${pageSize}"];
-    }
 
     _url = 'v1/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/locations';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 63 matching lines @@
    * binding, API services can add a binding such as "/v1/{name=users / *
    * }/operations" to their service configuration. For backwards compatibility,
    * the default name includes the operations collection id, however overriding
    * users must ensure the name binding is the parent resource, without the
    * operations collection id.
    *
    * Request parameters:
    *
    * [appsId] - Part of `name`. The name of the operation's parent resource.
    *
+   * [filter] - The standard list filter.
+   *
    * [pageToken] - The standard list page token.
    *
    * [pageSize] - The standard list page size.
    *
-   * [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 pageToken, core.int pageSize, core.String filter}) {
+  async.Future<ListOperationsResponse> 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 (filter != null) {
-      _queryParams["filter"] = [filter];
-    }
 
     _url = 'v1/apps/' + commons.Escaper.ecapeVariable('$appsId') + '/operations';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 156 matching lines @@
    *
    * [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`.
    *
-   * [updateMask] - 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/v1/apps.services.versions#inboundservicetype)
    * and automatic scaling
    * (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/apps.services.versions#automaticscaling).
    * You must specify the shardBy
    * (https://cloud.google.com/appengine/docs/admin-api/reference/rest/v1/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).
    *
+   * [updateMask] - 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 updateMask, core.bool migrateTraffic}) {
+  async.Future<Operation> patch(Service request, core.String appsId, core.String servicesId, {core.bool migrateTraffic, core.String updateMask}) {
     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 (updateMask != null) {
       _queryParams["updateMask"] = [updateMask];
     }
-    if (migrateTraffic != null) {
-      _queryParams["migrateTraffic"] = ["${migrateTraffic}"];
-    }
 
     _url = 'v1/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 501 matching lines @@
    *
    * Request parameters:
    *
    * [appsId] - Part of `parent`. Name of the parent Version resource. Example:
    * apps/myapp/services/default/versions/v1.
    *
    * [servicesId] - Part of `parent`. See documentation of `appsId`.
    *
    * [versionsId] - Part of `parent`. 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 = 'v1/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);
@@ skipping 1460 matching lines @@
 
   core.Map<core.String, core.Object> toJson() {
     final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
     if (instances != null) {
       _json["instances"] = instances;
     }
     return _json;
   }
 }
 
-/** Extra network settings. Only applicable for VM runtimes. */
+/**
+ * Extra network settings. Only applicable for App Engine flexible environment
+ * versions
+ */
 class Network {
   /**
    * List of ports, or port pairs, to forward from the virtual machine to the
-   * application container.
+   * application container. Only applicable for App Engine flexible environment
+   * versions.
    */
   core.List<core.String> forwardedPorts;
-  /** Tag to apply to the VM instance during creation. */
+  /**
+   * Tag to apply to the VM instance during creation. Only applicable for for
+   * App Engine flexible environment versions.
+   */
   core.String instanceTag;
   /**
-   * Google Cloud Platform network where the virtual machines are created.
+   * Google Compute Engine 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.
+   * must exist in the same region as the App Engine flexible environment
+   * application.
    */
   core.String subnetworkName;
 
   Network();
 
   Network.fromJson(core.Map _json) {
     if (_json.containsKey("forwardedPorts")) {
       forwardedPorts = _json["forwardedPorts"];
     }
     if (_json.containsKey("instanceTag")) {
@@ skipping 1363 matching lines @@
   /**
    * A service with manual scaling runs continuously, allowing you to perform
    * complex initialization and rely on the state of its memory over time.
    */
   ManualScaling manualScaling;
   /**
    * Full path to the Version resource in the API. Example:
    * apps/myapp/services/default/versions/v1.@OutputOnly
    */
   core.String name;
-  /** Extra network settings. Only applicable for VM runtimes. */
+  /**
+   * Extra network settings. Only applicable for App Engine flexible environment
+   * versions.
+   */
   Network network;
   /**
    * Files that match this pattern will not be built into this version. Only
    * applicable for Go runtimes.Only returned in GET requests if view=FULL is
    * set.
    */
   core.String nobuildFilesRegex;
   /**
    * Configures readiness health checking for VM instances. Unhealthy instances
    * are not put into the backend traffic rotation.Only returned in GET requests
@@ skipping 305 matching lines @@
     final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
     if (filesCount != null) {
       _json["filesCount"] = filesCount;
     }
     if (sourceUrl != null) {
       _json["sourceUrl"] = sourceUrl;
     }
     return _json;
   }
 }