Skip to content

Build

Source code in docs_src/capo_codebuild/types/build.py
class Build(TypedDict, closed=True):
    id: NotRequired["capo_codebuild.types.non_empty_string.NonEmptyString"]
    """<p>The unique ID for the build.</p>"""
    arn: NotRequired["capo_codebuild.types.non_empty_string.NonEmptyString"]
    """<p>The Amazon Resource Name (ARN) of the build.</p>"""
    build_number: NotRequired["capo_codebuild.types.wrapper_long.WrapperLong"]
    """<p>The number of the build. For each project, the <code>buildNumber</code> of its first build is <code>1</code>. The <code>buildNumber</code> of each subsequent build is incremented by <code>1</code>. If a build is deleted, the <code>buildNumber</code> of other builds does not change.</p>"""
    start_time: NotRequired["capo_codebuild.types.timestamp.Timestamp"]
    """<p>When the build process started, expressed in Unix time format.</p>"""
    end_time: NotRequired["capo_codebuild.types.timestamp.Timestamp"]
    """<p>When the build process ended, expressed in Unix time format.</p>"""
    current_phase: NotRequired["capo_codebuild.types.string.String"]
    """<p>The current build phase.</p>"""
    build_status: NotRequired["capo_codebuild.types.status_type.StatusType"]
    """<p>The current status of the build. Valid values include:</p> <ul> <li> <p> <code>FAILED</code>: The build failed.</p> </li> <li> <p> <code>FAULT</code>: The build faulted.</p> </li> <li> <p> <code>IN_PROGRESS</code>: The build is still in progress.</p> </li> <li> <p> <code>STOPPED</code>: The build stopped.</p> </li> <li> <p> <code>SUCCEEDED</code>: The build succeeded.</p> </li> <li> <p> <code>TIMED_OUT</code>: The build timed out.</p> </li> </ul>"""
    source_version: NotRequired["capo_codebuild.types.non_empty_string.NonEmptyString"]
    """<p>Any version identifier for the version of the source code to be built. If <code>sourceVersion</code> is specified at the project level, then this <code>sourceVersion</code> (at the build level) takes precedence. </p> <p> For more information, see <a href="https://docs.aws.amazon.com/codebuild/latest/userguide/sample-source-version.html">Source Version Sample with CodeBuild</a> in the <i>CodeBuild User Guide</i>. </p>"""
    resolved_source_version: NotRequired[
        "capo_codebuild.types.non_empty_string.NonEmptyString"
    ]
    """<p> An identifier for the version of this build's source code. </p> <ul> <li> <p> For CodeCommit, GitHub, GitHub Enterprise, and BitBucket, the commit ID. </p> </li> <li> <p> For CodePipeline, the source revision provided by CodePipeline. </p> </li> <li> <p> For Amazon S3, this does not apply. </p> </li> </ul>"""
    project_name: NotRequired["capo_codebuild.types.non_empty_string.NonEmptyString"]
    """<p>The name of the CodeBuild project.</p>"""
    phases: NotRequired["capo_codebuild.types.build_phases.BuildPhases"]
    """<p>Information about all previous build phases that are complete and information about any current build phase that is not yet complete.</p>"""
    source: NotRequired["capo_codebuild.types.project_source.ProjectSource"]
    """<p>Information about the source code to be built.</p>"""
    secondary_sources: NotRequired[
        "capo_codebuild.types.project_sources.ProjectSources"
    ]
    """<p> An array of <code>ProjectSource</code> objects. </p>"""
    secondary_source_versions: NotRequired[
        "capo_codebuild.types.project_secondary_source_versions.ProjectSecondarySourceVersions"
    ]
    """<p> An array of <code>ProjectSourceVersion</code> objects. Each <code>ProjectSourceVersion</code> must be one of: </p> <ul> <li> <p>For CodeCommit: the commit ID, branch, or Git tag to use.</p> </li> <li> <p>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 <code>pr/pull-request-ID</code> (for example, <code>pr/25</code>). 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.</p> </li> <li> <p>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.</p> </li> <li> <p>For Amazon S3: the version ID of the object that represents the build input ZIP file to use.</p> </li> </ul>"""
    artifacts: NotRequired["capo_codebuild.types.build_artifacts.BuildArtifacts"]
    """<p>Information about the output artifacts for the build.</p>"""
    secondary_artifacts: NotRequired[
        "capo_codebuild.types.build_artifacts_list.BuildArtifactsList"
    ]
    """<p> An array of <code>ProjectArtifacts</code> objects. </p>"""
    cache: NotRequired["capo_codebuild.types.project_cache.ProjectCache"]
    """<p>Information about the cache for the build.</p>"""
    environment: NotRequired[
        "capo_codebuild.types.project_environment.ProjectEnvironment"
    ]
    """<p>Information about the build environment for this build.</p>"""
    service_role: NotRequired["capo_codebuild.types.non_empty_string.NonEmptyString"]
    """<p>The name of a service role used for this build.</p>"""
    logs: NotRequired["capo_codebuild.types.logs_location.LogsLocation"]
    """<p>Information about the build's logs in CloudWatch Logs.</p>"""
    timeout_in_minutes: NotRequired["capo_codebuild.types.wrapper_int.WrapperInt"]
    """<p>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.</p>"""
    queued_timeout_in_minutes: NotRequired[
        "capo_codebuild.types.wrapper_int.WrapperInt"
    ]
    """<p> The number of minutes a build is allowed to be queued before it times out. </p>"""
    build_complete: "capo_codebuild.types.boolean.Boolean"
    """<p>Whether the build is complete. True if complete; otherwise, false.</p>"""
    initiator: NotRequired["capo_codebuild.types.string.String"]
    """<p>The entity that started the build. Valid values include:</p> <ul> <li> <p>If CodePipeline started the build, the pipeline's name (for example, <code>codepipeline/my-demo-pipeline</code>).</p> </li> <li> <p>If a user started the build, the user's name (for example, <code>MyUserName</code>).</p> </li> <li> <p>If the Jenkins plugin for CodeBuild started the build, the string <code>CodeBuild-Jenkins-Plugin</code>.</p> </li> </ul>"""
    vpc_config: NotRequired["capo_codebuild.types.vpc_config.VpcConfig"]
    """<p>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.</p>"""
    network_interface: NotRequired[
        "capo_codebuild.types.network_interface.NetworkInterface"
    ]
    """<p>Describes a network interface.</p>"""
    encryption_key: NotRequired["capo_codebuild.types.non_empty_string.NonEmptyString"]
    """<p>The Key Management Service customer master key (CMK) to be used for encrypting the build output artifacts.</p> <note> <p> You can use a cross-account KMS key to encrypt the build output artifacts if your service role has permission to that key. </p> </note> <p>You can specify either the Amazon Resource Name (ARN) of the CMK or, if available, the CMK's alias (using the format <code>alias/<alias-name></code>).</p>"""
    exported_environment_variables: NotRequired[
        "capo_codebuild.types.exported_environment_variables.ExportedEnvironmentVariables"
    ]
    """<p>A list of exported environment variables for this build.</p> <p>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 <a href="https://docs.aws.amazon.com/codepipeline/latest/userguide/actions-variables.html">Working with variables</a> in the <i>CodePipeline User Guide</i>.</p>"""
    report_arns: NotRequired["capo_codebuild.types.build_report_arns.BuildReportArns"]
    """<p> An array of the ARNs associated with this build's reports. </p>"""
    file_system_locations: NotRequired[
        "capo_codebuild.types.project_file_system_locations.ProjectFileSystemLocations"
    ]
    """<p> An array of <code>ProjectFileSystemLocation</code> objects for a CodeBuild build project. A <code>ProjectFileSystemLocation</code> object specifies the <code>identifier</code>, <code>location</code>, <code>mountOptions</code>, <code>mountPoint</code>, and <code>type</code> of a file system created using Amazon Elastic File System. </p>"""
    debug_session: NotRequired["capo_codebuild.types.debug_session.DebugSession"]
    """<p>Contains information about the debug session for this build.</p>"""
    build_batch_arn: NotRequired["capo_codebuild.types.string.String"]
    """<p>The ARN of the batch build that this build is a member of, if applicable.</p>"""
    auto_retry_config: NotRequired[
        "capo_codebuild.types.auto_retry_config.AutoRetryConfig"
    ]
    """<p>Information about the auto-retry configuration for the build.</p>"""

