Backblaze B2 Extension Error Codes

The All-in-One WP Migration plugin uses Backblaze B2 API to communicate with your account and store your backups. If there is an error communicating with your Backblaze B2 drive and the files that are stored in it, you might get one of these errors.
Backblaze B2 sets a per-user quota for each user to make sure that the resources available are shared fairly. If you have many other applications or systems connected to your B2 account you may encounter issues.

What can you do about it?

If the All-in-One WP Migration plugin cannot connect to your B2 drive, please sign out from your account and sign in again in the Backblaze B2 Settings page of the plugin on your WordPress Console.
Ensure that there are no other applications using your B2 drive at the same time as the All-in-One WP Migration extension. If you have other 3rd party applications or other services that are connected to your Backblaze B2 drive, consider stopping or uninstalling them. If you share large numbers of documents with other people or the public, consider an alternative solution to Backblaze B2.

Please see more specific detail about each error code below:

Invalid Credentials
The All-in-One WP migration plugin cannot connect to your B2 cloud. Please sign out from your account and sign in again in the Backblaze B2 Settings of the plugin on your WordPress Console.

The user does not have sufficient permissions for the file
The All-in-One WP migration plugin cannot access a file or folder on your Backblaze B2. Please check that your account has permissions on the file or folder that you are trying to access with the plugin.
If this does not work, or if the file is stored on your drive, please sign out from your account and sign in again in the Backblaze B2 Settings page of the plugin on your WordPress Console.

Cannot be used within the domain
The All-in-One WP migration plugin cannot access your Backblaze B2 cloud. If you are attempting to backup op or migrate your site whilst logged in on a corporate domain, please check that you are able to access your Backblaze B2 storage or contact the domain administrator.

File not found
The All-in-One WP migration plugin cannot access a file or folder on your Backblaze drive. Please check that the file exists and that you can access it through your drive.

Backend Error
An unexpected error occurred with your B2 cloud while processing the request. Please try again. Please sign out from your account and sign in again in the Backblaze B2 Settings page of the plugin on your WordPress Console.

Bad Request
The All-in-One WP migration plugin cannot connect to your Backblaze B2 account. Please sign out from your account and sign in again in the Backblaze B2 Settings of the plugin on your WordPress Console.

User Rate Limit Exceeded
There have been too many API calls on your drive. Try again after stopping drive sync and any other applications that connect to your drive and waiting for 5 minutes

Rate Limit Exceeded
There have been too many API calls on your drive. Try again after stopping drive sync and any other applications that connect to your drive and waiting for 5 minutes.

Sharing Rate Limit Exceeded
You have exceeded the sharing rate limit on your Backblaze B2 account. This can be related to emails or documents that you are sharing publicly from your drive Don’t send large volumes of emails when you are doing backups/migrations. Remove permissions on publicly available files in your drive.

The user has not granted access to the file
The All-in-One WP migration plugin cannot access a file or folder on your Backblaze B2. Please check that your cloud account has permissions on the file or folder that you are trying to access with the plugin. If this does not work, or if the file is stored on your drive, please sign out from your account and sign in again in the Backblaze B2 Settings page of the plugin on your WordPress Console.

Too Many Requests
There have been too many requests on your Backblaze B2 account. This can be related to documents that you are sharing publicly from your drive or other applications that are using your B2 cloud.

Here is a complete list of HTTP error codes:

*press control F to search this page

Code: 400 ‘Bad Request’
Message: Cannot process the request because it is malformed or incorrect.

Code: 401 ‘Unauthorized’
Message: Required authentication information is either missing or not valid for the resource.

Code: 403 ‘Forbidden’
Message: Access is denied to the requested resource. The user might not have enough permission.

Code: 404 ‘Not Found’
Message: The requested resource doesn’t exist.

Code: 405 ‘Method Not Allowed’
Message: The HTTP method in the request is not allowed on the resource.

Code: 406 ‘Not Acceptable’
Message: This service doesn’t support the format requested in the Accept header. The requested resource is capable of generating only content not acceptable according to the Accept headers sent in the request.

Code: 407 ‘Proxy Authentication Required’
Message: Proxy authentication required. The client must first authenticate themselves with the proxy.

Code: 408 ‘Request Timeout’
Message: Request timed out. The server timed out waiting for the request. The client did not produce a request within the time that the server was prepared to wait. Repeat the request without modifications at any later time.

