blob: 66f571abb95d780d6ebf6cd8707c5a6d3ddfa487 [file] [log] [blame]
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -07001<html><body>
2<style>
3
4body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13}
14
15body {
16 font-size: 13px;
17 padding: 1em;
18}
19
20h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23}
24
25h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28}
29
30h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34}
35
36pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42 margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46 font-family: Arial, sans serif;
47}
48
49h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51}
52
53.toc_element {
54 margin-top: 0.5em;
55}
56
57.firstline {
58 margin-left: 2 em;
59}
60
61.method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66}
67
68.details {
69 font-weight: bold;
70 font-size: 14px;
71}
72
73</style>
74
75<h1><a href="cloudbuild_v1.html">Google Cloud Container Builder API</a> . <a href="cloudbuild_v1.projects.html">projects</a> . <a href="cloudbuild_v1.projects.triggers.html">triggers</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78 <code><a href="#create">create(projectId, body, x__xgafv=None)</a></code></p>
79<p class="firstline">Creates a new BuildTrigger.</p>
80<p class="toc_element">
81 <code><a href="#delete">delete(projectId, triggerId, x__xgafv=None)</a></code></p>
82<p class="firstline">Deletes an BuildTrigger by its project ID and trigger ID.</p>
83<p class="toc_element">
84 <code><a href="#get">get(projectId, triggerId, x__xgafv=None)</a></code></p>
85<p class="firstline">Gets information about a BuildTrigger.</p>
86<p class="toc_element">
87 <code><a href="#list">list(projectId, x__xgafv=None)</a></code></p>
88<p class="firstline">Lists existing BuildTrigger.</p>
89<p class="toc_element">
90 <code><a href="#patch">patch(projectId, triggerId, body, x__xgafv=None)</a></code></p>
91<p class="firstline">Updates an BuildTrigger by its project ID and trigger ID.</p>
92<h3>Method Details</h3>
93<div class="method">
94 <code class="details" id="create">create(projectId, body, x__xgafv=None)</code>
95 <pre>Creates a new BuildTrigger.
96
97This API is experimental.
98
99Args:
100 projectId: string, ID of the project for which to configure automatic builds. (required)
101 body: object, The request body. (required)
102 The object takes the form of:
103
104{ # Configuration for an automated build in response to source repository
105 # changes.
106 "id": "A String", # Unique identifier of the trigger.
107 #
108 # @OutputOnly
109 "triggerTemplate": { # RepoSource describes the location of the source in a Google Cloud Source # Template describing the types of source changes to trigger a build.
110 #
111 # Branch and tag names in trigger templates are interpreted as regular
112 # expressions. Any branch or tag change that matches that regular expression
113 # will trigger a build.
114 # Repository.
115 "projectId": "A String", # ID of the project that owns the repo. If omitted, the project ID requesting
116 # the build is assumed.
117 "branchName": "A String", # Name of the branch to build.
118 "repoName": "A String", # Name of the repo. If omitted, the name "default" is assumed.
119 "tagName": "A String", # Name of the tag to build.
120 "commitSha": "A String", # Explicit commit SHA to build.
121 },
122 "createTime": "A String", # Time when the trigger was created.
123 #
124 # @OutputOnly
125 "build": { # A build resource in the Container Builder API. # Contents of the build template.
126 #
127 # At a high level, a Build describes where to find source code, how to build
128 # it (for example, the builder image to run on the source), and what tag to
129 # apply to the built image when it is pushed to Google Container Registry.
130 "status": "A String", # Status of the build.
131 # @OutputOnly
132 "finishTime": "A String", # Time at which execution of the build was finished.
133 # @OutputOnly
134 "timeout": "A String", # Amount of time that this build should be allowed to run, to second
135 # granularity. If this amount of time elapses, work on the build will cease
136 # and the build status will be TIMEOUT.
137 #
138 # Default time is ten minutes.
139 "statusDetail": "A String", # Customer-readable message about the current status.
140 # @OutputOnly
141 "startTime": "A String", # Time at which execution of the build was started.
142 # @OutputOnly
143 "logsBucket": "A String", # Google Cloud Storage bucket where logs should be written (see
144 # [Bucket Name
145 # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
146 # Logs file names will be of the format `${logs_bucket}/log-${build_id}.txt`.
147 "results": { # Results describes the artifacts created by the build pipeline. # Results of the build.
148 # @OutputOnly
149 "images": [ # Images that were built as a part of the build.
150 { # BuiltImage describes an image built by the pipeline.
151 "name": "A String", # Name used to push the container image to Google Container Registry, as
152 # presented to `docker push`.
153 "digest": "A String", # Docker Registry 2.0 digest.
154 },
155 ],
156 "buildStepImages": [ # List of build step digests, in order corresponding to build step indices.
157 "A String",
158 ],
159 },
160 "createTime": "A String", # Time at which the build was created.
161 # @OutputOnly
162 "id": "A String", # Unique identifier of the build.
163 # @OutputOnly
164 "source": { # Source describes the location of the source in a supported storage # Describes where to find the source files to build.
165 # service.
166 "storageSource": { # StorageSource describes the location of the source in an archive file in # If provided, get the source from this location in in Google Cloud
167 # Storage.
168 # Google Cloud Storage.
169 "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
170 # omitted, the latest generation will be used.
171 "object": "A String", # Google Cloud Storage object containing source.
172 #
173 # This object must be a gzipped archive file (.tar.gz) containing source to
174 # build.
175 "bucket": "A String", # Google Cloud Storage bucket containing source (see
176 # [Bucket Name
177 # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
178 },
179 "repoSource": { # RepoSource describes the location of the source in a Google Cloud Source # If provided, get source from this location in a Cloud Repo.
180 # Repository.
181 "projectId": "A String", # ID of the project that owns the repo. If omitted, the project ID requesting
182 # the build is assumed.
183 "branchName": "A String", # Name of the branch to build.
184 "repoName": "A String", # Name of the repo. If omitted, the name "default" is assumed.
185 "tagName": "A String", # Name of the tag to build.
186 "commitSha": "A String", # Explicit commit SHA to build.
187 },
188 },
189 "steps": [ # Describes the operations to be performed on the workspace.
190 { # BuildStep describes a step to perform in the build pipeline.
191 "waitFor": [ # The ID(s) of the step(s) that this build step depends on.
192 # This build step will not start until all the build steps in wait_for
193 # have completed successfully. If wait_for is empty, this build step will
194 # start when all previous build steps in the Build.Steps list have completed
195 # successfully.
196 "A String",
197 ],
198 "name": "A String", # Name of the container image to use for creating this stage in the
199 # pipeline, as presented to `docker pull`.
200 "args": [ # Command-line arguments to use when running this step's container.
201 "A String",
202 ],
203 "env": [ # Additional environment variables to set for this step's container.
204 "A String",
205 ],
206 "id": "A String", # Optional unique identifier for this build step, used in wait_for to
207 # reference this build step as a dependency.
208 "dir": "A String", # Working directory (relative to project source root) to use when running
209 # this operation's container.
210 },
211 ],
212 "sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that # A permanent fixed identifier for source.
213 # @OutputOnly
214 # some source was used for this build.
215 "resolvedRepoSource": { # RepoSource describes the location of the source in a Google Cloud Source # A copy of the build's source.repo_source, if exists, with any
216 # revisions resolved.
217 # Repository.
218 "projectId": "A String", # ID of the project that owns the repo. If omitted, the project ID requesting
219 # the build is assumed.
220 "branchName": "A String", # Name of the branch to build.
221 "repoName": "A String", # Name of the repo. If omitted, the name "default" is assumed.
222 "tagName": "A String", # Name of the tag to build.
223 "commitSha": "A String", # Explicit commit SHA to build.
224 },
225 "fileHashes": { # Hash(es) of the build source, which can be used to verify that the original
226 # source integrity was maintained in the build. Note that FileHashes will
227 # only be populated if BuildOptions has requested a SourceProvenanceHash.
228 #
229 # The keys to this map are file paths used as build source and the values
230 # contain the hash values for those files.
231 #
232 # If the build source came in a single package such as a gzipped tarfile
233 # (.tar.gz), the FileHash will be for the single path to that file.
234 # @OutputOnly
235 "a_key": { # Container message for hashes of byte content of files, used in
236 # SourceProvenance messages to verify integrity of source input to the build.
237 "fileHash": [ # Collection of file hashes.
238 { # Container message for hash values.
239 "type": "A String", # The type of hash that was performed.
240 "value": "A String", # The hash value.
241 },
242 ],
243 },
244 },
245 "resolvedStorageSource": { # StorageSource describes the location of the source in an archive file in # A copy of the build's source.storage_source, if exists, with any
246 # generations resolved.
247 # Google Cloud Storage.
248 "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
249 # omitted, the latest generation will be used.
250 "object": "A String", # Google Cloud Storage object containing source.
251 #
252 # This object must be a gzipped archive file (.tar.gz) containing source to
253 # build.
254 "bucket": "A String", # Google Cloud Storage bucket containing source (see
255 # [Bucket Name
256 # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
257 },
258 },
259 "projectId": "A String", # ID of the project.
260 # @OutputOnly.
261 "images": [ # List of images expected to be built and pushed to Google Container
262 # Registry. If an image is listed here and the image is not produced by
263 # one of the build steps, the build will fail. Any images present when
264 # the build steps are complete will be pushed to Container Registry.
265 "A String",
266 ],
267 "options": { # Optional arguments to enable specific features of builds. # Special options for this build.
268 "requestedVerifyOption": "A String", # Options for a verifiable build with details uploaded to the Analysis API.
269 "sourceProvenanceHash": [ # Requested hash for SourceProvenance.
270 "A String",
271 ],
272 },
273 "logUrl": "A String", # URL to logs for this build in Google Cloud Logging.
274 # @OutputOnly
275 },
276 }
277
278 x__xgafv: string, V1 error format.
279 Allowed values
280 1 - v1 error format
281 2 - v2 error format
282
283Returns:
284 An object of the form:
285
286 { # Configuration for an automated build in response to source repository
287 # changes.
288 "id": "A String", # Unique identifier of the trigger.
289 #
290 # @OutputOnly
291 "triggerTemplate": { # RepoSource describes the location of the source in a Google Cloud Source # Template describing the types of source changes to trigger a build.
292 #
293 # Branch and tag names in trigger templates are interpreted as regular
294 # expressions. Any branch or tag change that matches that regular expression
295 # will trigger a build.
296 # Repository.
297 "projectId": "A String", # ID of the project that owns the repo. If omitted, the project ID requesting
298 # the build is assumed.
299 "branchName": "A String", # Name of the branch to build.
300 "repoName": "A String", # Name of the repo. If omitted, the name "default" is assumed.
301 "tagName": "A String", # Name of the tag to build.
302 "commitSha": "A String", # Explicit commit SHA to build.
303 },
304 "createTime": "A String", # Time when the trigger was created.
305 #
306 # @OutputOnly
307 "build": { # A build resource in the Container Builder API. # Contents of the build template.
308 #
309 # At a high level, a Build describes where to find source code, how to build
310 # it (for example, the builder image to run on the source), and what tag to
311 # apply to the built image when it is pushed to Google Container Registry.
312 "status": "A String", # Status of the build.
313 # @OutputOnly
314 "finishTime": "A String", # Time at which execution of the build was finished.
315 # @OutputOnly
316 "timeout": "A String", # Amount of time that this build should be allowed to run, to second
317 # granularity. If this amount of time elapses, work on the build will cease
318 # and the build status will be TIMEOUT.
319 #
320 # Default time is ten minutes.
321 "statusDetail": "A String", # Customer-readable message about the current status.
322 # @OutputOnly
323 "startTime": "A String", # Time at which execution of the build was started.
324 # @OutputOnly
325 "logsBucket": "A String", # Google Cloud Storage bucket where logs should be written (see
326 # [Bucket Name
327 # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
328 # Logs file names will be of the format `${logs_bucket}/log-${build_id}.txt`.
329 "results": { # Results describes the artifacts created by the build pipeline. # Results of the build.
330 # @OutputOnly
331 "images": [ # Images that were built as a part of the build.
332 { # BuiltImage describes an image built by the pipeline.
333 "name": "A String", # Name used to push the container image to Google Container Registry, as
334 # presented to `docker push`.
335 "digest": "A String", # Docker Registry 2.0 digest.
336 },
337 ],
338 "buildStepImages": [ # List of build step digests, in order corresponding to build step indices.
339 "A String",
340 ],
341 },
342 "createTime": "A String", # Time at which the build was created.
343 # @OutputOnly
344 "id": "A String", # Unique identifier of the build.
345 # @OutputOnly
346 "source": { # Source describes the location of the source in a supported storage # Describes where to find the source files to build.
347 # service.
348 "storageSource": { # StorageSource describes the location of the source in an archive file in # If provided, get the source from this location in in Google Cloud
349 # Storage.
350 # Google Cloud Storage.
351 "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
352 # omitted, the latest generation will be used.
353 "object": "A String", # Google Cloud Storage object containing source.
354 #
355 # This object must be a gzipped archive file (.tar.gz) containing source to
356 # build.
357 "bucket": "A String", # Google Cloud Storage bucket containing source (see
358 # [Bucket Name
359 # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
360 },
361 "repoSource": { # RepoSource describes the location of the source in a Google Cloud Source # If provided, get source from this location in a Cloud Repo.
362 # Repository.
363 "projectId": "A String", # ID of the project that owns the repo. If omitted, the project ID requesting
364 # the build is assumed.
365 "branchName": "A String", # Name of the branch to build.
366 "repoName": "A String", # Name of the repo. If omitted, the name "default" is assumed.
367 "tagName": "A String", # Name of the tag to build.
368 "commitSha": "A String", # Explicit commit SHA to build.
369 },
370 },
371 "steps": [ # Describes the operations to be performed on the workspace.
372 { # BuildStep describes a step to perform in the build pipeline.
373 "waitFor": [ # The ID(s) of the step(s) that this build step depends on.
374 # This build step will not start until all the build steps in wait_for
375 # have completed successfully. If wait_for is empty, this build step will
376 # start when all previous build steps in the Build.Steps list have completed
377 # successfully.
378 "A String",
379 ],
380 "name": "A String", # Name of the container image to use for creating this stage in the
381 # pipeline, as presented to `docker pull`.
382 "args": [ # Command-line arguments to use when running this step's container.
383 "A String",
384 ],
385 "env": [ # Additional environment variables to set for this step's container.
386 "A String",
387 ],
388 "id": "A String", # Optional unique identifier for this build step, used in wait_for to
389 # reference this build step as a dependency.
390 "dir": "A String", # Working directory (relative to project source root) to use when running
391 # this operation's container.
392 },
393 ],
394 "sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that # A permanent fixed identifier for source.
395 # @OutputOnly
396 # some source was used for this build.
397 "resolvedRepoSource": { # RepoSource describes the location of the source in a Google Cloud Source # A copy of the build's source.repo_source, if exists, with any
398 # revisions resolved.
399 # Repository.
400 "projectId": "A String", # ID of the project that owns the repo. If omitted, the project ID requesting
401 # the build is assumed.
402 "branchName": "A String", # Name of the branch to build.
403 "repoName": "A String", # Name of the repo. If omitted, the name "default" is assumed.
404 "tagName": "A String", # Name of the tag to build.
405 "commitSha": "A String", # Explicit commit SHA to build.
406 },
407 "fileHashes": { # Hash(es) of the build source, which can be used to verify that the original
408 # source integrity was maintained in the build. Note that FileHashes will
409 # only be populated if BuildOptions has requested a SourceProvenanceHash.
410 #
411 # The keys to this map are file paths used as build source and the values
412 # contain the hash values for those files.
413 #
414 # If the build source came in a single package such as a gzipped tarfile
415 # (.tar.gz), the FileHash will be for the single path to that file.
416 # @OutputOnly
417 "a_key": { # Container message for hashes of byte content of files, used in
418 # SourceProvenance messages to verify integrity of source input to the build.
419 "fileHash": [ # Collection of file hashes.
420 { # Container message for hash values.
421 "type": "A String", # The type of hash that was performed.
422 "value": "A String", # The hash value.
423 },
424 ],
425 },
426 },
427 "resolvedStorageSource": { # StorageSource describes the location of the source in an archive file in # A copy of the build's source.storage_source, if exists, with any
428 # generations resolved.
429 # Google Cloud Storage.
430 "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
431 # omitted, the latest generation will be used.
432 "object": "A String", # Google Cloud Storage object containing source.
433 #
434 # This object must be a gzipped archive file (.tar.gz) containing source to
435 # build.
436 "bucket": "A String", # Google Cloud Storage bucket containing source (see
437 # [Bucket Name
438 # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
439 },
440 },
441 "projectId": "A String", # ID of the project.
442 # @OutputOnly.
443 "images": [ # List of images expected to be built and pushed to Google Container
444 # Registry. If an image is listed here and the image is not produced by
445 # one of the build steps, the build will fail. Any images present when
446 # the build steps are complete will be pushed to Container Registry.
447 "A String",
448 ],
449 "options": { # Optional arguments to enable specific features of builds. # Special options for this build.
450 "requestedVerifyOption": "A String", # Options for a verifiable build with details uploaded to the Analysis API.
451 "sourceProvenanceHash": [ # Requested hash for SourceProvenance.
452 "A String",
453 ],
454 },
455 "logUrl": "A String", # URL to logs for this build in Google Cloud Logging.
456 # @OutputOnly
457 },
458 }</pre>
459</div>
460
461<div class="method">
462 <code class="details" id="delete">delete(projectId, triggerId, x__xgafv=None)</code>
463 <pre>Deletes an BuildTrigger by its project ID and trigger ID.
464
465This API is experimental.
466
467Args:
468 projectId: string, ID of the project that owns the trigger. (required)
469 triggerId: string, ID of the BuildTrigger to delete. (required)
470 x__xgafv: string, V1 error format.
471 Allowed values
472 1 - v1 error format
473 2 - v2 error format
474
475Returns:
476 An object of the form:
477
478 { # A generic empty message that you can re-use to avoid defining duplicated
479 # empty messages in your APIs. A typical example is to use it as the request
480 # or the response type of an API method. For instance:
481 #
482 # service Foo {
483 # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
484 # }
485 #
486 # The JSON representation for `Empty` is empty JSON object `{}`.
487 }</pre>
488</div>
489
490<div class="method">
491 <code class="details" id="get">get(projectId, triggerId, x__xgafv=None)</code>
492 <pre>Gets information about a BuildTrigger.
493
494This API is experimental.
495
496Args:
497 projectId: string, ID of the project that owns the trigger. (required)
498 triggerId: string, ID of the BuildTrigger to get. (required)
499 x__xgafv: string, V1 error format.
500 Allowed values
501 1 - v1 error format
502 2 - v2 error format
503
504Returns:
505 An object of the form:
506
507 { # Configuration for an automated build in response to source repository
508 # changes.
509 "id": "A String", # Unique identifier of the trigger.
510 #
511 # @OutputOnly
512 "triggerTemplate": { # RepoSource describes the location of the source in a Google Cloud Source # Template describing the types of source changes to trigger a build.
513 #
514 # Branch and tag names in trigger templates are interpreted as regular
515 # expressions. Any branch or tag change that matches that regular expression
516 # will trigger a build.
517 # Repository.
518 "projectId": "A String", # ID of the project that owns the repo. If omitted, the project ID requesting
519 # the build is assumed.
520 "branchName": "A String", # Name of the branch to build.
521 "repoName": "A String", # Name of the repo. If omitted, the name "default" is assumed.
522 "tagName": "A String", # Name of the tag to build.
523 "commitSha": "A String", # Explicit commit SHA to build.
524 },
525 "createTime": "A String", # Time when the trigger was created.
526 #
527 # @OutputOnly
528 "build": { # A build resource in the Container Builder API. # Contents of the build template.
529 #
530 # At a high level, a Build describes where to find source code, how to build
531 # it (for example, the builder image to run on the source), and what tag to
532 # apply to the built image when it is pushed to Google Container Registry.
533 "status": "A String", # Status of the build.
534 # @OutputOnly
535 "finishTime": "A String", # Time at which execution of the build was finished.
536 # @OutputOnly
537 "timeout": "A String", # Amount of time that this build should be allowed to run, to second
538 # granularity. If this amount of time elapses, work on the build will cease
539 # and the build status will be TIMEOUT.
540 #
541 # Default time is ten minutes.
542 "statusDetail": "A String", # Customer-readable message about the current status.
543 # @OutputOnly
544 "startTime": "A String", # Time at which execution of the build was started.
545 # @OutputOnly
546 "logsBucket": "A String", # Google Cloud Storage bucket where logs should be written (see
547 # [Bucket Name
548 # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
549 # Logs file names will be of the format `${logs_bucket}/log-${build_id}.txt`.
550 "results": { # Results describes the artifacts created by the build pipeline. # Results of the build.
551 # @OutputOnly
552 "images": [ # Images that were built as a part of the build.
553 { # BuiltImage describes an image built by the pipeline.
554 "name": "A String", # Name used to push the container image to Google Container Registry, as
555 # presented to `docker push`.
556 "digest": "A String", # Docker Registry 2.0 digest.
557 },
558 ],
559 "buildStepImages": [ # List of build step digests, in order corresponding to build step indices.
560 "A String",
561 ],
562 },
563 "createTime": "A String", # Time at which the build was created.
564 # @OutputOnly
565 "id": "A String", # Unique identifier of the build.
566 # @OutputOnly
567 "source": { # Source describes the location of the source in a supported storage # Describes where to find the source files to build.
568 # service.
569 "storageSource": { # StorageSource describes the location of the source in an archive file in # If provided, get the source from this location in in Google Cloud
570 # Storage.
571 # Google Cloud Storage.
572 "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
573 # omitted, the latest generation will be used.
574 "object": "A String", # Google Cloud Storage object containing source.
575 #
576 # This object must be a gzipped archive file (.tar.gz) containing source to
577 # build.
578 "bucket": "A String", # Google Cloud Storage bucket containing source (see
579 # [Bucket Name
580 # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
581 },
582 "repoSource": { # RepoSource describes the location of the source in a Google Cloud Source # If provided, get source from this location in a Cloud Repo.
583 # Repository.
584 "projectId": "A String", # ID of the project that owns the repo. If omitted, the project ID requesting
585 # the build is assumed.
586 "branchName": "A String", # Name of the branch to build.
587 "repoName": "A String", # Name of the repo. If omitted, the name "default" is assumed.
588 "tagName": "A String", # Name of the tag to build.
589 "commitSha": "A String", # Explicit commit SHA to build.
590 },
591 },
592 "steps": [ # Describes the operations to be performed on the workspace.
593 { # BuildStep describes a step to perform in the build pipeline.
594 "waitFor": [ # The ID(s) of the step(s) that this build step depends on.
595 # This build step will not start until all the build steps in wait_for
596 # have completed successfully. If wait_for is empty, this build step will
597 # start when all previous build steps in the Build.Steps list have completed
598 # successfully.
599 "A String",
600 ],
601 "name": "A String", # Name of the container image to use for creating this stage in the
602 # pipeline, as presented to `docker pull`.
603 "args": [ # Command-line arguments to use when running this step's container.
604 "A String",
605 ],
606 "env": [ # Additional environment variables to set for this step's container.
607 "A String",
608 ],
609 "id": "A String", # Optional unique identifier for this build step, used in wait_for to
610 # reference this build step as a dependency.
611 "dir": "A String", # Working directory (relative to project source root) to use when running
612 # this operation's container.
613 },
614 ],
615 "sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that # A permanent fixed identifier for source.
616 # @OutputOnly
617 # some source was used for this build.
618 "resolvedRepoSource": { # RepoSource describes the location of the source in a Google Cloud Source # A copy of the build's source.repo_source, if exists, with any
619 # revisions resolved.
620 # Repository.
621 "projectId": "A String", # ID of the project that owns the repo. If omitted, the project ID requesting
622 # the build is assumed.
623 "branchName": "A String", # Name of the branch to build.
624 "repoName": "A String", # Name of the repo. If omitted, the name "default" is assumed.
625 "tagName": "A String", # Name of the tag to build.
626 "commitSha": "A String", # Explicit commit SHA to build.
627 },
628 "fileHashes": { # Hash(es) of the build source, which can be used to verify that the original
629 # source integrity was maintained in the build. Note that FileHashes will
630 # only be populated if BuildOptions has requested a SourceProvenanceHash.
631 #
632 # The keys to this map are file paths used as build source and the values
633 # contain the hash values for those files.
634 #
635 # If the build source came in a single package such as a gzipped tarfile
636 # (.tar.gz), the FileHash will be for the single path to that file.
637 # @OutputOnly
638 "a_key": { # Container message for hashes of byte content of files, used in
639 # SourceProvenance messages to verify integrity of source input to the build.
640 "fileHash": [ # Collection of file hashes.
641 { # Container message for hash values.
642 "type": "A String", # The type of hash that was performed.
643 "value": "A String", # The hash value.
644 },
645 ],
646 },
647 },
648 "resolvedStorageSource": { # StorageSource describes the location of the source in an archive file in # A copy of the build's source.storage_source, if exists, with any
649 # generations resolved.
650 # Google Cloud Storage.
651 "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
652 # omitted, the latest generation will be used.
653 "object": "A String", # Google Cloud Storage object containing source.
654 #
655 # This object must be a gzipped archive file (.tar.gz) containing source to
656 # build.
657 "bucket": "A String", # Google Cloud Storage bucket containing source (see
658 # [Bucket Name
659 # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
660 },
661 },
662 "projectId": "A String", # ID of the project.
663 # @OutputOnly.
664 "images": [ # List of images expected to be built and pushed to Google Container
665 # Registry. If an image is listed here and the image is not produced by
666 # one of the build steps, the build will fail. Any images present when
667 # the build steps are complete will be pushed to Container Registry.
668 "A String",
669 ],
670 "options": { # Optional arguments to enable specific features of builds. # Special options for this build.
671 "requestedVerifyOption": "A String", # Options for a verifiable build with details uploaded to the Analysis API.
672 "sourceProvenanceHash": [ # Requested hash for SourceProvenance.
673 "A String",
674 ],
675 },
676 "logUrl": "A String", # URL to logs for this build in Google Cloud Logging.
677 # @OutputOnly
678 },
679 }</pre>
680</div>
681
682<div class="method">
683 <code class="details" id="list">list(projectId, x__xgafv=None)</code>
684 <pre>Lists existing BuildTrigger.
685
686This API is experimental.
687
688Args:
689 projectId: string, ID of the project for which to list BuildTriggers. (required)
690 x__xgafv: string, V1 error format.
691 Allowed values
692 1 - v1 error format
693 2 - v2 error format
694
695Returns:
696 An object of the form:
697
698 { # Response containing existing BuildTriggers.
699 "triggers": [ # BuildTriggers for the project, sorted by create_time descending.
700 { # Configuration for an automated build in response to source repository
701 # changes.
702 "id": "A String", # Unique identifier of the trigger.
703 #
704 # @OutputOnly
705 "triggerTemplate": { # RepoSource describes the location of the source in a Google Cloud Source # Template describing the types of source changes to trigger a build.
706 #
707 # Branch and tag names in trigger templates are interpreted as regular
708 # expressions. Any branch or tag change that matches that regular expression
709 # will trigger a build.
710 # Repository.
711 "projectId": "A String", # ID of the project that owns the repo. If omitted, the project ID requesting
712 # the build is assumed.
713 "branchName": "A String", # Name of the branch to build.
714 "repoName": "A String", # Name of the repo. If omitted, the name "default" is assumed.
715 "tagName": "A String", # Name of the tag to build.
716 "commitSha": "A String", # Explicit commit SHA to build.
717 },
718 "createTime": "A String", # Time when the trigger was created.
719 #
720 # @OutputOnly
721 "build": { # A build resource in the Container Builder API. # Contents of the build template.
722 #
723 # At a high level, a Build describes where to find source code, how to build
724 # it (for example, the builder image to run on the source), and what tag to
725 # apply to the built image when it is pushed to Google Container Registry.
726 "status": "A String", # Status of the build.
727 # @OutputOnly
728 "finishTime": "A String", # Time at which execution of the build was finished.
729 # @OutputOnly
730 "timeout": "A String", # Amount of time that this build should be allowed to run, to second
731 # granularity. If this amount of time elapses, work on the build will cease
732 # and the build status will be TIMEOUT.
733 #
734 # Default time is ten minutes.
735 "statusDetail": "A String", # Customer-readable message about the current status.
736 # @OutputOnly
737 "startTime": "A String", # Time at which execution of the build was started.
738 # @OutputOnly
739 "logsBucket": "A String", # Google Cloud Storage bucket where logs should be written (see
740 # [Bucket Name
741 # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
742 # Logs file names will be of the format `${logs_bucket}/log-${build_id}.txt`.
743 "results": { # Results describes the artifacts created by the build pipeline. # Results of the build.
744 # @OutputOnly
745 "images": [ # Images that were built as a part of the build.
746 { # BuiltImage describes an image built by the pipeline.
747 "name": "A String", # Name used to push the container image to Google Container Registry, as
748 # presented to `docker push`.
749 "digest": "A String", # Docker Registry 2.0 digest.
750 },
751 ],
752 "buildStepImages": [ # List of build step digests, in order corresponding to build step indices.
753 "A String",
754 ],
755 },
756 "createTime": "A String", # Time at which the build was created.
757 # @OutputOnly
758 "id": "A String", # Unique identifier of the build.
759 # @OutputOnly
760 "source": { # Source describes the location of the source in a supported storage # Describes where to find the source files to build.
761 # service.
762 "storageSource": { # StorageSource describes the location of the source in an archive file in # If provided, get the source from this location in in Google Cloud
763 # Storage.
764 # Google Cloud Storage.
765 "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
766 # omitted, the latest generation will be used.
767 "object": "A String", # Google Cloud Storage object containing source.
768 #
769 # This object must be a gzipped archive file (.tar.gz) containing source to
770 # build.
771 "bucket": "A String", # Google Cloud Storage bucket containing source (see
772 # [Bucket Name
773 # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
774 },
775 "repoSource": { # RepoSource describes the location of the source in a Google Cloud Source # If provided, get source from this location in a Cloud Repo.
776 # Repository.
777 "projectId": "A String", # ID of the project that owns the repo. If omitted, the project ID requesting
778 # the build is assumed.
779 "branchName": "A String", # Name of the branch to build.
780 "repoName": "A String", # Name of the repo. If omitted, the name "default" is assumed.
781 "tagName": "A String", # Name of the tag to build.
782 "commitSha": "A String", # Explicit commit SHA to build.
783 },
784 },
785 "steps": [ # Describes the operations to be performed on the workspace.
786 { # BuildStep describes a step to perform in the build pipeline.
787 "waitFor": [ # The ID(s) of the step(s) that this build step depends on.
788 # This build step will not start until all the build steps in wait_for
789 # have completed successfully. If wait_for is empty, this build step will
790 # start when all previous build steps in the Build.Steps list have completed
791 # successfully.
792 "A String",
793 ],
794 "name": "A String", # Name of the container image to use for creating this stage in the
795 # pipeline, as presented to `docker pull`.
796 "args": [ # Command-line arguments to use when running this step's container.
797 "A String",
798 ],
799 "env": [ # Additional environment variables to set for this step's container.
800 "A String",
801 ],
802 "id": "A String", # Optional unique identifier for this build step, used in wait_for to
803 # reference this build step as a dependency.
804 "dir": "A String", # Working directory (relative to project source root) to use when running
805 # this operation's container.
806 },
807 ],
808 "sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that # A permanent fixed identifier for source.
809 # @OutputOnly
810 # some source was used for this build.
811 "resolvedRepoSource": { # RepoSource describes the location of the source in a Google Cloud Source # A copy of the build's source.repo_source, if exists, with any
812 # revisions resolved.
813 # Repository.
814 "projectId": "A String", # ID of the project that owns the repo. If omitted, the project ID requesting
815 # the build is assumed.
816 "branchName": "A String", # Name of the branch to build.
817 "repoName": "A String", # Name of the repo. If omitted, the name "default" is assumed.
818 "tagName": "A String", # Name of the tag to build.
819 "commitSha": "A String", # Explicit commit SHA to build.
820 },
821 "fileHashes": { # Hash(es) of the build source, which can be used to verify that the original
822 # source integrity was maintained in the build. Note that FileHashes will
823 # only be populated if BuildOptions has requested a SourceProvenanceHash.
824 #
825 # The keys to this map are file paths used as build source and the values
826 # contain the hash values for those files.
827 #
828 # If the build source came in a single package such as a gzipped tarfile
829 # (.tar.gz), the FileHash will be for the single path to that file.
830 # @OutputOnly
831 "a_key": { # Container message for hashes of byte content of files, used in
832 # SourceProvenance messages to verify integrity of source input to the build.
833 "fileHash": [ # Collection of file hashes.
834 { # Container message for hash values.
835 "type": "A String", # The type of hash that was performed.
836 "value": "A String", # The hash value.
837 },
838 ],
839 },
840 },
841 "resolvedStorageSource": { # StorageSource describes the location of the source in an archive file in # A copy of the build's source.storage_source, if exists, with any
842 # generations resolved.
843 # Google Cloud Storage.
844 "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
845 # omitted, the latest generation will be used.
846 "object": "A String", # Google Cloud Storage object containing source.
847 #
848 # This object must be a gzipped archive file (.tar.gz) containing source to
849 # build.
850 "bucket": "A String", # Google Cloud Storage bucket containing source (see
851 # [Bucket Name
852 # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
853 },
854 },
855 "projectId": "A String", # ID of the project.
856 # @OutputOnly.
857 "images": [ # List of images expected to be built and pushed to Google Container
858 # Registry. If an image is listed here and the image is not produced by
859 # one of the build steps, the build will fail. Any images present when
860 # the build steps are complete will be pushed to Container Registry.
861 "A String",
862 ],
863 "options": { # Optional arguments to enable specific features of builds. # Special options for this build.
864 "requestedVerifyOption": "A String", # Options for a verifiable build with details uploaded to the Analysis API.
865 "sourceProvenanceHash": [ # Requested hash for SourceProvenance.
866 "A String",
867 ],
868 },
869 "logUrl": "A String", # URL to logs for this build in Google Cloud Logging.
870 # @OutputOnly
871 },
872 },
873 ],
874 }</pre>
875</div>
876
877<div class="method">
878 <code class="details" id="patch">patch(projectId, triggerId, body, x__xgafv=None)</code>
879 <pre>Updates an BuildTrigger by its project ID and trigger ID.
880
881This API is experimental.
882
883Args:
884 projectId: string, ID of the project that owns the trigger. (required)
885 triggerId: string, ID of the BuildTrigger to update. (required)
886 body: object, The request body. (required)
887 The object takes the form of:
888
889{ # Configuration for an automated build in response to source repository
890 # changes.
891 "id": "A String", # Unique identifier of the trigger.
892 #
893 # @OutputOnly
894 "triggerTemplate": { # RepoSource describes the location of the source in a Google Cloud Source # Template describing the types of source changes to trigger a build.
895 #
896 # Branch and tag names in trigger templates are interpreted as regular
897 # expressions. Any branch or tag change that matches that regular expression
898 # will trigger a build.
899 # Repository.
900 "projectId": "A String", # ID of the project that owns the repo. If omitted, the project ID requesting
901 # the build is assumed.
902 "branchName": "A String", # Name of the branch to build.
903 "repoName": "A String", # Name of the repo. If omitted, the name "default" is assumed.
904 "tagName": "A String", # Name of the tag to build.
905 "commitSha": "A String", # Explicit commit SHA to build.
906 },
907 "createTime": "A String", # Time when the trigger was created.
908 #
909 # @OutputOnly
910 "build": { # A build resource in the Container Builder API. # Contents of the build template.
911 #
912 # At a high level, a Build describes where to find source code, how to build
913 # it (for example, the builder image to run on the source), and what tag to
914 # apply to the built image when it is pushed to Google Container Registry.
915 "status": "A String", # Status of the build.
916 # @OutputOnly
917 "finishTime": "A String", # Time at which execution of the build was finished.
918 # @OutputOnly
919 "timeout": "A String", # Amount of time that this build should be allowed to run, to second
920 # granularity. If this amount of time elapses, work on the build will cease
921 # and the build status will be TIMEOUT.
922 #
923 # Default time is ten minutes.
924 "statusDetail": "A String", # Customer-readable message about the current status.
925 # @OutputOnly
926 "startTime": "A String", # Time at which execution of the build was started.
927 # @OutputOnly
928 "logsBucket": "A String", # Google Cloud Storage bucket where logs should be written (see
929 # [Bucket Name
930 # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
931 # Logs file names will be of the format `${logs_bucket}/log-${build_id}.txt`.
932 "results": { # Results describes the artifacts created by the build pipeline. # Results of the build.
933 # @OutputOnly
934 "images": [ # Images that were built as a part of the build.
935 { # BuiltImage describes an image built by the pipeline.
936 "name": "A String", # Name used to push the container image to Google Container Registry, as
937 # presented to `docker push`.
938 "digest": "A String", # Docker Registry 2.0 digest.
939 },
940 ],
941 "buildStepImages": [ # List of build step digests, in order corresponding to build step indices.
942 "A String",
943 ],
944 },
945 "createTime": "A String", # Time at which the build was created.
946 # @OutputOnly
947 "id": "A String", # Unique identifier of the build.
948 # @OutputOnly
949 "source": { # Source describes the location of the source in a supported storage # Describes where to find the source files to build.
950 # service.
951 "storageSource": { # StorageSource describes the location of the source in an archive file in # If provided, get the source from this location in in Google Cloud
952 # Storage.
953 # Google Cloud Storage.
954 "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
955 # omitted, the latest generation will be used.
956 "object": "A String", # Google Cloud Storage object containing source.
957 #
958 # This object must be a gzipped archive file (.tar.gz) containing source to
959 # build.
960 "bucket": "A String", # Google Cloud Storage bucket containing source (see
961 # [Bucket Name
962 # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
963 },
964 "repoSource": { # RepoSource describes the location of the source in a Google Cloud Source # If provided, get source from this location in a Cloud Repo.
965 # Repository.
966 "projectId": "A String", # ID of the project that owns the repo. If omitted, the project ID requesting
967 # the build is assumed.
968 "branchName": "A String", # Name of the branch to build.
969 "repoName": "A String", # Name of the repo. If omitted, the name "default" is assumed.
970 "tagName": "A String", # Name of the tag to build.
971 "commitSha": "A String", # Explicit commit SHA to build.
972 },
973 },
974 "steps": [ # Describes the operations to be performed on the workspace.
975 { # BuildStep describes a step to perform in the build pipeline.
976 "waitFor": [ # The ID(s) of the step(s) that this build step depends on.
977 # This build step will not start until all the build steps in wait_for
978 # have completed successfully. If wait_for is empty, this build step will
979 # start when all previous build steps in the Build.Steps list have completed
980 # successfully.
981 "A String",
982 ],
983 "name": "A String", # Name of the container image to use for creating this stage in the
984 # pipeline, as presented to `docker pull`.
985 "args": [ # Command-line arguments to use when running this step's container.
986 "A String",
987 ],
988 "env": [ # Additional environment variables to set for this step's container.
989 "A String",
990 ],
991 "id": "A String", # Optional unique identifier for this build step, used in wait_for to
992 # reference this build step as a dependency.
993 "dir": "A String", # Working directory (relative to project source root) to use when running
994 # this operation's container.
995 },
996 ],
997 "sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that # A permanent fixed identifier for source.
998 # @OutputOnly
999 # some source was used for this build.
1000 "resolvedRepoSource": { # RepoSource describes the location of the source in a Google Cloud Source # A copy of the build's source.repo_source, if exists, with any
1001 # revisions resolved.
1002 # Repository.
1003 "projectId": "A String", # ID of the project that owns the repo. If omitted, the project ID requesting
1004 # the build is assumed.
1005 "branchName": "A String", # Name of the branch to build.
1006 "repoName": "A String", # Name of the repo. If omitted, the name "default" is assumed.
1007 "tagName": "A String", # Name of the tag to build.
1008 "commitSha": "A String", # Explicit commit SHA to build.
1009 },
1010 "fileHashes": { # Hash(es) of the build source, which can be used to verify that the original
1011 # source integrity was maintained in the build. Note that FileHashes will
1012 # only be populated if BuildOptions has requested a SourceProvenanceHash.
1013 #
1014 # The keys to this map are file paths used as build source and the values
1015 # contain the hash values for those files.
1016 #
1017 # If the build source came in a single package such as a gzipped tarfile
1018 # (.tar.gz), the FileHash will be for the single path to that file.
1019 # @OutputOnly
1020 "a_key": { # Container message for hashes of byte content of files, used in
1021 # SourceProvenance messages to verify integrity of source input to the build.
1022 "fileHash": [ # Collection of file hashes.
1023 { # Container message for hash values.
1024 "type": "A String", # The type of hash that was performed.
1025 "value": "A String", # The hash value.
1026 },
1027 ],
1028 },
1029 },
1030 "resolvedStorageSource": { # StorageSource describes the location of the source in an archive file in # A copy of the build's source.storage_source, if exists, with any
1031 # generations resolved.
1032 # Google Cloud Storage.
1033 "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
1034 # omitted, the latest generation will be used.
1035 "object": "A String", # Google Cloud Storage object containing source.
1036 #
1037 # This object must be a gzipped archive file (.tar.gz) containing source to
1038 # build.
1039 "bucket": "A String", # Google Cloud Storage bucket containing source (see
1040 # [Bucket Name
1041 # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
1042 },
1043 },
1044 "projectId": "A String", # ID of the project.
1045 # @OutputOnly.
1046 "images": [ # List of images expected to be built and pushed to Google Container
1047 # Registry. If an image is listed here and the image is not produced by
1048 # one of the build steps, the build will fail. Any images present when
1049 # the build steps are complete will be pushed to Container Registry.
1050 "A String",
1051 ],
1052 "options": { # Optional arguments to enable specific features of builds. # Special options for this build.
1053 "requestedVerifyOption": "A String", # Options for a verifiable build with details uploaded to the Analysis API.
1054 "sourceProvenanceHash": [ # Requested hash for SourceProvenance.
1055 "A String",
1056 ],
1057 },
1058 "logUrl": "A String", # URL to logs for this build in Google Cloud Logging.
1059 # @OutputOnly
1060 },
1061 }
1062
1063 x__xgafv: string, V1 error format.
1064 Allowed values
1065 1 - v1 error format
1066 2 - v2 error format
1067
1068Returns:
1069 An object of the form:
1070
1071 { # Configuration for an automated build in response to source repository
1072 # changes.
1073 "id": "A String", # Unique identifier of the trigger.
1074 #
1075 # @OutputOnly
1076 "triggerTemplate": { # RepoSource describes the location of the source in a Google Cloud Source # Template describing the types of source changes to trigger a build.
1077 #
1078 # Branch and tag names in trigger templates are interpreted as regular
1079 # expressions. Any branch or tag change that matches that regular expression
1080 # will trigger a build.
1081 # Repository.
1082 "projectId": "A String", # ID of the project that owns the repo. If omitted, the project ID requesting
1083 # the build is assumed.
1084 "branchName": "A String", # Name of the branch to build.
1085 "repoName": "A String", # Name of the repo. If omitted, the name "default" is assumed.
1086 "tagName": "A String", # Name of the tag to build.
1087 "commitSha": "A String", # Explicit commit SHA to build.
1088 },
1089 "createTime": "A String", # Time when the trigger was created.
1090 #
1091 # @OutputOnly
1092 "build": { # A build resource in the Container Builder API. # Contents of the build template.
1093 #
1094 # At a high level, a Build describes where to find source code, how to build
1095 # it (for example, the builder image to run on the source), and what tag to
1096 # apply to the built image when it is pushed to Google Container Registry.
1097 "status": "A String", # Status of the build.
1098 # @OutputOnly
1099 "finishTime": "A String", # Time at which execution of the build was finished.
1100 # @OutputOnly
1101 "timeout": "A String", # Amount of time that this build should be allowed to run, to second
1102 # granularity. If this amount of time elapses, work on the build will cease
1103 # and the build status will be TIMEOUT.
1104 #
1105 # Default time is ten minutes.
1106 "statusDetail": "A String", # Customer-readable message about the current status.
1107 # @OutputOnly
1108 "startTime": "A String", # Time at which execution of the build was started.
1109 # @OutputOnly
1110 "logsBucket": "A String", # Google Cloud Storage bucket where logs should be written (see
1111 # [Bucket Name
1112 # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
1113 # Logs file names will be of the format `${logs_bucket}/log-${build_id}.txt`.
1114 "results": { # Results describes the artifacts created by the build pipeline. # Results of the build.
1115 # @OutputOnly
1116 "images": [ # Images that were built as a part of the build.
1117 { # BuiltImage describes an image built by the pipeline.
1118 "name": "A String", # Name used to push the container image to Google Container Registry, as
1119 # presented to `docker push`.
1120 "digest": "A String", # Docker Registry 2.0 digest.
1121 },
1122 ],
1123 "buildStepImages": [ # List of build step digests, in order corresponding to build step indices.
1124 "A String",
1125 ],
1126 },
1127 "createTime": "A String", # Time at which the build was created.
1128 # @OutputOnly
1129 "id": "A String", # Unique identifier of the build.
1130 # @OutputOnly
1131 "source": { # Source describes the location of the source in a supported storage # Describes where to find the source files to build.
1132 # service.
1133 "storageSource": { # StorageSource describes the location of the source in an archive file in # If provided, get the source from this location in in Google Cloud
1134 # Storage.
1135 # Google Cloud Storage.
1136 "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
1137 # omitted, the latest generation will be used.
1138 "object": "A String", # Google Cloud Storage object containing source.
1139 #
1140 # This object must be a gzipped archive file (.tar.gz) containing source to
1141 # build.
1142 "bucket": "A String", # Google Cloud Storage bucket containing source (see
1143 # [Bucket Name
1144 # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
1145 },
1146 "repoSource": { # RepoSource describes the location of the source in a Google Cloud Source # If provided, get source from this location in a Cloud Repo.
1147 # Repository.
1148 "projectId": "A String", # ID of the project that owns the repo. If omitted, the project ID requesting
1149 # the build is assumed.
1150 "branchName": "A String", # Name of the branch to build.
1151 "repoName": "A String", # Name of the repo. If omitted, the name "default" is assumed.
1152 "tagName": "A String", # Name of the tag to build.
1153 "commitSha": "A String", # Explicit commit SHA to build.
1154 },
1155 },
1156 "steps": [ # Describes the operations to be performed on the workspace.
1157 { # BuildStep describes a step to perform in the build pipeline.
1158 "waitFor": [ # The ID(s) of the step(s) that this build step depends on.
1159 # This build step will not start until all the build steps in wait_for
1160 # have completed successfully. If wait_for is empty, this build step will
1161 # start when all previous build steps in the Build.Steps list have completed
1162 # successfully.
1163 "A String",
1164 ],
1165 "name": "A String", # Name of the container image to use for creating this stage in the
1166 # pipeline, as presented to `docker pull`.
1167 "args": [ # Command-line arguments to use when running this step's container.
1168 "A String",
1169 ],
1170 "env": [ # Additional environment variables to set for this step's container.
1171 "A String",
1172 ],
1173 "id": "A String", # Optional unique identifier for this build step, used in wait_for to
1174 # reference this build step as a dependency.
1175 "dir": "A String", # Working directory (relative to project source root) to use when running
1176 # this operation's container.
1177 },
1178 ],
1179 "sourceProvenance": { # Provenance of the source. Ways to find the original source, or verify that # A permanent fixed identifier for source.
1180 # @OutputOnly
1181 # some source was used for this build.
1182 "resolvedRepoSource": { # RepoSource describes the location of the source in a Google Cloud Source # A copy of the build's source.repo_source, if exists, with any
1183 # revisions resolved.
1184 # Repository.
1185 "projectId": "A String", # ID of the project that owns the repo. If omitted, the project ID requesting
1186 # the build is assumed.
1187 "branchName": "A String", # Name of the branch to build.
1188 "repoName": "A String", # Name of the repo. If omitted, the name "default" is assumed.
1189 "tagName": "A String", # Name of the tag to build.
1190 "commitSha": "A String", # Explicit commit SHA to build.
1191 },
1192 "fileHashes": { # Hash(es) of the build source, which can be used to verify that the original
1193 # source integrity was maintained in the build. Note that FileHashes will
1194 # only be populated if BuildOptions has requested a SourceProvenanceHash.
1195 #
1196 # The keys to this map are file paths used as build source and the values
1197 # contain the hash values for those files.
1198 #
1199 # If the build source came in a single package such as a gzipped tarfile
1200 # (.tar.gz), the FileHash will be for the single path to that file.
1201 # @OutputOnly
1202 "a_key": { # Container message for hashes of byte content of files, used in
1203 # SourceProvenance messages to verify integrity of source input to the build.
1204 "fileHash": [ # Collection of file hashes.
1205 { # Container message for hash values.
1206 "type": "A String", # The type of hash that was performed.
1207 "value": "A String", # The hash value.
1208 },
1209 ],
1210 },
1211 },
1212 "resolvedStorageSource": { # StorageSource describes the location of the source in an archive file in # A copy of the build's source.storage_source, if exists, with any
1213 # generations resolved.
1214 # Google Cloud Storage.
1215 "generation": "A String", # Google Cloud Storage generation for the object. If the generation is
1216 # omitted, the latest generation will be used.
1217 "object": "A String", # Google Cloud Storage object containing source.
1218 #
1219 # This object must be a gzipped archive file (.tar.gz) containing source to
1220 # build.
1221 "bucket": "A String", # Google Cloud Storage bucket containing source (see
1222 # [Bucket Name
1223 # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
1224 },
1225 },
1226 "projectId": "A String", # ID of the project.
1227 # @OutputOnly.
1228 "images": [ # List of images expected to be built and pushed to Google Container
1229 # Registry. If an image is listed here and the image is not produced by
1230 # one of the build steps, the build will fail. Any images present when
1231 # the build steps are complete will be pushed to Container Registry.
1232 "A String",
1233 ],
1234 "options": { # Optional arguments to enable specific features of builds. # Special options for this build.
1235 "requestedVerifyOption": "A String", # Options for a verifiable build with details uploaded to the Analysis API.
1236 "sourceProvenanceHash": [ # Requested hash for SourceProvenance.
1237 "A String",
1238 ],
1239 },
1240 "logUrl": "A String", # URL to logs for this build in Google Cloud Logging.
1241 # @OutputOnly
1242 },
1243 }</pre>
1244</div>
1245
1246</body></html>