Build (AWS Java SDK :: Services :: AWS Code Build 2.16.60 API)

java.lang.Object
- software.amazon.awssdk.services.codebuild.model.Build

All Implemented Interfaces:: Serializable, SdkPojo, ToCopyableBuilder<Build.Builder,Build>

@Generated(value="software.amazon.awssdk:codegen")
public final class Build
extends Object
implements SdkPojo, Serializable, ToCopyableBuilder<Build.Builder,Build>

Information about a build.

See Also:: Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static interface Build.Builder

Nested Classes
Modifier and Type	Class and Description
`static interface`	`Build.Builder`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`String`	`arn()` The Amazon Resource Name (ARN) of the build.
`BuildArtifacts`	`artifacts()` Information about the output artifacts for the build.
`String`	`buildBatchArn()` The ARN of the batch build that this build is a member of, if applicable.
`Boolean`	`buildComplete()` Whether the build is complete.
`static Build.Builder`	`builder()`
`Long`	`buildNumber()` The number of the build.
`StatusType`	`buildStatus()` The current status of the build.
`String`	`buildStatusAsString()` The current status of the build.
`ProjectCache`	`cache()` Information about the cache for the build.
`String`	`currentPhase()` The current build phase.
`DebugSession`	`debugSession()` Contains information about the debug session for this build.
`String`	`encryptionKey()` The AWS Key Management Service (AWS KMS) customer master key (CMK) to be used for encrypting the build output artifacts.
`Instant`	`endTime()` When the build process ended, expressed in Unix time format.
`ProjectEnvironment`	`environment()` Information about the build environment for this build.
`boolean`	`equals(Object obj)`
`boolean`	`equalsBySdkFields(Object obj)`
`List<ExportedEnvironmentVariable>`	`exportedEnvironmentVariables()` A list of exported environment variables for this build.
`List<ProjectFileSystemLocation>`	`fileSystemLocations()` An array of `ProjectFileSystemLocation` objects for a CodeBuild build project.
`<T> Optional<T>`	`getValueForField(String fieldName, Class<T> clazz)`
`boolean`	`hasExportedEnvironmentVariables()` Returns true if the ExportedEnvironmentVariables property was specified by the sender (it may be empty), or false if the sender did not specify the value (it will be empty).
`boolean`	`hasFileSystemLocations()` Returns true if the FileSystemLocations property was specified by the sender (it may be empty), or false if the sender did not specify the value (it will be empty).
`int`	`hashCode()`
`boolean`	`hasPhases()` Returns true if the Phases property was specified by the sender (it may be empty), or false if the sender did not specify the value (it will be empty).
`boolean`	`hasReportArns()` Returns true if the ReportArns property was specified by the sender (it may be empty), or false if the sender did not specify the value (it will be empty).
`boolean`	`hasSecondaryArtifacts()` Returns true if the SecondaryArtifacts property was specified by the sender (it may be empty), or false if the sender did not specify the value (it will be empty).
`boolean`	`hasSecondarySources()` Returns true if the SecondarySources property was specified by the sender (it may be empty), or false if the sender did not specify the value (it will be empty).
`boolean`	`hasSecondarySourceVersions()` Returns true if the SecondarySourceVersions property was specified by the sender (it may be empty), or false if the sender did not specify the value (it will be empty).
`String`	`id()` The unique ID for the build.
`String`	`initiator()` The entity that started the build.
`LogsLocation`	`logs()` Information about the build's logs in Amazon CloudWatch Logs.
`NetworkInterface`	`networkInterface()` Describes a network interface.
`List<BuildPhase>`	`phases()` Information about all previous build phases that are complete and information about any current build phase that is not yet complete.
`String`	`projectName()` The name of the AWS CodeBuild project.
`Integer`	`queuedTimeoutInMinutes()` The number of minutes a build is allowed to be queued before it times out.
`List<String>`	`reportArns()` An array of the ARNs associated with this build's reports.
`String`	`resolvedSourceVersion()` An identifier for the version of this build's source code.
`List<SdkField<?>>`	`sdkFields()`
`List<BuildArtifacts>`	`secondaryArtifacts()` An array of `ProjectArtifacts` objects.
`List<ProjectSource>`	`secondarySources()` An array of `ProjectSource` objects.
`List<ProjectSourceVersion>`	`secondarySourceVersions()` An array of `ProjectSourceVersion` objects.
`static Class<? extends Build.Builder>`	`serializableBuilderClass()`
`String`	`serviceRole()` The name of a service role used for this build.
`ProjectSource`	`source()` Information about the source code to be built.
`String`	`sourceVersion()` Any version identifier for the version of the source code to be built.
`Instant`	`startTime()` When the build process started, expressed in Unix time format.
`Integer`	`timeoutInMinutes()` How long, in minutes, for AWS CodeBuild to wait before timing out this build if it does not get marked as completed.
`Build.Builder`	`toBuilder()`
`String`	`toString()` Returns a string representation of this object.
`VpcConfig`	`vpcConfig()` If your AWS CodeBuild project accesses resources in an Amazon VPC, you provide this parameter that identifies the VPC ID and the list of security group IDs and subnet IDs.

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy

