Error Responses

This section provides reference information about Amazon S3 errors.

Note

SOAP support over HTTP is deprecated, but it is still available over HTTPS. New Amazon S3 features will not be supported for SOAP. We recommend that you use either the REST API or the AWS SDKs.

Topics

REST Error Responses
List of Error Codes

REST Error Responses

When there is an error, the header information contains:

Content-Type: application/xml
An appropriate 3xx, 4xx, or 5xx HTTP status code

The body or the response also contains information about the error. The following sample error response shows the structure of response elements common to all REST error responses.


<?xml version="1.0" encoding="UTF-8"?>
<Error>
  <Code>NoSuchKey</Code>
  <Message>The resource you requested does not exist</Message>
  <Resource>/mybucket/myfoto.jpg</Resource> 
  <RequestId>4442587FB7D0A2F9</RequestId>
</Error>

The following table explains the REST error response elements

Name	Description
`Code`	The error code is a string that uniquely identifies an error condition. It is meant to be read and understood by programs that detect and handle errors by type. For more information, see List of Error Codes. Type: String Ancestor: Error
`Error`	Container for all error elements. Type: Container Ancestor: None
`Message`	The error message contains a generic description of the error condition in English. It is intended for a human audience. Simple programs display the message directly to the end user if they encounter an error condition they don't know how or don't care to handle. Sophisticated programs with more exhaustive error handling and proper internationalization are more likely to ignore the error message. Type: String Ancestor: Error
`RequestId`	ID of the request associated with the error. Type: String Ancestor: Error
`Resource`	The bucket or object that is involved in the error. Type: String Ancestor: Error

Many error responses contain additional structured data meant to be read and understood by a developer diagnosing programming errors. For example, if you send a Content-MD5 header with a REST PUT request that doesn't match the digest calculated on the server, you receive a BadDigest error. The error response also includes as detail elements the digest we calculated, and the digest you told us to expect. During development, you can use this information to diagnose the error. In production, a well-behaved program might include this information in its error log.

For information about general response elements, go to Error Responses.

List of Error Codes

The following table lists Amazon S3 error codes.

