Class Build.Builder (3.44.0) 

public static final class Build.Builder extends GeneratedMessageV3.Builder<Build.Builder> implements BuildOrBuilder

A build resource in the Cloud Build API.

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 where to store the built artifacts.

Fields can include the following variables, which will be expanded when the build is created:

  • $PROJECT_ID: the project ID of the build.
  • $PROJECT_NUMBER: the project number of the build.
  • $LOCATION: the location/region 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.
  • $SHORT_SHA: first 7 characters of $REVISION_ID or $COMMIT_SHA.

Protobuf type google.devtools.cloudbuild.v1.Build

Inheritance

Object > AbstractMessageLite.Builder<MessageType,BuilderType> > AbstractMessage.Builder<BuilderType> > GeneratedMessageV3.Builder > Build.Builder

Implements

BuildOrBuilder

Static Methods

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()
Returns
Type Description
Descriptor

Methods

addAllImages(Iterable<String> values)

public Build.Builder addAllImages(Iterable<String> values)

A list of images to be pushed upon the successful completion of all build steps.

The images are 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 status is marked FAILURE.

repeated string images = 13;

Parameter
Name Description
values Iterable<String>

The images to add.
Returns
Type Description
Build.Builder

This builder for chaining.

addAllSecrets(Iterable<? extends Secret> values)

public Build.Builder addAllSecrets(Iterable<? extends Secret> values)

Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use available_secrets to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets

repeated .google.devtools.cloudbuild.v1.Secret secrets = 32;

Parameter
Name Description
values Iterable<? extends com.google.cloudbuild.v1.Secret>
Returns
Type Description
Build.Builder

addAllSteps(Iterable<? extends BuildStep> values)

public Build.Builder addAllSteps(Iterable<? extends BuildStep> values)

Required. The operations to be performed on the workspace.

repeated .google.devtools.cloudbuild.v1.BuildStep steps = 11;

Parameter
Name Description
values Iterable<? extends com.google.cloudbuild.v1.BuildStep>
Returns
Type Description
Build.Builder

addAllTags(Iterable<String> values)

public Build.Builder addAllTags(Iterable<String> values)

Tags for annotation of a Build. These are not docker tags.

repeated string tags = 31;

Parameter
Name Description
values Iterable<String>

The tags to add.
Returns
Type Description
Build.Builder

This builder for chaining.

addAllWarnings(Iterable<? extends Build.Warning> values)

public Build.Builder addAllWarnings(Iterable<? extends Build.Warning> values)

Output only. Non-fatal problems encountered during the execution of the build.

repeated .google.devtools.cloudbuild.v1.Build.Warning warnings = 49 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
values Iterable<? extends com.google.cloudbuild.v1.Build.Warning>
Returns
Type Description
Build.Builder

addImages(String value)

public Build.Builder addImages(String value)

A list of images to be pushed upon the successful completion of all build steps.

The images are 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 status is marked FAILURE.

repeated string images = 13;

Parameter
Name Description
value String

The images to add.
Returns
Type Description
Build.Builder

This builder for chaining.

addImagesBytes(ByteString value)

public Build.Builder addImagesBytes(ByteString value)

A list of images to be pushed upon the successful completion of all build steps.

The images are 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 status is marked FAILURE.

repeated string images = 13;

Parameter
Name Description
value ByteString

The bytes of the images to add.
Returns
Type Description
Build.Builder

This builder for chaining.

addRepeatedField(Descriptors.FieldDescriptor field, Object value)

public Build.Builder addRepeatedField(Descriptors.FieldDescriptor field, Object value)
Parameters
Name Description
field FieldDescriptor
value Object
Returns
Type Description
Build.Builder
Overrides

addSecrets(Secret value)

public Build.Builder addSecrets(Secret value)

Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use available_secrets to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets

repeated .google.devtools.cloudbuild.v1.Secret secrets = 32;

Parameter
Name Description
value Secret
Returns
Type Description
Build.Builder

addSecrets(Secret.Builder builderForValue)

public Build.Builder addSecrets(Secret.Builder builderForValue)

Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use available_secrets to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets

repeated .google.devtools.cloudbuild.v1.Secret secrets = 32;

Parameter
Name Description
builderForValue Secret.Builder
Returns
Type Description
Build.Builder

addSecrets(int index, Secret value)

public Build.Builder addSecrets(int index, Secret value)

Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use available_secrets to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets

repeated .google.devtools.cloudbuild.v1.Secret secrets = 32;

Parameters
Name Description
index int
value Secret
Returns
Type Description
Build.Builder

addSecrets(int index, Secret.Builder builderForValue)

public Build.Builder addSecrets(int index, Secret.Builder builderForValue)

Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use available_secrets to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets

repeated .google.devtools.cloudbuild.v1.Secret secrets = 32;

Parameters
Name Description
index int
builderForValue Secret.Builder
Returns
Type Description
Build.Builder

addSecretsBuilder()

public Secret.Builder addSecretsBuilder()

Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use available_secrets to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets

repeated .google.devtools.cloudbuild.v1.Secret secrets = 32;

Returns
Type Description
Secret.Builder

addSecretsBuilder(int index)

public Secret.Builder addSecretsBuilder(int index)

Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use available_secrets to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets

repeated .google.devtools.cloudbuild.v1.Secret secrets = 32;

Parameter
Name Description
index int
Returns
Type Description
Secret.Builder

addSteps(BuildStep value)

public Build.Builder addSteps(BuildStep value)

Required. The operations to be performed on the workspace.

repeated .google.devtools.cloudbuild.v1.BuildStep steps = 11;

Parameter
Name Description
value BuildStep
Returns
Type Description
Build.Builder

addSteps(BuildStep.Builder builderForValue)

public Build.Builder addSteps(BuildStep.Builder builderForValue)

Required. The operations to be performed on the workspace.

repeated .google.devtools.cloudbuild.v1.BuildStep steps = 11;

Parameter
Name Description
builderForValue BuildStep.Builder
Returns
Type Description
Build.Builder

addSteps(int index, BuildStep value)

public Build.Builder addSteps(int index, BuildStep value)

Required. The operations to be performed on the workspace.

repeated .google.devtools.cloudbuild.v1.BuildStep steps = 11;

Parameters
Name Description
index int
value BuildStep
Returns
Type Description
Build.Builder

addSteps(int index, BuildStep.Builder builderForValue)

public Build.Builder addSteps(int index, BuildStep.Builder builderForValue)

Required. The operations to be performed on the workspace.

repeated .google.devtools.cloudbuild.v1.BuildStep steps = 11;

Parameters
Name Description
index int
builderForValue BuildStep.Builder
Returns
Type Description
Build.Builder

addStepsBuilder()

public BuildStep.Builder addStepsBuilder()

Required. The operations to be performed on the workspace.

repeated .google.devtools.cloudbuild.v1.BuildStep steps = 11;

Returns
Type Description
BuildStep.Builder

addStepsBuilder(int index)

public BuildStep.Builder addStepsBuilder(int index)

Required. The operations to be performed on the workspace.

repeated .google.devtools.cloudbuild.v1.BuildStep steps = 11;

Parameter
Name Description
index int
Returns
Type Description
BuildStep.Builder

addTags(String value)

public Build.Builder addTags(String value)

Tags for annotation of a Build. These are not docker tags.

repeated string tags = 31;

Parameter
Name Description
value String

The tags to add.
Returns
Type Description
Build.Builder

This builder for chaining.

addTagsBytes(ByteString value)

public Build.Builder addTagsBytes(ByteString value)

Tags for annotation of a Build. These are not docker tags.

repeated string tags = 31;

Parameter
Name Description
value ByteString

The bytes of the tags to add.
Returns
Type Description
Build.Builder

This builder for chaining.

addWarnings(Build.Warning value)

public Build.Builder addWarnings(Build.Warning value)

Output only. Non-fatal problems encountered during the execution of the build.

repeated .google.devtools.cloudbuild.v1.Build.Warning warnings = 49 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value Build.Warning
Returns
Type Description
Build.Builder

addWarnings(Build.Warning.Builder builderForValue)

public Build.Builder addWarnings(Build.Warning.Builder builderForValue)

Output only. Non-fatal problems encountered during the execution of the build.

repeated .google.devtools.cloudbuild.v1.Build.Warning warnings = 49 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
builderForValue Build.Warning.Builder
Returns
Type Description
Build.Builder

addWarnings(int index, Build.Warning value)

public Build.Builder addWarnings(int index, Build.Warning value)

Output only. Non-fatal problems encountered during the execution of the build.

repeated .google.devtools.cloudbuild.v1.Build.Warning warnings = 49 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameters
Name Description
index int
value Build.Warning
Returns
Type Description
Build.Builder

addWarnings(int index, Build.Warning.Builder builderForValue)

public Build.Builder addWarnings(int index, Build.Warning.Builder builderForValue)