Code: 409 ‘Conflict’
Message: The current state conflicts with what the request expects. The request could not be processed because of the conflict.

Code: 410 ‘Gone’
Message: The requested resource is no longer available at the server.

Code: 411 ‘Length REquired’
Message: A Content-Length based header is required on the request.

Code: 412 ‘Precondition Failed’
Message: The server does not meet one of the preconditions that the requester put on the request.

Code 413 ‘Request Entity Too Large’
Message: The request size exceeds the maximum limit.

Code 414 ‘Request-URI Too Long’
Message: Request-URI too long. The URI provided was too long for the server to process.

Code: 415 ‘Unsupported Media Type’
Message: The content type of the request is a format that is not supported by the service.

Code: 416 ‘Requested Range Not Satisfiable’
Message: The specified byte range is invalid or unavailable.

Code: 417 ‘Expectation Failed’
Message: Expectation failed. The server cannot meet the requirements of the Expect request-header field.

Code: 422 ‘Unprocessable Entity’
Message: The request was well-formed but was unable to be followed due to semantic errors.

Code: 423 ‘Locked’
Message: The resource that is being accessed is locked.

Code: 424 ‘Failed Dependency’
Message: The request failed because it depended on another request and that request failed

Code: 500 ‘Internal Server Error’
Message: There was an interntal error while processing the request.

Code: 501 ‘Not Implemented’
Message: The requested feature is not implemented.

Code: 502 ‘Bad Gateway’
Message: Bad gateway. The server was acting as a gateway or a proxy and received an invalid response from the upstream server.

Code: 503 ‘Service Unavailable’
Message: The service is temporarily unavailable. You may repeat the request after a delay. There may be a Retry-After header.

Code: 504 ‘504 Gateway Timeout’
Message: The server was acting as a gateway or proxy and did not receive a timely response from the upstream server.

Code: 505 ‘HTTP Version Not Supported’
Message: The server does not support the HTTP protocol version used in the request.

Code: 507 ‘ Insufficient Storage’
Message: The server is unable to store the representation needed to complete the request. Please ensure that you have enough disk space.

Code: 508 ‘Loop Detected’
Message: The server detected an infinite loop while processing the request.

Here is a complete list of Backblaze B2 API error codes:

*press control F to search this page

Error: unauthorized
One of:

• B2 has not been enabled for this account

• User is in B2 suspend

• Invalid authorization

• Not authorized

• The bucket is not authorized

• Bucket does not have the specified file

Error: missing_phone_number
Account is missing a mobile phone number. Please update account settings

Error: bad_request
One of:

• Invalid fileId: <fileId>. File id used for the request is not valid

• No active upload for: <fileId>. Used file id is not valid for the upload request

• No active upload for large file (<fileId>). Used file id is not valid for the large file/multipart upload request

• Wrong hostname for request

• AccountId bad. Provided account id not valid

• Account <accountId> does not exist

• Not a valid file id: <fileId>

• Invalid bucked id: <bucketId>

• bucketName is required but nor provided

• bucketName must be at least 6 characters long

• bucketName can be at most 50 characters long

• Bucket id <bucketId> does not exist

• Bucket id <bucketId> is not a B2 bucket

• bucketTypes cannot be empty. Must be provided either ‘allPublic’ or ‘allPrivate’ type

• “all” cannot be requested with other bucket types

• Invalid bucketTypes requested

• Invalid characters in bucketName: must be alphanumeric or ‘-‘

• No Authorization header in the request

• Snapshot buckets are reserved for Backblaze use

• Allow snapshot header must be specified when deleting a file from a snapshot bucket

• Application key does not exist. Please provide valid application key to access the account

• Part <partNumber> found sha1 is different from expected (in upload requests for large files)

• Part number is smaller than minimum part size for upload (in upload requests for large files)

• Last part cannot be empty (in upload requests for large files)

• File names must not start with ‘/’

• File names must not end with ‘/’

• File names must not contain ‘\’

• File names must not contain DELETE

• File names must not contain ‘//’

• File names must contain at least one character

• File names in UTF8 must be no more than 1000 bytes

• File names segment must not be more than 250 bytes

• File names must not start with the given delimiter

• File is too big

• fileNamePrefix must be specified

• validDurationInSeconds must be >= 0

• validDurationInSeconds cannot be greater than a week

• Prefix must be 1 or more characters long

• Delimiter must be within acceptable list

