| « Previous | |
  | Did this page help you? Yes | No | Tell us about it... |
Error Codes
Topics
Overview
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 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 Query API, these errors are accompanied by a 500-series HTTP response code.
Summary of Client Error Codes
| Error Code | Description | Notes |
|---|---|---|
AddressLimitExceeded
| You've reached the limit on the number of elastic IP addresses your account can have. |
Each AWS account has an EC2 elastic IP address limit. For new accounts, this limit is 5. If you need more than 5 EC2 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. You have a separate limit for VPC elastic IP addresses (5). To request to increase the limit, complete the Amazon VPC Limits form. |
AttachmentLimitExceeded
| You've reached the limit on the number of Amazon EBS volumes that can be attached to a single instance. | |
AuthFailure
| User not authorized. | You might be trying to run an AMI for which you do not have permission. |
Blocked
| The account is currently blocked. | Contact aws-verification@amazon.com if you have questions. |
CustomerGatewayLimitExceeded
| You've reached the limit on the number of customer gateways you can create. | |
DependencyViolation
| The specified object has dependent resources. | |
DiskImageSizeTooLarge
| The disk image exceeds the allowed limit (for instance or volume import). | |
FilterLimitExceeded
| Request uses too many filters or too many total filter values. | |
Gateway.NotAttached
| Specified gateway isn't attached, so it can't be detached. | |
IdempotentParameterMismatch
| Request uses the same client token as a previous, but non-identical request. | Do not reuse a client token with different requests, unless the requests are identical. |
IncorrectInstanceState
| Instance is in an incorrect state so the attempted action cannot occur. | |
IncorrectState
| Volume is in an incorrect state. | To attach to an instance, it must be in the 'available' state. |
InstanceLimitExceeded
| Account has maximum allowed concurrent running instances. | Each AWS account has a concurrent running instance limit. For new accounts, 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. |
InsufficientInstanceCapacity
| There is insufficient capacity available for the requested instance type. | The returned message gives guidance on how to solve the problem. |
InsufficientReservedInstancesCapacity
| Insufficient Reserved Instances capacity. | |
InternetGatewayLimitExceeded
| You've reached the limit on the number of Internet gateways you can create. | |
InvalidAMIAttributeItemValue
| The 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. |
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. | |
InvalidAssociationID.NotFound
| Specified association ID does not exist. | |
InvalidAttachment.NotFound
| The instance cannot detach from a volume to which it is not attached. | |
InvalidConversionTaskId
| Specified conversion task ID (for instance or volume import) is invalid. | |
InvalidCustomerGateway.DuplicateIpAddress
| Conflict among chosen gateway IP addresses. | |
InvalidCustomerGatewayID.NotFound
| The specified customer gateway ID does not exist. | |
InvalidDevice.InUse
| The device to which you are trying to attach (i.e. /dev/sdh) is already in use on the instance. | |
InvalidDhcpOptionsID.NotFound
| Specified DHCP options ID does not exist. | |
InvalidFormat
| Specified disk format (for instance or volume import) is invalid. | |
InvalidFilter
| Specified filter is invalid. | |
InvalidGatewayID.NotFound
| Specified gateway ID does not exist. | |
InvalidGroup.Duplicate
| Attempt to create a duplicate group. | |
InvalidGroupId.Malformed
| Specified group ID is invalid. | |
InvalidGroup.InUse
| Specified group cannot be deleted because it is in use. | |
InvalidGroup.NotFound
| Specified security group does not exist. | This error may occur because the security group ID has not propagated through the system. For more information, see Eventual Consistency. |
InvalidGroup.Reserved
| Specified group name is a reserved name. | |
InvalidInstanceAttributeValue | The specified instance attribute value is not valid. | This error is most commonly encountered when trying to set the
InstanceType/--instance-type attribute to
an unrecognized value. |
InvalidInstanceID.Malformed
| Specified instance ID is not valid. | |
InvalidInstanceID.NotFound
| Specified instance ID does not exist. | This error may occur because the instance ID has not propagated through the system. For more information, see Eventual Consistency. |
InvalidInternetGatewayID.NotFound
| Specified Internet gateway ID does not exist. | |
InvalidIPAddress.InUse
| Specified IP address is currently in use. | |
InvalidKeyPair.Duplicate
| Attempt to create a duplicate key pair. | |
InvalidKeyPair.Format
| Format of the public key you've attempted to import is invalid. | |
InvalidKeyPair.NotFound
| Specified key pair name does not exist. | |
InvalidManifest
| Specified AMI has an unparsable manifest. | |
InvalidNetworkAclEntry.NotFound
| Specified network ACL entry does not exist. | |
InvalidNetworkAclID.NotFound
| Specified network ACL ID does not exist. | |
InvalidParameterCombination
| Example: RunInstances was called with both minCount and maxCount set to 0, or minCount > maxCount. | |
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. | |
InvalidRoute.NotFound
| Specified route does not exist in the route table. | |
InvalidRouteTableID.NotFound
| Specified route table ID does not exist. | |
InvalidSecurity.RequestHasExpired
| The difference between the request timestamp and the AWS server time is greater than 5 minutes. | Ensure that your system clock is accurate and configured to use the correct time zone. |
InvalidSnapshotID.Malformed
| The snapshot ID that was passed as an argument was malformed. | |
InvalidSnapshot.InUse
| The snapshot which you are trying to delete is in use by one or more AMIs. | |
InvalidSnapshot.NotFound
| The specified snapshot does not exist. | |
InvalidUserID.Malformed
| The 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. | |
InvalidReservedInstancesId
| Reserved Instances ID not found. | |
InvalidReservedInstancesOfferingId
| Reserved Instances Offering ID not found. | |
InvalidSubnetID.NotFound
| Specified subnet ID does not exist. | |
InvalidVolumeID.Duplicate
| Volume already exists in the system. | |
InvalidVolumeID.Malformed
| Specified volume ID was malformed. | |
InvalidVolumeID.ZoneMismatch
| Specified volume ID and instance ID are in different Availability Zones. | |
InvalidVolume.NotFound
| Specified volume does not exist. | |
InvalidVpcID.NotFound
| Specified VPC ID does not exist. | |
InvalidVpnConnectionID.NotFound
| The specified VPN connection ID does not exist. | |
InvalidVpnGatewayID.NotFound
| Specified virtual private gateway ID does not exist. | |
InvalidZone.NotFound
| The specified zone does not exist. | |
LegacySecurityGroup
| You must delete the 2009-07-15-default security group before you can attach an Internet gateway. | |
MissingParameter
| The request is missing a required parameter. | |
NetworkAclEntryAlreadyExists
| Specified rule number already exists in this network ACL. | |
NetworkAclEntryLimitExceeded
| You've reached the limit on the number of network ACL entries you can add to the ACL. | |
NetworkAclLimitExceeded
| You've reached the limit on the number of network ACLs you can create. | |
NonEBSInstance
| The instance specified does not support EBS. | Please restart the instance and try again. This will ensure that the code is run on an instance with updated code. |
OptInRequired
| The user is not authorized to use the requested product. | This error message can apply to Amazon EC2 or individual AWS Marketplace product codes. |
PendingSnapshotLimitExceeded
| You've reached the limit on the number of Amazon EBS snapshots you can have in the pending state. | |
PendingVerification
| The account is pending verification. | Contact aws-verification@amazon.com if you have questions. |
RequestLimitExceeded
| The maximum request rate permitted by the Amazon EC2 APIs has been exceeded for your account. | For best results, use an increasing or variable sleep interval between requests. For more information, see Query API Request Rate. |
ReservedInstancesLimitExceeded
| Your current quota does not allow you to purchase the required number of reserved instances. | |
Resource.AlreadyAssociated
| Specified gateway is already attached, or specified subnet is already associated with another object. | |
ResourceLimitExceeded
| Exceeded an EC2 resource limit. | Example: You reached the maximum number of import conversion tasks allowed. |
RouteAlreadyExists
| A route for the specified CIDR block already exists in this route table. | |
RouteLimitExceeded
| You've reached the limit on the number of routes you can add to a route table. | |
RouteTableLimitExceeded
| You've reached the limit on the number of route tables you can create. | |
RulesPerSecurityGroupLimitExceeded
| You've reached the limit on the number of rules you can add to a security group. | |
SecurityGroupLimitExceeded
| You've reached the limit on the number of security groups you can create. | |
SecurityGroupsPerInstanceLimitExceeded
| You've reached the limit on the number of security groups you can put an instance into. | |
SnapshotLimitExceeded
| You've reached the limit on the number of Amazon EBS snapshots you can create. | |
SubnetLimitExceeded
| You've reached the limit on the number of subnets you can create for the VPC. | |
UnauthorizedOperation | You are not authorized to perform this operation. | |
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. |
UnsupportedOperation
| The instance type or feature is not supported in your requested Availability Zone or with the requested configuration. | The returned message gives guidance on how to solve the problem. |
VolumeInUse
| The specified volume is unavailable. | To attach to an instance, the volume must be in the 'available' state. Ensure that the specified volume is not already in use by an instance. If it is not, this error message can also occur if the volume is still being created. |
VolumeLimitExceeded
| You've reached the limit on the number of Amazon EBS volumes you can create. | |
VpcLimitExceeded
| You've reached the limit on the number of VPCs you can create. | |
VpnConnectionLimitExceeded
| You've reached the limit on the number of VPN connections you can create. | |
VpnGatewayAttachmentLimitExceeded
| You've reached the limit on the number of VPCs that can be attached to the given virtual private gateway. | |
VpnGatewayLimitExceeded
| You've reached the limit on the number of virtual private gateways you can create. |
Summary of Server Error Codes
| Error Code | Description | Notes |
|---|---|---|
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. The returned message might also give specific guidance on how to solve the problem. |
InsufficientReservedInstanceCapacity
| Not enough available Reserved Instances to satisfy your minimum request. | Reduce the number of Reserved Instances in your request or wait for additional capacity to become available. |
InternalError
| Internal Error. | This error should not occur. If this persists, please contact us with details by posting a message on the AWS forums. |
Unavailable
| The server is overloaded and cannot handle the request. |
Request Error Response
The following shows the structure of a request error response.
<Response>
<Errors>
<Error>
<Code>Error code text</Code>
<Message>Error message</Message>
</Error>
</Errors>
<RequestID>request ID</RequestID>
</Response>
Example Error Response Request
The following shows an example of an error response.
<Response>
<Errors>
<Error>
<Code>InvalidInstanceID.NotFound</Code>
<Message>The instance ID 'i-4cbc822a' does not exist</Message>
</Error>
</Errors>
<RequestID>ea966190-f9aa-478e-9ede-cb5432daacc0</RequestID>
</Response>Eventual Consistency
The Amazon EC2 API follows an eventual consistency model, due to the distributed nature of the system supporting the API. This means that when you run an API command, the result may not be immediately visible to subsequent API commands, which can result in an error.
For more information about eventual consistency and how to manage it, see Eventual Consistency.