Output only. Non-fatal problems encountered during the execution of the build.

repeated .google.devtools.cloudbuild.v1.Build.Warning warnings = 49 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameters
Name Description
index int
builderForValue Build.Warning.Builder
Returns
Type Description
Build.Builder

addWarningsBuilder()

public Build.Warning.Builder addWarningsBuilder()

Output only. Non-fatal problems encountered during the execution of the build.

repeated .google.devtools.cloudbuild.v1.Build.Warning warnings = 49 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Build.Warning.Builder

addWarningsBuilder(int index)

public Build.Warning.Builder addWarningsBuilder(int index)

Output only. Non-fatal problems encountered during the execution of the build.

repeated .google.devtools.cloudbuild.v1.Build.Warning warnings = 49 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
index int
Returns
Type Description
Build.Warning.Builder

build()

public Build build()
Returns
Type Description
Build

buildPartial()

public Build buildPartial()
Returns
Type Description
Build

clear()

public Build.Builder clear()
Returns
Type Description
Build.Builder
Overrides

clearApproval()

public Build.Builder clearApproval()

Output only. Describes this build's approval configuration, status, and result.

.google.devtools.cloudbuild.v1.BuildApproval approval = 44 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Build.Builder

clearArtifacts()

public Build.Builder clearArtifacts()

Artifacts produced by the build that should be uploaded upon successful completion of all build steps.

.google.devtools.cloudbuild.v1.Artifacts artifacts = 37;

Returns
Type Description
Build.Builder

clearAvailableSecrets()

public Build.Builder clearAvailableSecrets()

Secrets and secret environment variables.

.google.devtools.cloudbuild.v1.Secrets available_secrets = 47;

Returns
Type Description
Build.Builder

clearBuildTriggerId()

public Build.Builder clearBuildTriggerId()

Output only. The ID of the BuildTrigger that triggered this build, if it was triggered automatically.

string build_trigger_id = 22 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Build.Builder

This builder for chaining.

clearCreateTime()

public Build.Builder clearCreateTime()

Output only. Time at which the request to create the build was received.

.google.protobuf.Timestamp create_time = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Build.Builder

clearFailureInfo()

public Build.Builder clearFailureInfo()

Output only. Contains information about the build when status=FAILURE.

.google.devtools.cloudbuild.v1.Build.FailureInfo failure_info = 51 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Build.Builder

clearField(Descriptors.FieldDescriptor field)

public Build.Builder clearField(Descriptors.FieldDescriptor field)
Parameter
Name Description
field FieldDescriptor
Returns
Type Description
Build.Builder
Overrides

clearFinishTime()

public Build.Builder clearFinishTime()

Output only. 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.

.google.protobuf.Timestamp finish_time = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Build.Builder

clearId()

public Build.Builder clearId()

Output only. Unique identifier of the build.

string id = 1 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Build.Builder

This builder for chaining.

clearImages()

public Build.Builder clearImages()

A list of images to be pushed upon the successful completion of all build steps.

The images are 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 status is marked FAILURE.

repeated string images = 13;

Returns
Type Description
Build.Builder

This builder for chaining.

clearLogUrl()

public Build.Builder clearLogUrl()

Output only. URL to logs for this build in Google Cloud Console.

string log_url = 25 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Build.Builder

This builder for chaining.

clearLogsBucket()

public Build.Builder clearLogsBucket()

Cloud Storage bucket where logs should be written (see Bucket Name Requirements). Logs file names will be of the format ${logs_bucket}/log-${build_id}.txt.

string logs_bucket = 19;

Returns
Type Description
Build.Builder

This builder for chaining.

clearName()

public Build.Builder clearName()

Output only. The 'Build' name with format: projects/{project}/locations/{location}/builds/{build}, where {build} is a unique identifier generated by the service.

string name = 45 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Build.Builder

This builder for chaining.

clearOneof(Descriptors.OneofDescriptor oneof)

public Build.Builder clearOneof(Descriptors.OneofDescriptor oneof)
Parameter
Name Description
oneof OneofDescriptor
Returns
Type Description
Build.Builder
Overrides

clearOptions()

public Build.Builder clearOptions()

Special options for this build.

.google.devtools.cloudbuild.v1.BuildOptions options = 23;

Returns
Type Description
Build.Builder

clearProjectId()

public Build.Builder clearProjectId()

Output only. ID of the project.

string project_id = 16 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Build.Builder

This builder for chaining.

clearQueueTtl()

public Build.Builder clearQueueTtl()

TTL in queue for this build. If provided and the build is enqueued longer than this value, the build will expire and the build status will be EXPIRED.

The TTL starts ticking from create_time.

.google.protobuf.Duration queue_ttl = 40;

Returns
Type Description
Build.Builder

clearResults()

public Build.Builder clearResults()

Output only. Results of the build.

.google.devtools.cloudbuild.v1.Results results = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Build.Builder

clearSecrets()

public Build.Builder clearSecrets()

Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use available_secrets to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets

repeated .google.devtools.cloudbuild.v1.Secret secrets = 32;

Returns
Type Description
Build.Builder

clearServiceAccount()

public Build.Builder clearServiceAccount()

IAM service account whose credentials will be used at build runtime. Must be of the format projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}. ACCOUNT can be email address or uniqueId of the service account.

