2015-06-23 20:44:32 +02:00
/ *
2019-04-09 20:39:42 +02:00
* MinIO Cloud Storage , ( C ) 2015 , 2016 , 2017 , 2018 MinIO , Inc .
2015-06-23 20:44:32 +02:00
*
* Licensed under the Apache License , Version 2.0 ( the "License" ) ;
* you may not use this file except in compliance with the License .
* You may obtain a copy of the License at
*
* http : //www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing , software
* distributed under the License is distributed on an "AS IS" BASIS ,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND , either express or implied .
* See the License for the specific language governing permissions and
* limitations under the License .
* /
2016-08-19 01:23:42 +02:00
package cmd
2015-06-23 20:44:32 +02:00
2016-04-21 02:23:23 +02:00
import (
2020-01-07 18:13:44 +01:00
"errors"
2016-04-21 02:23:23 +02:00
"fmt"
"io"
2019-03-20 21:06:53 +01:00
"path"
2016-04-21 02:23:23 +02:00
)
// Converts underlying storage error. Convenience function written to
// handle all cases where we have known types of errors returned by
// underlying storage layer.
func toObjectErr ( err error , params ... string ) error {
switch err {
case errVolumeNotFound :
if len ( params ) >= 1 {
2016-08-25 18:39:01 +02:00
err = BucketNotFound { Bucket : params [ 0 ] }
2016-04-21 02:23:23 +02:00
}
2016-05-05 10:35:21 +02:00
case errVolumeNotEmpty :
if len ( params ) >= 1 {
2016-08-25 18:39:01 +02:00
err = BucketNotEmpty { Bucket : params [ 0 ] }
2016-05-05 10:35:21 +02:00
}
2016-04-21 02:23:23 +02:00
case errVolumeExists :
if len ( params ) >= 1 {
2016-08-25 18:39:01 +02:00
err = BucketExists { Bucket : params [ 0 ] }
2016-04-21 02:23:23 +02:00
}
case errDiskFull :
2016-08-25 18:39:01 +02:00
err = StorageFull { }
2019-05-02 16:09:57 +02:00
case errTooManyOpenFiles :
err = SlowDown { }
2016-10-21 01:09:55 +02:00
case errFileAccessDenied :
if len ( params ) >= 2 {
err = PrefixAccessDenied {
Bucket : params [ 0 ] ,
Object : params [ 1 ] ,
}
}
2019-03-20 21:06:53 +01:00
case errFileParentIsFile :
if len ( params ) >= 2 {
err = ParentIsObject {
Bucket : params [ 0 ] ,
Object : params [ 1 ] ,
}
}
2018-12-14 06:58:48 +01:00
case errIsNotRegular :
2016-04-21 02:23:23 +02:00
if len ( params ) >= 2 {
2016-08-25 18:39:01 +02:00
err = ObjectExistsAsDirectory {
2016-04-21 02:23:23 +02:00
Bucket : params [ 0 ] ,
Object : params [ 1 ] ,
}
}
2016-04-23 01:19:45 +02:00
case errFileNotFound :
2019-04-23 23:54:28 +02:00
switch len ( params ) {
case 2 :
2016-08-25 18:39:01 +02:00
err = ObjectNotFound {
2016-04-21 02:23:23 +02:00
Bucket : params [ 0 ] ,
Object : params [ 1 ] ,
}
2019-04-23 23:54:28 +02:00
case 3 :
err = InvalidUploadID {
Bucket : params [ 0 ] ,
Object : params [ 1 ] ,
UploadID : params [ 2 ] ,
}
2016-04-21 02:23:23 +02:00
}
2016-05-11 21:55:02 +02:00
case errFileNameTooLong :
if len ( params ) >= 2 {
2016-08-25 18:39:01 +02:00
err = ObjectNameInvalid {
2016-05-11 21:55:02 +02:00
Bucket : params [ 0 ] ,
Object : params [ 1 ] ,
}
}
2016-10-22 18:05:01 +02:00
case errDataTooLarge :
if len ( params ) >= 2 {
err = ObjectTooLarge {
Bucket : params [ 0 ] ,
Object : params [ 1 ] ,
}
}
2016-10-25 08:47:03 +02:00
case errDataTooSmall :
if len ( params ) >= 2 {
err = ObjectTooSmall {
Bucket : params [ 0 ] ,
Object : params [ 1 ] ,
}
}
2016-06-03 01:34:15 +02:00
case errXLReadQuorum :
2016-08-25 18:39:01 +02:00
err = InsufficientReadQuorum { }
2016-06-03 01:34:15 +02:00
case errXLWriteQuorum :
2016-08-25 18:39:01 +02:00
err = InsufficientWriteQuorum { }
2016-04-21 02:23:23 +02:00
case io . ErrUnexpectedEOF , io . ErrShortWrite :
2016-08-25 18:39:01 +02:00
err = IncompleteBody { }
}
2016-04-21 02:23:23 +02:00
return err
}
2015-07-01 01:30:02 +02:00
2017-05-11 01:52:38 +02:00
// SignatureDoesNotMatch - when content md5 does not match with what was sent from client.
type SignatureDoesNotMatch struct { }
func ( e SignatureDoesNotMatch ) Error ( ) string {
return "The request signature we calculated does not match the signature you provided. Check your key and signing method."
}
2016-04-28 04:28:13 +02:00
// StorageFull storage ran out of space.
2016-04-19 11:42:10 +02:00
type StorageFull struct { }
2015-06-23 20:44:32 +02:00
2016-04-19 11:42:10 +02:00
func ( e StorageFull ) Error ( ) string {
return "Storage reached its minimum free disk threshold."
2015-06-23 20:44:32 +02:00
}
2019-05-02 16:09:57 +02:00
// SlowDown too many file descriptors open or backend busy .
type SlowDown struct { }
func ( e SlowDown ) Error ( ) string {
return "Please reduce your request rate"
}
2016-05-06 05:24:29 +02:00
// InsufficientReadQuorum storage cannot satisfy quorum for read operation.
type InsufficientReadQuorum struct { }
2016-04-21 02:23:23 +02:00
2016-05-06 05:24:29 +02:00
func ( e InsufficientReadQuorum ) Error ( ) string {
2016-04-21 02:23:23 +02:00
return "Storage resources are insufficient for the read operation."
}
2016-05-06 05:24:29 +02:00
// InsufficientWriteQuorum storage cannot satisfy quorum for write operation.
type InsufficientWriteQuorum struct { }
2016-04-21 02:23:23 +02:00
2016-05-06 05:24:29 +02:00
func ( e InsufficientWriteQuorum ) Error ( ) string {
return "Storage resources are insufficient for the write operation."
2016-04-21 02:23:23 +02:00
}
2016-04-19 11:42:10 +02:00
// GenericError - generic object layer error.
type GenericError struct {
Bucket string
Object string
2015-10-18 04:17:33 +02:00
}
2016-04-28 04:28:13 +02:00
// BucketNotFound bucket does not exist.
2016-04-19 11:42:10 +02:00
type BucketNotFound GenericError
2015-06-23 20:44:32 +02:00
func ( e BucketNotFound ) Error ( ) string {
return "Bucket not found: " + e . Bucket
}
2017-05-08 23:53:47 +02:00
// BucketAlreadyExists the requested bucket name is not available.
type BucketAlreadyExists GenericError
func ( e BucketAlreadyExists ) Error ( ) string {
return "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."
}
2017-04-27 20:26:00 +02:00
// BucketAlreadyOwnedByYou already owned by you.
type BucketAlreadyOwnedByYou GenericError
func ( e BucketAlreadyOwnedByYou ) Error ( ) string {
return "Bucket already owned by you: " + e . Bucket
}
2016-04-28 04:28:13 +02:00
// BucketNotEmpty bucket is not empty.
2016-04-19 11:42:10 +02:00
type BucketNotEmpty GenericError
2015-06-23 20:44:32 +02:00
2015-10-16 20:26:01 +02:00
func ( e BucketNotEmpty ) Error ( ) string {
return "Bucket not empty: " + e . Bucket
2015-06-23 20:44:32 +02:00
}
2016-04-28 04:28:13 +02:00
// ObjectNotFound object does not exist.
2016-04-19 11:42:10 +02:00
type ObjectNotFound GenericError
2015-06-23 20:44:32 +02:00
func ( e ObjectNotFound ) Error ( ) string {
2015-10-16 20:26:01 +02:00
return "Object not found: " + e . Bucket + "#" + e . Object
2015-06-23 20:44:32 +02:00
}
2018-03-28 01:44:45 +02:00
// ObjectAlreadyExists object already exists.
type ObjectAlreadyExists GenericError
func ( e ObjectAlreadyExists ) Error ( ) string {
return "Object: " + e . Bucket + "#" + e . Object + " already exists"
}
2016-05-08 21:36:16 +02:00
// ObjectExistsAsDirectory object already exists as a directory.
type ObjectExistsAsDirectory GenericError
2016-02-03 00:23:28 +01:00
2016-05-08 21:36:16 +02:00
func ( e ObjectExistsAsDirectory ) Error ( ) string {
return "Object exists on : " + e . Bucket + " as directory " + e . Object
2015-06-23 20:44:32 +02:00
}
2016-10-21 01:09:55 +02:00
//PrefixAccessDenied object access is denied.
type PrefixAccessDenied GenericError
func ( e PrefixAccessDenied ) Error ( ) string {
2019-08-06 21:08:58 +02:00
return "Prefix access is denied: " + e . Bucket + SlashSeparator + e . Object
2016-10-21 01:09:55 +02:00
}
2019-03-20 21:06:53 +01:00
// ParentIsObject object access is denied.
type ParentIsObject GenericError
func ( e ParentIsObject ) Error ( ) string {
2019-08-06 21:08:58 +02:00
return "Parent is object " + e . Bucket + SlashSeparator + path . Dir ( e . Object )
2019-03-20 21:06:53 +01:00
}
2016-04-28 04:28:13 +02:00
// BucketExists bucket exists.
2016-04-19 11:42:10 +02:00
type BucketExists GenericError
2015-06-23 20:44:32 +02:00
func ( e BucketExists ) Error ( ) string {
return "Bucket exists: " + e . Bucket
}
2016-04-11 10:29:18 +02:00
// UnsupportedDelimiter - unsupported delimiter.
type UnsupportedDelimiter struct {
Delimiter string
}
func ( e UnsupportedDelimiter ) Error ( ) string {
return fmt . Sprintf ( "delimiter '%s' is not supported. Only '/' is supported" , e . Delimiter )
}
2016-04-19 11:42:10 +02:00
// InvalidUploadIDKeyCombination - invalid upload id and key marker combination.
2016-04-11 10:29:18 +02:00
type InvalidUploadIDKeyCombination struct {
UploadIDMarker , KeyMarker string
}
func ( e InvalidUploadIDKeyCombination ) Error ( ) string {
return fmt . Sprintf ( "Invalid combination of uploadID marker '%s' and marker '%s'" , e . UploadIDMarker , e . KeyMarker )
}
// InvalidMarkerPrefixCombination - invalid marker and prefix combination.
type InvalidMarkerPrefixCombination struct {
Marker , Prefix string
}
func ( e InvalidMarkerPrefixCombination ) Error ( ) string {
return fmt . Sprintf ( "Invalid combination of marker '%s' and prefix '%s'" , e . Marker , e . Prefix )
}
accessPolicy: Implement Put, Get, Delete access policy.
This patch implements Get,Put,Delete bucket policies
Supporting - http://docs.aws.amazon.com/AmazonS3/latest/dev/access-policy-language-overview.html
Currently supports following actions.
"*": true,
"s3:*": true,
"s3:GetObject": true,
"s3:ListBucket": true,
"s3:PutObject": true,
"s3:CreateBucket": true,
"s3:GetBucketLocation": true,
"s3:DeleteBucket": true,
"s3:DeleteObject": true,
"s3:AbortMultipartUpload": true,
"s3:ListBucketMultipartUploads": true,
"s3:ListMultipartUploadParts": true,
following conditions for "StringEquals" and "StringNotEquals"
"s3:prefix", "s3:max-keys"
2016-02-04 01:46:56 +01:00
// BucketPolicyNotFound - no bucket policy found.
2016-04-19 11:42:10 +02:00
type BucketPolicyNotFound GenericError
accessPolicy: Implement Put, Get, Delete access policy.
This patch implements Get,Put,Delete bucket policies
Supporting - http://docs.aws.amazon.com/AmazonS3/latest/dev/access-policy-language-overview.html
Currently supports following actions.
"*": true,
"s3:*": true,
"s3:GetObject": true,
"s3:ListBucket": true,
"s3:PutObject": true,
"s3:CreateBucket": true,
"s3:GetBucketLocation": true,
"s3:DeleteBucket": true,
"s3:DeleteObject": true,
"s3:AbortMultipartUpload": true,
"s3:ListBucketMultipartUploads": true,
"s3:ListMultipartUploadParts": true,
following conditions for "StringEquals" and "StringNotEquals"
"s3:prefix", "s3:max-keys"
2016-02-04 01:46:56 +01:00
func ( e BucketPolicyNotFound ) Error ( ) string {
return "No bucket policy found for bucket: " + e . Bucket
}
2019-07-19 22:20:33 +02:00
// BucketLifecycleNotFound - no bucket lifecycle found.
type BucketLifecycleNotFound GenericError
func ( e BucketLifecycleNotFound ) Error ( ) string {
return "No bucket life cycle found for bucket : " + e . Bucket
2020-02-05 10:42:34 +01:00
}
// BucketSSEConfigNotFound - no bucket encryption config found
type BucketSSEConfigNotFound GenericError
func ( e BucketSSEConfigNotFound ) Error ( ) string {
return "No bucket encryption found for bucket: " + e . Bucket
2019-07-19 22:20:33 +02:00
}
2020-05-01 00:55:54 +02:00
// BucketQuotaConfigNotFound - no bucket quota config found.
type BucketQuotaConfigNotFound GenericError
func ( e BucketQuotaConfigNotFound ) Error ( ) string {
return "No quota config found for bucket : " + e . Bucket
}
// BucketQuotaExceeded - bucket quota exceeded.
type BucketQuotaExceeded GenericError
func ( e BucketQuotaExceeded ) Error ( ) string {
return "Bucket quota exceeded for bucket: " + e . Bucket
}
2016-04-28 04:28:13 +02:00
/// Bucket related errors.
2015-07-01 01:30:02 +02:00
2016-04-28 04:28:13 +02:00
// BucketNameInvalid - bucketname provided is invalid.
2016-04-19 11:42:10 +02:00
type BucketNameInvalid GenericError
2015-07-01 01:30:02 +02:00
2020-03-19 00:19:29 +01:00
// Error returns string an error formatted as the given text.
2015-07-01 01:30:02 +02:00
func ( e BucketNameInvalid ) Error ( ) string {
return "Bucket name invalid: " + e . Bucket
}
2016-04-28 04:28:13 +02:00
/// Object related errors.
2016-04-19 11:42:10 +02:00
2016-04-28 04:28:13 +02:00
// ObjectNameInvalid - object name provided is invalid.
2016-04-19 11:42:10 +02:00
type ObjectNameInvalid GenericError
2019-07-12 06:38:12 +02:00
// ObjectNameTooLong - object name too long.
type ObjectNameTooLong GenericError
// ObjectNamePrefixAsSlash - object name has a slash as prefix.
type ObjectNamePrefixAsSlash GenericError
2020-03-19 00:19:29 +01:00
// Error returns string an error formatted as the given text.
2015-07-01 01:30:02 +02:00
func ( e ObjectNameInvalid ) Error ( ) string {
return "Object name invalid: " + e . Bucket + "#" + e . Object
}
2020-03-19 00:19:29 +01:00
// Error returns string an error formatted as the given text.
2019-07-12 06:38:12 +02:00
func ( e ObjectNameTooLong ) Error ( ) string {
return "Object name too long: " + e . Bucket + "#" + e . Object
}
2020-03-19 00:19:29 +01:00
// Error returns string an error formatted as the given text.
2019-07-12 06:38:12 +02:00
func ( e ObjectNamePrefixAsSlash ) Error ( ) string {
return "Object name contains forward slash as pefix: " + e . Bucket + "#" + e . Object
}
2017-05-06 03:49:08 +02:00
// AllAccessDisabled All access to this object has been disabled
type AllAccessDisabled GenericError
2020-03-19 00:19:29 +01:00
// Error returns string an error formatted as the given text.
2017-05-06 03:49:08 +02:00
func ( e AllAccessDisabled ) Error ( ) string {
return "All access to this object has been disabled"
}
2016-04-28 04:28:13 +02:00
// IncompleteBody You did not provide the number of bytes specified by the Content-Length HTTP header.
2016-04-19 11:42:10 +02:00
type IncompleteBody GenericError
2015-07-09 05:18:32 +02:00
2020-03-19 00:19:29 +01:00
// Error returns string an error formatted as the given text.
2015-07-09 05:18:32 +02:00
func ( e IncompleteBody ) Error ( ) string {
return e . Bucket + "#" + e . Object + "has incomplete body"
}
2016-07-09 02:22:55 +02:00
// InvalidRange - invalid range typed error.
type InvalidRange struct {
2017-11-14 09:25:10 +01:00
OffsetBegin int64
OffsetEnd int64
ResourceSize int64
2016-07-09 02:22:55 +02:00
}
func ( e InvalidRange ) Error ( ) string {
2017-11-14 09:25:10 +01:00
return fmt . Sprintf ( "The requested range \"bytes %d-%d/%d\" is not satisfiable." , e . OffsetBegin , e . OffsetEnd , e . ResourceSize )
2016-07-09 02:22:55 +02:00
}
2016-10-22 18:05:01 +02:00
// ObjectTooLarge error returned when the size of the object > max object size allowed (5G) per request.
type ObjectTooLarge GenericError
func ( e ObjectTooLarge ) Error ( ) string {
return "size of the object greater than what is allowed(5G)"
}
2016-10-25 08:47:03 +02:00
// ObjectTooSmall error returned when the size of the object < what is expected.
type ObjectTooSmall GenericError
func ( e ObjectTooSmall ) Error ( ) string {
return "size of the object less than what is expected"
}
2017-08-31 20:29:22 +02:00
// OperationTimedOut - a timeout occurred.
type OperationTimedOut struct {
}
func ( e OperationTimedOut ) Error ( ) string {
2020-02-21 06:59:57 +01:00
return "Operation timed out"
2017-08-31 20:29:22 +02:00
}
2016-04-28 04:28:13 +02:00
/// Multipart related errors.
2015-07-01 01:30:02 +02:00
2016-04-11 10:29:18 +02:00
// MalformedUploadID malformed upload id.
type MalformedUploadID struct {
UploadID string
}
func ( e MalformedUploadID ) Error ( ) string {
return "Malformed upload id " + e . UploadID
}
// InvalidUploadID invalid upload id.
2015-07-01 01:30:02 +02:00
type InvalidUploadID struct {
2019-04-23 23:54:28 +02:00
Bucket string
Object string
2015-07-01 01:30:02 +02:00
UploadID string
}
func ( e InvalidUploadID ) Error ( ) string {
return "Invalid upload id " + e . UploadID
}
2015-07-09 01:54:32 +02:00
2015-07-14 04:29:32 +02:00
// InvalidPart One or more of the specified parts could not be found
2018-08-15 03:35:30 +02:00
type InvalidPart struct {
PartNumber int
ExpETag string
GotETag string
}
2015-07-14 04:29:32 +02:00
func ( e InvalidPart ) Error ( ) string {
2018-08-15 03:35:30 +02:00
return fmt . Sprintf ( "Specified part could not be found. PartNumber %d, Expected %s, got %s" ,
e . PartNumber , e . ExpETag , e . GotETag )
2015-07-14 04:29:32 +02:00
}
2016-05-08 21:06:05 +02:00
// PartTooSmall - error if part size is less than 5MB.
2016-06-28 23:51:49 +02:00
type PartTooSmall struct {
PartSize int64
PartNumber int
PartETag string
}
2016-05-08 21:06:05 +02:00
func ( e PartTooSmall ) Error ( ) string {
2017-10-28 00:07:14 +02:00
return fmt . Sprintf ( "Part size for %d should be at least 5MB" , e . PartNumber )
2016-05-08 21:06:05 +02:00
}
2016-08-17 20:36:33 +02:00
2017-07-13 01:42:14 +02:00
// PartTooBig returned if size of part is bigger than the allowed limit.
type PartTooBig struct { }
func ( e PartTooBig ) Error ( ) string {
return "Part size bigger than the allowed limit"
}
2018-01-13 05:34:52 +01:00
// InvalidETag error returned when the etag has changed on disk
type InvalidETag struct { }
func ( e InvalidETag ) Error ( ) string {
return "etag of the object has changed"
}
2016-08-17 20:36:33 +02:00
// NotImplemented If a feature is not implemented
type NotImplemented struct { }
func ( e NotImplemented ) Error ( ) string {
return "Not Implemented"
}
2016-11-17 01:42:23 +01:00
2017-09-13 01:14:41 +02:00
// UnsupportedMetadata - unsupported metadata
type UnsupportedMetadata struct { }
func ( e UnsupportedMetadata ) Error ( ) string {
return "Unsupported headers in Metadata"
}
2018-03-28 23:14:06 +02:00
// BackendDown is returned for network errors or if the gateway's backend is down.
type BackendDown struct { }
func ( e BackendDown ) Error ( ) string {
return "Backend down"
}
2019-11-20 02:42:27 +01:00
// isErrBucketNotFound - Check if error type is BucketNotFound.
func isErrBucketNotFound ( err error ) bool {
2020-01-07 18:13:44 +01:00
var bkNotFound BucketNotFound
return errors . As ( err , & bkNotFound )
2019-11-20 02:42:27 +01:00
}
2017-11-14 09:25:10 +01:00
// isErrObjectNotFound - Check if error type is ObjectNotFound.
2016-11-17 01:42:23 +01:00
func isErrObjectNotFound ( err error ) bool {
2020-01-07 18:13:44 +01:00
var objNotFound ObjectNotFound
return errors . As ( err , & objNotFound )
2016-11-17 01:42:23 +01:00
}
2019-03-06 21:38:41 +01:00
// PreConditionFailed - Check if copy precondition failed
type PreConditionFailed struct { }
func ( e PreConditionFailed ) Error ( ) string {
return "At least one of the pre-conditions you specified did not hold"
}
func isErrPreconditionFailed ( err error ) bool {
_ , ok := err . ( PreConditionFailed )
return ok
}