Exception: S3::Error::ResponseError

Inherits:

StandardError

• Object
• StandardError
• S3::Error::ResponseError

Defined in:

lib/s3/exceptions.rb

Overview

All responses with a code between 300 and 599 that contain an body are wrapped in an ErrorResponse which contains an Error object. This Error class generates a custom exception with the name of the xml Error and its message. All such runtime generated exception classes descend from ResponseError and contain the ErrorResponse object so that all code that makes a request can rescue ResponseError and get access to the ErrorResponse.

Direct Known Subclasses

AccessDenied, AccountProblem, AmbiguousGrantByEmailAddress, BadDigest, BucketAlreadyExists, BucketAlreadyOwnedByYou, BucketNotEmpty, CredentialsNotSupported, CrossLocationLoggingProhibited, EntityTooLarge, EntityTooSmall, ExpiredToken, ForbiddenBucket, IncompleteBody, IncorrectNumberOfFilesInPostRequestPOST, InlineDataTooLarge, InternalError, InvalidAccessKeyId, InvalidAddressingHeader, InvalidArgument, InvalidBucketName, InvalidDigest, InvalidLocationConstraint, InvalidPayer, InvalidPolicyDocument, InvalidRange, InvalidSOAPRequest, InvalidSecurity, InvalidStorageClass, InvalidTargetBucketForLogging, InvalidToken, InvalidURI, KeyTooLong, MalformedACLError, MalformedPOSTRequest, MalformedXML, MaxMessageLengthExceeded, MaxPostPreDataLengthExceededErrorYour, MetadataTooLarge, MethodNotAllowed, MissingAttachment, MissingContentLength, MissingRequestBodyError, MissingSecurityElement, MissingSecurityHeader, NoLoggingStatusForKey, NoSuchBucket, NoSuchKey, NotImplemented, NotSignedUp, OperationAborted, PermanentRedirect, PreconditionFailed, Redirect, RequestIsNotMultiPartContent, RequestTimeTooSkewed, RequestTimeout, RequestTorrentOfBucketError, SignatureDoesNotMatch, SlowDown, TemporaryRedirect, TokenRefreshRequired, TooManyBuckets, UnexpectedContent, UnresolvableGrantByEmailAddress, UserKeyMustBeSpecified

Instance Attribute Summary

• #response ⇒ Object readonly

  Returns the value of attribute response.

Class Method Summary

• .exception(code) ⇒ Object

  Factory for all other Exception classes in module, each for every error response available from AmazonAWS.

Instance Method Summary

• #initialize(message, response) ⇒ ResponseError constructor

  Creates new S3::ResponseError.

Constructor Details

#initialize(message, response) ⇒ ResponseError

Creates new S3::ResponseError.

Parameters

• message - what went wrong
• response - Net::HTTPResponse object or nil

# File 'lib/s3/exceptions.rb', line 20

def initialize(message, response)
  @response = response
  super(message)
end

Instance Attribute Details

#response ⇒ Object (readonly)

Returns the value of attribute response.

# File 'lib/s3/exceptions.rb', line 13

def response
  @response
end

Class Method Details

.exception(code) ⇒ Object

Factory for all other Exception classes in module, each for every error response available from AmazonAWS

Parameters

• code - Code name of exception

Returns

Descendant of ResponseError suitable for that exception code or ResponseError class if no class found

# File 'lib/s3/exceptions.rb', line 34

def self.exception(code)
  S3::Error.const_get(code)
rescue NameError
  ResponseError
end