string service_account = 42 [(.google.api.resource_reference) = { ... }

Returns
Type Description
Build.Builder

This builder for chaining.

clearSource()

public Build.Builder clearSource()

The location of the source files to build.

.google.devtools.cloudbuild.v1.Source source = 3;

Returns
Type Description
Build.Builder

clearSourceProvenance()

public Build.Builder clearSourceProvenance()

Output only. A permanent fixed identifier for source.

.google.devtools.cloudbuild.v1.SourceProvenance source_provenance = 21 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Build.Builder

clearStartTime()

public Build.Builder clearStartTime()

Output only. Time at which execution of the build was started.

.google.protobuf.Timestamp start_time = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Build.Builder

clearStatus()

public Build.Builder clearStatus()

Output only. Status of the build.

.google.devtools.cloudbuild.v1.Build.Status status = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Build.Builder

This builder for chaining.

clearStatusDetail()

public Build.Builder clearStatusDetail()

Output only. Customer-readable message about the current status.

string status_detail = 24 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Build.Builder

This builder for chaining.

clearSteps()

public Build.Builder clearSteps()

Required. The operations to be performed on the workspace.

repeated .google.devtools.cloudbuild.v1.BuildStep steps = 11;

Returns
Type Description
Build.Builder

clearSubstitutions()

public Build.Builder clearSubstitutions()
Returns
Type Description
Build.Builder

clearTags()

public Build.Builder clearTags()

Tags for annotation of a Build. These are not docker tags.

repeated string tags = 31;

Returns
Type Description
Build.Builder

This builder for chaining.

clearTimeout()

public Build.Builder clearTimeout()

Amount of time that this build should be allowed to run, to second granularity. If this amount of time elapses, work on the build will cease and the build status will be TIMEOUT.

timeout starts ticking from startTime.

Default time is 60 minutes.

.google.protobuf.Duration timeout = 12;

Returns
Type Description
Build.Builder

clearTiming()

public Build.Builder clearTiming()
Returns
Type Description
Build.Builder

clearWarnings()

public Build.Builder clearWarnings()

Output only. Non-fatal problems encountered during the execution of the build.

repeated .google.devtools.cloudbuild.v1.Build.Warning warnings = 49 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Build.Builder

clone()

public Build.Builder clone()
Returns
Type Description
Build.Builder
Overrides

containsSubstitutions(String key)

public boolean containsSubstitutions(String key)

Substitutions data for Build resource.

map<string, string> substitutions = 29;

Parameter
Name Description
key String
Returns
Type Description
boolean

containsTiming(String key)

public boolean containsTiming(String key)

Output only. Stores timing information for phases of the build. Valid keys are:

  • BUILD: time to execute all build steps.
  • PUSH: time to push all artifacts including docker images and non docker artifacts.
  • FETCHSOURCE: time to fetch source.

  • SETUPBUILD: time to set up build.

    If the build does not specify source or images, these keys will not be included.

map<string, .google.devtools.cloudbuild.v1.TimeSpan> timing = 33 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
key String
Returns
Type Description
boolean

getApproval()

public BuildApproval getApproval()

Output only. Describes this build's approval configuration, status, and result.

.google.devtools.cloudbuild.v1.BuildApproval approval = 44 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
BuildApproval

The approval.

getApprovalBuilder()

public BuildApproval.Builder getApprovalBuilder()

Output only. Describes this build's approval configuration, status, and result.

.google.devtools.cloudbuild.v1.BuildApproval approval = 44 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
BuildApproval.Builder

getApprovalOrBuilder()

public BuildApprovalOrBuilder getApprovalOrBuilder()

Output only. Describes this build's approval configuration, status, and result.

.google.devtools.cloudbuild.v1.BuildApproval approval = 44 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
BuildApprovalOrBuilder

getArtifacts()

public Artifacts getArtifacts()

Artifacts produced by the build that should be uploaded upon successful completion of all build steps.

.google.devtools.cloudbuild.v1.Artifacts artifacts = 37;

Returns
Type Description
Artifacts

The artifacts.

getArtifactsBuilder()

public Artifacts.Builder getArtifactsBuilder()

Artifacts produced by the build that should be uploaded upon successful completion of all build steps.

.google.devtools.cloudbuild.v1.Artifacts artifacts = 37;

Returns
Type Description
Artifacts.Builder

getArtifactsOrBuilder()

public ArtifactsOrBuilder getArtifactsOrBuilder()

Artifacts produced by the build that should be uploaded upon successful completion of all build steps.

.google.devtools.cloudbuild.v1.Artifacts artifacts = 37;

Returns
Type Description
ArtifactsOrBuilder

getAvailableSecrets()

public Secrets getAvailableSecrets()

Secrets and secret environment variables.

.google.devtools.cloudbuild.v1.Secrets available_secrets = 47;

Returns
Type Description
Secrets

The availableSecrets.

getAvailableSecretsBuilder()

public Secrets.Builder getAvailableSecretsBuilder()

Secrets and secret environment variables.

.google.devtools.cloudbuild.v1.Secrets available_secrets = 47;

Returns
Type Description
Secrets.Builder

getAvailableSecretsOrBuilder()

public SecretsOrBuilder getAvailableSecretsOrBuilder()

Secrets and secret environment variables.

.google.devtools.cloudbuild.v1.Secrets available_secrets = 47;

Returns
Type Description
SecretsOrBuilder

getBuildTriggerId()

public String getBuildTriggerId()

Output only. The ID of the BuildTrigger that triggered this build, if it was triggered automatically.

string build_trigger_id = 22 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
String

The buildTriggerId.

getBuildTriggerIdBytes()

public ByteString getBuildTriggerIdBytes()

Output only. The ID of the BuildTrigger that triggered this build, if it was triggered automatically.

string build_trigger_id = 22 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
ByteString

The bytes for buildTriggerId.

getCreateTime()

public Timestamp getCreateTime()

Output only. Time at which the request to create the build was received.

.google.protobuf.Timestamp create_time = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Timestamp

The createTime.

getCreateTimeBuilder()

public Timestamp.Builder getCreateTimeBuilder()

Output only. Time at which the request to create the build was received.

.google.protobuf.Timestamp create_time = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Builder

getCreateTimeOrBuilder()

public TimestampOrBuilder getCreateTimeOrBuilder()

Output only. Time at which the request to create the build was received.

.google.protobuf.Timestamp create_time = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
TimestampOrBuilder

getDefaultInstanceForType()

public Build getDefaultInstanceForType()
Returns
Type Description
Build

getDescriptorForType()

public Descriptors.Descriptor getDescriptorForType()
Returns
Type Description
Descriptor
Overrides

getFailureInfo()

public Build.FailureInfo getFailureInfo()

Output only. Contains information about the build when status=FAILURE.

.google.devtools.cloudbuild.v1.Build.FailureInfo failure_info = 51 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Build.FailureInfo

The failureInfo.

getFailureInfoBuilder()

public Build.FailureInfo.Builder getFailureInfoBuilder()

Output only. Contains information about the build when status=FAILURE.

.google.devtools.cloudbuild.v1.Build.FailureInfo failure_info = 51 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Build.FailureInfo.Builder

getFailureInfoOrBuilder()

public Build.FailureInfoOrBuilder getFailureInfoOrBuilder()

Output only. Contains information about the build when status=FAILURE.

.google.devtools.cloudbuild.v1.Build.FailureInfo failure_info = 51 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Build.FailureInfoOrBuilder

getFinishTime()

public Timestamp getFinishTime()

Output only. 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.

.google.protobuf.Timestamp finish_time = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Timestamp

The finishTime.

getFinishTimeBuilder()

public Timestamp.Builder getFinishTimeBuilder()

Output only. 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.

.google.protobuf.Timestamp finish_time = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Builder

getFinishTimeOrBuilder()

public TimestampOrBuilder getFinishTimeOrBuilder()

Output only. 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.

.google.protobuf.Timestamp finish_time = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
TimestampOrBuilder

getId()

public String getId()

Output only. Unique identifier of the build.

string id = 1 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
String

The id.

getIdBytes()

public ByteString getIdBytes()

Output only. Unique identifier of the build.

string id = 1 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
ByteString

The bytes for id.

getImages(int index)

public String getImages(int index)

A list of images to be pushed upon the successful completion of all build steps.

The images are 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 status is marked FAILURE.

repeated string images = 13;

Parameter
Name Description
index int

The index of the element to return.
Returns
Type Description
String

The images at the given index.

getImagesBytes(int index)

public ByteString getImagesBytes(int index)

A list of images to be pushed upon the successful completion of all build steps.

The images are 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 status is marked FAILURE.

repeated string images = 13;

Parameter
Name Description
index int

The index of the value to return.
Returns
Type Description
ByteString

The bytes of the images at the given index.

getImagesCount()

public int getImagesCount()

A list of images to be pushed upon the successful completion of all build steps.

The images are 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 status is marked FAILURE.

repeated string images = 13;

Returns
Type Description
int

The count of images.

getImagesList()

public ProtocolStringList getImagesList()

A list of images to be pushed upon the successful completion of all build steps.

The images are 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 status is marked FAILURE.

repeated string images = 13;

Returns
Type Description
ProtocolStringList

A list containing the images.

getLogUrl()

public String getLogUrl()

Output only. URL to logs for this build in Google Cloud Console.

string log_url = 25 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
String

The logUrl.

getLogUrlBytes()

public ByteString getLogUrlBytes()

Output only. URL to logs for this build in Google Cloud Console.

string log_url = 25 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
ByteString

The bytes for logUrl.

getLogsBucket()

public String getLogsBucket()

Cloud Storage bucket where logs should be written (see Bucket Name Requirements). Logs file names will be of the format ${logs_bucket}/log-${build_id}.txt.

string logs_bucket = 19;

Returns
Type Description
String

The logsBucket.

getLogsBucketBytes()

public ByteString getLogsBucketBytes()

Cloud Storage bucket where logs should be written (see Bucket Name Requirements). Logs file names will be of the format ${logs_bucket}/log-${build_id}.txt.

string logs_bucket = 19;

Returns
Type Description
ByteString

The bytes for logsBucket.

getMutableSubstitutions() (deprecated)

public Map<String,String> getMutableSubstitutions()

Use alternate mutation accessors instead.

Returns
Type Description
Map<String,String>

getMutableTiming() (deprecated)

public Map<String,TimeSpan> getMutableTiming()

Use alternate mutation accessors instead.

Returns
Type Description
Map<String,TimeSpan>

getName()

public String getName()

Output only. The 'Build' name with format: projects/{project}/locations/{location}/builds/{build}, where {build} is a unique identifier generated by the service.

string name = 45 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
String

The name.

getNameBytes()

public ByteString getNameBytes()

Output only. The 'Build' name with format: projects/{project}/locations/{location}/builds/{build}, where {build} is a unique identifier generated by the service.

string name = 45 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
ByteString

The bytes for name.

getOptions()

public BuildOptions getOptions()

Special options for this build.

.google.devtools.cloudbuild.v1.BuildOptions options = 23;

Returns
Type Description
BuildOptions

The options.

getOptionsBuilder()

public BuildOptions.Builder getOptionsBuilder()

Special options for this build.

.google.devtools.cloudbuild.v1.BuildOptions options = 23;

Returns
Type Description
BuildOptions.Builder

getOptionsOrBuilder()

public BuildOptionsOrBuilder getOptionsOrBuilder()

Special options for this build.

.google.devtools.cloudbuild.v1.BuildOptions options = 23;

Returns
Type Description
BuildOptionsOrBuilder

getProjectId()

public String getProjectId()

Output only. ID of the project.

string project_id = 16 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
String

The projectId.

getProjectIdBytes()

public ByteString getProjectIdBytes()

Output only. ID of the project.

string project_id = 16 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
ByteString

The bytes for projectId.

getQueueTtl()

public Duration getQueueTtl()

TTL in queue for this build. If provided and the build is enqueued longer than this value, the build will expire and the build status will be EXPIRED.

The TTL starts ticking from create_time.

.google.protobuf.Duration queue_ttl = 40;

Returns
Type Description
Duration

The queueTtl.

getQueueTtlBuilder()

public Duration.Builder getQueueTtlBuilder()

TTL in queue for this build. If provided and the build is enqueued longer than this value, the build will expire and the build status will be EXPIRED.

The TTL starts ticking from create_time.

.google.protobuf.Duration queue_ttl = 40;

Returns
Type Description
Builder

getQueueTtlOrBuilder()

public DurationOrBuilder getQueueTtlOrBuilder()

TTL in queue for this build. If provided and the build is enqueued longer than this value, the build will expire and the build status will be EXPIRED.

The TTL starts ticking from create_time.

.google.protobuf.Duration queue_ttl = 40;

Returns
Type Description
DurationOrBuilder

getResults()

public Results getResults()

Output only. Results of the build.

.google.devtools.cloudbuild.v1.Results results = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Results

The results.

getResultsBuilder()

public Results.Builder getResultsBuilder()

Output only. Results of the build.

.google.devtools.cloudbuild.v1.Results results = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Results.Builder

getResultsOrBuilder()

public ResultsOrBuilder getResultsOrBuilder()

Output only. Results of the build.

.google.devtools.cloudbuild.v1.Results results = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
ResultsOrBuilder

getSecrets(int index)

public Secret getSecrets(int index)

Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use available_secrets to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets

repeated .google.devtools.cloudbuild.v1.Secret secrets = 32;

Parameter
Name Description
index int
Returns
Type Description
Secret

getSecretsBuilder(int index)

public Secret.Builder getSecretsBuilder(int index)

Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use available_secrets to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets

repeated .google.devtools.cloudbuild.v1.Secret secrets = 32;

Parameter
Name Description
index int
Returns
Type Description
Secret.Builder

getSecretsBuilderList()

public List<Secret.Builder> getSecretsBuilderList()

Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use available_secrets to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets

repeated .google.devtools.cloudbuild.v1.Secret secrets = 32;

Returns
Type Description
List<Builder>

getSecretsCount()

public int getSecretsCount()

Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use available_secrets to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets

repeated .google.devtools.cloudbuild.v1.Secret secrets = 32;

Returns
Type Description
int

getSecretsList()

public List<Secret> getSecretsList()

Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use available_secrets to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets

repeated .google.devtools.cloudbuild.v1.Secret secrets = 32;

Returns
Type Description
List<Secret>

getSecretsOrBuilder(int index)

public SecretOrBuilder getSecretsOrBuilder(int index)

Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use available_secrets to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets

repeated .google.devtools.cloudbuild.v1.Secret secrets = 32;

Parameter
Name Description
index int
Returns
Type Description
SecretOrBuilder

getSecretsOrBuilderList()

public List<? extends SecretOrBuilder> getSecretsOrBuilderList()

Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use available_secrets to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets

repeated .google.devtools.cloudbuild.v1.Secret secrets = 32;

Returns
Type Description
List<? extends com.google.cloudbuild.v1.SecretOrBuilder>

getServiceAccount()

public String getServiceAccount()

IAM service account whose credentials will be used at build runtime. Must be of the format projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}. ACCOUNT can be email address or uniqueId of the service account.

