Amazon CodeDeploy

AWS CodeDeploy is a fully managed deployment service that automates software deployments to various compute services such as Amazon EC2, AWS Fargate, AWS Lambda, and on-premises servers. CodeDeploy makes it easier to rapidly release new features, helps avoid downtime during application deployment, and handles the complexity of updating your applications with in-place, blue/green, and canary deployment strategies.

1 APIs 7 Features
AmazonDeploymentDevOpsCI/CDRelease ManagementBlue/Green Deployment

APIs

Amazon CodeDeploy API

The Amazon CodeDeploy REST API enables programmatic management of applications, deployment groups, deployment configurations, and deployments. Create and update deployment group...

MCP Servers

Features

Multiple Deployment Strategies

Support for in-place, blue/green, and canary deployment strategies across EC2, Lambda, ECS, and on-premises targets to minimize downtime and risk.

Automated Rollbacks

Automatically roll back deployments if a specified number of instances fail health checks or if CloudWatch alarms are triggered during deployment.

Deployment Lifecycle Hooks

Define custom lifecycle event hooks (BeforeInstall, AfterInstall, ApplicationStart, etc.) using scripts or Lambda functions for fine-grained deployment control.

Traffic Shifting for Lambda and ECS

Implement canary and linear traffic shifting for Lambda function updates and ECS service deployments with configurable traffic weights and bake times.

Deployment Groups

Organize deployment targets using deployment groups with EC2 instance tags, Auto Scaling groups, ECS clusters, or on-premises instance tags.

CodeDeploy Agent

Install the CodeDeploy agent on EC2 or on-premises instances to enable deployment target registration and lifecycle hook execution.

Integration with AWS Load Balancers

Integrate with Application Load Balancers and Network Load Balancers for blue/green deployments that shift traffic between original and replacement instances.

Use Cases

Zero-Downtime Application Updates

Use blue/green deployments to update applications without downtime by routing traffic to a new environment while keeping the original environment available for rollback.

Lambda Function Updates

Deploy new Lambda function versions with canary or linear traffic shifting to gradually migrate traffic from the current version to the updated function version.

ECS Service Deployment

Deploy updated container tasks to ECS services with blue/green deployments and configurable traffic shifting through an Application Load Balancer.

On-Premises Application Deployment

Extend cloud-based deployment automation to on-premises servers using the CodeDeploy agent and on-premises instance registration.

Multi-Stage CD Pipeline

Use CodeDeploy as the deployment stage in an AWS CodePipeline for fully automated continuous delivery from source code to production.

Integrations

AWS CodePipeline

Use CodeDeploy as the deployment stage in CodePipeline CD pipelines.

AWS CodeBuild

Trigger CodeDeploy deployments from build artifacts produced by CodeBuild.

AWS Lambda

Deploy Lambda function updates with traffic shifting strategies.

Amazon ECS

Deploy ECS service updates with blue/green deployments.

AWS CloudWatch

Trigger automatic rollbacks based on CloudWatch alarm states.

Elastic Load Balancing

Integrate with ALB and NLB for blue/green traffic shifting.

Amazon EC2 Auto Scaling

Deploy to Auto Scaling groups with automatic instance health checking.

AWS Systems Manager

Use SSM Run Command and State Manager for deployment automation.

GitHub

Deploy application revisions stored in GitHub repositories.

Amazon S3

Store and retrieve application deployment bundles from S3.

Semantic Vocabularies

Amazon Codedeploy Context

16 classes · 29 properties

JSON-LD

API Governance Rules

Amazon CodeDeploy API Rules

9 rules · 5 errors 3 warnings 1 info

SPECTRAL

JSON Structure

Amazon Codedeploy Alarm List Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Alarm Name Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Alarm Structure

1 properties

JSON STRUCTURE

Amazon Codedeploy App Spec Content Structure

2 properties

JSON STRUCTURE

Amazon Codedeploy Application Id Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Application Info Structure

6 properties

JSON STRUCTURE

Amazon Codedeploy Application Name Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Applications List Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Arn Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Boolean Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Bundle Type Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Commit Id Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Compute Platform Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Deployment Id Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Deployment Info Structure