Error Code	Description	HTTP Status Code	SOAP Fault Code Prefix
`AccessDenied`	Access Denied	403 Forbidden	Client
`AccountProblem`	There is a problem with your AWS account that prevents the operation from completing successfully. Please contact AWS Support for further assistance, see Contact Us.	403 Forbidden	Client
`AllAccessDisabled`	All access to this Amazon S3 resource has been disabled. Please contact AWS Support for further assistance, see Contact Us.	403 Forbidden	Client
`AmbiguousGrantByEmailAddress`	The email address you provided is associated with more than one account.	400 Bad Request	Client
`BadDigest`	The Content-MD5 you specified did not match what we received.	400 Bad Request	Client
`BucketAlreadyExists`	The requested bucket name is not available. The bucket namespace is shared by all users of the system. Please select a different name and try again.	409 Conflict	Client
`BucketAlreadyOwnedByYou`	Your previous request to create the named bucket succeeded and you already own it. You get this error in all AWS regions except US East (N. Virginia) region, us-east-1. In us-east-1 region, you will get 200 OK, but it is no-op (if bucket exists it Amazon S3 will not do anything).	409 Conflict (in all regions except US East (N. Virginia) region).	Client
`BucketNotEmpty`	The bucket you tried to delete is not empty.	409 Conflict	Client
`CredentialsNotSupported`	This request does not support credentials.	400 Bad Request	Client
`CrossLocationLoggingProhibited`	Cross-location logging not allowed. Buckets in one geographic location cannot log information to a bucket in another location.	403 Forbidden	Client
`EntityTooSmall`	Your proposed upload is smaller than the minimum allowed object size.	400 Bad Request	Client
`EntityTooLarge`	Your proposed upload exceeds the maximum allowed object size.	400 Bad Request	Client
`ExpiredToken`	The provided token has expired.	400 Bad Request	Client
`IllegalVersioningConfigurationException`	Indicates that the versioning configuration specified in the request is invalid.	400 Bad Request	Client
`IncompleteBody`	You did not provide the number of bytes specified by the Content-Length HTTP header	400 Bad Request	Client
`IncorrectNumberOfFilesInPostRequest`	POST requires exactly one file upload per request.	400 Bad Request	Client
`InlineDataTooLarge`	Inline data exceeds the maximum allowed size.	400 Bad Request	Client
`InternalError`	We encountered an internal error. Please try again.	500 Internal Server Error	Server
`InvalidAccessKeyId`	The AWS access key Id you provided does not exist in our records.	403 Forbidden	Client
`InvalidAddressingHeader`	You must specify the Anonymous role.	N/A	Client
`InvalidArgument`	Invalid Argument	400 Bad Request	Client
`InvalidBucketName`	The specified bucket is not valid.	400 Bad Request	Client
`InvalidBucketState`	The request is not valid with the current state of the bucket.	409 Conflict	Client
`InvalidDigest`	The Content-MD5 you specified is not valid.	400 Bad Request	Client
`InvalidEncryptionAlgorithmError`	The encryption request you specified is not valid. The valid value is AES256.	400 Bad Request	Client
`InvalidLocationConstraint`	The specified location constraint is not valid. For more information about regions, see How to Select a Region for Your Buckets.	400 Bad Request	Client
`InvalidObjectState`	The operation is not valid for the current state of the object.	403 Forbidden	Client
`InvalidPart`	One or more of the specified parts could not be found. The part might not have been uploaded, or the specified entity tag might not have matched the part's entity tag.	400 Bad Request	Client
`InvalidPartOrder`	The list of parts was not in ascending order.Parts list must specified in order by part number.	400 Bad Request	Client
`InvalidPayer`	All access to this object has been disabled. Please contact AWS Support for further assistance, see Contact Us.	403 Forbidden	Client
`InvalidPolicyDocument`	The content of the form does not meet the conditions specified in the policy document.	400 Bad Request	Client
`InvalidRange`	The requested range cannot be satisfied.	416 Requested Range Not Satisfiable	Client
`InvalidRequest`	Please use AWS4-HMAC-SHA256.	400 Bad Request	N/A
`InvalidRequest`	SOAP requests must be made over an HTTPS connection.	400 Bad Request	Client
`InvalidRequest`	S3 Transfer Acceleration is not supported for buckets with non-DNS compliant names.	400 Bad Request	N/A
`InvalidRequest`	S3 Transfer Acceleration is not supported for buckets with periods (.) in their names.	400 Bad Request	N/A
`InvalidRequest`	S3 Transfer Accelerate endpoint only supports virtual style requests.	400 Bad Request	N/A
`InvalidRequest`	S3 Transfer Accelerate is not configured on this bucket.	400 Bad Request	N/A
`InvalidRequest`	S3 Transfer Accelerate is disabled on this bucket.	400 Bad Request	N/A
`InvalidRequest`	S3 Transfer Acceleration is not supported on this bucket. Contact AWS Support for more information.	400 Bad Request	N/A
`InvalidRequest`	S3 Transfer Acceleration cannot be enabled on this bucket. Contact AWS Support for more information.	400 Bad Request	N/A
`InvalidSecurity`	The provided security credentials are not valid.	403 Forbidden	Client
`InvalidSOAPRequest`	The SOAP request body is invalid.	400 Bad Request	Client
`InvalidStorageClass`	The storage class you specified is not valid.	400 Bad Request	Client
`InvalidTargetBucketForLogging`	The target bucket for logging does not exist, is not owned by you, or does not have the appropriate grants for the log-delivery group.	400 Bad Request	Client
`InvalidToken`	The provided token is malformed or otherwise invalid.	400 Bad Request	Client
`InvalidURI`	Couldn't parse the specified URI.	400 Bad Request	Client
`KeyTooLongError`	Your key is too long.	400 Bad Request	Client
`MalformedACLError`	The XML you provided was not well-formed or did not validate against our published schema.	400 Bad Request	Client
`MalformedPOSTRequest`	The body of your POST request is not well-formed multipart/form-data.	400 Bad Request	Client
`MalformedXML`	This happens when the user sends malformed xml (xml that doesn't conform to the published xsd) for the configuration. The error message is, "The XML you provided was not well-formed or did not validate against our published schema."	400 Bad Request	Client
`MaxMessageLengthExceeded`	Your request was too big.	400 Bad Request	Client
`MaxPostPreDataLengthExceededError`	Your POST request fields preceding the upload file were too large.	400 Bad Request	Client
`MetadataTooLarge`	Your metadata headers exceed the maximum allowed metadata size.	400 Bad Request	Client
`MethodNotAllowed`	The specified method is not allowed against this resource.	405 Method Not Allowed	Client
`MissingAttachment`	A SOAP attachment was expected, but none were found.	N/A	Client
`MissingContentLength`	You must provide the Content-Length HTTP header.	411 Length Required	Client
`MissingRequestBodyError`	This happens when the user sends an empty xml document as a request. The error message is, "Request body is empty."	400 Bad Request	Client
`MissingSecurityElement`	The SOAP 1.1 request is missing a security element.	400 Bad Request	Client
`MissingSecurityHeader`	Your request is missing a required header.	400 Bad Request	Client
`NoLoggingStatusForKey`	There is no such thing as a logging status subresource for a key.	400 Bad Request	Client
`NoSuchBucket`	The specified bucket does not exist.	404 Not Found	Client
`NoSuchKey`	The specified key does not exist.	404 Not Found	Client
`NoSuchLifecycleConfiguration`	The lifecycle configuration does not exist.	404 Not Found	Client
`NoSuchUpload`	The specified multipart upload does not exist. The upload ID might be invalid, or the multipart upload might have been aborted or completed.	404 Not Found	Client
`NoSuchVersion`	Indicates that the version ID specified in the request does not match an existing version.	404 Not Found	Client
`NotImplemented`	A header you provided implies functionality that is not implemented.	501 Not Implemented	Server
`NotSignedUp`	Your account is not signed up for the Amazon S3 service. You must sign up before you can use Amazon S3. You can sign up at the following URL: https://aws.amazon.com/s3	403 Forbidden	Client
`NoSuchBucketPolicy`	The specified bucket does not have a bucket policy.	404 Not Found	Client
`OperationAborted`	A conflicting conditional operation is currently in progress against this resource. Try again.	409 Conflict	Client
`PermanentRedirect`	The bucket you are attempting to access must be addressed using the specified endpoint. Send all future requests to this endpoint.	301 Moved Permanently	Client
`PreconditionFailed`	At least one of the preconditions you specified did not hold.	412 Precondition Failed	Client
`Redirect`	Temporary redirect.	307 Moved Temporarily	Client
`RestoreAlreadyInProgress`	Object restore is already in progress.	409 Conflict	Client
`RequestIsNotMultiPartContent`	Bucket POST must be of the enclosure-type multipart/form-data.	400 Bad Request	Client
`RequestTimeout`	Your socket connection to the server was not read from or written to within the timeout period.	400 Bad Request	Client
`RequestTimeTooSkewed`	The difference between the request time and the server's time is too large.	403 Forbidden	Client
`RequestTorrentOfBucketError`	Requesting the torrent file of a bucket is not permitted.	400 Bad Request	Client
`SignatureDoesNotMatch`	The request signature we calculated does not match the signature you provided. Check your AWS secret access key and signing method. For more information, see REST Authentication and SOAP Authentication for details.	403 Forbidden	Client
`ServiceUnavailable`	Reduce your request rate.	503 Service Unavailable	Server
`SlowDown`	Reduce your request rate.	503 Slow Down	Server
`TemporaryRedirect`	You are being redirected to the bucket while DNS updates.	307 Moved Temporarily	Client
`TokenRefreshRequired`	The provided token must be refreshed.	400 Bad Request	Client
`TooManyBuckets`	You have attempted to create more buckets than allowed.	400 Bad Request	Client
`UnexpectedContent`	This request does not support content.	400 Bad Request	Client
`UnresolvableGrantByEmailAddress`	The email address you provided does not match any account on record.	400 Bad Request	Client
`UserKeyMustBeSpecified`	The bucket POST must contain the specified field name. If it is specified, check the order of the fields.	400 Bad Request	Client

Warning Javascript is disabled or is unavailable in your browser.

To use the AWS Documentation, Javascript must be enabled. Please refer to your browser's Help pages for instructions.

Document Conventions

« Previous Next »