API Error Codes

There are two types of error codes: client and server.

Client error codes suggest that the error was caused by something the client did, such as an authentication failure or an invalid AMI identifier. In the SOAP API, These error codes are prefixed with Client. For example: Client.AuthFailure. In the Query API, these errors are accompanied by a 400-series HTTP response code.

Server error codes suggest a server-side issue caused the error and should be reported. In the SOAP API, these error codes are prefixed with Server. For example: Server.Unavailable. In the Query API, these errors are accompanied by a 500-series HTTP response code.

Error CodeDescriptionNotes
AddressLimitExceeded User has the maximum number of allowed IP addresses. Each user has an IP address limit. For new users, this limit is 5. If you need more than 5 Elastic IP addresses, please complete the Amazon EC2 Elastic IP Address Request Form. We will ask you to think through your use case and help us understand your need for additional addresses.
AuthFailure User not authorized. You might be trying to run an AMI for which you do not have permission.
InvalidManifest Specified AMI has an unparsable Manifest.
InvalidAMIID.Malformed Specified AMI ID is not valid.
InvalidAMIID.NotFound Specified AMI ID does not exist.
InvalidAMIID.Unavailable Specified AMI ID has been deregistered and is no longer available.
InvalidInstanceID.Malformed Specified instance ID is not valid.
InvalidInstanceID.NotFound Specified instance ID does not exist.
InvalidKeyPair.NotFound Specified key pair name does not exist.
InvalidKeyPair.Duplicate Attempt to create a duplicate key pair.
InvalidGroup.NotFound Specified group name does not exist.
InvalidGroup.Duplicate Attempt to create a duplicate group.
InvalidGroup.InUse Specified group cannot be deleted because it is in use.
InvalidGroup.Reserved Specified group name is a reserved name.
InvalidParameterValue The value supplied for a parameter was invalid. Requests that could cause this error include (for example) supplying an invalid image attribute to the DescribeImageAttribute request or an invalid version or encoding value for the userData in a RunInstances request.
InvalidPermission.Duplicate Attempt to authorize a permission that has already been authorized.
InvalidPermission.Malformed Specified permission is invalid.
InvalidReservationID.Malformed Specified reservation ID is invalid.
InvalidReservationID.NotFound Specified reservation ID does not exist.
InstanceLimitExceeded User has max allowed concurrent running instances. Each user has a concurrent running instance limit. For new users, this limit is 20. If you need more than 20 instances, please complete the Amazon EC2 Instance Request Form and your request will be considered.
InvalidParameterCombination RunInstances was called with minCount and maxCount set to 0 or minCount > maxCount.
InvalidUserID.MalformedThe user ID is neither in the form of an AWS account ID or one of the special values accepted by the owner or executableBy flags in the DescribeImages call. 
InvalidAMIAttributeItemValueThe value of an item added to, or removed from, an image attribute is invalid.If you are specifying a userId, check that it is in the form of an AWS account ID.
UnknownParameter An unknown or unrecognized parameter was supplied. Requests that could cause this error include supplying a misspelled parameter or a parameter that is not supported for the specified API version.
Error CodeDescriptionNotes
InternalError Internal Error. This error should not occur. If it does, please try to reproduce it and let us know by posting a message on the AWS forums.
InsufficientAddressCapacity Not enough available addresses to satisfy your minimum request. Reduce the number of addresses you are requesting or wait for additional capacity to become available.
InsufficientInstanceCapacity Not enough available instances to satisfy your minimum request. Reduce the number of instances in your request or wait for additional capacity to become available.
Unavailable The server is overloaded and cannot handle the request.