Api-roll 47: 2017-03-27

generated/googleapis/lib/spanner/v1.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis.spanner.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 84 matching lines @@
    * Lists the supported instance configurations for a given project.
    *
    * Request parameters:
    *
    * [parent] - Required. The name of the project for which a list of supported
    * instance
    * configurations is requested. Values are of the form
    * `projects/<project>`.
    * Value must have pattern "^projects/[^/]+$".
    *
+   * [pageSize] - Number of instance configurations to be returned in the
+   * response. If 0 or
+   * less, defaults to the server's maximum allowed page size.
+   *
    * [pageToken] - If non-empty, `page_token` should contain a
    * next_page_token
    * from a previous ListInstanceConfigsResponse.
    *
-   * [pageSize] - Number of instance configurations to be returned in the
-   * response. If 0 or
-   * less, defaults to the server's maximum allowed page size.
-   *
    * Completes with a [ListInstanceConfigsResponse].
    *
    * 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<ListInstanceConfigsResponse> list(core.String parent, {core.String pageToken, core.int pageSize}) {
+  async.Future<ListInstanceConfigsResponse> list(core.String parent, {core.int pageSize, 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 (parent == null) {
       throw new core.ArgumentError("Parameter parent is required.");
     }
+    if (pageSize != null) {
+      _queryParams["pageSize"] = ["${pageSize}"];
+    }
     if (pageToken != null) {
       _queryParams["pageToken"] = [pageToken];
     }
-    if (pageSize != null) {
-      _queryParams["pageSize"] = ["${pageSize}"];
-    }
 
     _url = 'v1/' + commons.Escaper.ecapeVariableReserved('$parent') + '/instanceConfigs';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 241 matching lines @@
   /**
    * Lists all instances in the given project.
    *
    * Request parameters:
    *
    * [parent] - Required. The name of the project for which a list of instances
    * is
    * requested. Values are of the form `projects/<project>`.
    * Value must have pattern "^projects/[^/]+$".
    *
-   * [pageToken] - If non-empty, `page_token` should contain a
-   * next_page_token from a
-   * previous ListInstancesResponse.
-   *
-   * [pageSize] - Number of instances to be returned in the response. If 0 or
-   * less, defaults
-   * to the server's maximum allowed page size.
-   *
    * [filter] - An expression for filtering the results of the request. Filter
    * rules are
    * case insensitive. The fields eligible for filtering are:
    *
    *   * name
    *   * display_name
    *   * labels.key where key is the name of a label
    *
    * Some examples of using filters are:
    *
    *   * name:* --> The instance has a name.
    *   * name:Howl --> The instance's name contains the string "howl".
    *   * name:HOWL --> Equivalent to above.
    *   * NAME:howl --> Equivalent to above.
    *   * labels.env:* --> The instance has the label "env".
    *   * labels.env:dev --> The instance has the label "env" and the value of
    *                        the label contains the string "dev".
    *   * name:howl labels.env:dev --> The instance's name contains "howl" and
    *                                  it has the label "env" with its value
    *                                  containing "dev".
    *
+   * [pageToken] - If non-empty, `page_token` should contain a
+   * next_page_token from a
+   * previous ListInstancesResponse.
+   *
+   * [pageSize] - Number of instances to be returned in the response. If 0 or
+   * less, defaults
+   * to the server's maximum allowed page size.
+   *
    * 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 parent, {core.String pageToken, core.int pageSize, core.String filter}) {
+  async.Future<ListInstancesResponse> list(core.String parent, {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 (parent == null) {
       throw new core.ArgumentError("Parameter parent 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/' + commons.Escaper.ecapeVariableReserved('$parent') + '/instances';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 437 matching lines @@
 
   /**
    * Lists Cloud Spanner databases.
    *
    * Request parameters:
    *
    * [parent] - Required. The instance whose databases should be listed.
    * Values are of the form `projects/<project>/instances/<instance>`.
    * Value must have pattern "^projects/[^/]+/instances/[^/]+$".
    *
+   * [pageSize] - Number of databases to be returned in the response. If 0 or
+   * less,
+   * defaults to the server's maximum allowed page size.
+   *
    * [pageToken] - If non-empty, `page_token` should contain a
    * next_page_token from a
    * previous ListDatabasesResponse.
    *
-   * [pageSize] - Number of databases to be returned in the response. If 0 or
-   * less,
-   * defaults to the server's maximum allowed page size.
-   *
    * Completes with a [ListDatabasesResponse].
    *
    * 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<ListDatabasesResponse> list(core.String parent, {core.String pageToken, core.int pageSize}) {
+  async.Future<ListDatabasesResponse> list(core.String parent, {core.int pageSize, 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 (parent == null) {
       throw new core.ArgumentError("Parameter parent is required.");
     }
+    if (pageSize != null) {
+      _queryParams["pageSize"] = ["${pageSize}"];
+    }
     if (pageToken != null) {
       _queryParams["pageToken"] = [pageToken];
     }
-    if (pageSize != null) {
-      _queryParams["pageSize"] = ["${pageSize}"];
-    }
 
     _url = 'v1/' + commons.Escaper.ecapeVariableReserved('$parent') + '/databases';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 481 matching lines @@
    * transactions.
    *
    * Sessions can only execute one transaction at a time. To execute
    * multiple concurrent read-write/write-only transactions, create
    * multiple sessions. Note that standalone reads and queries use a
    * transaction internally, and count toward the one transaction
    * limit.
    *
    * Cloud Spanner limits the number of sessions that can exist at any given
    * time; thus, it is a good idea to delete idle and/or unneeded sessions.
-   * Aside from explicit deletes, Cloud Spanner can delete sessions for
-   * which no operations are sent for more than an hour, or due to
-   * internal errors. If a session is deleted, requests to it
-   * return `NOT_FOUND`.
+   * Aside from explicit deletes, Cloud Spanner can delete sessions for which no
+   * operations are sent for more than an hour. If a session is deleted,
+   * requests to it return `NOT_FOUND`.
    *
    * Idle sessions can be kept alive by sending a trivial SQL query
    * periodically, e.g., `"SELECT 1"`.
    *
    * Request parameters:
    *
    * [database] - Required. The database in which the new session is created.
    * Value must have pattern "^projects/[^/]+/instances/[^/]+/databases/[^/]+$".
    *
    * Completes with a [Session].
@@ skipping 533 matching lines @@
    * 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:
    *
    * [name] - The name of the operation collection.
    * Value must have pattern "^projects/[^/]+/instances/[^/]+/operations$".
    *
+   * [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 name, {core.String pageToken, core.int pageSize, core.String filter}) {
+  async.Future<ListOperationsResponse> list(core.String name, {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 (name == null) {
       throw new core.ArgumentError("Parameter name 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/' + commons.Escaper.ecapeVariableReserved('$name');
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 358 matching lines @@
    * - "ATTRIBUTION" : The principal (even if an authority selector is present),
    * which
    * must only be used for attribution, not authorization.
    * - "SECURITY_REALM" : Any of the security realms in the IAMContext
    * (go/security-realms).
    * When used with IN, the condition indicates "any of the request's realms
    * match one of the given values; with NOT_IN, "none of the realms match
    * any of the given values". It is not permitted to grant access based on
    * the *absence* of a realm, so realm conditions can only be used in
    * a "positive" context (e.g., ALLOW/IN or DENY/NOT_IN).
+   * - "APPROVER" : An approver (distinct from the requester) that has
+   * authorized this
+   * request.
+   * When used with IN, the condition indicates that one of the approvers
+   * associated with the request matches the specified principal, or is a
+   * member of the specified group. Approvers can only grant additional
+   * access, and are thus only used in a strictly positive context
+   * (e.g. ALLOW/IN or DENY/NOT_IN).
+   * See: go/rpc-security-policy-dynamicauth.
    */
   core.String iam;
   /**
    * An operator to apply the subject with.
    * Possible string values are:
    * - "NO_OP" : Default no-op.
    * - "EQUALS" : DEPRECATED. Use IN instead.
    * - "NOT_EQUALS" : DEPRECATED. Use NOT_IN instead.
    * - "IN" : Set-inclusion check.
    * - "NOT_IN" : Set-exclusion check.
@@ skipping 3194 matching lines @@
     }
     if (table != null) {
       _json["table"] = table;
     }
     if (values != null) {
       _json["values"] = values;
     }
     return _json;
   }
 }