string service_account = 42 [(.google.api.resource_reference) = { ... }

Returns
Type Description
String

The serviceAccount.

getServiceAccountBytes()

public ByteString getServiceAccountBytes()

IAM service account whose credentials will be used at build runtime. Must be of the format projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}. ACCOUNT can be email address or uniqueId of the service account.

string service_account = 42 [(.google.api.resource_reference) = { ... }

Returns
Type Description
ByteString

The bytes for serviceAccount.

getSource()

public Source getSource()

The location of the source files to build.

.google.devtools.cloudbuild.v1.Source source = 3;

Returns
Type Description
Source

The source.

getSourceBuilder()

public Source.Builder getSourceBuilder()

The location of the source files to build.

.google.devtools.cloudbuild.v1.Source source = 3;

Returns
Type Description
Source.Builder

getSourceOrBuilder()

public SourceOrBuilder getSourceOrBuilder()

The location of the source files to build.

.google.devtools.cloudbuild.v1.Source source = 3;

Returns
Type Description
SourceOrBuilder

getSourceProvenance()

public SourceProvenance getSourceProvenance()

Output only. A permanent fixed identifier for source.

.google.devtools.cloudbuild.v1.SourceProvenance source_provenance = 21 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
SourceProvenance

The sourceProvenance.

getSourceProvenanceBuilder()

public SourceProvenance.Builder getSourceProvenanceBuilder()

Output only. A permanent fixed identifier for source.

.google.devtools.cloudbuild.v1.SourceProvenance source_provenance = 21 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
SourceProvenance.Builder

getSourceProvenanceOrBuilder()

public SourceProvenanceOrBuilder getSourceProvenanceOrBuilder()

Output only. A permanent fixed identifier for source.

.google.devtools.cloudbuild.v1.SourceProvenance source_provenance = 21 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
SourceProvenanceOrBuilder

getStartTime()

public Timestamp getStartTime()

Output only. Time at which execution of the build was started.

.google.protobuf.Timestamp start_time = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Timestamp

The startTime.

getStartTimeBuilder()

public Timestamp.Builder getStartTimeBuilder()

Output only. Time at which execution of the build was started.

.google.protobuf.Timestamp start_time = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Builder

getStartTimeOrBuilder()

public TimestampOrBuilder getStartTimeOrBuilder()

Output only. Time at which execution of the build was started.

.google.protobuf.Timestamp start_time = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
TimestampOrBuilder

getStatus()

public Build.Status getStatus()

Output only. Status of the build.

.google.devtools.cloudbuild.v1.Build.Status status = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Build.Status

The status.

getStatusDetail()

public String getStatusDetail()

Output only. Customer-readable message about the current status.

string status_detail = 24 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
String

The statusDetail.

getStatusDetailBytes()

public ByteString getStatusDetailBytes()

Output only. Customer-readable message about the current status.

string status_detail = 24 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
ByteString

The bytes for statusDetail.

getStatusValue()

public int getStatusValue()

Output only. Status of the build.

.google.devtools.cloudbuild.v1.Build.Status status = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
int

The enum numeric value on the wire for status.

getSteps(int index)

public BuildStep getSteps(int index)

Required. The operations to be performed on the workspace.

repeated .google.devtools.cloudbuild.v1.BuildStep steps = 11;

Parameter
Name Description
index int
Returns
Type Description
BuildStep

getStepsBuilder(int index)

public BuildStep.Builder getStepsBuilder(int index)

Required. The operations to be performed on the workspace.

repeated .google.devtools.cloudbuild.v1.BuildStep steps = 11;

Parameter
Name Description
index int
Returns
Type Description
BuildStep.Builder

getStepsBuilderList()

public List<BuildStep.Builder> getStepsBuilderList()

Required. The operations to be performed on the workspace.

repeated .google.devtools.cloudbuild.v1.BuildStep steps = 11;

Returns
Type Description
List<Builder>

getStepsCount()

public int getStepsCount()

Required. The operations to be performed on the workspace.

repeated .google.devtools.cloudbuild.v1.BuildStep steps = 11;

Returns
Type Description
int

getStepsList()

public List<BuildStep> getStepsList()

Required. The operations to be performed on the workspace.

repeated .google.devtools.cloudbuild.v1.BuildStep steps = 11;

Returns
Type Description
List<BuildStep>

getStepsOrBuilder(int index)

public BuildStepOrBuilder getStepsOrBuilder(int index)

Required. The operations to be performed on the workspace.

repeated .google.devtools.cloudbuild.v1.BuildStep steps = 11;

Parameter
Name Description
index int
Returns
Type Description
BuildStepOrBuilder

getStepsOrBuilderList()

public List<? extends BuildStepOrBuilder> getStepsOrBuilderList()

Required. The operations to be performed on the workspace.

repeated .google.devtools.cloudbuild.v1.BuildStep steps = 11;

Returns
Type Description
List<? extends com.google.cloudbuild.v1.BuildStepOrBuilder>

getSubstitutions() (deprecated)

public Map<String,String> getSubstitutions()

Use #getSubstitutionsMap() instead.

Returns
Type Description
Map<String,String>

getSubstitutionsCount()

public int getSubstitutionsCount()

Substitutions data for Build resource.

map<string, string> substitutions = 29;

Returns
Type Description
int

getSubstitutionsMap()

public Map<String,String> getSubstitutionsMap()

Substitutions data for Build resource.

map<string, string> substitutions = 29;

Returns
Type Description
Map<String,String>

getSubstitutionsOrDefault(String key, String defaultValue)

public String getSubstitutionsOrDefault(String key, String defaultValue)

Substitutions data for Build resource.

map<string, string> substitutions = 29;

Parameters
Name Description
key String
defaultValue String
Returns
Type Description
String

getSubstitutionsOrThrow(String key)

public String getSubstitutionsOrThrow(String key)

Substitutions data for Build resource.

map<string, string> substitutions = 29;

Parameter
Name Description
key String
Returns
Type Description
String

getTags(int index)

public String getTags(int index)

Tags for annotation of a Build. These are not docker tags.

repeated string tags = 31;

Parameter
Name Description
index int

The index of the element to return.
Returns
Type Description
String

The tags at the given index.

getTagsBytes(int index)

public ByteString getTagsBytes(int index)

Tags for annotation of a Build. These are not docker tags.

repeated string tags = 31;

Parameter
Name Description
index int

The index of the value to return.
Returns
Type Description
ByteString

The bytes of the tags at the given index.

getTagsCount()

public int getTagsCount()

Tags for annotation of a Build. These are not docker tags.

repeated string tags = 31;

Returns
Type Description
int

The count of tags.

getTagsList()

public ProtocolStringList getTagsList()

Tags for annotation of a Build. These are not docker tags.

repeated string tags = 31;

Returns
Type Description
ProtocolStringList

A list containing the tags.

getTimeout()

public Duration getTimeout()

Amount of time that this build should be allowed to run, to second granularity. If this amount of time elapses, work on the build will cease and the build status will be TIMEOUT.

timeout starts ticking from startTime.

Default time is 60 minutes.

.google.protobuf.Duration timeout = 12;

Returns
Type Description
Duration

The timeout.

getTimeoutBuilder()

public Duration.Builder getTimeoutBuilder()

Amount of time that this build should be allowed to run, to second granularity. If this amount of time elapses, work on the build will cease and the build status will be TIMEOUT.

timeout starts ticking from startTime.

Default time is 60 minutes.

.google.protobuf.Duration timeout = 12;

Returns
Type Description
Builder

getTimeoutOrBuilder()

public DurationOrBuilder getTimeoutOrBuilder()

Amount of time that this build should be allowed to run, to second granularity. If this amount of time elapses, work on the build will cease and the build status will be TIMEOUT.

timeout starts ticking from startTime.

Default time is 60 minutes.

.google.protobuf.Duration timeout = 12;

Returns
Type Description
DurationOrBuilder

getTiming() (deprecated)

public Map<String,TimeSpan> getTiming()

Use #getTimingMap() instead.

Returns
Type Description
Map<String,TimeSpan>

getTimingCount()

public int getTimingCount()

Output only. Stores timing information for phases of the build. Valid keys are:

  • BUILD: time to execute all build steps.
  • PUSH: time to push all artifacts including docker images and non docker artifacts.
  • FETCHSOURCE: time to fetch source.

  • SETUPBUILD: time to set up build.

    If the build does not specify source or images, these keys will not be included.

map<string, .google.devtools.cloudbuild.v1.TimeSpan> timing = 33 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
int

getTimingMap()

public Map<String,TimeSpan> getTimingMap()

Output only. Stores timing information for phases of the build. Valid keys are:

  • BUILD: time to execute all build steps.
  • PUSH: time to push all artifacts including docker images and non docker artifacts.
  • FETCHSOURCE: time to fetch source.

  • SETUPBUILD: time to set up build.

    If the build does not specify source or images, these keys will not be included.

map<string, .google.devtools.cloudbuild.v1.TimeSpan> timing = 33 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
Map<String,TimeSpan>

getTimingOrDefault(String key, TimeSpan defaultValue)

public TimeSpan getTimingOrDefault(String key, TimeSpan defaultValue)

Output only. Stores timing information for phases of the build. Valid keys are:

  • BUILD: time to execute all build steps.
  • PUSH: time to push all artifacts including docker images and non docker artifacts.
  • FETCHSOURCE: time to fetch source.

  • SETUPBUILD: time to set up build.

    If the build does not specify source or images, these keys will not be included.

map<string, .google.devtools.cloudbuild.v1.TimeSpan> timing = 33 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameters
Name Description
key String
defaultValue TimeSpan
Returns
Type Description
TimeSpan

getTimingOrThrow(String key)

public TimeSpan getTimingOrThrow(String key)

Output only. Stores timing information for phases of the build. Valid keys are:

  • BUILD: time to execute all build steps.
  • PUSH: time to push all artifacts including docker images and non docker artifacts.
  • FETCHSOURCE: time to fetch source.

  • SETUPBUILD: time to set up build.

    If the build does not specify source or images, these keys will not be included.

map<string, .google.devtools.cloudbuild.v1.TimeSpan> timing = 33 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
key String
Returns
Type Description
TimeSpan

getWarnings(int index)

public Build.Warning getWarnings(int index)

Output only. Non-fatal problems encountered during the execution of the build.

repeated .google.devtools.cloudbuild.v1.Build.Warning warnings = 49 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
index int
Returns
Type Description
Build.Warning

getWarningsBuilder(int index)

public Build.Warning.Builder getWarningsBuilder(int index)

Output only. Non-fatal problems encountered during the execution of the build.

repeated .google.devtools.cloudbuild.v1.Build.Warning warnings = 49 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
index int
Returns
Type Description
Build.Warning.Builder

getWarningsBuilderList()

public List<Build.Warning.Builder> getWarningsBuilderList()

Output only. Non-fatal problems encountered during the execution of the build.

repeated .google.devtools.cloudbuild.v1.Build.Warning warnings = 49 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
List<Builder>

getWarningsCount()

public int getWarningsCount()

Output only. Non-fatal problems encountered during the execution of the build.

repeated .google.devtools.cloudbuild.v1.Build.Warning warnings = 49 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
int

getWarningsList()

public List<Build.Warning> getWarningsList()

Output only. Non-fatal problems encountered during the execution of the build.

repeated .google.devtools.cloudbuild.v1.Build.Warning warnings = 49 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
List<Warning>

getWarningsOrBuilder(int index)

public Build.WarningOrBuilder getWarningsOrBuilder(int index)

Output only. Non-fatal problems encountered during the execution of the build.

repeated .google.devtools.cloudbuild.v1.Build.Warning warnings = 49 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
index int
Returns
Type Description
Build.WarningOrBuilder

getWarningsOrBuilderList()

public List<? extends Build.WarningOrBuilder> getWarningsOrBuilderList()

Output only. Non-fatal problems encountered during the execution of the build.

repeated .google.devtools.cloudbuild.v1.Build.Warning warnings = 49 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
List<? extends com.google.cloudbuild.v1.Build.WarningOrBuilder>

hasApproval()

public boolean hasApproval()

Output only. Describes this build's approval configuration, status, and result.

.google.devtools.cloudbuild.v1.BuildApproval approval = 44 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
boolean

Whether the approval field is set.

hasArtifacts()

public boolean hasArtifacts()

Artifacts produced by the build that should be uploaded upon successful completion of all build steps.

.google.devtools.cloudbuild.v1.Artifacts artifacts = 37;

Returns
Type Description
boolean

Whether the artifacts field is set.

hasAvailableSecrets()

public boolean hasAvailableSecrets()

Secrets and secret environment variables.

.google.devtools.cloudbuild.v1.Secrets available_secrets = 47;

Returns
Type Description
boolean

Whether the availableSecrets field is set.

hasCreateTime()

public boolean hasCreateTime()

Output only. Time at which the request to create the build was received.

.google.protobuf.Timestamp create_time = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
boolean

Whether the createTime field is set.

hasFailureInfo()

public boolean hasFailureInfo()

Output only. Contains information about the build when status=FAILURE.

.google.devtools.cloudbuild.v1.Build.FailureInfo failure_info = 51 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
boolean

Whether the failureInfo field is set.

hasFinishTime()

public boolean hasFinishTime()

Output only. 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.

.google.protobuf.Timestamp finish_time = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
boolean

Whether the finishTime field is set.

hasOptions()

public boolean hasOptions()

Special options for this build.

.google.devtools.cloudbuild.v1.BuildOptions options = 23;

Returns
Type Description
boolean

Whether the options field is set.

hasQueueTtl()

public boolean hasQueueTtl()

TTL in queue for this build. If provided and the build is enqueued longer than this value, the build will expire and the build status will be EXPIRED.

The TTL starts ticking from create_time.

.google.protobuf.Duration queue_ttl = 40;

Returns
Type Description
boolean

Whether the queueTtl field is set.

hasResults()

public boolean hasResults()

Output only. Results of the build.

.google.devtools.cloudbuild.v1.Results results = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
boolean

Whether the results field is set.

hasSource()

public boolean hasSource()

The location of the source files to build.

.google.devtools.cloudbuild.v1.Source source = 3;

Returns
Type Description
boolean

Whether the source field is set.

hasSourceProvenance()

public boolean hasSourceProvenance()

Output only. A permanent fixed identifier for source.

.google.devtools.cloudbuild.v1.SourceProvenance source_provenance = 21 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
boolean

Whether the sourceProvenance field is set.

hasStartTime()

public boolean hasStartTime()

Output only. Time at which execution of the build was started.

.google.protobuf.Timestamp start_time = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type Description
boolean

Whether the startTime field is set.

hasTimeout()

public boolean hasTimeout()

Amount of time that this build should be allowed to run, to second granularity. If this amount of time elapses, work on the build will cease and the build status will be TIMEOUT.

timeout starts ticking from startTime.

Default time is 60 minutes.

.google.protobuf.Duration timeout = 12;

Returns
Type Description
boolean

Whether the timeout field is set.

internalGetFieldAccessorTable()

protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
Type Description
FieldAccessorTable
Overrides

internalGetMapFieldReflection(int number)

protected MapFieldReflectionAccessor internalGetMapFieldReflection(int number)
Parameter
Name Description
number int
Returns
Type Description
com.google.protobuf.MapFieldReflectionAccessor
Overrides
com.google.protobuf.GeneratedMessageV3.Builder.internalGetMapFieldReflection(int)

internalGetMutableMapFieldReflection(int number)

protected MapFieldReflectionAccessor internalGetMutableMapFieldReflection(int number)
Parameter
Name Description
number int
Returns
Type Description
com.google.protobuf.MapFieldReflectionAccessor
Overrides
com.google.protobuf.GeneratedMessageV3.Builder.internalGetMutableMapFieldReflection(int)

isInitialized()

public final boolean isInitialized()
Returns
Type Description
boolean
Overrides

mergeApproval(BuildApproval value)

public Build.Builder mergeApproval(BuildApproval value)

Output only. Describes this build's approval configuration, status, and result.

.google.devtools.cloudbuild.v1.BuildApproval approval = 44 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value BuildApproval
Returns
Type Description
Build.Builder

mergeArtifacts(Artifacts value)

public Build.Builder mergeArtifacts(Artifacts value)

Artifacts produced by the build that should be uploaded upon successful completion of all build steps.

.google.devtools.cloudbuild.v1.Artifacts artifacts = 37;

Parameter
Name Description
value Artifacts
Returns
Type Description
Build.Builder

mergeAvailableSecrets(Secrets value)

public Build.Builder mergeAvailableSecrets(Secrets value)

Secrets and secret environment variables.

.google.devtools.cloudbuild.v1.Secrets available_secrets = 47;

Parameter
Name Description
value Secrets
Returns
Type Description
Build.Builder

mergeCreateTime(Timestamp value)

public Build.Builder mergeCreateTime(Timestamp value)

Output only. Time at which the request to create the build was received.

.google.protobuf.Timestamp create_time = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value Timestamp
Returns
Type Description
Build.Builder

mergeFailureInfo(Build.FailureInfo value)

public Build.Builder mergeFailureInfo(Build.FailureInfo value)

Output only. Contains information about the build when status=FAILURE.

.google.devtools.cloudbuild.v1.Build.FailureInfo failure_info = 51 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value Build.FailureInfo
Returns
Type Description
Build.Builder

mergeFinishTime(Timestamp value)

public Build.Builder mergeFinishTime(Timestamp value)

Output only. 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.

.google.protobuf.Timestamp finish_time = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value Timestamp
Returns
Type Description
Build.Builder

mergeFrom(Build other)

public Build.Builder mergeFrom(Build other)
Parameter
Name Description
other Build
Returns
Type Description
Build.Builder

mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public Build.Builder mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
input CodedInputStream
extensionRegistry ExtensionRegistryLite
Returns
Type Description
Build.Builder
Overrides
Exceptions
Type Description
IOException

mergeFrom(Message other)

public Build.Builder mergeFrom(Message other)
Parameter
Name Description
other Message
Returns
Type Description
Build.Builder
Overrides

mergeOptions(BuildOptions value)

public Build.Builder mergeOptions(BuildOptions value)

Special options for this build.

.google.devtools.cloudbuild.v1.BuildOptions options = 23;

Parameter
Name Description
value BuildOptions
Returns
Type Description
Build.Builder

mergeQueueTtl(Duration value)

public Build.Builder mergeQueueTtl(Duration value)

TTL in queue for this build. If provided and the build is enqueued longer than this value, the build will expire and the build status will be EXPIRED.

The TTL starts ticking from create_time.

.google.protobuf.Duration queue_ttl = 40;

Parameter
Name Description
value Duration
Returns
Type Description
Build.Builder

mergeResults(Results value)

public Build.Builder mergeResults(Results value)

Output only. Results of the build.

.google.devtools.cloudbuild.v1.Results results = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value Results
Returns
Type Description
Build.Builder

mergeSource(Source value)

public Build.Builder mergeSource(Source value)

The location of the source files to build.

.google.devtools.cloudbuild.v1.Source source = 3;

Parameter
Name Description
value Source
Returns
Type Description
Build.Builder

mergeSourceProvenance(SourceProvenance value)

public Build.Builder mergeSourceProvenance(SourceProvenance value)

Output only. A permanent fixed identifier for source.

.google.devtools.cloudbuild.v1.SourceProvenance source_provenance = 21 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value SourceProvenance
Returns
Type Description
Build.Builder

mergeStartTime(Timestamp value)

public Build.Builder mergeStartTime(Timestamp value)

Output only. Time at which execution of the build was started.

.google.protobuf.Timestamp start_time = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value Timestamp
Returns
Type Description
Build.Builder

mergeTimeout(Duration value)

public Build.Builder mergeTimeout(Duration value)

Amount of time that this build should be allowed to run, to second granularity. If this amount of time elapses, work on the build will cease and the build status will be TIMEOUT.

timeout starts ticking from startTime.

Default time is 60 minutes.

.google.protobuf.Duration timeout = 12;

Parameter
Name Description
value Duration
Returns
Type Description
Build.Builder

mergeUnknownFields(UnknownFieldSet unknownFields)

public final Build.Builder mergeUnknownFields(UnknownFieldSet unknownFields)
Parameter
Name Description
unknownFields UnknownFieldSet
Returns
Type Description
Build.Builder
Overrides

putAllSubstitutions(Map<String,String> values)

public Build.Builder putAllSubstitutions(Map<String,String> values)

Substitutions data for Build resource.

map<string, string> substitutions = 29;

Parameter
Name Description
values Map<String,String>
Returns
Type Description
Build.Builder

putAllTiming(Map<String,TimeSpan> values)

public Build.Builder putAllTiming(Map<String,TimeSpan> values)

Output only. Stores timing information for phases of the build. Valid keys are:

  • BUILD: time to execute all build steps.
  • PUSH: time to push all artifacts including docker images and non docker artifacts.
  • FETCHSOURCE: time to fetch source.

  • SETUPBUILD: time to set up build.

    If the build does not specify source or images, these keys will not be included.

map<string, .google.devtools.cloudbuild.v1.TimeSpan> timing = 33 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
values Map<String,TimeSpan>
Returns
Type Description
Build.Builder

putSubstitutions(String key, String value)

public Build.Builder putSubstitutions(String key, String value)

Substitutions data for Build resource.

map<string, string> substitutions = 29;

Parameters
Name Description
key String
value String
Returns
Type Description
Build.Builder

putTiming(String key, TimeSpan value)

public Build.Builder putTiming(String key, TimeSpan value)

Output only. Stores timing information for phases of the build. Valid keys are:

  • BUILD: time to execute all build steps.
  • PUSH: time to push all artifacts including docker images and non docker artifacts.
  • FETCHSOURCE: time to fetch source.

  • SETUPBUILD: time to set up build.

    If the build does not specify source or images, these keys will not be included.

map<string, .google.devtools.cloudbuild.v1.TimeSpan> timing = 33 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameters
Name Description
key String
value TimeSpan
Returns
Type Description
Build.Builder

putTimingBuilderIfAbsent(String key)

public TimeSpan.Builder putTimingBuilderIfAbsent(String key)

Output only. Stores timing information for phases of the build. Valid keys are:

  • BUILD: time to execute all build steps.
  • PUSH: time to push all artifacts including docker images and non docker artifacts.
  • FETCHSOURCE: time to fetch source.

  • SETUPBUILD: time to set up build.

    If the build does not specify source or images, these keys will not be included.

map<string, .google.devtools.cloudbuild.v1.TimeSpan> timing = 33 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
key String
Returns
Type Description
TimeSpan.Builder

removeSecrets(int index)

public Build.Builder removeSecrets(int index)

Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use available_secrets to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets

repeated .google.devtools.cloudbuild.v1.Secret secrets = 32;

Parameter
Name Description
index int
Returns
Type Description
Build.Builder

removeSteps(int index)

public Build.Builder removeSteps(int index)

Required. The operations to be performed on the workspace.

repeated .google.devtools.cloudbuild.v1.BuildStep steps = 11;

Parameter
Name Description
index int
Returns
Type Description
Build.Builder

removeSubstitutions(String key)

public Build.Builder removeSubstitutions(String key)

Substitutions data for Build resource.

map<string, string> substitutions = 29;

Parameter
Name Description
key String
Returns
Type Description
Build.Builder

removeTiming(String key)

public Build.Builder removeTiming(String key)

Output only. Stores timing information for phases of the build. Valid keys are:

  • BUILD: time to execute all build steps.
  • PUSH: time to push all artifacts including docker images and non docker artifacts.
  • FETCHSOURCE: time to fetch source.

  • SETUPBUILD: time to set up build.

    If the build does not specify source or images, these keys will not be included.

map<string, .google.devtools.cloudbuild.v1.TimeSpan> timing = 33 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
key String
Returns
Type Description
Build.Builder

removeWarnings(int index)

public Build.Builder removeWarnings(int index)

Output only. Non-fatal problems encountered during the execution of the build.

repeated .google.devtools.cloudbuild.v1.Build.Warning warnings = 49 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
index int
Returns
Type Description
Build.Builder

setApproval(BuildApproval value)

public Build.Builder setApproval(BuildApproval value)

Output only. Describes this build's approval configuration, status, and result.

.google.devtools.cloudbuild.v1.BuildApproval approval = 44 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value BuildApproval
Returns
Type Description
Build.Builder

setApproval(BuildApproval.Builder builderForValue)

public Build.Builder setApproval(BuildApproval.Builder builderForValue)

Output only. Describes this build's approval configuration, status, and result.

.google.devtools.cloudbuild.v1.BuildApproval approval = 44 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
builderForValue BuildApproval.Builder
Returns
Type Description
Build.Builder

setArtifacts(Artifacts value)

public Build.Builder setArtifacts(Artifacts value)

Artifacts produced by the build that should be uploaded upon successful completion of all build steps.

.google.devtools.cloudbuild.v1.Artifacts artifacts = 37;

Parameter
Name Description
value Artifacts
Returns
Type Description
Build.Builder

setArtifacts(Artifacts.Builder builderForValue)

public Build.Builder setArtifacts(Artifacts.Builder builderForValue)

Artifacts produced by the build that should be uploaded upon successful completion of all build steps.

.google.devtools.cloudbuild.v1.Artifacts artifacts = 37;

Parameter
Name Description
builderForValue Artifacts.Builder
Returns
Type Description
Build.Builder

setAvailableSecrets(Secrets value)

public Build.Builder setAvailableSecrets(Secrets value)

Secrets and secret environment variables.

.google.devtools.cloudbuild.v1.Secrets available_secrets = 47;

Parameter
Name Description
value Secrets
Returns
Type Description
Build.Builder

setAvailableSecrets(Secrets.Builder builderForValue)

public Build.Builder setAvailableSecrets(Secrets.Builder builderForValue)

Secrets and secret environment variables.

.google.devtools.cloudbuild.v1.Secrets available_secrets = 47;

Parameter
Name Description
builderForValue Secrets.Builder
Returns
Type Description
Build.Builder

setBuildTriggerId(String value)

public Build.Builder setBuildTriggerId(String value)

Output only. The ID of the BuildTrigger that triggered this build, if it was triggered automatically.

string build_trigger_id = 22 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value String

The buildTriggerId to set.
Returns
Type Description
Build.Builder

This builder for chaining.

setBuildTriggerIdBytes(ByteString value)

public Build.Builder setBuildTriggerIdBytes(ByteString value)

Output only. The ID of the BuildTrigger that triggered this build, if it was triggered automatically.

string build_trigger_id = 22 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value ByteString

The bytes for buildTriggerId to set.
Returns
Type Description
Build.Builder

This builder for chaining.

setCreateTime(Timestamp value)

public Build.Builder setCreateTime(Timestamp value)

Output only. Time at which the request to create the build was received.

.google.protobuf.Timestamp create_time = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value Timestamp
Returns
Type Description
Build.Builder

setCreateTime(Timestamp.Builder builderForValue)

public Build.Builder setCreateTime(Timestamp.Builder builderForValue)

Output only. Time at which the request to create the build was received.

.google.protobuf.Timestamp create_time = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
builderForValue Builder
Returns
Type Description
Build.Builder

setFailureInfo(Build.FailureInfo value)

public Build.Builder setFailureInfo(Build.FailureInfo value)

Output only. Contains information about the build when status=FAILURE.

.google.devtools.cloudbuild.v1.Build.FailureInfo failure_info = 51 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value Build.FailureInfo
Returns
Type Description
Build.Builder

setFailureInfo(Build.FailureInfo.Builder builderForValue)

public Build.Builder setFailureInfo(Build.FailureInfo.Builder builderForValue)

Output only. Contains information about the build when status=FAILURE.

.google.devtools.cloudbuild.v1.Build.FailureInfo failure_info = 51 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
builderForValue Build.FailureInfo.Builder
Returns
Type Description
Build.Builder

setField(Descriptors.FieldDescriptor field, Object value)

public Build.Builder setField(Descriptors.FieldDescriptor field, Object value)
Parameters
Name Description
field FieldDescriptor
value Object
Returns
Type Description
Build.Builder
Overrides

setFinishTime(Timestamp value)

public Build.Builder setFinishTime(Timestamp value)

Output only. 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.

.google.protobuf.Timestamp finish_time = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value Timestamp
Returns
Type Description
Build.Builder

setFinishTime(Timestamp.Builder builderForValue)

public Build.Builder setFinishTime(Timestamp.Builder builderForValue)

Output only. 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.

.google.protobuf.Timestamp finish_time = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
builderForValue Builder
Returns
Type Description
Build.Builder

setId(String value)

public Build.Builder setId(String value)

Output only. Unique identifier of the build.

string id = 1 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value String

The id to set.
Returns
Type Description
Build.Builder

This builder for chaining.

setIdBytes(ByteString value)

public Build.Builder setIdBytes(ByteString value)

Output only. Unique identifier of the build.

string id = 1 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value ByteString

The bytes for id to set.
Returns
Type Description
Build.Builder

This builder for chaining.

setImages(int index, String value)

public Build.Builder setImages(int index, String value)

A list of images to be pushed upon the successful completion of all build steps.

The images are 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 status is marked FAILURE.

repeated string images = 13;

Parameters
Name Description
index int

The index to set the value at.
value String

The images to set.
Returns
Type Description
Build.Builder

This builder for chaining.

setLogUrl(String value)

public Build.Builder setLogUrl(String value)

Output only. URL to logs for this build in Google Cloud Console.

string log_url = 25 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value String

The logUrl to set.
Returns
Type Description
Build.Builder

This builder for chaining.

setLogUrlBytes(ByteString value)

public Build.Builder setLogUrlBytes(ByteString value)

Output only. URL to logs for this build in Google Cloud Console.

string log_url = 25 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value ByteString

The bytes for logUrl to set.
Returns
Type Description
Build.Builder

This builder for chaining.

setLogsBucket(String value)

public Build.Builder setLogsBucket(String value)

Cloud Storage bucket where logs should be written (see Bucket Name Requirements). Logs file names will be of the format ${logs_bucket}/log-${build_id}.txt.

string logs_bucket = 19;

Parameter
Name Description
value String

The logsBucket to set.
Returns
Type Description
Build.Builder

This builder for chaining.

setLogsBucketBytes(ByteString value)

public Build.Builder setLogsBucketBytes(ByteString value)

Cloud Storage bucket where logs should be written (see Bucket Name Requirements). Logs file names will be of the format ${logs_bucket}/log-${build_id}.txt.

string logs_bucket = 19;

Parameter
Name Description
value ByteString

The bytes for logsBucket to set.
Returns
Type Description
Build.Builder

This builder for chaining.

setName(String value)

public Build.Builder setName(String value)

Output only. The 'Build' name with format: projects/{project}/locations/{location}/builds/{build}, where {build} is a unique identifier generated by the service.

string name = 45 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value String

The name to set.
Returns
Type Description
Build.Builder

This builder for chaining.

setNameBytes(ByteString value)

public Build.Builder setNameBytes(ByteString value)

Output only. The 'Build' name with format: projects/{project}/locations/{location}/builds/{build}, where {build} is a unique identifier generated by the service.

string name = 45 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value ByteString

The bytes for name to set.
Returns
Type Description
Build.Builder

This builder for chaining.

setOptions(BuildOptions value)

public Build.Builder setOptions(BuildOptions value)

Special options for this build.

.google.devtools.cloudbuild.v1.BuildOptions options = 23;

Parameter
Name Description
value BuildOptions
Returns
Type Description
Build.Builder

setOptions(BuildOptions.Builder builderForValue)

public Build.Builder setOptions(BuildOptions.Builder builderForValue)

Special options for this build.

.google.devtools.cloudbuild.v1.BuildOptions options = 23;

Parameter
Name Description
builderForValue BuildOptions.Builder
Returns
Type Description
Build.Builder

setProjectId(String value)

public Build.Builder setProjectId(String value)

Output only. ID of the project.

string project_id = 16 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value String

The projectId to set.
Returns
Type Description
Build.Builder

This builder for chaining.

setProjectIdBytes(ByteString value)

public Build.Builder setProjectIdBytes(ByteString value)

Output only. ID of the project.

string project_id = 16 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value ByteString

The bytes for projectId to set.
Returns
Type Description
Build.Builder

This builder for chaining.

setQueueTtl(Duration value)

public Build.Builder setQueueTtl(Duration value)

TTL in queue for this build. If provided and the build is enqueued longer than this value, the build will expire and the build status will be EXPIRED.

The TTL starts ticking from create_time.

.google.protobuf.Duration queue_ttl = 40;

Parameter
Name Description
value Duration
Returns
Type Description
Build.Builder

setQueueTtl(Duration.Builder builderForValue)

public Build.Builder setQueueTtl(Duration.Builder builderForValue)

TTL in queue for this build. If provided and the build is enqueued longer than this value, the build will expire and the build status will be EXPIRED.

The TTL starts ticking from create_time.

.google.protobuf.Duration queue_ttl = 40;

Parameter
Name Description
builderForValue Builder
Returns
Type Description
Build.Builder

setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)

