AWS Documentation » AWS CodeDeploy » User Guide » Troubleshooting AWS CodeDeploy » Error Codes for AWS CodeDeploy

The procedures in this guide support the new console design. If you choose to use the older version of the console, you will find many of the concepts and basic procedures in this guide still apply. To access help in the new console, choose the information icon.

Error Codes for AWS CodeDeploy

This topic provides reference information about AWS CodeDeploy errors.

Error Code	Description
AGENT_ISSUE	The deployment failed because of a problem with the AWS CodeDeploy agent. Make sure the agent is installed and running on all instances in this deployment group. Learn more: Verify the AWS CodeDeploy Agent Is Running Install or Reinstall the AWS CodeDeploy Agent Working with the AWS CodeDeploy Agent
HEALTH_CONSTRAINTS	The overall deployment failed because too many individual instances failed deployment, too few healthy instances are available for deployment, or some instances in your deployment group are experiencing problems. Learn more: Instance Health Troubleshoot Instance Issues Troubleshoot EC2/On-Premises Deployment Issues
HEALTH_CONSTRAINTS_INVALID	The deployment can’t start because the minimum number of healthy instances, as defined by your deployment configuration, are not available. You can reduce the required number of healthy instances by updating your deployment configuration or increase the number of instances in this deployment group. Learn more: Instance Health Working with Instances for AWS CodeDeploy
IAM_ROLE_MISSING	The deployment failed because no service role exists with the service role name specified for the deployment group. Make sure you are using the correct service role name. Learn more: Step 3: Create a Service Role for AWS CodeDeploy Change Deployment Group Settings with AWS CodeDeploy
IAM_ROLE_PERMISSIONS	AWS CodeDeploy does not have the permissions required to assume a role, or the IAM role you're using does't give you permission to perform operations in an AWS service. Learn more: Step 1: Provision an IAM User Step 3: Create a Service Role for AWS CodeDeploy Step 4: Create an IAM Instance Profile for Your Amazon EC2 Instances
AUTO_SCALING_IAM_ROLE_PERMISSIONS	The service role associated with your deployment group does not have the permission required to perform operations in the following AWS service. Learn more: Step 3: Create a Service Role for AWS CodeDeploy Creating a Role to Delegate Permissions to an AWS Service
OVER_MAX_INSTANCES	The deployment failed because more instances are targeted for deployment than are allowed for your account. To reduce the number of instances targeted for this deployment, update the tag settings for this deployment group or delete some of the targeted instances. Alternatively, you can contact AWS Support to request a limit increase. Learn more: Change Deployment Group Settings with AWS CodeDeploy AWS CodeDeploy Limits Request a Limit Increase
THROTTLED	The deployment failed because more requests were made than are permitted for AWS CodeDeploy by an IAM role. Try reducing the number of requests. Learn more: Query API Request Rate
UNABLE_TO_SEND_ASG	The deployment failed because the deployment group isn’t configured correctly with its Amazon EC2 Auto Scaling group. In the AWS CodeDeploy console, delete the Amazon EC2 Auto Scaling group from the deployment group, and then add it again. Learn more: Under the Hood: AWS CodeDeploy and Auto Scaling Integration

Related Topics

Troubleshooting AWS CodeDeploy