Api-roll 42: 2016-11-08

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 48 matching lines @@
    * Creates a new RuntimeConfig resource. The configuration name must be
    * unique within project.
    *
    * [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/[^/]*$".
+   * Value must have pattern "^projects/[^/]+$".
+   *
+   * [requestId] - An optional unique request_id. If server receives two Create
+   * requests with
+   * the same request_id then second request will be ignored and the resource
+   * stored in the backend will be returned. Empty request_id fields are
+   * ignored.
+   * It is responsibility of the client to ensure uniqueness of the request_id
+   * strings.
+   * The 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) {
+  async.Future<RuntimeConfig> create(RuntimeConfig request, core.String parent, {core.String requestId}) {
     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 (parent == null) {
       throw new core.ArgumentError("Parameter parent is required.");
     }
+    if (requestId != null) {
+      _queryParams["requestId"] = [requestId];
+    }
 
     _url = 'v1beta1/' + commons.Escaper.ecapeVariableReserved('$parent') + '/configs';
 
     var _response = _requester.request(_url,
                                        "POST",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new RuntimeConfig.fromJson(data));
   }
 
   /**
    * Deletes a RuntimeConfig resource.
    *
    * Request parameters:
    *
    * [name] - The RuntimeConfig resource to delete, in the format:
    *
    * `projects/[PROJECT_ID]/configs/[CONFIG_NAME]`
-   * Value must have pattern "^projects/[^/] * / configs/[^/]*$".
+   * Value must have pattern "^projects/[^/]+/configs/[^/]+$".
    *
    * Completes with a [Empty].
    *
    * 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<Empty> delete(core.String name) {
@@ skipping 21 matching lines @@
   }
 
   /**
    * Gets information about a RuntimeConfig resource.
    *
    * Request parameters:
    *
    * [name] - The name of the RuntimeConfig resource to retrieve, in the format:
    *
    * `projects/[PROJECT_ID]/configs/[CONFIG_NAME]`
-   * Value must have pattern "^projects/[^/] * / configs/[^/]*$".
+   * Value must have pattern "^projects/[^/]+/configs/[^/]+$".
    *
    * 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> get(core.String name) {
@@ skipping 21 matching lines @@
   }
 
   /**
    * Lists all the RuntimeConfig resources within project.
    *
    * 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/[^/]*$".
+   * Value must have pattern "^projects/[^/]+$".
    *
    * [pageSize] - Specifies the number of results to return per page. If there
    * are fewer
    * elements than the specified number, returns all elements.
    *
    * [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.
    *
    * Completes with a [ListConfigsResponse].
@@ skipping 37 matching lines @@
   /**
    * Updates a RuntimeConfig resource. The configuration must exist beforehand.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [name] - The name of the RuntimeConfig resource to update, in the format:
    *
    * `projects/[PROJECT_ID]/configs/[CONFIG_NAME]`
-   * Value must have pattern "^projects/[^/] * / configs/[^/]*$".
+   * Value must have pattern "^projects/[^/]+/configs/[^/]+$".
    *
    * 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> update(RuntimeConfig request, core.String name) {
@@ skipping 33 matching lines @@
       _requester = client;
 
   /**
    * Gets the latest state of a long-running operation.  Clients can use this
    * method to poll the operation result at intervals as recommended by the API
    * service.
    *
    * Request parameters:
    *
    * [name] - The name of the operation resource.
-   * Value must have pattern "^projects/[^/] * / configs/[^/] * /
-   * operations/.*$".
+   * Value must have pattern "^projects/[^/]+/configs/[^/]+/operations/.+$".
    *
    * 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> get(core.String name) {
@@ skipping 41 matching lines @@
    *
    * [request] - The metadata request object.
    *
    * 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/[^/]*$".
+   * Value must have pattern "^projects/[^/]+/configs/[^/]+$".
+   *
+   * [requestId] - An optional unique request_id. If server receives two Create
+   * requests with
+   * the same request_id then second request will be ignored and the resource
+   * stored in the backend will be returned. Empty request_id fields are
+   * ignored.
+   * It is responsibility of the client to ensure uniqueness of the request_id
+   * strings.
+   * The 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) {
+  async.Future<Variable> create(Variable request, core.String parent, {core.String requestId}) {
     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 (parent == null) {
       throw new core.ArgumentError("Parameter parent is required.");
     }
+    if (requestId != null) {
+      _queryParams["requestId"] = [requestId];
+    }
 
     _url = 'v1beta1/' + commons.Escaper.ecapeVariableReserved('$parent') + '/variables';
 
     var _response = _requester.request(_url,
                                        "POST",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Variable.fromJson(data));
   }
 
   /**
    * Deletes a variable or multiple variables.
    *
    * If you specify a variable name, then that variable is deleted. If you
    * specify a prefix and `recursive` is true, then all variables with that
    * prefix are deleted. You must set a `recursive` to true if you delete
    * variables by prefix.
    *
    * Request parameters:
    *
    * [name] - The name of the variable to delete, in the format:
    *
    * `projects/[PROJECT_ID]/configs/[CONFIG_NAME]/variables/[VARIABLE_NAME]`
-   * Value must have pattern "^projects/[^/] * / configs/[^/] * /
-   * variables/.*$".
+   * Value must have pattern "^projects/[^/]+/configs/[^/]+/variables/.+$".
    *
    * [recursive] - Set to `true` to recursively delete multiple variables with
    * the same
    * prefix.
    *
    * Completes with a [Empty].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
@@ skipping 28 matching lines @@
   }
 
   /**
    * Gets information about a single variable.
    *
    * Request parameters:
    *
    * [name] - The name of the variable to return, in the format:
    *
    * `projects/[PROJECT_ID]/configs/[CONFIG_NAME]/variables/[VARIBLE_NAME]`
-   * Value must have pattern "^projects/[^/] * / configs/[^/] * /
-   * variables/.*$".
+   * Value must have pattern "^projects/[^/]+/configs/[^/]+/variables/.+$".
    *
    * 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> get(core.String name) {
@@ skipping 25 matching lines @@
    * filters.
    * This only lists variable names, not the values.
    *
    * 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/[^/]*$".
+   * Value must have pattern "^projects/[^/]+/configs/[^/]+$".
    *
    * [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
@@ skipping 44 matching lines @@
   /**
    * Updates an existing variable with a new value.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [name] - The name of the variable to update, in the format:
    *
    * `projects/[PROJECT_ID]/configs/[CONFIG_NAME]/variables/[VARIABLE_NAME]`
-   * Value must have pattern "^projects/[^/] * / configs/[^/] * /
-   * variables/.*$".
+   * Value must have pattern "^projects/[^/]+/configs/[^/]+/variables/.+$".
    *
    * 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> update(Variable request, core.String name) {
@@ skipping 41 matching lines @@
    * Changes](/deployment-manager/runtime-configurator/watching-a-variable)
    * documentation.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [name] - The name of the variable to watch, in the format:
    *
    * `projects/[PROJECT_ID]/configs/[CONFIG_NAME]`
-   * Value must have pattern "^projects/[^/] * / configs/[^/] * /
-   * variables/.*$".
+   * Value must have pattern "^projects/[^/]+/configs/[^/]+/variables/.+$".
    *
    * 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> watch(WatchVariableRequest request, core.String name) {
@@ skipping 40 matching lines @@
    * still exist and must be deleted prior to subsequent creation attempts.
    *
    * [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/[^/]*$".
+   * Value must have pattern "^projects/[^/]+/configs/[^/]+$".
+   *
+   * [requestId] - An optional unique request_id. If server receives two Create
+   * requests with
+   * the same request_id then second request will be ignored and information
+   * stored in the backend will be returned. Empty request_id fields are
+   * ignored.
+   * It is responsibility of the client to ensure uniqueness of the request_id
+   * strings.
+   * The 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) {
+  async.Future<Operation> create(Waiter request, core.String parent, {core.String requestId}) {
     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 (parent == null) {
       throw new core.ArgumentError("Parameter parent is required.");
     }
+    if (requestId != null) {
+      _queryParams["requestId"] = [requestId];
+    }
 
     _url = 'v1beta1/' + commons.Escaper.ecapeVariableReserved('$parent') + '/waiters';
 
     var _response = _requester.request(_url,
                                        "POST",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Operation.fromJson(data));
   }
 
   /**
    * Deletes the waiter with the specified name.
    *
    * Request parameters:
    *
    * [name] - The Waiter resource to delete, in the format:
    *
    *  `projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]`
-   * Value must have pattern "^projects/[^/] * / configs/[^/] * /
-   * waiters/[^/]*$".
+   * Value must have pattern "^projects/[^/]+/configs/[^/]+/waiters/[^/]+$".
    *
    * Completes with a [Empty].
    *
    * 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<Empty> delete(core.String name) {
@@ skipping 23 matching lines @@
   /**
    * Gets information about a single waiter.
    *
    * Request parameters:
    *
    * [name] - The fully-qualified name of the Waiter resource object to
    * retrieve, in the
    * format:
    *
    * `projects/[PROJECT_ID]/configs/[CONFIG_NAME]/waiters/[WAITER_NAME]`
-   * Value must have pattern "^projects/[^/] * / configs/[^/] * /
-   * waiters/[^/]*$".
+   * Value must have pattern "^projects/[^/]+/configs/[^/]+/waiters/[^/]+$".
    *
    * Completes with a [Waiter].
    *
    * 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<Waiter> get(core.String name) {
@@ skipping 23 matching lines @@
   /**
    * List waiters within the given configuration.
    *
    * Request parameters:
    *
    * [parent] - The path to the configuration for which you want to get a list
    * of waiters.
    * The configuration must exist beforehand; the path must by in the format:
    *
    * `projects/[PROJECT_ID]/configs/[CONFIG_NAME]`
-   * Value must have pattern "^projects/[^/] * / configs/[^/]*$".
+   * Value must have pattern "^projects/[^/]+/configs/[^/]+$".
    *
    * [pageSize] - Specifies the number of results to return per page. If there
    * are fewer
    * elements than the specified number, returns all elements.
    *
    * [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.
    *
    * Completes with a [ListWaitersResponse].
@@ skipping 256 matching lines @@
  * This resource represents a long-running operation that is the result of a
  * network API call.
  */
 class Operation {
   /**
    * If the value is `false`, it means the operation is still in progress.
    * If true, the operation is completed, and either `error` or `response` is
    * available.
    */
   core.bool done;
-  /** The error result of the operation in case of failure. */
+  /** The error result of the operation in case of failure or cancellation. */
   Status error;
   /**
    * Service-specific metadata associated with the operation.  It typically
    * contains progress information and common metadata such as create time.
    * Some services might not provide such metadata.  Any method that returns a
    * long-running operation should document the metadata type, if any.
    *
    * 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 466 matching lines @@
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (newerThan != null) {
       _json["newerThan"] = newerThan;
     }
     return _json;
   }
 }