public Build.Builder setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)
Parameters
Name Description
field FieldDescriptor
index int
value Object
Returns
Type Description
Build.Builder
Overrides

setResults(Results value)

public Build.Builder setResults(Results value)

Output only. Results of the build.

.google.devtools.cloudbuild.v1.Results results = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value Results
Returns
Type Description
Build.Builder

setResults(Results.Builder builderForValue)

public Build.Builder setResults(Results.Builder builderForValue)

Output only. Results of the build.

.google.devtools.cloudbuild.v1.Results results = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
builderForValue Results.Builder
Returns
Type Description
Build.Builder

setSecrets(int index, Secret value)

public Build.Builder setSecrets(int index, Secret value)

Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use available_secrets to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets

repeated .google.devtools.cloudbuild.v1.Secret secrets = 32;

Parameters
Name Description
index int
value Secret
Returns
Type Description
Build.Builder

setSecrets(int index, Secret.Builder builderForValue)

public Build.Builder setSecrets(int index, Secret.Builder builderForValue)

Secrets to decrypt using Cloud Key Management Service. Note: Secret Manager is the recommended technique for managing sensitive data with Cloud Build. Use available_secrets to configure builds to access secrets from Secret Manager. For instructions, see: https://cloud.google.com/cloud-build/docs/securing-builds/use-secrets