• Timed out while iterating and skipping files

• Maximum number of file info entries is 10

• File info name too long: <name>

• File info value too long: <value>

• Total size of file name and file info headers is <totalSize>, which is over the max of 7000

• File names segment must not be more than 250 bytes

• Cannot change a bucket to a snapshot bucket

• bucket_not_updated

• Request path is null

• Missing header: X-Bz-Part-Number

• Part number must be in the range 1 – 10000

• Not a valid part number: <headerValue>

• Request path should look like: /b2api/v1/b2_upload_part/<fileId>/

• Invalid file id in path. Provided file id in the request is invalid

• Invalid tome id in path

• Not a valid hex sha1: <contentSha1> (in upload requests for large files)

Error: cap_exceeded
Usage capabilities exceeded

Error: method_not_allowed
Only POST is supported, not <method>

Error: request_timeout
The service timed out reading the uploaded file

Error: conflict
The ifRevisionIs test failed

Error: missing_auth_token
Authorization token is missing.

Error: expired_auth_token
Authorization token has expired

Error: already_hidden
File already hidden: <fileName>

Error: bad_auth_token
One of:

• Invalid authorization token

• Authorization token for wrong cluster

Error: too_many_buckets
The account is already at the maximum bucket count

Error: duplicate_bucket_name
Bucket name is already in use

Error: bad_bucket_id
Bucket <bucketId> does not exist

Error: file_not_present
File not present: <fileName> <fileId>

Error: not_found
One of:

• File state deleted

• File state none

• File state unknown

Error: no_such_file
File not present: <fileName>

Error: range_not_satisfiable
The Range header is the request is outside the size of the file

Error: service_unavailable
One of:

• No uploads available in vault <vaultId>

• Various reasons

Error: invalid_bucket_id
Invalid bucketId: <bucketId>

Error: out_of_range
maxFileCount out of range: <maxFileCount>

Error: invalid_file_id
Invalid startFileId: <startFileId>

Here is a complete list of cURL error codes:

CURLE_OK (0)
All fine. Proceed as usual.

CURLE_UNSUPPORTED_PROTOCOL (1)
The URL you passed to libcurl used a protocol that this libcurl does not support. The support might be a compile-time option that you didn’t use, it can be a misspelled protocol string or just a protocol libcurl has no code for.

CURLE_FAILED_INIT (2)
Very early initialization code failed. This is likely to be an internal error or problem, or a resource problem where something fundamental couldn’t get done at init time.

CURLE_URL_MALFORMAT (3)
The URL was not properly formatted.

CURLE_NOT_BUILT_IN (4)
A requested feature, protocol or option was not found built-in in this libcurl due to a build-time decision. This means that a feature or option was not enabled or explicitly disabled when libcurl was built and in order to get it to function you have to get a rebuilt libcurl.

CURLE_COULDNT_RESOLVE_PROXY (5)
Couldn’t resolve proxy. The given proxy host could not be resolved.

CURLE_COULDNT_RESOLVE_HOST (6)
Couldn’t resolve host. The given remote host was not resolved.

CURLE_COULDNT_CONNECT (7)
Failed to connect() to host or proxy.

CURLE_FTP_WEIRD_SERVER_REPLY (8)
The server sent data libcurl couldn’t parse. This error code is used for more than just FTP and is aliased as CURLE_WEIRD_SERVER_REPLY since 7.51.0.

CURLE_REMOTE_ACCESS_DENIED (9)
We were denied access to the resource given in the URL. For FTP, this occurs while trying to change to the remote directory.

CURLE_FTP_ACCEPT_FAILED (10)
While waiting for the server to connect back when an active FTP session is used, an error code was sent over the control connection or similar.

CURLE_FTP_WEIRD_PASS_REPLY (11)
After having sent the FTP password to the server, libcurl expects a proper reply. This error code indicates that an unexpected code was returned.

CURLE_FTP_ACCEPT_TIMEOUT (12)
During an active FTP session, while waiting for the server to connect, the CURLOPT_ACCEPTTIMEOUT_MS (or the internal default) timeout expired.

CURLE_FTP_WEIRD_PASV_REPLY (13)
libcurl failed to get a sensible result back from the server as a response to either a PASV or a EPSV command. The server is flawed.

CURLE_FTP_WEIRD_227_FORMAT (14)
FTP servers return a 227-line as a response to a PASV command. If libcurl fails to parse that line, this return code is passed back.

