Amazon CodeBuild

AWS CodeBuild is a fully managed continuous integration service that compiles source code, runs tests, and produces ready-to-deploy software packages. CodeBuild scales continuously and processes multiple builds concurrently so your builds are not left waiting in a queue. It supports popular build environments for Java, Python, Node.js, Ruby, Go, Android, .NET Core, Docker, and more. CodeBuild integrates with AWS CodePipeline, GitHub, Bitbucket, and other source providers for end-to-end CI/CD workflows.

1 APIs 10 Features
AmazonCI/CDBuildContinuous IntegrationDevOpsTesting

APIs

Amazon CodeBuild API

The Amazon CodeBuild REST API enables programmatic management of build projects, builds, report groups, and source credentials. Create and configure build projects with custom e...

MCP Servers

Features

Fully Managed Build Service

No need to provision, manage, or scale build servers. AWS handles all infrastructure management so you can focus on writing code.

Continuous Scaling

Automatically scales to meet peak build demand. Processes multiple builds concurrently so builds are never left waiting in a queue.

Pre-configured Build Environments

Out-of-the-box build environments for Java, Python, Node.js, Ruby, Go, Android, .NET Core, Docker, and more. Customize with your own build tools.

Build Batches

Run multiple related builds in parallel as a batch sharing the same source configuration and retrieve combined results for the entire batch.

Test Reports

Collect and analyze test results from unit tests, integration tests, and code coverage reports. Track test trends and identify flaky tests.

Source Integration

Integrate with CodeCommit, GitHub, GitHub Enterprise, GitLab, Bitbucket, and Amazon S3 as source providers with webhook support for automatic build triggering.

VPC Support

Run builds inside a VPC for access to private resources, configuring VPC settings including subnets and security groups for build environments.

Build Caching

Cache build dependencies in Amazon S3 or locally within the build environment to speed up subsequent builds and reduce build times.

Custom Build Environments

Use your own Docker images as build environments, pulling from Amazon ECR or Docker Hub for fully customized build configurations.

Pay-Per-Build Pricing

Pay only for the build minutes you consume with no upfront costs or long-term commitments for on-demand build capacity.

Use Cases

Continuous Integration Pipelines

Automatically compile, test, and validate code changes on every commit to catch issues early and maintain code quality across development teams.

Automated Testing

Run unit tests, integration tests, and end-to-end tests as part of every build to ensure code correctness and prevent regressions.

Docker Image Building

Build and push Docker container images to Amazon ECR as part of a containerized application deployment workflow.

Multi-Environment Build Matrix

Use build batches to test across multiple runtime versions or configurations in parallel, identifying compatibility issues efficiently.

AWS CodePipeline Integration

Use CodeBuild as the build and test stage in an AWS CodePipeline CD pipeline for fully automated code delivery from commit to deployment.

Integrations

AWS CodePipeline

Add CodeBuild as build or test actions in CodePipeline deployment stages.

AWS CodeCommit

Use CodeCommit repositories as source for CodeBuild projects with webhook triggers.

GitHub

Integrate with GitHub repositories and pull request builds using webhooks.

GitLab

Use GitLab repositories as source for CodeBuild projects.

Bitbucket

Integrate with Bitbucket repositories for cloud-based CI.

Amazon ECR

Pull custom build environment images from ECR and push built container images.

Amazon S3

Store build artifacts and cache build dependencies in S3 buckets.

AWS IAM

Control access to build projects and builds with fine-grained IAM permissions.

Amazon CloudWatch

Monitor build metrics and set alarms on build duration, failure rates, and queued builds.

AWS Secrets Manager

Securely inject secrets and environment variables into build environments.

Semantic Vocabularies

Amazon Codebuild Context

11 classes · 29 properties

JSON-LD

API Governance Rules

Amazon CodeBuild API Rules

18 rules · 9 errors 8 warnings 1 info

SPECTRAL

JSON Structure

Amazon Codebuild Artifact Namespace Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Artifact Packaging Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Artifacts Type Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Auth Type Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Batch Restrictions Structure

2 properties

JSON STRUCTURE

Amazon Codebuild Boolean Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Build Artifacts Structure

7 properties

JSON STRUCTURE

Amazon Codebuild Build Batch Filter Structure

1 properties

JSON STRUCTURE

Amazon Codebuild Build Batch Ids Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Build Batch Phase Structure

6 properties

JSON STRUCTURE

Amazon Codebuild Build Batch Phases Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Build Batch Structure

30 properties

JSON STRUCTURE

Amazon Codebuild Build Batches Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Build Group Structure

5 properties

