/AWS1/CL_BLDBUILD¶
Information about a build.
CONSTRUCTOR¶
IMPORTING¶
Optional arguments:¶
iv_id TYPE /AWS1/BLDNONEMPTYSTRING /AWS1/BLDNONEMPTYSTRING¶
The unique ID for the build.
iv_arn TYPE /AWS1/BLDNONEMPTYSTRING /AWS1/BLDNONEMPTYSTRING¶
The Amazon Resource Name (ARN) of the build.
iv_buildnumber TYPE /AWS1/BLDWRAPPERLONG /AWS1/BLDWRAPPERLONG¶
The number of the build. For each project, the
buildNumberof its first build is1. ThebuildNumberof each subsequent build is incremented by1. If a build is deleted, thebuildNumberof other builds does not change.
iv_starttime TYPE /AWS1/BLDTIMESTAMP /AWS1/BLDTIMESTAMP¶
When the build process started, expressed in Unix time format.
iv_endtime TYPE /AWS1/BLDTIMESTAMP /AWS1/BLDTIMESTAMP¶
When the build process ended, expressed in Unix time format.
iv_currentphase TYPE /AWS1/BLDSTRING /AWS1/BLDSTRING¶
The current build phase.
iv_buildstatus TYPE /AWS1/BLDSTATUSTYPE /AWS1/BLDSTATUSTYPE¶
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.
iv_sourceversion TYPE /AWS1/BLDNONEMPTYSTRING /AWS1/BLDNONEMPTYSTRING¶
Any version identifier for the version of the source code to be built. If
sourceVersionis specified at the project level, then thissourceVersion(at the build level) takes precedence.For more information, see Source Version Sample with CodeBuild in the CodeBuild User Guide.
iv_resolvedsourceversion TYPE /AWS1/BLDNONEMPTYSTRING /AWS1/BLDNONEMPTYSTRING¶
An identifier for the version of this build's source code.
For CodeCommit, GitHub, GitHub Enterprise, and BitBucket, the commit ID.
For CodePipeline, the source revision provided by CodePipeline.
For Amazon S3, this does not apply.
iv_projectname TYPE /AWS1/BLDNONEMPTYSTRING /AWS1/BLDNONEMPTYSTRING¶
The name of the CodeBuild project.
it_phases TYPE /AWS1/CL_BLDBUILDPHASE=>TT_BUILDPHASES TT_BUILDPHASES¶
Information about all previous build phases that are complete and information about any current build phase that is not yet complete.
io_source TYPE REF TO /AWS1/CL_BLDPROJECTSOURCE /AWS1/CL_BLDPROJECTSOURCE¶
Information about the source code to be built.
it_secondarysources TYPE /AWS1/CL_BLDPROJECTSOURCE=>TT_PROJECTSOURCES TT_PROJECTSOURCES¶
An array of
ProjectSourceobjects.
it_secondarysourceversions TYPE /AWS1/CL_BLDPROJECTSOURCEVRS=>TT_PROJECTSECSOURCEVERSIONS TT_PROJECTSECSOURCEVERSIONS¶
An array of
ProjectSourceVersionobjects. EachProjectSourceVersionmust be one of:
For 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.
io_artifacts TYPE REF TO /AWS1/CL_BLDBUILDARTIFACTS /AWS1/CL_BLDBUILDARTIFACTS¶
Information about the output artifacts for the build.
it_secondaryartifacts TYPE /AWS1/CL_BLDBUILDARTIFACTS=>TT_BUILDARTIFACTSLIST TT_BUILDARTIFACTSLIST¶
An array of
ProjectArtifactsobjects.
io_cache TYPE REF TO /AWS1/CL_BLDPROJECTCACHE /AWS1/CL_BLDPROJECTCACHE¶
Information about the cache for the build.
io_environment TYPE REF TO /AWS1/CL_BLDPROJECTENVIRONMENT /AWS1/CL_BLDPROJECTENVIRONMENT¶
Information about the build environment for this build.
iv_servicerole TYPE /AWS1/BLDNONEMPTYSTRING /AWS1/BLDNONEMPTYSTRING¶
The name of a service role used for this build.
io_logs TYPE REF TO /AWS1/CL_BLDLOGSLOCATION /AWS1/CL_BLDLOGSLOCATION¶
Information about the build's logs in CloudWatch Logs.
iv_timeoutinminutes TYPE /AWS1/BLDWRAPPERINT /AWS1/BLDWRAPPERINT¶
How long, in minutes, from 5 to 2160 (36 hours), for CodeBuild to wait before timing out this build if it does not get marked as completed.
iv_queuedtimeoutinminutes TYPE /AWS1/BLDWRAPPERINT /AWS1/BLDWRAPPERINT¶
The number of minutes a build is allowed to be queued before it times out.
iv_buildcomplete TYPE /AWS1/BLDBOOLEAN /AWS1/BLDBOOLEAN¶
Whether the build is complete. True if complete; otherwise, false.
iv_initiator TYPE /AWS1/BLDSTRING /AWS1/BLDSTRING¶
The entity that started the build. Valid values include:
If CodePipeline started the build, the pipeline's name (for example,
codepipeline/my-demo-pipeline).If a user started the build, the user's name (for example,
MyUserName).If the Jenkins plugin for CodeBuild started the build, the string
CodeBuild-Jenkins-Plugin.
io_vpcconfig TYPE REF TO /AWS1/CL_BLDVPCCONFIG /AWS1/CL_BLDVPCCONFIG¶
If your 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.
io_networkinterface TYPE REF TO /AWS1/CL_BLDNETWORKINTERFACE /AWS1/CL_BLDNETWORKINTERFACE¶
Describes a network interface.
iv_encryptionkey TYPE /AWS1/BLDNONEMPTYSTRING /AWS1/BLDNONEMPTYSTRING¶
The Key Management Service 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/).
it_expedenvironmentvariables TYPE /AWS1/CL_BLDEXPEDENVIRONMENT00=>TT_EXPEDENVIRONMENTVARIABLES TT_EXPEDENVIRONMENTVARIABLES¶
A list of exported environment variables for this build.
Exported environment variables are used in conjunction with 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 CodePipeline User Guide.
it_reportarns TYPE /AWS1/CL_BLDBUILDREPORTARNS_W=>TT_BUILDREPORTARNS TT_BUILDREPORTARNS¶
An array of the ARNs associated with this build's reports.
it_filesystemlocations TYPE /AWS1/CL_BLDPROJECTFILESYSTE00=>TT_PROJECTFILESYSTEMLOCATIONS TT_PROJECTFILESYSTEMLOCATIONS¶
An array of
ProjectFileSystemLocationobjects for a CodeBuild build project. AProjectFileSystemLocationobject specifies theidentifier,location,mountOptions,mountPoint, andtypeof a file system created using Amazon Elastic File System.
io_debugsession TYPE REF TO /AWS1/CL_BLDDEBUGSESSION /AWS1/CL_BLDDEBUGSESSION¶
Contains information about the debug session for this build.
iv_buildbatcharn TYPE /AWS1/BLDSTRING /AWS1/BLDSTRING¶
The ARN of the batch build that this build is a member of, if applicable.
io_autoretryconfig TYPE REF TO /AWS1/CL_BLDAUTORETRYCONFIG /AWS1/CL_BLDAUTORETRYCONFIG¶
Information about the auto-retry configuration for the build.
Queryable Attributes¶
id¶
The unique ID for the build.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_ID() |
Getter for ID, with configurable default |
ASK_ID() |
Getter for ID w/ exceptions if field has no value |
HAS_ID() |
Determine if ID has a value |
arn¶
The Amazon Resource Name (ARN) of the build.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_ARN() |
Getter for ARN, with configurable default |
ASK_ARN() |
Getter for ARN w/ exceptions if field has no value |
HAS_ARN() |
Determine if ARN has a value |
buildNumber¶
The number of the build. For each project, the
buildNumberof its first build is1. ThebuildNumberof each subsequent build is incremented by1. If a build is deleted, thebuildNumberof other builds does not change.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_BUILDNUMBER() |
Getter for BUILDNUMBER, with configurable default |
ASK_BUILDNUMBER() |
Getter for BUILDNUMBER w/ exceptions if field has no value |
HAS_BUILDNUMBER() |
Determine if BUILDNUMBER has a value |
startTime¶
When the build process started, expressed in Unix time format.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_STARTTIME() |
Getter for STARTTIME, with configurable default |
ASK_STARTTIME() |
Getter for STARTTIME w/ exceptions if field has no value |
HAS_STARTTIME() |
Determine if STARTTIME has a value |
endTime¶
When the build process ended, expressed in Unix time format.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_ENDTIME() |
Getter for ENDTIME, with configurable default |
ASK_ENDTIME() |
Getter for ENDTIME w/ exceptions if field has no value |
HAS_ENDTIME() |
Determine if ENDTIME has a value |
currentPhase¶
The current build phase.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_CURRENTPHASE() |
Getter for CURRENTPHASE, with configurable default |
ASK_CURRENTPHASE() |
Getter for CURRENTPHASE w/ exceptions if field has no value |
HAS_CURRENTPHASE() |
Determine if CURRENTPHASE has a value |
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.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_BUILDSTATUS() |
Getter for BUILDSTATUS, with configurable default |
ASK_BUILDSTATUS() |
Getter for BUILDSTATUS w/ exceptions if field has no value |
HAS_BUILDSTATUS() |
Determine if BUILDSTATUS has a value |
sourceVersion¶
Any version identifier for the version of the source code to be built. If
sourceVersionis specified at the project level, then thissourceVersion(at the build level) takes precedence.For more information, see Source Version Sample with CodeBuild in the CodeBuild User Guide.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_SOURCEVERSION() |
Getter for SOURCEVERSION, with configurable default |
ASK_SOURCEVERSION() |
Getter for SOURCEVERSION w/ exceptions if field has no value |
HAS_SOURCEVERSION() |
Determine if SOURCEVERSION has a value |
resolvedSourceVersion¶
An identifier for the version of this build's source code.
For CodeCommit, GitHub, GitHub Enterprise, and BitBucket, the commit ID.
For CodePipeline, the source revision provided by CodePipeline.
For Amazon S3, this does not apply.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_RESOLVEDSOURCEVERSION() |
Getter for RESOLVEDSOURCEVERSION, with configurable default |
ASK_RESOLVEDSOURCEVERSION() |
Getter for RESOLVEDSOURCEVERSION w/ exceptions if field has |
HAS_RESOLVEDSOURCEVERSION() |
Determine if RESOLVEDSOURCEVERSION has a value |
projectName¶
The name of the CodeBuild project.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_PROJECTNAME() |
Getter for PROJECTNAME, with configurable default |
ASK_PROJECTNAME() |
Getter for PROJECTNAME w/ exceptions if field has no value |
HAS_PROJECTNAME() |
Determine if PROJECTNAME has a value |
phases¶
Information about all previous build phases that are complete and information about any current build phase that is not yet complete.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_PHASES() |
Getter for PHASES, with configurable default |
ASK_PHASES() |
Getter for PHASES w/ exceptions if field has no value |
HAS_PHASES() |
Determine if PHASES has a value |
source¶
Information about the source code to be built.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_SOURCE() |
Getter for SOURCE |
secondarySources¶
An array of
ProjectSourceobjects.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_SECONDARYSOURCES() |
Getter for SECONDARYSOURCES, with configurable default |
ASK_SECONDARYSOURCES() |
Getter for SECONDARYSOURCES w/ exceptions if field has no va |
HAS_SECONDARYSOURCES() |
Determine if SECONDARYSOURCES has a value |
secondarySourceVersions¶
An array of
ProjectSourceVersionobjects. EachProjectSourceVersionmust be one of:
For 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.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_SECONDARYSOURCEVERSIONS() |
Getter for SECONDARYSOURCEVERSIONS, with configurable defaul |
ASK_SECONDARYSOURCEVERSIONS() |
Getter for SECONDARYSOURCEVERSIONS w/ exceptions if field ha |
HAS_SECONDARYSOURCEVERSIONS() |
Determine if SECONDARYSOURCEVERSIONS has a value |
artifacts¶
Information about the output artifacts for the build.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_ARTIFACTS() |
Getter for ARTIFACTS |
secondaryArtifacts¶
An array of
ProjectArtifactsobjects.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_SECONDARYARTIFACTS() |
Getter for SECONDARYARTIFACTS, with configurable default |
ASK_SECONDARYARTIFACTS() |
Getter for SECONDARYARTIFACTS w/ exceptions if field has no |
HAS_SECONDARYARTIFACTS() |
Determine if SECONDARYARTIFACTS has a value |
cache¶
Information about the cache for the build.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_CACHE() |
Getter for CACHE |
environment¶
Information about the build environment for this build.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_ENVIRONMENT() |
Getter for ENVIRONMENT |
serviceRole¶
The name of a service role used for this build.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_SERVICEROLE() |
Getter for SERVICEROLE, with configurable default |
ASK_SERVICEROLE() |
Getter for SERVICEROLE w/ exceptions if field has no value |
HAS_SERVICEROLE() |
Determine if SERVICEROLE has a value |
logs¶
Information about the build's logs in CloudWatch Logs.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_LOGS() |
Getter for LOGS |
timeoutInMinutes¶
How long, in minutes, from 5 to 2160 (36 hours), for CodeBuild to wait before timing out this build if it does not get marked as completed.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_TIMEOUTINMINUTES() |
Getter for TIMEOUTINMINUTES, with configurable default |
ASK_TIMEOUTINMINUTES() |
Getter for TIMEOUTINMINUTES w/ exceptions if field has no va |
HAS_TIMEOUTINMINUTES() |
Determine if TIMEOUTINMINUTES has a value |
queuedTimeoutInMinutes¶
The number of minutes a build is allowed to be queued before it times out.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_QUEUEDTIMEOUTINMINUTES() |
Getter for QUEUEDTIMEOUTINMINUTES, with configurable default |
ASK_QUEUEDTIMEOUTINMINUTES() |
Getter for QUEUEDTIMEOUTINMINUTES w/ exceptions if field has |
HAS_QUEUEDTIMEOUTINMINUTES() |
Determine if QUEUEDTIMEOUTINMINUTES has a value |
buildComplete¶
Whether the build is complete. True if complete; otherwise, false.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_BUILDCOMPLETE() |
Getter for BUILDCOMPLETE |
initiator¶
The entity that started the build. Valid values include:
If CodePipeline started the build, the pipeline's name (for example,
codepipeline/my-demo-pipeline).If a user started the build, the user's name (for example,
MyUserName).If the Jenkins plugin for CodeBuild started the build, the string
CodeBuild-Jenkins-Plugin.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_INITIATOR() |
Getter for INITIATOR, with configurable default |
ASK_INITIATOR() |
Getter for INITIATOR w/ exceptions if field has no value |
HAS_INITIATOR() |
Determine if INITIATOR has a value |
vpcConfig¶
If your 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.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_VPCCONFIG() |
Getter for VPCCONFIG |
networkInterface¶
Describes a network interface.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_NETWORKINTERFACE() |
Getter for NETWORKINTERFACE |
encryptionKey¶
The Key Management Service 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/).
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_ENCRYPTIONKEY() |
Getter for ENCRYPTIONKEY, with configurable default |
ASK_ENCRYPTIONKEY() |
Getter for ENCRYPTIONKEY w/ exceptions if field has no value |
HAS_ENCRYPTIONKEY() |
Determine if ENCRYPTIONKEY has a value |
exportedEnvironmentVariables¶
A list of exported environment variables for this build.
Exported environment variables are used in conjunction with 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 CodePipeline User Guide.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_EXPEDENVIRONMENTVARIAB00() |
Getter for EXPORTEDENVIRONMENTVARIABLES, with configurable d |
ASK_EXPEDENVIRONMENTVARIAB00() |
Getter for EXPORTEDENVIRONMENTVARIABLES w/ exceptions if fie |
HAS_EXPEDENVIRONMENTVARIAB00() |
Determine if EXPORTEDENVIRONMENTVARIABLES has a value |
reportArns¶
An array of the ARNs associated with this build's reports.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_REPORTARNS() |
Getter for REPORTARNS, with configurable default |
ASK_REPORTARNS() |
Getter for REPORTARNS w/ exceptions if field has no value |
HAS_REPORTARNS() |
Determine if REPORTARNS has a value |
fileSystemLocations¶
An array of
ProjectFileSystemLocationobjects for a CodeBuild build project. AProjectFileSystemLocationobject specifies theidentifier,location,mountOptions,mountPoint, andtypeof a file system created using Amazon Elastic File System.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_FILESYSTEMLOCATIONS() |
Getter for FILESYSTEMLOCATIONS, with configurable default |
ASK_FILESYSTEMLOCATIONS() |
Getter for FILESYSTEMLOCATIONS w/ exceptions if field has no |
HAS_FILESYSTEMLOCATIONS() |
Determine if FILESYSTEMLOCATIONS has a value |
debugSession¶
Contains information about the debug session for this build.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_DEBUGSESSION() |
Getter for DEBUGSESSION |
buildBatchArn¶
The ARN of the batch build that this build is a member of, if applicable.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_BUILDBATCHARN() |
Getter for BUILDBATCHARN, with configurable default |
ASK_BUILDBATCHARN() |
Getter for BUILDBATCHARN w/ exceptions if field has no value |
HAS_BUILDBATCHARN() |
Determine if BUILDBATCHARN has a value |
autoRetryConfig¶
Information about the auto-retry configuration for the build.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_AUTORETRYCONFIG() |
Getter for AUTORETRYCONFIG |
Public Local Types In This Class¶
Internal table types, representing arrays and maps of this class, are defined as local types:
TT_BUILDS¶
TYPES TT_BUILDS TYPE STANDARD TABLE OF REF TO /AWS1/CL_BLDBUILD WITH DEFAULT KEY
.