- Method Detail
  - id
```
public final String id()
```
    The unique ID for the build.
    
    Returns:
    
    The unique ID for the build.
  - arn
```
public final String arn()
```
    The Amazon Resource Name (ARN) of the build.
    
    Returns:
    
    The Amazon Resource Name (ARN) of the build.
  - buildNumber
```
public final Long buildNumber()
```
    The number of the build. For each project, the buildNumber of its first build is 1. The buildNumber of each subsequent build is incremented by 1. If a build is deleted, the buildNumber of other builds does not change.
    
    Returns:
    
    The number of the build. For each project, the buildNumber of its first build is 1. The buildNumber of each subsequent build is incremented by 1. If a build is deleted, the buildNumber of other builds does not change.
  - startTime
```
public final Instant startTime()
```
    When the build process started, expressed in Unix time format.
    
    Returns:
    
    When the build process started, expressed in Unix time format.
  - endTime
```
public final Instant endTime()
```
    When the build process ended, expressed in Unix time format.
    
    Returns:
    
    When the build process ended, expressed in Unix time format.
  - currentPhase
```
public final String currentPhase()
```
    The current build phase.
    
    Returns:
    
    The current build phase.
  - buildStatus
```
public final StatusType buildStatus()
```
    The current status of the build. Valid values include:
    - FAILED: The build failed.
    - FAULT: The build faulted.
    - IN_PROGRESS: The build is still in progress.
    - STOPPED: The build stopped.
    - SUCCEEDED: The build succeeded.
    - TIMED_OUT: The build timed out.
    If the service returns an enum value that is not available in the current SDK version, buildStatus will return StatusType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from buildStatusAsString().
    Returns:
    The current status of the build. Valid values include:
    
    FAILED: The build failed.
    
    FAULT: The build faulted.
    
    IN_PROGRESS: The build is still in progress.
    
    STOPPED: The build stopped.
    
    SUCCEEDED: The build succeeded.
    
    TIMED_OUT: The build timed out.
    See Also:
    
    StatusType
  - buildStatusAsString
```
public final String buildStatusAsString()
```
    The current status of the build. Valid values include:
    - FAILED: The build failed.
    - FAULT: The build faulted.
    - IN_PROGRESS: The build is still in progress.
    - STOPPED: The build stopped.
    - SUCCEEDED: The build succeeded.
    - TIMED_OUT: The build timed out.
    If the service returns an enum value that is not available in the current SDK version, buildStatus will return StatusType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from buildStatusAsString().
    Returns:
    The current status of the build. Valid values include:
    
    FAILED: The build failed.
    
    FAULT: The build faulted.
    
    IN_PROGRESS: The build is still in progress.
    
    STOPPED: The build stopped.
    
    SUCCEEDED: The build succeeded.
    
    TIMED_OUT: The build timed out.
    See Also:
    
    StatusType
  - sourceVersion
```
public final String sourceVersion()
```
    Any version identifier for the version of the source code to be built. If sourceVersion is specified at the project level, then this sourceVersion (at the build level) takes precedence.
    
    For more information, see Source Version Sample with CodeBuild in the AWS CodeBuild User Guide.
    
    Returns:
    
    Any version identifier for the version of the source code to be built. If sourceVersion is specified at the project level, then this sourceVersion (at the build level) takes precedence.
    
    For more information, see Source Version Sample with CodeBuild in the AWS CodeBuild User Guide.
  - resolvedSourceVersion
