b2sdk.exception – Exceptions

exception b2sdk.exception.AlreadyFailed(*args, **kwargs)

Bases: b2sdk.exception.B2SimpleError

exception b2sdk.exception.B2ConnectionError(*args, **kwargs)

Bases: b2sdk.exception.TransientErrorMixin, b2sdk.exception.B2SimpleError

exception b2sdk.exception.B2Error(*args, **kwargs)

Bases: Exception

__init__(*args, **kwargs)

Python 2 does not like it when you pass unicode as the message in an exception. We like to use file names in exception messages. To avoid problems, if the message has any non-ascii characters in it, they are replaced with backslash-uNNNN

https://pythonhosted.org/kitchen/unicode-frustrations.html#frustration-5-exceptions

property prefix

nice auto-generated error message prefix >>> B2SimpleError().prefix ‘Simple error’ >>> AlreadyFailed().prefix ‘Already failed’

should_retry_http()

Returns true if this is an error that can cause an HTTP call to be retried.

should_retry_upload()

Returns true if this is an error that should tell the upload code to get a new upload URL and try the upload again.

exception b2sdk.exception.B2HttpCallbackException(*args, **kwargs)

Bases: b2sdk.exception.B2SimpleError

exception b2sdk.exception.B2HttpCallbackPostRequestException(*args, **kwargs)

Bases: b2sdk.exception.B2HttpCallbackException

exception b2sdk.exception.B2HttpCallbackPreRequestException(*args, **kwargs)

Bases: b2sdk.exception.B2HttpCallbackException

exception b2sdk.exception.B2RequestTimeout(*args, **kwargs)

Bases: b2sdk.exception.TransientErrorMixin, b2sdk.exception.B2SimpleError

exception b2sdk.exception.B2SimpleError(*args, **kwargs)

Bases: b2sdk.exception.B2Error

a B2Error with a message prefix

exception b2sdk.exception.BadDateFormat(*args, **kwargs)

Bases: b2sdk.exception.B2SimpleError

prefix = 'Date from server'

exception b2sdk.exception.BadFileInfo(*args, **kwargs)

Bases: b2sdk.exception.B2SimpleError

exception b2sdk.exception.BadJson(*args, **kwargs)

Bases: b2sdk.exception.B2SimpleError

prefix = 'Bad request'

exception b2sdk.exception.BadUploadUrl(*args, **kwargs)

Bases: b2sdk.exception.TransientErrorMixin, b2sdk.exception.B2SimpleError

exception b2sdk.exception.BrokenPipe(*args, **kwargs)

Bases: b2sdk.exception.B2Error

should_retry_upload()

Returns true if this is an error that should tell the upload code to get a new upload URL and try the upload again.

exception b2sdk.exception.BucketNotAllowed(*args, **kwargs)

Bases: b2sdk.exception.NotAllowedByAppKeyError

exception b2sdk.exception.CapabilityNotAllowed(*args, **kwargs)

Bases: b2sdk.exception.NotAllowedByAppKeyError

exception b2sdk.exception.ChecksumMismatch(checksum_type, expected, actual)

Bases: b2sdk.exception.TransientErrorMixin, b2sdk.exception.B2Error

__init__(checksum_type, expected, actual)

Initialize self. See help(type(self)) for accurate signature.

exception b2sdk.exception.ClockSkew(clock_skew_seconds)

Bases: b2sdk.exception.B2HttpCallbackPostRequestException

The clock on the server differs from the local clock by too much.

__init__(clock_skew_seconds)

Parameters

clock_skew_seconds – The different: local_clock - server_clock

exception b2sdk.exception.CommandError(message)

Bases: b2sdk.exception.B2Error

b2 command error (user caused). Accepts exactly one argument. We expect users of shell scripts will parse our __str__ output.

__init__(message)

Python 2 does not like it when you pass unicode as the message in an exception. We like to use file names in exception messages. To avoid problems, if the message has any non-ascii characters in it, they are replaced with backslash-uNNNN

https://pythonhosted.org/kitchen/unicode-frustrations.html#frustration-5-exceptions

exception b2sdk.exception.Conflict(*args, **kwargs)

Bases: b2sdk.exception.B2SimpleError

exception b2sdk.exception.ConnectionReset(*args, **kwargs)

Bases: b2sdk.exception.B2Error

should_retry_upload()

Returns true if this is an error that should tell the upload code to get a new upload URL and try the upload again.

exception b2sdk.exception.DestFileNewer(dest_file, source_file, dest_prefix, source_prefix)

Bases: b2sdk.exception.B2Error

__init__(dest_file, source_file, dest_prefix, source_prefix)

Python 2 does not like it when you pass unicode as the message in an exception. We like to use file names in exception messages. To avoid problems, if the message has any non-ascii characters in it, they are replaced with backslash-uNNNN

https://pythonhosted.org/kitchen/unicode-frustrations.html#frustration-5-exceptions

should_retry_http()

Returns true if this is an error that can cause an HTTP call to be retried.

exception b2sdk.exception.DuplicateBucketName(*args, **kwargs)

Bases: b2sdk.exception.B2SimpleError

prefix = 'Bucket name is already in use'

exception b2sdk.exception.FileAlreadyHidden(*args, **kwargs)

Bases: b2sdk.exception.B2SimpleError

exception b2sdk.exception.FileNameNotAllowed(*args, **kwargs)

Bases: b2sdk.exception.NotAllowedByAppKeyError

exception b2sdk.exception.FileNotPresent(*args, **kwargs)

Bases: b2sdk.exception.B2SimpleError

exception b2sdk.exception.InvalidAuthToken(message, code)

Bases: b2sdk.exception.Unauthorized