arn instance-attribute

arn: NotRequired[NonEmptyString]

The Amazon Resource Name (ARN) of the build.

artifacts instance-attribute

artifacts: NotRequired[BuildArtifacts]

Information about the output artifacts for the build.

auto_retry_config instance-attribute

auto_retry_config: NotRequired[AutoRetryConfig]

Information about the auto-retry configuration for the build.

build_batch_arn instance-attribute

build_batch_arn: NotRequired[String]

The ARN of the batch build that this build is a member of, if applicable.

build_complete instance-attribute

build_complete: Boolean

Whether the build is complete. True if complete; otherwise, false.

build_number instance-attribute

build_number: NotRequired[WrapperLong]

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.

build_status instance-attribute

build_status: NotRequired[StatusType]

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.

cache instance-attribute

cache: NotRequired[ProjectCache]

Information about the cache for the build.

current_phase instance-attribute

current_phase: NotRequired[String]

The current build phase.

debug_session instance-attribute

debug_session: NotRequired[DebugSession]

Contains information about the debug session for this build.

encryption_key instance-attribute

encryption_key: NotRequired[NonEmptyString]

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/).

end_time instance-attribute

end_time: NotRequired[Timestamp]

When the build process ended, expressed in Unix time format.

environment instance-attribute

environment: NotRequired[ProjectEnvironment]