```
public final String resolvedSourceVersion()
```
    An identifier for the version of this build's source code.
    - For AWS CodeCommit, GitHub, GitHub Enterprise, and BitBucket, the commit ID.
    - For AWS CodePipeline, the source revision provided by AWS CodePipeline.
    - For Amazon S3, this does not apply.
    Returns:
    An identifier for the version of this build's source code.
    
    For AWS CodeCommit, GitHub, GitHub Enterprise, and BitBucket, the commit ID.
    
    For AWS CodePipeline, the source revision provided by AWS CodePipeline.
    
    For Amazon S3, this does not apply.
  - projectName
```
public final String projectName()
```
    The name of the AWS CodeBuild project.
    
    Returns:
    
    The name of the AWS CodeBuild project.
  - hasPhases
```
public final boolean hasPhases()
```
    Returns true if the Phases property was specified by the sender (it may be empty), or false if the sender did not specify the value (it will be empty). For responses returned by the SDK, the sender is the AWS service.
  - phases
```
public final List<BuildPhase> phases()
```
    Information about all previous build phases that are complete and information about any current build phase that is not yet complete.
    
    Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
    
    You can use hasPhases() to see if a value was sent in this field.
    
    Returns:
    
    Information about all previous build phases that are complete and information about any current build phase that is not yet complete.
  - source
```
public final ProjectSource source()
```
    Information about the source code to be built.
    
    Returns:
    
    Information about the source code to be built.
  - hasSecondarySources
```
public final boolean hasSecondarySources()
```
    Returns true if the SecondarySources property was specified by the sender (it may be empty), or false if the sender did not specify the value (it will be empty). For responses returned by the SDK, the sender is the AWS service.
  - secondarySources
```
public final List<ProjectSource> secondarySources()
```
    An array of ProjectSource objects.
    
    Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
    
    You can use hasSecondarySources() to see if a value was sent in this field.
    
    Returns:
    
    An array of ProjectSource objects.
  - hasSecondarySourceVersions
```
public final boolean hasSecondarySourceVersions()
```
    Returns true if the SecondarySourceVersions property was specified by the sender (it may be empty), or false if the sender did not specify the value (it will be empty). For responses returned by the SDK, the sender is the AWS service.
  - secondarySourceVersions
```
public final List<ProjectSourceVersion> secondarySourceVersions()
```
    An array of ProjectSourceVersion objects. Each ProjectSourceVersion must be one of:
    - For AWS CodeCommit: the commit ID, branch, or Git tag to use.
    - For GitHub: the commit ID, pull request ID, branch name, or tag name that corresponds to the version of the source code you want to build. If a pull request ID is specified, it must use the format pr/pull-request-ID (for example, pr/25). If a branch name is specified, the branch's HEAD commit ID is used. If not specified, the default branch's HEAD commit ID is used.
    - For Bitbucket: the commit ID, branch name, or tag name that corresponds to the version of the source code you want to build. If a branch name is specified, the branch's HEAD commit ID is used. If not specified, the default branch's HEAD commit ID is used.
    - For Amazon S3: the version ID of the object that represents the build input ZIP file to use.
    Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
    
    You can use hasSecondarySourceVersions() to see if a value was sent in this field.
    Returns:
    An array of ProjectSourceVersion objects. Each ProjectSourceVersion must be one of:
    
    For AWS CodeCommit: the commit ID, branch, or Git tag to use.
    
    For GitHub: the commit ID, pull request ID, branch name, or tag name that corresponds to the version of the source code you want to build. If a pull request ID is specified, it must use the format pr/pull-request-ID (for example, pr/25). If a branch name is specified, the branch's HEAD commit ID is used. If not specified, the default branch's HEAD commit ID is used.
    
    For Bitbucket: the commit ID, branch name, or tag name that corresponds to the version of the source code you want to build. If a branch name is specified, the branch's HEAD commit ID is used. If not specified, the default branch's HEAD commit ID is used.
    
    For Amazon S3: the version ID of the object that represents the build input ZIP file to use.
  - artifacts
```
public final BuildArtifacts artifacts()
```
    Information about the output artifacts for the build.
    
    Returns:
    
    Information about the output artifacts for the build.
  - hasSecondaryArtifacts
```
public final boolean hasSecondaryArtifacts()
```
    Returns true if the SecondaryArtifacts property was specified by the sender (it may be empty), or false if the sender did not specify the value (it will be empty). For responses returned by the SDK, the sender is the AWS service.
  - secondaryArtifacts