repeated .google.devtools.cloudbuild.v1.Secret secrets = 32;

Parameters
Name Description
index int
builderForValue Secret.Builder
Returns
Type Description
Build.Builder

setServiceAccount(String value)

public Build.Builder setServiceAccount(String value)

IAM service account whose credentials will be used at build runtime. Must be of the format projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}. ACCOUNT can be email address or uniqueId of the service account.

string service_account = 42 [(.google.api.resource_reference) = { ... }

Parameter
Name Description
value String

The serviceAccount to set.
Returns
Type Description
Build.Builder

This builder for chaining.

setServiceAccountBytes(ByteString value)

public Build.Builder setServiceAccountBytes(ByteString value)

IAM service account whose credentials will be used at build runtime. Must be of the format projects/{PROJECT_ID}/serviceAccounts/{ACCOUNT}. ACCOUNT can be email address or uniqueId of the service account.

string service_account = 42 [(.google.api.resource_reference) = { ... }

Parameter
Name Description
value ByteString

The bytes for serviceAccount to set.
Returns
Type Description
Build.Builder

This builder for chaining.

setSource(Source value)

public Build.Builder setSource(Source value)

The location of the source files to build.

.google.devtools.cloudbuild.v1.Source source = 3;

Parameter
Name Description
value Source
Returns
Type Description
Build.Builder

setSource(Source.Builder builderForValue)

public Build.Builder setSource(Source.Builder builderForValue)

The location of the source files to build.

.google.devtools.cloudbuild.v1.Source source = 3;

Parameter
Name Description
builderForValue Source.Builder
Returns
Type Description
Build.Builder

setSourceProvenance(SourceProvenance value)

public Build.Builder setSourceProvenance(SourceProvenance value)

Output only. A permanent fixed identifier for source.

.google.devtools.cloudbuild.v1.SourceProvenance source_provenance = 21 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value SourceProvenance
Returns
Type Description
Build.Builder

setSourceProvenance(SourceProvenance.Builder builderForValue)

public Build.Builder setSourceProvenance(SourceProvenance.Builder builderForValue)

Output only. A permanent fixed identifier for source.

.google.devtools.cloudbuild.v1.SourceProvenance source_provenance = 21 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
builderForValue SourceProvenance.Builder
Returns
Type Description
Build.Builder

setStartTime(Timestamp value)

public Build.Builder setStartTime(Timestamp value)

Output only. Time at which execution of the build was started.

.google.protobuf.Timestamp start_time = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value Timestamp
Returns
Type Description
Build.Builder

setStartTime(Timestamp.Builder builderForValue)

public Build.Builder setStartTime(Timestamp.Builder builderForValue)

Output only. Time at which execution of the build was started.

.google.protobuf.Timestamp start_time = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
builderForValue Builder
Returns
Type Description
Build.Builder

setStatus(Build.Status value)

public Build.Builder setStatus(Build.Status value)

Output only. Status of the build.

.google.devtools.cloudbuild.v1.Build.Status status = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value Build.Status

The status to set.
Returns
Type Description
Build.Builder

This builder for chaining.

setStatusDetail(String value)

public Build.Builder setStatusDetail(String value)

Output only. Customer-readable message about the current status.

string status_detail = 24 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value String

The statusDetail to set.
Returns
Type Description
Build.Builder

This builder for chaining.

setStatusDetailBytes(ByteString value)

public Build.Builder setStatusDetailBytes(ByteString value)

Output only. Customer-readable message about the current status.

string status_detail = 24 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value ByteString

The bytes for statusDetail to set.
Returns
Type Description
Build.Builder

This builder for chaining.

setStatusValue(int value)

public Build.Builder setStatusValue(int value)

Output only. Status of the build.

.google.devtools.cloudbuild.v1.Build.Status status = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name Description
value int

The enum numeric value on the wire for status to set.
Returns
Type Description
Build.Builder

This builder for chaining.

setSteps(int index, BuildStep value)

public Build.Builder setSteps(int index, BuildStep value)

Required. The operations to be performed on the workspace.

repeated .google.devtools.cloudbuild.v1.BuildStep steps = 11;

Parameters
Name Description
index int
value BuildStep
Returns
Type Description
Build.Builder

setSteps(int index, BuildStep.Builder builderForValue)

public Build.Builder setSteps(int index, BuildStep.Builder builderForValue)

Required. The operations to be performed on the workspace.

repeated .google.devtools.cloudbuild.v1.BuildStep steps = 11;

Parameters
Name Description
index int
builderForValue BuildStep.Builder
Returns
Type Description
Build.Builder

setTags(int index, String value)

public Build.Builder setTags(int index, String value)

Tags for annotation of a Build. These are not docker tags.

repeated string tags = 31;

Parameters
Name Description
index int

The index to set the value at.
value String

The tags to set.
Returns
Type Description
Build.Builder

This builder for chaining.

setTimeout(Duration value)

public Build.Builder setTimeout(Duration value)

Amount of time that this build should be allowed to run, to second granularity. If this amount of time elapses, work on the build will cease and the build status will be TIMEOUT.

timeout starts ticking from startTime.

Default time is 60 minutes.

.google.protobuf.Duration timeout = 12;

Parameter
Name Description
value Duration
Returns
Type Description
Build.Builder

setTimeout(Duration.Builder builderForValue)

public Build.Builder setTimeout(Duration.Builder builderForValue)

Amount of time that this build should be allowed to run, to second granularity. If this amount of time elapses, work on the build will cease and the build status will be TIMEOUT.

timeout starts ticking from startTime.

Default time is 60 minutes.

.google.protobuf.Duration timeout = 12;

Parameter
Name Description
builderForValue Builder
Returns
Type Description
Build.Builder

setUnknownFields(UnknownFieldSet unknownFields)

public final Build.Builder setUnknownFields(UnknownFieldSet unknownFields)
Parameter
Name Description
unknownFields UnknownFieldSet
Returns
Type Description
Build.Builder
Overrides

setWarnings(int index, Build.Warning value)

public Build.Builder setWarnings(int index, Build.Warning value)

Output only. Non-fatal problems encountered during the execution of the build.

repeated .google.devtools.cloudbuild.v1.Build.Warning warnings = 49 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameters
Name Description
index int
value Build.Warning
Returns
Type Description
Build.Builder

setWarnings(int index, Build.Warning.Builder builderForValue)

public Build.Builder setWarnings(int index, Build.Warning.Builder builderForValue)

Output only. Non-fatal problems encountered during the execution of the build.

repeated .google.devtools.cloudbuild.v1.Build.Warning warnings = 49 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameters
Name Description
index int
builderForValue Build.Warning.Builder
Returns
Type Description
Build.Builder