Api-roll 46: 2017-03-06

generated/googleapis_beta/lib/runtimeconfig/v1beta1.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis_beta.runtimeconfig.v1beta1;
 
 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 50 matching lines @@
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [parent] - The [project
    * ID](https://support.google.com/cloud/answer/6158840?hl=en&ref_topic=6158848)
    * for this request, in the format `projects/[PROJECT_ID]`.
    * Value must have pattern "^projects/[^/]+$".
    *
-   * [requestId] - An optional but recommended unique <code>request_id</code>.
-   * If the server
-   * receives two <code>create()</code> requests  with the same
-   * <code>request_id</code>, then the second request will be ignored and the
+   * [requestId] - An optional but recommended unique `request_id`. If the
+   * server
+   * receives two `create()` requests  with the same
+   * `request_id`, then the second request will be ignored and the
    * first resource created and stored in the backend is returned.
-   * Empty <code>request_id</code> fields are ignored.
+   * Empty `request_id` fields are ignored.
    *
    * It is responsibility of the client to ensure uniqueness of the
-   * <code>request_id</code> strings.
+   * `request_id` strings.
    *
-   * <code>request_id</code> strings are limited to 64 characters.
+   * `request_id` strings are limited to 64 characters.
    *
    * Completes with a [RuntimeConfig].
    *
    * 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<RuntimeConfig> create(RuntimeConfig request, core.String parent, {core.String requestId}) {
@@ skipping 112 matching lines @@
 
   /**
    * Gets the access control policy for a resource.
    * Returns an empty policy if the resource exists and does not have a policy
    * set.
    *
    * Request parameters:
    *
    * [resource] - REQUIRED: The resource for which the policy is being
    * requested.
-   * `resource` is usually specified as a path. For example, a Project
-   * resource is specified as `projects/{project}`.
+   * See the operation documentation for the appropriate value for this field.
    * Value must have pattern "^projects/[^/]+/configs/[^/]+$".
    *
    * Completes with a [Policy].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
@@ skipping 80 matching lines @@
   /**
    * Sets the access control policy on the specified resource. Replaces any
    * existing policy.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [resource] - REQUIRED: The resource for which the policy is being
    * specified.
-   * `resource` is usually specified as a path. For example, a Project
-   * resource is specified as `projects/{project}`.
+   * See the operation documentation for the appropriate value for this field.
    * Value must have pattern "^projects/[^/]+/configs/[^/]+$".
    *
    * Completes with a [Policy].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
@@ skipping 22 matching lines @@
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Policy.fromJson(data));
   }
 
   /**
    * Returns permissions that a caller has on the specified resource.
    * If the resource does not exist, this will return an empty set of
    * permissions, not a NOT_FOUND error.
    *
+   * Note: This operation is designed to be used for building permission-aware
+   * UIs and command-line tools, not for authorization checking. This operation
+   * may "fail open" without warning.
+   *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [resource] - REQUIRED: The resource for which the policy detail is being
    * requested.
-   * `resource` is usually specified as a path. For example, a Project
-   * resource is specified as `projects/{project}`.
+   * See the operation documentation for the appropriate value for this field.
    * Value must have pattern "^projects/[^/]+/configs/[^/]+$".
    *
    * Completes with a [TestIamPermissionsResponse].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
@@ skipping 120 matching lines @@
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
    * Returns permissions that a caller has on the specified resource.
    * If the resource does not exist, this will return an empty set of
    * permissions, not a NOT_FOUND error.
    *
+   * Note: This operation is designed to be used for building permission-aware
+   * UIs and command-line tools, not for authorization checking. This operation
+   * may "fail open" without warning.
+   *
    * Request parameters:
    *
    * [resource] - REQUIRED: The resource for which the policy detail is being
    * requested.
-   * `resource` is usually specified as a path. For example, a Project
-   * resource is specified as `projects/{project}`.
+   * See the operation documentation for the appropriate value for this field.
    * Value must have pattern "^projects/[^/]+/configs/[^/]+/operations/.+$".
    *
    * [permissions] - The set of permissions to check for the `resource`.
    * Permissions with
    * wildcards (such as '*' or 'storage.*') are not allowed. For more
    * information see
    * [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
    *
    * Completes with a [TestIamPermissionsResponse].
    *
@@ skipping 53 matching lines @@
    *
    * Request parameters:
    *
    * [parent] - The path to the RutimeConfig resource that this variable should
    * belong to.
    * The configuration must exist beforehand; the path must by in the format:
    *
    * `projects/[PROJECT_ID]/configs/[CONFIG_NAME]`
    * Value must have pattern "^projects/[^/]+/configs/[^/]+$".
    *
-   * [requestId] - An optional but recommended unique <code>request_id</code>.
-   * If the server
-   * receives two <code>create()</code> requests  with the same
-   * <code>request_id</code>, then the second request will be ignored and the
+   * [requestId] - An optional but recommended unique `request_id`. If the
+   * server
+   * receives two `create()` requests  with the same
+   * `request_id`, then the second request will be ignored and the
    * first resource created and stored in the backend is returned.
-   * Empty <code>request_id</code> fields are ignored.
+   * Empty `request_id` fields are ignored.
    *
    * It is responsibility of the client to ensure uniqueness of the
-   * <code>request_id</code> strings.
+   * `request_id` strings.
    *
-   * <code>request_id</code> strings are limited to 64 characters.
+   * `request_id` strings are limited to 64 characters.
    *
    * Completes with a [Variable].
    *
    * 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<Variable> create(Variable request, core.String parent, {core.String requestId}) {
@@ skipping 118 matching lines @@
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Variable.fromJson(data));
   }
 
   /**
    * Lists variables within given a configuration, matching any provided
    * filters.
-   * This only lists variable names, not the values.
+   * This only lists variable names, not the values, unless `return_values` is
+   * true, in which case only variables that user has IAM permission to
+   * GetVariable
+   * will be returned.
    *
    * Request parameters:
    *
    * [parent] - The path to the RuntimeConfig resource for which you want to
    * list variables.
    * The configuration must exist beforehand; the path must by in the format:
    *
    * `projects/[PROJECT_ID]/configs/[CONFIG_NAME]`
    * Value must have pattern "^projects/[^/]+/configs/[^/]+$".
    *
-   * [pageToken] - Specifies a page token to use. Set `pageToken` to a
-   * `nextPageToken`
-   * returned by a previous list request to get the next page of results.
-   *
    * [pageSize] - Specifies the number of results to return per page. If there
    * are fewer
    * elements than the specified number, returns all elements.
    *
    * [filter] - Filters variables by matching the specified filter. For example:
    *
    * `projects/example-project/config/[CONFIG_NAME]/variables/example-variable`.
    *
+   * [pageToken] - Specifies a page token to use. Set `pageToken` to a
+   * `nextPageToken`
+   * returned by a previous list request to get the next page of results.
+   *
+   * [returnValues] - The flag indicates whether the user wants to return values
+   * of variables.
+   * If true, then only those variables that user has IAM GetVariable permission
+   * will be returned along with their values.
+   *
    * Completes with a [ListVariablesResponse].
    *
    * 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<ListVariablesResponse> list(core.String parent, {core.String pageToken, core.int pageSize, core.String filter}) {
+  async.Future<ListVariablesResponse> list(core.String parent, {core.int pageSize, core.String filter, core.String pageToken, core.bool returnValues}) {
     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 (pageToken != null) {
-      _queryParams["pageToken"] = [pageToken];
-    }
     if (pageSize != null) {
       _queryParams["pageSize"] = ["${pageSize}"];
     }
     if (filter != null) {
       _queryParams["filter"] = [filter];
     }
+    if (pageToken != null) {
+      _queryParams["pageToken"] = [pageToken];
+    }
+    if (returnValues != null) {
+      _queryParams["returnValues"] = ["${returnValues}"];
+    }
 
     _url = 'v1beta1/' + commons.Escaper.ecapeVariableReserved('$parent') + '/variables';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new ListVariablesResponse.fromJson(data));
   }
 
   /**
    * Returns permissions that a caller has on the specified resource.
    * If the resource does not exist, this will return an empty set of
    * permissions, not a NOT_FOUND error.
    *
+   * Note: This operation is designed to be used for building permission-aware
+   * UIs and command-line tools, not for authorization checking. This operation
+   * may "fail open" without warning.
+   *
    * Request parameters:
    *
    * [resource] - REQUIRED: The resource for which the policy detail is being
    * requested.
-   * `resource` is usually specified as a path. For example, a Project
-   * resource is specified as `projects/{project}`.
+   * See the operation documentation for the appropriate value for this field.
    * Value must have pattern "^projects/[^/]+/configs/[^/]+/variables/.+$".
    *
    * [permissions] - The set of permissions to check for the `resource`.
    * Permissions with
    * wildcards (such as '*' or 'storage.*') are not allowed. For more
    * information see
    * [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
    *
    * Completes with a [TestIamPermissionsResponse].
    *
@@ skipping 158 matching lines @@
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [parent] - The path to the configuration that will own the waiter.
    * The configuration must exist beforehand; the path must by in the format:
    *
    * `projects/[PROJECT_ID]/configs/[CONFIG_NAME]`.
    * Value must have pattern "^projects/[^/]+/configs/[^/]+$".
    *
-   * [requestId] - An optional but recommended unique <code>request_id</code>.
-   * If the server
-   * receives two <code>create()</code> requests  with the same
-   * <code>request_id</code>, then the second request will be ignored and the
+   * [requestId] - An optional but recommended unique `request_id`. If the
+   * server
+   * receives two `create()` requests  with the same
+   * `request_id`, then the second request will be ignored and the
    * first resource created and stored in the backend is returned.
-   * Empty <code>request_id</code> fields are ignored.
+   * Empty `request_id` fields are ignored.
    *
    * It is responsibility of the client to ensure uniqueness of the
-   * <code>request_id</code> strings.
+   * `request_id` strings.
    *
-   * <code>request_id</code> strings are limited to 64 characters.
+   * `request_id` strings are limited to 64 characters.
    *
    * 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> create(Waiter request, core.String parent, {core.String requestId}) {
@@ skipping 168 matching lines @@
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new ListWaitersResponse.fromJson(data));
   }
 
   /**
    * Returns permissions that a caller has on the specified resource.
    * If the resource does not exist, this will return an empty set of
    * permissions, not a NOT_FOUND error.
    *
+   * Note: This operation is designed to be used for building permission-aware
+   * UIs and command-line tools, not for authorization checking. This operation
+   * may "fail open" without warning.
+   *
    * Request parameters:
    *
    * [resource] - REQUIRED: The resource for which the policy detail is being
    * requested.
-   * `resource` is usually specified as a path. For example, a Project
-   * resource is specified as `projects/{project}`.
+   * See the operation documentation for the appropriate value for this field.
    * Value must have pattern "^projects/[^/]+/configs/[^/]+/waiters/[^/]+$".
    *
    * [permissions] - The set of permissions to check for the `resource`.
    * Permissions with
    * wildcards (such as '*' or 'storage.*') are not allowed. For more
    * information see
    * [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
    *
    * Completes with a [TestIamPermissionsResponse].
    *
@@ skipping 745 matching lines @@
    * - "VARIABLE_STATE_UNSPECIFIED" : Default variable state.
    * - "UPDATED" : The variable was updated, while `variables().watch` was
    * executing.
    * - "DELETED" : The variable was deleted, while `variables().watch` was
    * executing.
    */
   core.String state;
   /**
    * The string value of the variable. The length of the value must be less
    * than 4096 bytes. Empty values are also accepted. For example,
-   * <code>text: "my text value"</code>.
+   * `text: "my text value"`. The string must be valid UTF-8.
    */
   core.String text;
   /** [Output Only] The time of the last variable update. */
   core.String updateTime;
   /**
    * The binary value of the variable. The length of the value must be less
    * than 4096 bytes. Empty values are also accepted. The value must be
    * base64 encoded. Only one of `value` or `text` can be set.
    */
   core.String value;
@@ skipping 196 matching lines @@
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (newerThan != null) {
       _json["newerThan"] = newerThan;
     }
     return _json;
   }
 }