```
public final List<BuildArtifacts> secondaryArtifacts()
```
    An array of ProjectArtifacts objects.
    
    Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
    
    You can use hasSecondaryArtifacts() to see if a value was sent in this field.
    
    Returns:
    
    An array of ProjectArtifacts objects.
  - cache
```
public final ProjectCache cache()
```
    Information about the cache for the build.
    
    Returns:
    
    Information about the cache for the build.
  - environment
```
public final ProjectEnvironment environment()
```
    Information about the build environment for this build.
    
    Returns:
    
    Information about the build environment for this build.
  - serviceRole
```
public final String serviceRole()
```
    The name of a service role used for this build.
    
    Returns:
    
    The name of a service role used for this build.
  - logs
```
public final LogsLocation logs()
```
    Information about the build's logs in Amazon CloudWatch Logs.
    
    Returns:
    
    Information about the build's logs in Amazon CloudWatch Logs.
  - timeoutInMinutes
```
public final Integer timeoutInMinutes()
```
    How long, in minutes, for AWS CodeBuild to wait before timing out this build if it does not get marked as completed.
    
    Returns:
    
    How long, in minutes, for AWS CodeBuild to wait before timing out this build if it does not get marked as completed.
  - queuedTimeoutInMinutes
```
public final Integer queuedTimeoutInMinutes()
```
    The number of minutes a build is allowed to be queued before it times out.
    
    Returns:
    
    The number of minutes a build is allowed to be queued before it times out.
  - buildComplete
```
public final Boolean buildComplete()
```
    Whether the build is complete. True if complete; otherwise, false.
    
    Returns:
    
    Whether the build is complete. True if complete; otherwise, false.
  - initiator
```
public final String initiator()
```
    The entity that started the build. Valid values include:
    - If AWS CodePipeline started the build, the pipeline's name (for example, codepipeline/my-demo-pipeline).
    - If an AWS Identity and Access Management (IAM) user started the build, the user's name (for example, MyUserName).
    - If the Jenkins plugin for AWS CodeBuild started the build, the string CodeBuild-Jenkins-Plugin.
    Returns:
    The entity that started the build. Valid values include:
    
    If AWS CodePipeline started the build, the pipeline's name (for example, codepipeline/my-demo-pipeline).
    
    If an AWS Identity and Access Management (IAM) user started the build, the user's name (for example, MyUserName).
    
    If the Jenkins plugin for AWS CodeBuild started the build, the string CodeBuild-Jenkins-Plugin.
  - vpcConfig
```
public final VpcConfig vpcConfig()
```
    If your AWS CodeBuild project accesses resources in an Amazon VPC, you provide this parameter that identifies the VPC ID and the list of security group IDs and subnet IDs. The security groups and subnets must belong to the same VPC. You must provide at least one security group and one subnet ID.
    
    Returns:
    
    If your AWS CodeBuild project accesses resources in an Amazon VPC, you provide this parameter that identifies the VPC ID and the list of security group IDs and subnet IDs. The security groups and subnets must belong to the same VPC. You must provide at least one security group and one subnet ID.
  - networkInterface
```
public final NetworkInterface networkInterface()
```
    Describes a network interface.
    
    Returns:
    
    Describes a network interface.
  - encryptionKey
```
public final String encryptionKey()
```
    The AWS Key Management Service (AWS KMS) customer master key (CMK) to be used for encrypting the build output artifacts.
    
    You can use a cross-account KMS key to encrypt the build output artifacts if your service role has permission to that key.
    
    You can specify either the Amazon Resource Name (ARN) of the CMK or, if available, the CMK's alias (using the format alias/<alias-name>).
    
    Returns:
    
    The AWS Key Management Service (AWS KMS) customer master key (CMK) to be used for encrypting the build output artifacts.
    
    You can use a cross-account KMS key to encrypt the build output artifacts if your service role has permission to that key.
    
    You can specify either the Amazon Resource Name (ARN) of the CMK or, if available, the CMK's alias (using the format alias/<alias-name>).
  - hasExportedEnvironmentVariables
```
public final boolean hasExportedEnvironmentVariables()
```
    Returns true if the ExportedEnvironmentVariables property was specified by the sender (it may be empty), or false if the sender did not specify the value (it will be empty). For responses returned by the SDK, the sender is the AWS service.
  - exportedEnvironmentVariables