Information about the build environment for this build.

exported_environment_variables instance-attribute

exported_environment_variables: NotRequired[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.

file_system_locations instance-attribute

file_system_locations: NotRequired[ProjectFileSystemLocations]

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.

id instance-attribute

id: NotRequired[NonEmptyString]

The unique ID for the build.

initiator instance-attribute

initiator: NotRequired[String]

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.

logs instance-attribute

logs: NotRequired[LogsLocation]

Information about the build's logs in CloudWatch Logs.

network_interface instance-attribute

network_interface: NotRequired[NetworkInterface]

Describes a network interface.

phases instance-attribute

phases: NotRequired[BuildPhases]

Information about all previous build phases that are complete and information about any current build phase that is not yet complete.

project_name instance-attribute

project_name: NotRequired[NonEmptyString]

The name of the CodeBuild project.

queued_timeout_in_minutes instance-attribute

queued_timeout_in_minutes: NotRequired[WrapperInt]

The number of minutes a build is allowed to be queued before it times out.

report_arns instance-attribute

report_arns: NotRequired[BuildReportArns]

An array of the ARNs associated with this build's reports.

resolved_source_version instance-attribute

resolved_source_version: NotRequired[NonEmptyString]

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.

secondary_artifacts instance-attribute

secondary_artifacts: NotRequired[BuildArtifactsList]

An array of ProjectArtifacts objects.

secondary_source_versions instance-attribute

secondary_source_versions: NotRequired[ProjectSecondarySourceVersions]

An array of ProjectSourceVersion objects. Each ProjectSourceVersion must 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.

secondary_sources instance-attribute

secondary_sources: NotRequired[ProjectSources]

An array of ProjectSource objects.

service_role instance-attribute

service_role: NotRequired[NonEmptyString]

The name of a service role used for this build.

source instance-attribute

source: NotRequired[ProjectSource]

Information about the source code to be built.

source_version instance-attribute

source_version: NotRequired[NonEmptyString]

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 CodeBuild User Guide.

start_time instance-attribute

start_time: NotRequired[Timestamp]

When the build process started, expressed in Unix time format.

timeout_in_minutes instance-attribute

timeout_in_minutes: NotRequired[WrapperInt]

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.

vpc_config instance-attribute

vpc_config: NotRequired[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.