Api-roll 43: 2016-12-13

generated/googleapis/lib/cloudbuild/v1.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis.cloudbuild.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 19 matching lines @@
 }
 
 
 class OperationsResourceApi {
   final commons.ApiRequester _requester;
 
   OperationsResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
+   * Starts asynchronous cancellation on a long-running operation.  The server
+   * makes a best effort to cancel the operation, but success is not
+   * guaranteed.  If the server doesn't support this method, it returns
+   * `google.rpc.Code.UNIMPLEMENTED`.  Clients can use
+   * Operations.GetOperation or
+   * other methods to check whether the cancellation succeeded or whether the
+   * operation completed despite cancellation. On successful cancellation,
+   * the operation is not deleted; instead, it becomes an operation with
+   * an Operation.error value with a google.rpc.Status.code of 1,
+   * corresponding to `Code.CANCELLED`.
+   *
+   * [request] - The metadata request object.
+   *
+   * Request parameters:
+   *
+   * [name] - The name of the operation resource to be cancelled.
+   * Value must have pattern "^operations/.+$".
+   *
+   * 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> cancel(CancelOperationRequest request, core.String name) {
+    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 (name == null) {
+      throw new core.ArgumentError("Parameter name is required.");
+    }
+
+    _url = 'v1/' + commons.Escaper.ecapeVariableReserved('$name') + ':cancel';
+
+    var _response = _requester.request(_url,
+                                       "POST",
+                                       body: _body,
+                                       queryParams: _queryParams,
+                                       uploadOptions: _uploadOptions,
+                                       uploadMedia: _uploadMedia,
+                                       downloadOptions: _downloadOptions);
+    return _response.then((data) => new Empty.fromJson(data));
+  }
+
+  /**
    * 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 "^operations/.+$".
    *
    * Completes with a [Operation].
@@ skipping 570 matching lines @@
  *   resolved from the specified branch or tag.
  */
 class Build {
   /**
    * The ID of the BuildTrigger that triggered this build, if it was
    * triggered automatically.
    * @OutputOnly
    */
   core.String buildTriggerId;
   /**
-   * Time at which the build was created.
+   * Time at which the request to create the build was received.
    * @OutputOnly
    */
   core.String createTime;
   /**
    * Time at which execution of the build was finished.
+   *
+   * The difference between finish_time and start_time is the duration of the
+   * build's execution.
    * @OutputOnly
    */
   core.String finishTime;
   /**
    * Unique identifier of the build.
    * @OutputOnly
    */
   core.String id;
   /**
    * A list of images to be pushed upon the successful completion of all build
    * steps.
    *
-   * The images will be pushed using the builder
-   * service account's credentials.
+   * The images will be pushed using the builder service account's credentials.
    *
    * The digests of the pushed images will be stored in the Build resource's
    * results field.
    *
    * If any of the images fail to be pushed, the build is marked FAILURE.
    */
   core.List<core.String> images;
   /**
    * URL to logs for this build in Google Cloud Logging.
    * @OutputOnly
@@ skipping 28 matching lines @@
   /**
    * Time at which execution of the build was started.
    * @OutputOnly
    */
   core.String startTime;
   /**
    * Status of the build.
    * @OutputOnly
    * Possible string values are:
    * - "STATUS_UNKNOWN" : Status of the build is unknown.
-   * - "QUEUING" : Build has been received and is being queued.
    * - "QUEUED" : Build is queued; work has not yet begun.
    * - "WORKING" : Build is being executed.
    * - "SUCCESS" : Build finished successfully.
    * - "FAILURE" : Build failed to complete successfully.
    * - "INTERNAL_ERROR" : Build failed due to an internal cause.
    * - "TIMEOUT" : Build took longer than was allowed.
    * - "CANCELLED" : Build was canceled by a user.
    */
   core.String status;
   /**
@@ skipping 206 matching lines @@
    */
   core.List<core.String> env;
   /**
    * Optional unique identifier for this build step, used in wait_for to
    * reference this build step as a dependency.
    */
   core.String id;
   /**
    * The name of the container image that will run this particular build step.
    *
-   * If the image is already available in the host's
-   * Docker daemon's cache, it will be run directly. If not, the host will
-   * attempt to pull the image first, using the builder service account's
-   * credentials if necessary.
+   * If the image is already available in the host's Docker daemon's cache, it
+   * will be run directly. If not, the host will attempt to pull the image
+   * first, using the builder service account's credentials if necessary.
    *
    * The Docker daemon's cache will already have the latest versions of all of
    * the officially supported build steps
    * (https://github.com/GoogleCloudPlatform/cloud-builders). The Docker daemon
    * will also have cached many of the layers for some popular images, like
    * "ubuntu", "debian", but they will be refreshed at the time you attempt to
    * use them.
    *
    * If you built an image in a previous build step, it will be stored in the
    * host's Docker daemon's cache and is available to use as the name for a
@@ skipping 186 matching lines @@
 
   CancelBuildRequest.fromJson(core.Map _json) {
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     return _json;
   }
 }
 
+/** The request message for Operations.CancelOperation. */
+class CancelOperationRequest {
+
+  CancelOperationRequest();
+
+  CancelOperationRequest.fromJson(core.Map _json) {
+  }
+
+  core.Map toJson() {
+    var _json = new core.Map();
+    return _json;
+  }
+}
+
 /**
  * A generic empty message that you can re-use to avoid defining duplicated
  * empty messages in your APIs. A typical example is to use it as the request
  * or the response type of an API method. For instance:
  *
  *     service Foo {
  *       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
  *     }
  *
  * The JSON representation for `Empty` is empty JSON object `{}`.
@@ skipping 579 matching lines @@
     }
     if (generation != null) {
       _json["generation"] = generation;
     }
     if (object != null) {
       _json["object"] = object;
     }
     return _json;
   }
 }