```
public final List<ExportedEnvironmentVariable> exportedEnvironmentVariables()
```
    A list of exported environment variables for this build.
    
    Exported environment variables are used in conjunction with AWS CodePipeline to export environment variables from the current build stage to subsequent stages in the pipeline. For more information, see Working with variables in the AWS CodePipeline User Guide.
    
    Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
    
    You can use hasExportedEnvironmentVariables() to see if a value was sent in this field.
    
    Returns:
    
    A list of exported environment variables for this build.
    
    Exported environment variables are used in conjunction with AWS CodePipeline to export environment variables from the current build stage to subsequent stages in the pipeline. For more information, see Working with variables in the AWS CodePipeline User Guide.
  - hasReportArns
```
public final boolean hasReportArns()
```
    Returns true if the ReportArns property was specified by the sender (it may be empty), or false if the sender did not specify the value (it will be empty). For responses returned by the SDK, the sender is the AWS service.
  - reportArns
```
public final List<String> reportArns()
```
    An array of the ARNs associated with this build's reports.
    
    Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
    
    You can use hasReportArns() to see if a value was sent in this field.
    
    Returns:
    
    An array of the ARNs associated with this build's reports.
  - hasFileSystemLocations
```
public final boolean hasFileSystemLocations()
```
    Returns true if the FileSystemLocations property was specified by the sender (it may be empty), or false if the sender did not specify the value (it will be empty). For responses returned by the SDK, the sender is the AWS service.
  - fileSystemLocations
```
public final List<ProjectFileSystemLocation> fileSystemLocations()
```
    An array of ProjectFileSystemLocation objects for a CodeBuild build project. A ProjectFileSystemLocation object specifies the identifier, location, mountOptions, mountPoint, and type of a file system created using Amazon Elastic File System.
    
    Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
    
    You can use hasFileSystemLocations() to see if a value was sent in this field.
    
    Returns:
    
    An array of ProjectFileSystemLocation objects for a CodeBuild build project. A ProjectFileSystemLocation object specifies the identifier, location, mountOptions, mountPoint, and type of a file system created using Amazon Elastic File System.
  - debugSession
```
public final DebugSession debugSession()
```
    Contains information about the debug session for this build.
    
    Returns:
    
    Contains information about the debug session for this build.
  - buildBatchArn
```
public final String buildBatchArn()
```
    The ARN of the batch build that this build is a member of, if applicable.
    
    Returns:
    
    The ARN of the batch build that this build is a member of, if applicable.
  - toBuilder
```
public Build.Builder toBuilder()
```
    Specified by:
    
    toBuilder in interface ToCopyableBuilder<Build.Builder,Build>
  - builder
```
public static Build.Builder builder()
```
  - serializableBuilderClass
```
public static Class<? extends Build.Builder> serializableBuilderClass()
```
  - hashCode
```
public final int hashCode()
```
    Overrides:
    
    hashCode in class Object
  - equals
```
public final boolean equals(Object obj)
```
    Overrides:
    
    equals in class Object
  - equalsBySdkFields
```
public final boolean equalsBySdkFields(Object obj)
```
    Specified by:
    
    equalsBySdkFields in interface SdkPojo
  - toString
```
public final String toString()
```
    Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.
    
    Overrides:
    
    toString in class Object
  - getValueForField
```
public final <T> Optional<T> getValueForField(String fieldName,
                                              Class<T> clazz)
```
  - sdkFields
```
public final List<SdkField<?>> sdkFields()
```
    Specified by:
    
    sdkFields in interface SdkPojo

Class Build

Nested Class Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder

Method Detail

id

arn

buildNumber

startTime

endTime

currentPhase

buildStatus

buildStatusAsString

sourceVersion

resolvedSourceVersion

projectName

hasPhases

phases

source

hasSecondarySources

secondarySources

hasSecondarySourceVersions

secondarySourceVersions

artifacts

hasSecondaryArtifacts

secondaryArtifacts

cache

environment

serviceRole

logs

timeoutInMinutes

queuedTimeoutInMinutes

buildComplete

initiator

vpcConfig

networkInterface

encryptionKey

hasExportedEnvironmentVariables

exportedEnvironmentVariables

hasReportArns

reportArns

hasFileSystemLocations

fileSystemLocations

debugSession

buildBatchArn

toBuilder

builder

serializableBuilderClass

hashCode

equals

equalsBySdkFields

toString

getValueForField

sdkFields