30 properties

JSON STRUCTURE

Amazon Codedeploy Deployment Option Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Deployment Status Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Deployment Style Structure

2 properties

JSON STRUCTURE

Amazon Codedeploy Deployment Target Structure

5 properties

JSON STRUCTURE

Amazon Codedeploy Deployment Type Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Deployments List Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Description Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Diagnostics Structure

4 properties

JSON STRUCTURE

Amazon Codedeploy Duration Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy E Tag Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Ec2 Tag Filter Structure

3 properties

JSON STRUCTURE

Amazon Codedeploy Ec2 Tag Set List Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Ec2 Tag Set Structure

1 properties

JSON STRUCTURE

Amazon Codedeploy Ecs Cluster Name Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Ecs Service List Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Ecs Service Name Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Ecs Service Structure

2 properties

JSON STRUCTURE

Amazon Codedeploy Ecs Target Structure

7 properties

JSON STRUCTURE

Amazon Codedeploy Ecs Task Set List Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Ecs Task Set Structure

8 properties

JSON STRUCTURE

Amazon Codedeploy Elb Info List Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Elb Info Structure

1 properties

JSON STRUCTURE

Amazon Codedeploy Elb Name Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Error Code Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Error Information Structure

2 properties

JSON STRUCTURE

Amazon Codedeploy Error Message Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy External Id Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Filter Value List Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Filter Value Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Git Hub Location Structure

2 properties

JSON STRUCTURE

Amazon Codedeploy Iam Session Arn Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Iam User Arn Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Instance Action Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Instance Arn Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Instance Count Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Instance Id Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Instance Info Structure

7 properties

JSON STRUCTURE

Amazon Codedeploy Instance Name Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Instance Status Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Instance Summary Structure

6 properties

JSON STRUCTURE

Amazon Codedeploy Instance Target Structure

7 properties

JSON STRUCTURE

Amazon Codedeploy Instance Type Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Instances List Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Key Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Lambda Target Structure

7 properties

JSON STRUCTURE

Amazon Codedeploy Lifecycle Event Structure

5 properties

JSON STRUCTURE

Amazon Codedeploy Lifecycle Message Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Listener Arn List Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Listener Arn Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Log Tail Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Message Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Next Token Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Nullable Boolean Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Percentage Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Raw String Sha256 Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Raw String Structure

2 properties

JSON STRUCTURE

Amazon Codedeploy Repository Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Revision Info Structure

2 properties

JSON STRUCTURE

Amazon Codedeploy Revision Location Structure

5 properties

JSON STRUCTURE

Amazon Codedeploy Role Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Rollback Info Structure

3 properties

JSON STRUCTURE

Amazon Codedeploy S3 Bucket Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy S3 Key Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy S3 Location Structure

5 properties

JSON STRUCTURE

Amazon Codedeploy Script Name Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Sort Order Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Stop Status Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Tag Filter List Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Tag Filter Structure

3 properties

JSON STRUCTURE

Amazon Codedeploy Tag Filter Type Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Tag Key List Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Tag List Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Tag Structure

2 properties

JSON STRUCTURE

Amazon Codedeploy Target Arn Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Target Filters Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Target Group Info Structure

1 properties

JSON STRUCTURE

Amazon Codedeploy Target Group Name Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Target Id List Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Target Id Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Target Instances Structure

3 properties

JSON STRUCTURE

Amazon Codedeploy Target Label Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Target Status Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Time Based Canary Structure

2 properties

JSON STRUCTURE

Amazon Codedeploy Time Based Linear Structure

2 properties

JSON STRUCTURE

Amazon Codedeploy Time Range Structure

2 properties

JSON STRUCTURE

Amazon Codedeploy Time Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Timestamp Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Traffic Route Structure

1 properties

JSON STRUCTURE

Amazon Codedeploy Traffic Weight Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Trigger Config Structure

3 properties

JSON STRUCTURE

Amazon Codedeploy Trigger Name Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Value Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Version Id Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Version Structure

0 properties

JSON STRUCTURE

Amazon Codedeploy Wait Time In Mins Structure

0 properties

JSON STRUCTURE

