Skip to main content

Error

Container for all error elements.

Contents​

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. The following is a list of Amazon S3 error codes. For more information, see Error responses.

Error Codes in Amazon S3​

  • Code: AccessDenied

    • Description: Access Denied
    • HTTP Status Code: 403 Forbidden

  • Code: AuthorizationHeaderMalformed

    • Description: The authorization header you provided is invalid.
    • HTTP Status Code: 400 Bad Request

  • Code: BadDigest

    • Description: The Content-MD5 you specified did not match what we received.
    • HTTP Status Code: 400 Bad Request

  • Code: BucketAlreadyExists

    • Description: 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.
    • HTTP Status Code: 409 Conflict

  • Code: BucketAlreadyOwnedByYou

    • Description: The bucket you tried to create already exists, and you own it. Amazon S3 returns this error in all AWS Regions except in the North Virginia Region. For legacy compatibility, if you re-create an existing bucket that you already own in the North Virginia Region, Amazon S3 returns 200 OK and resets the bucket access control lists (ACLs).
    • HTTP Status Code: 409 Conflict (in all Regions except the North Virginia Region)

  • Code: BucketNotEmpty

    • Description: The bucket you tried to delete is not empty.
    • HTTP Status Code: 409 Conflict

  • Code: EntityTooSmall

    • Description: Your proposed upload is smaller than the minimum allowed object size.
    • HTTP Status Code: 400 Bad Request

  • Code: EntityTooLarge

    • Description: Your proposed upload exceeds the maximum allowed object size.
    • HTTP Status Code: 400 Bad Request

  • Code: ExpiredToken

    • Description: The provided token has expired.
    • HTTP Status Code: 400 Bad Request
    • SOAP Fault Code Prefix: Client

  • Code: InternalError

    • Description: We encountered an internal error. Please try again.
    • HTTP Status Code: 500 Internal Server Error

  • Code: InvalidAccessKeyId

    • Description: The AWS access key ID you provided does not exist in our records.
    • HTTP Status Code: 403 Forbidden

  • Code: InvalidArgument

    • Description: Invalid Argument.
    • HTTP Status Code: 400 Bad Request
    • SOAP Fault Code Prefix: Client

  • Code: InvalidPart

    • Description: 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.
    • HTTP Status Code: 400 Bad Request

  • Code: InvalidPartOrder

    • Description: The list of parts was not in ascending order. Parts list must be specified in order by part number.
    • HTTP Status Code: 400 Bad Request
    • SOAP Fault Code Prefix: Client

  • Code: InvalidPolicyDocument

    • Description: The content of the form does not meet the conditions specified in the policy document.
    • HTTP Status Code: 400 Bad Request

  • Code: InvalidRange

    • Description: The requested range cannot be satisfied.
    • HTTP Status Code: 416 Requested Range Not Satisfiable

  • Code: InvalidToken

    • Description: The provided token is malformed or otherwise invalid.
    • HTTP Status Code: 400 Bad Request

  • Code: MalformedXML

    • Description: 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."
    • HTTP Status Code: 400 Bad Request

  • Code: MethodNotAllowed

    • Description: The specified method is not allowed against this resource.
    • HTTP Status Code: 405 Method Not Allowed

  • Code: NoSuchBucket

    • Description: The specified bucket does not exist.
    • HTTP Status Code: 404 Not Found

  • Code: NoSuchKey

    • Description: The specified key does not exist.
    • HTTP Status Code: 404 Not Found

  • Code: NoSuchUpload

    • Description: The specified multipart upload does not exist. The upload ID might be invalid, or the multipart upload might have been aborted or completed.
    • HTTP Status Code: 404 Not Found

  • Code: NotImplemented

    • Description: A header you provided implies functionality that is not implemented.
    • HTTP Status Code: 501 Not Implemented

  • Code: RequestTimeout

    • Description: Your socket connection to the server was not read from or written to within the timeout period.
    • HTTP Status Code: 400 Bad Request

  • Code: SignatureDoesNotMatch

    • Description: 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.
    • HTTP Status Code: 403 Forbidden

Type: String

Required: No

Key

The error key.

Type: String

Length Constraints: Minimum length of 1.

Required: No

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

Required: No

VersionId

The version ID of the error.

Type: String

Required: No