JSON STRUCTURE

Amazon Codebuild Build Groups Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Build Ids Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Build Not Deleted Structure

2 properties

JSON STRUCTURE

Amazon Codebuild Build Phase Structure

6 properties

JSON STRUCTURE

Amazon Codebuild Build Phase Type Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Build Phases Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Build Report Arns Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Build Structure

9 properties

JSON STRUCTURE

Amazon Codebuild Build Summaries Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Build Summary Structure

5 properties

JSON STRUCTURE

Amazon Codebuild Builds Not Deleted Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Builds Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Cache Mode Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Cache Type Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Code Coverage Structure

10 properties

JSON STRUCTURE

Amazon Codebuild Code Coverages Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Compute Type Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Debug Session Structure

2 properties

JSON STRUCTURE

Amazon Codebuild Environment Image Structure

3 properties

JSON STRUCTURE

Amazon Codebuild Environment Images Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Environment Type Structure

0 properties

JSON STRUCTURE

Amazon Codebuild File System Type Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Filter Group Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Filter Groups Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Git Clone Depth Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Identifiers Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Image Versions Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Key Input Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Language Type Structure

0 properties

JSON STRUCTURE

Amazon Codebuild List Builds Input Structure

2 properties

JSON STRUCTURE

Amazon Codebuild List Builds Output Structure

2 properties

JSON STRUCTURE

Amazon Codebuild List Reports Input Structure

4 properties

JSON STRUCTURE

Amazon Codebuild Logs Config Structure

2 properties

JSON STRUCTURE

Amazon Codebuild Logs Location Structure

8 properties

JSON STRUCTURE

Amazon Codebuild Network Interface Structure

2 properties

JSON STRUCTURE

Amazon Codebuild Non Empty String Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Non Negative Int Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Page Size Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Percentage Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Phase Context Structure

2 properties

JSON STRUCTURE

Amazon Codebuild Phase Contexts Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Platform Type Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Project Arns Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Project Artifacts Structure

10 properties

JSON STRUCTURE

Amazon Codebuild Project Badge Structure

2 properties

JSON STRUCTURE

Amazon Codebuild Project Cache Structure

3 properties

JSON STRUCTURE

Amazon Codebuild Project Name Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Project Names Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Project Source Structure

10 properties

JSON STRUCTURE

Amazon Codebuild Project Sources Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Project Structure

6 properties

JSON STRUCTURE

Amazon Codebuild Projects Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Report Arns Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Report Filter Structure

1 properties

JSON STRUCTURE

Amazon Codebuild Report Group Arns Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Report Group Name Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Report Group Structure

8 properties

JSON STRUCTURE

Amazon Codebuild Report Groups Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Report Status Type Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Report Structure

12 properties

JSON STRUCTURE

Amazon Codebuild Report Type Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Reports Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Resolved Artifact Structure

3 properties

JSON STRUCTURE

Amazon Codebuild Retry Build Input Structure

1 properties

JSON STRUCTURE

Amazon Codebuild Retry Build Output Structure

1 properties

JSON STRUCTURE

Amazon Codebuild S3 Logs Config Structure

4 properties

JSON STRUCTURE

Amazon Codebuild Security Group Ids Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Server Type Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Sort Order Type Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Source Auth Structure

2 properties

JSON STRUCTURE

Amazon Codebuild Source Auth Type Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Source Type Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Start Build Input Structure

30 properties

JSON STRUCTURE

Amazon Codebuild Start Build Output Structure

1 properties

JSON STRUCTURE

Amazon Codebuild Status Type Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Stop Build Input Structure

1 properties

JSON STRUCTURE

Amazon Codebuild Stop Build Output Structure

1 properties

JSON STRUCTURE

Amazon Codebuild String Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Subnets Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Tag List Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Tag Structure

2 properties

JSON STRUCTURE

Amazon Codebuild Test Case Filter Structure

2 properties

JSON STRUCTURE

Amazon Codebuild Test Case Structure

8 properties

JSON STRUCTURE

Amazon Codebuild Test Cases Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Time Out Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Timestamp Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Value Input Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Vpc Config Structure

3 properties

JSON STRUCTURE

Amazon Codebuild Webhook Build Type Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Webhook Filter Structure

3 properties

JSON STRUCTURE

Amazon Codebuild Webhook Structure

7 properties

JSON STRUCTURE

Amazon Codebuild Wrapper Boolean Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Wrapper Int Structure

0 properties

JSON STRUCTURE

Amazon Codebuild Wrapper Long Structure

0 properties

JSON STRUCTURE

Example Payloads

Amazon Codebuild Tag Example

2 fields

EXAMPLE

Resources