Example Payloads

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
📰
BlogRSS
BlogRSS
💬
FAQ
FAQ
📝
SignUp
SignUp
👥
GitHubOrganization
GitHubOrganization
🔗
SpectralRules
SpectralRules
🔗
Vocabulary
Vocabulary
🔗
JSONLD
JSONLD
🔗
Packages
Packages
🔗
WellKnown
WellKnown
🔗
SecurityTxt
SecurityTxt
🔗
MCPServer
MCPServer
🔗
LLMsTxt
LLMsTxt
🔗
Overlay
Overlay
🔗
Conformance
Conformance
🔗
ErrorCatalog
ErrorCatalog
🔗
Lifecycle
Lifecycle

Sources

Raw ↑
aid: amazon-codedeploy
name: Amazon CodeDeploy
description: AWS CodeDeploy is a fully managed deployment service that automates software deployments to various compute services
  such as Amazon EC2, AWS Fargate, AWS Lambda, and on-premises servers. CodeDeploy makes it easier to rapidly release new
  features, helps avoid downtime during application deployment, and handles the complexity of updating your applications with
  in-place, blue/green, and canary deployment strategies.
type: Index
image: https://kinlane-productions.s3.amazonaws.com/apis-json/apis-json-logo.jpg
tags:
- Amazon
- AWS
- Deployment
- DevOps
- CI/CD
- Release Management
- Blue/Green Deployment
url: https://raw.githubusercontent.com/api-evangelist/amazon-codedeploy/refs/heads/main/apis.yml
created: '2026-03-16'
modified: '2026-06-20'
specificationVersion: '0.19'
apis:
- aid: amazon-codedeploy:amazon-codedeploy-api
  name: Amazon CodeDeploy API
  description: The Amazon CodeDeploy REST API enables programmatic management of applications, deployment groups, deployment
    configurations, and deployments. Create and update deployment groups, trigger deployments to EC2, Lambda, ECS, and on-premises
    targets, monitor deployment status, and manage deployment lifecycle hooks and rollback policies.
  humanURL: https://docs.aws.amazon.com/codedeploy/latest/APIReference/Welcome.html
  baseURL: https://codedeploy.us-east-1.amazonaws.com
  tags:
  - Amazon
  - AWS
  - Deployment
  - DevOps
  - CI/CD
  properties:
  - type: Documentation
    url: https://docs.aws.amazon.com/codedeploy/latest/userguide/welcome.html
  - type: APIReference
    url: https://docs.aws.amazon.com/codedeploy/latest/APIReference/Welcome.html
  - type: OpenAPI
    url: openapi/amazon-codedeploy-openapi-original.yaml
common:
- type: TrustCenter
  url: security/amazon-codedeploy-trust-center.yml
- type: VulnerabilityDisclosure
  url: security/amazon-codedeploy-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/amazon-codedeploy-domain-security.yml
- type: Authentication
  url: authentication/amazon-codedeploy-authentication.yml
- type: GettingStarted
  url: https://docs.aws.amazon.com/codedeploy/latest/userguide/getting-started-codedeploy.html
- type: Authentication
  url: https://docs.aws.amazon.com/codedeploy/latest/userguide/auth-and-access-control.html
- type: Pricing
  url: https://aws.amazon.com/codedeploy/pricing/
- type: Console
  url: https://console.aws.amazon.com/codedeploy/
- type: Portal
  url: https://aws.amazon.com/codedeploy/
- type: Documentation
  url: https://docs.aws.amazon.com/codedeploy/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: BlogRSS
  url: https://aws.amazon.com/blogs/devops/tag/aws-codedeploy/feed/
- type: FAQ
  url: https://aws.amazon.com/codedeploy/faqs/
- type: SignUp
  url: https://portal.aws.amazon.com/gp/aws/developer/registration/index.html
- type: GitHubOrganization
  url: https://github.com/aws
- type: SpectralRules
  url: rules/amazon-codedeploy-spectral-rules.yml
- type: Vocabulary
  url: vocabulary/amazon-codedeploy-vocabulary.yaml
