Error codes for AWS CodeDeploy (original) (raw)
This topic provides reference information about CodeDeploy errors.
| Error Code | Description |
|---|---|
| AGENT_ISSUE | The deployment failed because of a problem with the CodeDeploy agent. Make sure the agent is installed and running on all instances in this deployment group. Learn more: Verify the CodeDeploy agent is running Install the CodeDeploy agent Working with the CodeDeploy agent |
| 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 2: Create a service role for CodeDeploy Creating a Role to Delegate Permissions to an AWS Service |
| 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 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 2: Create a service role for CodeDeploy Change deployment group settings with CodeDeploy |
| IAM_ROLE_PERMISSIONS | 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: Setting up Step 2: Create a service role for CodeDeploy Step 4: Create an IAM instance profile for your Amazon EC2 instances |
| NO_INSTANCES | This might be caused by one of the following. For an EC2/On-Premises blue/green deployment, if you use Amazon EC2 tags they might not be configured properly. In your CodeDeploy deployment group, make sure they are included in your blue instances and your green instances. You can confirm your instances are tagged properly using the Amazon EC2 console. If you use an Amazon EC2 Auto Scaling group, your Auto Scaling group might not have enough capacity. Make sure your Auto Scaling group has enough capacity for your deployment. You can view the capacity of your Amazon EC2 Auto Scaling group by looking at its number of healthy instances using the Amazon EC2 console. For an EC2/On-Premises blue/green deployment, the blue and green fleets might not be the same size. Make sure both fleets are the same size. Learn more: Tagging Instances for Deployments Tutorial: Use CodeDeploy to deploy an application to an Auto Scaling group Create an application for a blue/green deployment (console) |
| 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 CodeDeploy CodeDeploy quotas 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 CodeDeploy console, delete the Amazon EC2 Auto Scaling group from the deployment group, and then add it again. Learn more: Under the Hood: CodeDeploy and Auto Scaling Integration |
Troubleshoot Amazon EC2 Auto Scaling issues
Resources
Did this page help you? - Yes
Thanks for letting us know we're doing a good job!
If you've got a moment, please tell us what we did right so we can do more of it.
Did this page help you? - No
Thanks for letting us know this page needs work. We're sorry we let you down.
If you've got a moment, please tell us how we can make the documentation better.