Specific type of Unauthorized that means the auth token is invalid. This is not the case where the auth token is valid but does not allow access.

__init__(message, code)

Python 2 does not like it when you pass unicode as the message in an exception. We like to use file names in exception messages. To avoid problems, if the message has any non-ascii characters in it, they are replaced with backslash-uNNNN

https://pythonhosted.org/kitchen/unicode-frustrations.html#frustration-5-exceptions

exception b2sdk.exception.InvalidMetadataDirective(*args, **kwargs)

Bases: b2sdk.exception.B2Error

exception b2sdk.exception.InvalidRange(content_length, range_)

Bases: b2sdk.exception.B2Error

__init__(content_length, range_)

Python 2 does not like it when you pass unicode as the message in an exception. We like to use file names in exception messages. To avoid problems, if the message has any non-ascii characters in it, they are replaced with backslash-uNNNN

https://pythonhosted.org/kitchen/unicode-frustrations.html#frustration-5-exceptions

exception b2sdk.exception.InvalidUploadSource(*args, **kwargs)

Bases: b2sdk.exception.B2SimpleError

exception b2sdk.exception.MaxFileSizeExceeded(size, max_allowed_size)

Bases: b2sdk.exception.B2Error

__init__(size, max_allowed_size)

Python 2 does not like it when you pass unicode as the message in an exception. We like to use file names in exception messages. To avoid problems, if the message has any non-ascii characters in it, they are replaced with backslash-uNNNN

https://pythonhosted.org/kitchen/unicode-frustrations.html#frustration-5-exceptions

exception b2sdk.exception.MaxRetriesExceeded(limit, exception_info_list)

Bases: b2sdk.exception.B2Error

__init__(limit, exception_info_list)

Python 2 does not like it when you pass unicode as the message in an exception. We like to use file names in exception messages. To avoid problems, if the message has any non-ascii characters in it, they are replaced with backslash-uNNNN

https://pythonhosted.org/kitchen/unicode-frustrations.html#frustration-5-exceptions

exception b2sdk.exception.MissingPart(*args, **kwargs)

Bases: b2sdk.exception.B2SimpleError

prefix = 'Part number has not been uploaded'

exception b2sdk.exception.NonExistentBucket(*args, **kwargs)

Bases: b2sdk.exception.B2SimpleError

prefix = 'No such bucket'

exception b2sdk.exception.NotAllowedByAppKeyError(*args, **kwargs)

Bases: b2sdk.exception.B2SimpleError

Base class for errors caused by restrictions on an application key.

exception b2sdk.exception.PartSha1Mismatch(key)

Bases: b2sdk.exception.B2Error

__init__(key)

Python 2 does not like it when you pass unicode as the message in an exception. We like to use file names in exception messages. To avoid problems, if the message has any non-ascii characters in it, they are replaced with backslash-uNNNN

https://pythonhosted.org/kitchen/unicode-frustrations.html#frustration-5-exceptions

exception b2sdk.exception.RestrictedBucket(bucket_name)

Bases: b2sdk.exception.B2Error

__init__(bucket_name)

Python 2 does not like it when you pass unicode as the message in an exception. We like to use file names in exception messages. To avoid problems, if the message has any non-ascii characters in it, they are replaced with backslash-uNNNN

https://pythonhosted.org/kitchen/unicode-frustrations.html#frustration-5-exceptions

exception b2sdk.exception.ServiceError(*args, **kwargs)

Bases: b2sdk.exception.TransientErrorMixin, b2sdk.exception.B2Error

Used for HTTP status codes 500 through 599.

exception b2sdk.exception.StorageCapExceeded(*args, **kwargs)

Bases: b2sdk.exception.B2Error

exception b2sdk.exception.TooManyRequests(*args, **kwargs)

Bases: b2sdk.exception.B2Error

should_retry_http()

Returns true if this is an error that can cause an HTTP call to be retried.

class b2sdk.exception.TransientErrorMixin

Bases: object

should_retry_http()

should_retry_upload()

exception b2sdk.exception.TruncatedOutput(bytes_read, file_size)

Bases: b2sdk.exception.TransientErrorMixin, b2sdk.exception.B2Error

__init__(bytes_read, file_size)

Initialize self. See help(type(self)) for accurate signature.

exception b2sdk.exception.Unauthorized(message, code)

Bases: b2sdk.exception.B2Error

__init__(message, code)

Python 2 does not like it when you pass unicode as the message in an exception. We like to use file names in exception messages. To avoid problems, if the message has any non-ascii characters in it, they are replaced with backslash-uNNNN

https://pythonhosted.org/kitchen/unicode-frustrations.html#frustration-5-exceptions

should_retry_upload()

Returns true if this is an error that should tell the upload code to get a new upload URL and try the upload again.

exception b2sdk.exception.UnexpectedCloudBehaviour(*args, **kwargs)

Bases: b2sdk.exception.B2SimpleError

exception b2sdk.exception.UnknownError(*args, **kwargs)

Bases: b2sdk.exception.B2SimpleError

exception b2sdk.exception.UnknownHost(*args, **kwargs)

Bases: b2sdk.exception.B2Error

exception b2sdk.exception.UnrecognizedBucketType(*args, **kwargs)

Bases: b2sdk.exception.B2Error

exception b2sdk.exception.UnsatisfiableRange(*args, **kwargs)

Bases: b2sdk.exception.B2Error

exception b2sdk.exception.UnusableFileName(*args, **kwargs)

Bases: b2sdk.exception.B2SimpleError

Raise when a filename doesn’t meet the rules.

Could possibly use InvalidUploadSource, but this is intended for the filename on the server, which could differ. https://www.backblaze.com/b2/docs/files.html.

b2sdk.exception.interpret_b2_error(status, code, message, post_params=None)