CURLE_FTP_CANT_GET_HOST (15)
An internal failure to lookup the host used for the new connection.

CURLE_HTTP2 (16)
A problem was detected in the HTTP2 framing layer. This is somewhat generic and can be one out of several problems, see the error buffer for details.

CURLE_FTP_COULDNT_SET_TYPE (17)
A problem was detected in the HTTP2 framing layer. This is somewhat generic and can be one out of several problems, see the error buffer for details.

CURLE_PARTIAL_FILE (18)
Received an error when trying to set the transfer mode to binary or ASCII.

CURLE_FTP_COULDNT_RETR_FILE (19)
This was either a weird reply to a ‘RETR’ command or a zero byte transfer complete.

CURLE_QUOTE_ERROR (21)
When sending custom “QUOTE” commands to the remote server, one of the commands returned an error code that was 400 or higher (for FTP) or otherwise indicated unsuccessful completion of the command.

CURLE_HTTP_RETURNED_ERROR (22)
This is returned if CURLOPT_FAILONERROR is set TRUE and the HTTP server returns an error code that is >= 400.

CURLE_WRITE_ERROR (23)
An error occurred when writing received data to a local file, or an error was returned to libcurl from a write callback.

CURLE_UPLOAD_FAILED (25)
Failed to start the upload. For FTP, the server typically denied the STOR command. The error buffer usually contains the server’s explanation for this.

CURLE_READ_ERROR (26)
There was a problem reading a local file or an error returned by the read callback.

CURLE_OUT_OF_MEMORY (27)
A memory allocation request failed. This is serious badness and things are severely screwed up if this ever occurs.

CURLE_OPERATION_TIMEDOUT (28)
Operation timeout. The specified time-out period was reached according to the conditions.

CURLE_FTP_PORT_FAILED (30)
The FTP PORT command returned an error. This mostly happens when you haven’t specified a good enough address for libcurl to use. See CURLOPT_FTPPORT.

CURLE_FTP_COULDNT_USE_REST (31)
he FTP REST command returned an error. This should never happen if the server is sane.

CURLE_RANGE_ERROR (33)
The server does not support or accept range requests.

CURLE_HTTP_POST_ERROR (34)
This is an odd error that mainly occurs due to internal confusion.

CURLE_SSL_CONNECT_ERROR (35)
A problem occurred somewhere in the SSL/TLS handshake. You really want the error buffer and read the message there as it pinpoints the problem slightly more. Could be certificates (file formats, paths, permissions), passwords, and others.

CURLE_BAD_DOWNLOAD_RESUME (36)
The download could not be resumed because the specified offset was out of the file boundary.

CURLE_FILE_COULDNT_READ_FILE (37)
A file is given with FILE:// couldn’t be opened. Most likely because the file path doesn’t identify an existing file. Did you check file permissions?

CURLE_LDAP_CANNOT_BIND (38)
LDAP cannot bind. LDAP bind operation failed.

CURLE_LDAP_SEARCH_FAILED (39)
LDAP search failed.

CURLE_FUNCTION_NOT_FOUND (41)
Function not found. A required zlib function was not found.

CURLE_ABORTED_BY_CALLBACK (42)
Aborted by callback. A callback returned “abort” to libcurl..

CURLE_BAD_FUNCTION_ARGUMENT (43)
Internal error. A function was called with a bad parameter.

CURLE_INTERFACE_FAILED (45)
Interface error. A specified outgoing interface could not be used. Set which interface to use for outgoing connections’ source IP address with CURLOPT_INTERFACE.

CURLE_TOO_MANY_REDIRECTS (47)
Too many redirects. When following redirects, libcurl hit the maximum amount. Set your limit with CURLOPT_MAXREDIRS.

CURLE_UNKNOWN_OPTION (48)
An option passed to libcurl is not recognized/known. Refer to the appropriate documentation. This is most likely a problem in the program that uses libcurl. The error buffer might contain more specific information about which exact option it concerns.

CURLE_TELNET_OPTION_SYNTAX (49)
A telnet option string was Illegally formatted.

CURLE_GOT_NOTHING (52)
Nothing was returned from the server, and under the circumstances, getting nothing is considered an error.

CURLE_SSL_ENGINE_NOTFOUND (53)
The specified crypto engine wasn’t found.

CURLE_SSL_ENGINE_SETFAILED (54)
Failed to set the selected SSL crypto engine as default!