🔗
TrustCenter
TrustCenter
🔗
VulnerabilityDisclosure
VulnerabilityDisclosure
🔗
DomainSecurity
DomainSecurity
🔑
Authentication
Authentication
🚀
GettingStarted
GettingStarted
🔑
Authentication
Authentication
💰
Pricing
Pricing
🌐
Console
Console
🌐
Portal
Portal
🔗
Documentation
Documentation
📜
TermsOfService
TermsOfService
📜
PrivacyPolicy
PrivacyPolicy
🟢
StatusPage
StatusPage
📰
Blog
Blog
💬
FAQ
FAQ
📝
SignUp
SignUp
👥
GitHubOrganization
GitHubOrganization
👥
StackOverflow
StackOverflow
📰
Blog
Blog
🔗
SpectralRules
SpectralRules
🔗
Vocabulary
Vocabulary
🔗
JSONLD
JSONLD
🔗
Packages
Packages
🔗
WellKnown
WellKnown
🔗
SecurityTxt
SecurityTxt
🔗
MCPServer
MCPServer
🔗
LLMsTxt
LLMsTxt
🔗
Conformance
Conformance
🔗
Lifecycle
Lifecycle

Sources

Raw ↑
aid: amazon-codebuild
name: Amazon CodeBuild
description: AWS CodeBuild is a fully managed continuous integration service that compiles source code, runs tests, and produces
  ready-to-deploy software packages. CodeBuild scales continuously and processes multiple builds concurrently so your builds
  are not left waiting in a queue. It supports popular build environments for Java, Python, Node.js, Ruby, Go, Android, .NET
  Core, Docker, and more. CodeBuild integrates with AWS CodePipeline, GitHub, Bitbucket, and other source providers for end-to-end
  CI/CD workflows.
type: Index
image: https://kinlane-productions.s3.amazonaws.com/apis-json/apis-json-logo.jpg
tags:
- Amazon
- AWS
- CI/CD
- Build
- Continuous Integration
- DevOps
- Testing
url: https://raw.githubusercontent.com/api-evangelist/amazon-codebuild/refs/heads/main/apis.yml
created: '2024-01-15'
modified: '2026-06-20'
specificationVersion: '0.19'
apis:
- aid: amazon-codebuild:amazon-codebuild-api
  name: Amazon CodeBuild API
  description: The Amazon CodeBuild REST API enables programmatic management of build projects, builds, report groups, and
    source credentials. Create and configure build projects with custom environments, start and stop builds, retrieve build
    logs and artifacts, manage build batches, and configure webhooks for source providers.
  humanURL: https://docs.aws.amazon.com/codebuild/latest/APIReference/Welcome.html
  baseURL: https://codebuild.us-east-1.amazonaws.com
  tags:
  - Amazon
  - AWS
  - CI/CD
  - Build
  - Continuous Integration
  properties:
  - type: Documentation
    url: https://docs.aws.amazon.com/codebuild/latest/userguide/welcome.html
  - type: APIReference
    url: https://docs.aws.amazon.com/codebuild/latest/APIReference/Welcome.html
  - type: OpenAPI
    url: openapi/amazon-codebuild-openapi-original.yaml
  - type: Overlay
    url: overlays/amazon-codebuild-openapi-overlay.yaml
  - type: ErrorCatalog
    url: errors/amazon-codebuild-problem-types.yml
common:
- type: TrustCenter
  url: security/amazon-codebuild-trust-center.yml
- type: VulnerabilityDisclosure
  url: security/amazon-codebuild-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/amazon-codebuild-domain-security.yml
- type: Authentication
  url: authentication/amazon-codebuild-authentication.yml
- type: GettingStarted
  url: https://aws.amazon.com/codebuild/getting-started/
- type: Authentication
  url: https://docs.aws.amazon.com/codebuild/latest/userguide/auth-and-access-control.html
- type: Pricing
  url: https://aws.amazon.com/codebuild/pricing/
- type: Console
  url: https://console.aws.amazon.com/codebuild/
- type: Portal
  url: https://aws.amazon.com/codebuild/
- type: Documentation
  url: https://docs.aws.amazon.com/codebuild/latest/userguide/
- type: TermsOfService
  url: https://aws.amazon.com/service-terms/
- type: PrivacyPolicy
  url: https://aws.amazon.com/privacy/
- type: StatusPage
  url: https://health.aws.amazon.com/health/status
- type: Blog
  url: https://aws.amazon.com/blogs/devops/
- type: FAQ
  url: https://aws.amazon.com/codebuild/faqs/
- type: SignUp
  url: https://portal.aws.amazon.com/gp/aws/developer/registration/index.html
