You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
minio/docs/api/errors.md

3.7 KiB

List of Error Responses

This section provides information about Minio API errors. XML and JSON results have been prettified for readability. As a result, the Content-Length may not match exactly for both styles

Error Codes Table

The following table lists Minio error codes.

Error Code Description HTTP Status Code
AccessDenied Access Denied 403 Forbidden
BadDigest The Content-MD5 you specified did not match what we received. 400 Bad Request
BucketAlreadyExists The requested bucket name is not available. 409 Conflict
EntityTooSmall Your proposed upload is smaller than the minimum allowed object size. 400 Bad Request
EntityTooLarge Your proposed upload exceeds the maximum allowed object size. 400 Bad Request
IncompleteBody You did not provide the number of bytes specified by the Content-Length HTTP header 400 Bad Request
InternalError We encountered an internal error. Please try again. 500 Internal Server Error
InvalidAccessKeyId The access key Id you provided does not exist in our records. 403 Forbidden
InvalidBucketName The specified bucket is not valid. 400 Bad Request
InvalidDigest The Content-MD5 you specified is not valid. 400 Bad Request
InvalidRange The requested range cannot be satisfied. 416 Requested Range Not Satisfiable
MalformedXML The XML you provided was not well-formed or did not validate against our published schema. 400 Bad Request
MissingContentLength You must provide the Content-Length HTTP header. 411 Length Required
MissingRequestBodyError Request body is empty. 400 Bad Request
NoSuchBucket The specified bucket does not exist. 404 Not Found
NoSuchKey The specified key does not exist. 404 Not Found
NoSuchUpload The specified multipart upload does not exist 404 Not Found
NotImplemented A header you provided implies functionality that is not implemented. 501 Not Implemented
RequestTimeTooSkewed The difference between the request time and the server's time is too large. 403 Forbidden
SignatureDoesNotMatch The request signature we calculated does not match the signature you provided. 403 Forbidden
TooManyBuckets You have attempted to create more buckets than allowed. 400 Bad Request

REST Error Responses

When there is an error, the header information contains:

  • Content-Type: application/xml or application/json (Depending on Accept HTTP header)
  • An appropriate 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>/minio-bucket/images.bz2</Resource>
  <RequestId>********</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.
Type: String
Ancestor: Error
Error XML container for error.
Type: Container
Ancestor: None
Message The error message contains a generic description of the error condition.
Type: String
Ancestor: Error
RequestId ID of the request associated with the error.
Type: String
Ancestor: Error
Resource The bucket or object for which the error generated.
Type: String
Ancestor: Error