CURLE_SEND_ERROR (55)
Failed sending network data.

CURLE_RECV_ERROR (56)
Failure with receiving network data.

CURLE_SSL_CERTPROBLEM (58)
problem with the local client certificate.

CURLE_SSL_CIPHER (59)
Couldn’t use the specified cipher.

CURLE_PEER_FAILED_VERIFICATION (60)
The remote server’s SSL certificate or SSH md5 fingerprint was deemed not OK. This error code has been unified with CURLE_SSL_CACERT since 7.62.0. Its previous value was 51.

CURLE_BAD_CONTENT_ENCODING (61)
Unrecognized transfer encoding.

CURLE_LDAP_INVALID_URL (62)
Invalid LDAP URL..

CURLE_FILESIZE_EXCEEDED (63)
Maximum file size exceeded.

CURLE_USE_SSL_FAILED (64)
Requested FTP SSL level failed.

CURLE_SEND_FAIL_REWIND (65)
When doing a send operation curl had to rewind the data to retransmit, but the rewinding operation failed.

CURLE_SSL_ENGINE_INITFAILED (66)
Initiating the SSL Engine failed.

CURLE_LOGIN_DENIED (67)
The remote server denied curl to login (Added in 7.13.1)

CURLE_TFTP_NOTFOUND (68)
File not found on TFTP server.

CURLE_TFTP_PERM (69)
Permission problem on TFTP server.

CURLE_REMOTE_DISK_FULL (70)
Out of disk space on the server.

CURLE_TFTP_ILLEGAL (71)
Illegal TFTP operation.

CURLE_TFTP_UNKNOWNID (72)
Unknown TFTP transfer ID.

CURLE_REMOTE_FILE_EXISTS (73)
File already exists and will not be overwritten.

CURLE_TFTP_NOSUCHUSER (74)
This error should never be returned by a properly functioning TFTP server.

CURLE_CONV_FAILED (75)
Character conversion failed.

CURLE_CONV_REQD (76)
The caller must register conversion callbacks.

CURLE_SSL_CACERT_BADFILE (77)
Problem with reading the SSL CA cert (path? access rights?)

CURLE_REMOTE_FILE_NOT_FOUND (78)
The resource referenced in the URL does not exist.

CURLE_SSH (79)
An unspecified error occurred during the SSH session.

CURLE_SSL_SHUTDOWN_FAILED (80)
Failed to shut down the SSL connection.

CURLE_AGAIN (81)
The socket is not ready for send/recv to wait till it’s ready and try again. This return code is only returned from curl_easy_recv and curl_easy_send (Added in 7.18.2)

CURLE_SSL_CRL_BADFILE (82)
Failed to load CRL file (Added in 7.19.0)

CURLE_SSL_ISSUER_ERROR (83)
Issuer check failed (Added in 7.19.0)

CURLE_FTP_PRET_FAILED (84)
The FTP server does not understand the PRET command at all or does not support the given argument. Be careful when using CURLOPT_CUSTOMREQUEST, a custom LIST command will be sent with PRET CMD before PASV as well. (Added in 7.20.0)

CURLE_RTSP_CSEQ_ERROR (85)
Mismatch of RTSP CSeq numbers.

CURLE_RTSP_SESSION_ERROR (86)
Mismatch of RTSP Session Identifiers.

CURLE_FTP_BAD_FILE_LIST (87)
Unable to parse FTP file list (during FTP wildcard downloading).

CURLE_CHUNK_FAILED (88)
Chunk callback reported an error.

CURLE_NO_CONNECTION_AVAILABLE (89)
(For internal use only, will never be returned by libcurl) No connection available, the session will be queued. (added in 7.30.0)

CURLE_SSL_PINNEDPUBKEYNOTMATCH (90)
Failed to match the pinned key specified with CURLOPT_PINNEDPUBLICKEY.

CURLE_SSL_INVALIDCERTSTATUS (91)
The status returned failure when asked with CURLOPT_SSL_VERIFYSTATUS

CURLE_HTTP2_STREAM (92)
Stream error in the HTTP/2 framing layer.

<

CURLE_RECURSIVE_API_CALL (93)
An API function was called from inside a callback.

CURLE_AUTH_ERROR (94)
An authentication function returned an error.

CURLE_OBSOLETE*
These error codes will never be returned. They were used in an old libcurl version and are currently unused.

2 Comments

Leave A Comment?