- type: GitHubOrganization
  url: https://github.com/aws
- type: StackOverflow
  url: https://stackoverflow.com/questions/tagged/aws-codebuild
- type: Blog
  url: https://aws.amazon.com/blogs/devops/tag/aws-codebuild/feed/
- type: SpectralRules
  url: rules/amazon-codebuild-spectral-rules.yml
- type: Vocabulary
  url: vocabulary/amazon-codebuild-vocabulary.yaml
- type: JSONLD
  url: json-ld/amazon-codebuild-context.jsonld
- type: Packages
  url: packages/amazon-codebuild-packages.yml
- type: WellKnown
  url: well-known/amazon-codebuild-well-known.yml
- type: SecurityTxt
  url: well-known/amazon-codebuild-security.txt
- type: MCPServer
  url: mcp/amazon-codebuild-mcp.yml
- type: LLMsTxt
  url: llms/amazon-codebuild-llms.txt
- type: Conformance
  url: conformance/amazon-codebuild-conformance.yml
- type: Lifecycle
  url: lifecycle/amazon-codebuild-lifecycle.yml
- type: Features
  data:
  - name: Fully Managed Build Service
    description: No need to provision, manage, or scale build servers. AWS handles all infrastructure management so you can
      focus on writing code.
  - name: Continuous Scaling
    description: Automatically scales to meet peak build demand. Processes multiple builds concurrently so builds are never
      left waiting in a queue.
  - name: Pre-configured Build Environments
    description: Out-of-the-box build environments for Java, Python, Node.js, Ruby, Go, Android, .NET Core, Docker, and more.
      Customize with your own build tools.
  - name: Build Batches
    description: Run multiple related builds in parallel as a batch sharing the same source configuration and retrieve combined
      results for the entire batch.
  - name: Test Reports
    description: Collect and analyze test results from unit tests, integration tests, and code coverage reports. Track test
      trends and identify flaky tests.
  - name: Source Integration
    description: Integrate with CodeCommit, GitHub, GitHub Enterprise, GitLab, Bitbucket, and Amazon S3 as source providers
      with webhook support for automatic build triggering.
  - name: VPC Support
    description: Run builds inside a VPC for access to private resources, configuring VPC settings including subnets and security
      groups for build environments.
  - name: Build Caching
    description: Cache build dependencies in Amazon S3 or locally within the build environment to speed up subsequent builds
      and reduce build times.
  - name: Custom Build Environments
    description: Use your own Docker images as build environments, pulling from Amazon ECR or Docker Hub for fully customized
      build configurations.
  - name: Pay-Per-Build Pricing
    description: Pay only for the build minutes you consume with no upfront costs or long-term commitments for on-demand build
      capacity.
- type: UseCases
  data:
  - name: Continuous Integration Pipelines
    description: Automatically compile, test, and validate code changes on every commit to catch issues early and maintain
      code quality across development teams.
  - name: Automated Testing
    description: Run unit tests, integration tests, and end-to-end tests as part of every build to ensure code correctness
      and prevent regressions.
  - name: Docker Image Building
    description: Build and push Docker container images to Amazon ECR as part of a containerized application deployment workflow.
  - name: Multi-Environment Build Matrix
    description: Use build batches to test across multiple runtime versions or configurations in parallel, identifying compatibility
      issues efficiently.
  - name: AWS CodePipeline Integration
    description: Use CodeBuild as the build and test stage in an AWS CodePipeline CD pipeline for fully automated code delivery
      from commit to deployment.
- type: Integrations
  data:
  - name: AWS CodePipeline
    description: Add CodeBuild as build or test actions in CodePipeline deployment stages.
  - name: AWS CodeCommit
    description: Use CodeCommit repositories as source for CodeBuild projects with webhook triggers.
  - name: GitHub
    description: Integrate with GitHub repositories and pull request builds using webhooks.
  - name: GitLab
    description: Use GitLab repositories as source for CodeBuild projects.
  - name: Bitbucket
    description: Integrate with Bitbucket repositories for cloud-based CI.
  - name: Amazon ECR
    description: Pull custom build environment images from ECR and push built container images.
  - name: Amazon S3
    description: Store build artifacts and cache build dependencies in S3 buckets.
  - name: AWS IAM
    description: Control access to build projects and builds with fine-grained IAM permissions.
  - name: Amazon CloudWatch
    description: Monitor build metrics and set alarms on build duration, failure rates, and queued builds.
  - name: AWS Secrets Manager
    description: Securely inject secrets and environment variables into build environments.
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com