Api-roll 42: 2016-11-08

generated/googleapis/lib/cloudbuild/v1.dart

Index: generated/googleapis/lib/cloudbuild/v1.dart
diff --git a/generated/googleapis/lib/cloudbuild/v1.dart b/generated/googleapis/lib/cloudbuild/v1.dart
index 99dca8656fa53157e2439cbbd2ba38965228a7fa..75b527f2130440c8ccc2414ae02ba6db289a2a3c 100644
--- a/generated/googleapis/lib/cloudbuild/v1.dart
+++ b/generated/googleapis/lib/cloudbuild/v1.dart
@@ -44,7 +44,7 @@ class OperationsResourceApi {
    * Request parameters:
    *
    * [name] - The name of the operation resource.
-   * Value must have pattern "^operations/.*$".
+   * Value must have pattern "^operations/.+$".
    *
    * Completes with a [Operation].
    *
@@ -313,6 +313,8 @@ class ProjectsBuildsResourceApi {
    *
    * [pageSize] - Number of results to return in the list.
    *
+   * [filter] - The raw filter text to constrain the results.
+   *
    * [pageToken] - Token to provide to skip to a particular spot in the list.
    *
    * Completes with a [ListBuildsResponse].
@@ -323,7 +325,7 @@ class ProjectsBuildsResourceApi {
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
-  async.Future<ListBuildsResponse> list(core.String projectId, {core.int pageSize, core.String pageToken}) {
+  async.Future<ListBuildsResponse> list(core.String projectId, {core.int pageSize, core.String filter, core.String pageToken}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
@@ -337,6 +339,9 @@ class ProjectsBuildsResourceApi {
     if (pageSize != null) {
       _queryParams["pageSize"] = ["${pageSize}"];
     }
+    if (filter != null) {
+      _queryParams["filter"] = [filter];
+    }
     if (pageToken != null) {
       _queryParams["pageToken"] = [pageToken];
     }
@@ -602,9 +607,26 @@ class ProjectsTriggersResourceApi {
  * At a high level, a Build describes where to find source code, how to build
  * it (for example, the builder image to run on the source), and what tag to
  * apply to the built image when it is pushed to Google Container Registry.
+ *
+ * Fields can include the following variables which will be expanded when the
+ * build is created:
+ *
+ * - $PROJECT_ID: the project ID of the build.
+ * - $BUILD_ID: the autogenerated ID of the build.
+ * - $REPO_NAME: the source repository name specified by RepoSource.
+ * - $BRANCH_NAME: the branch name specified by RepoSource.
+ * - $TAG_NAME: the tag name specified by RepoSource.
+ * - $REVISION_ID or $COMMIT_SHA: the commit SHA specified by RepoSource or
+ *   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.
    * @OutputOnly
    */
@@ -620,10 +642,16 @@ class Build {
    */
   core.String id;
   /**
-   * List of images expected to be built and pushed to Google Container
-   * Registry. If an image is listed here and the image is not produced by
-   * one of the build steps, the build will fail. Any images present when
-   * the build steps are complete will be pushed to Container Registry.
+   * 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 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;
   /**
@@ -696,6 +724,9 @@ class Build {
   Build();
 
   Build.fromJson(core.Map _json) {
+    if (_json.containsKey("buildTriggerId")) {
+      buildTriggerId = _json["buildTriggerId"];
+    }
     if (_json.containsKey("createTime")) {
       createTime = _json["createTime"];
     }
@@ -748,6 +779,9 @@ class Build {
 
   core.Map toJson() {
     var _json = new core.Map();
+    if (buildTriggerId != null) {
+      _json["buildTriggerId"] = buildTriggerId;
+    }
     if (createTime != null) {
       _json["createTime"] = createTime;
     }
@@ -825,7 +859,7 @@ class BuildOperationMetadata {
 /** Optional arguments to enable specific features of builds. */
 class BuildOptions {
   /**
-   * Options for a verifiable build with details uploaded to the Analysis API.
+   * Requested verifiability options.
    * Possible string values are:
    * - "NOT_VERIFIED" : Not a verifiable build. (default)
    * - "VERIFIED" : Verified build.
@@ -859,14 +893,26 @@ class BuildOptions {
 
 /** BuildStep describes a step to perform in the build pipeline. */
 class BuildStep {
-  /** Command-line arguments to use when running this step's container. */
+  /**
+   * A list of arguments that will be presented to the step when it is started.
+   *
+   * If the image used to run the step's container has an entrypoint, these args
+   * will be used as arguments to that entrypoint. If the image does not define
+   * an entrypoint, the first element in args will be used as the entrypoint,
+   * and the remainder will be used as arguments.
+   */
   core.List<core.String> args;
   /**
    * Working directory (relative to project source root) to use when running
    * this operation's container.
    */
   core.String dir;
-  /** Additional environment variables to set for this step's container. */
+  /**
+   * A list of environment variable definitions to be used when running a step.
+   *
+   * The elements are of the form "KEY=VALUE" for the environment variable "KEY"
+   * being given the value "VALUE".
+   */
   core.List<core.String> env;
   /**
    * Optional unique identifier for this build step, used in wait_for to
@@ -874,8 +920,23 @@ class BuildStep {
    */
   core.String id;
   /**
-   * Name of the container image to use for creating this stage in the
-   * pipeline, as presented to `docker pull`.
+   * 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.
+   *
+   * 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
+   * later build step.
    */
   core.String name;
   /**
@@ -947,6 +1008,10 @@ class BuildTrigger {
    * @OutputOnly
    */
   core.String createTime;
+  /** Human-readable description of this trigger. */
+  core.String description;
+  /** If true, the trigger will never result in a build. */
+  core.bool disabled;
   /**
    * Path, from the source root, to a file whose contents is used for the
    * template.
@@ -976,6 +1041,12 @@ class BuildTrigger {
     if (_json.containsKey("createTime")) {
       createTime = _json["createTime"];
     }
+    if (_json.containsKey("description")) {
+      description = _json["description"];
+    }
+    if (_json.containsKey("disabled")) {
+      disabled = _json["disabled"];
+    }
     if (_json.containsKey("filename")) {
       filename = _json["filename"];
     }
@@ -995,6 +1066,12 @@ class BuildTrigger {
     if (createTime != null) {
       _json["createTime"] = createTime;
     }
+    if (description != null) {
+      _json["description"] = description;
+    }
+    if (disabled != null) {
+      _json["disabled"] = disabled;
+    }
     if (filename != null) {
       _json["filename"] = filename;
     }
@@ -1239,7 +1316,7 @@ class Operation {
    * 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