- type: JSONLD
  url: json-ld/amazon-codedeploy-context.jsonld
- type: Packages
  url: packages/amazon-codedeploy-packages.yml
- type: WellKnown
  url: well-known/amazon-codedeploy-well-known.yml
- type: SecurityTxt
  url: well-known/amazon-codedeploy-security.txt
- type: MCPServer
  url: mcp/amazon-codedeploy-mcp.yml
- type: LLMsTxt
  url: llms/amazon-codedeploy-llms.txt
- type: Overlay
  url: overlays/amazon-codedeploy-openapi-overlay.yaml
- type: Conformance
  url: conformance/amazon-codedeploy-conformance.yml
- type: ErrorCatalog
  url: errors/amazon-codedeploy-problem-types.yml
- type: Lifecycle
  url: lifecycle/amazon-codedeploy-lifecycle.yml
- type: Features
  data:
  - name: Multiple Deployment Strategies
    description: Support for in-place, blue/green, and canary deployment strategies across EC2, Lambda, ECS, and on-premises
      targets to minimize downtime and risk.
  - name: Automated Rollbacks
    description: Automatically roll back deployments if a specified number of instances fail health checks or if CloudWatch
      alarms are triggered during deployment.
  - name: Deployment Lifecycle Hooks
    description: Define custom lifecycle event hooks (BeforeInstall, AfterInstall, ApplicationStart, etc.) using scripts or
      Lambda functions for fine-grained deployment control.
  - name: Traffic Shifting for Lambda and ECS
    description: Implement canary and linear traffic shifting for Lambda function updates and ECS service deployments with
      configurable traffic weights and bake times.
  - name: Deployment Groups
    description: Organize deployment targets using deployment groups with EC2 instance tags, Auto Scaling groups, ECS clusters,
      or on-premises instance tags.
  - name: CodeDeploy Agent
    description: Install the CodeDeploy agent on EC2 or on-premises instances to enable deployment target registration and
      lifecycle hook execution.
  - name: Integration with AWS Load Balancers
    description: Integrate with Application Load Balancers and Network Load Balancers for blue/green deployments that shift
      traffic between original and replacement instances.
- type: UseCases
  data:
  - name: Zero-Downtime Application Updates
    description: Use blue/green deployments to update applications without downtime by routing traffic to a new environment
      while keeping the original environment available for rollback.
  - name: Lambda Function Updates
    description: Deploy new Lambda function versions with canary or linear traffic shifting to gradually migrate traffic from
      the current version to the updated function version.
  - name: ECS Service Deployment
    description: Deploy updated container tasks to ECS services with blue/green deployments and configurable traffic shifting
      through an Application Load Balancer.
  - name: On-Premises Application Deployment
    description: Extend cloud-based deployment automation to on-premises servers using the CodeDeploy agent and on-premises
      instance registration.
  - name: Multi-Stage CD Pipeline
    description: Use CodeDeploy as the deployment stage in an AWS CodePipeline for fully automated continuous delivery from
      source code to production.
- type: Integrations
  data:
  - name: AWS CodePipeline
    description: Use CodeDeploy as the deployment stage in CodePipeline CD pipelines.
  - name: AWS CodeBuild
    description: Trigger CodeDeploy deployments from build artifacts produced by CodeBuild.
  - name: AWS Lambda
    description: Deploy Lambda function updates with traffic shifting strategies.
  - name: Amazon ECS
    description: Deploy ECS service updates with blue/green deployments.
  - name: AWS CloudWatch
    description: Trigger automatic rollbacks based on CloudWatch alarm states.
  - name: Elastic Load Balancing
    description: Integrate with ALB and NLB for blue/green traffic shifting.
  - name: Amazon EC2 Auto Scaling
    description: Deploy to Auto Scaling groups with automatic instance health checking.
  - name: AWS Systems Manager
    description: Use SSM Run Command and State Manager for deployment automation.
  - name: GitHub
    description: Deploy application revisions stored in GitHub repositories.
  - name: Amazon S3
    description: Store and retrieve application deployment bundles from S3.
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com