Response codes#

Cloud Files returns an HTTP code that denotes the type of response.

The following table lists possible fault types with their associated error codes and descriptions.

Fault type

Associated error code

Description

OK

200

The request has succeeded. (Some API calls might return 201 instead.)

Created

201

The request has been fulfilled and a resource was created.

Accepted

202

The request has been accepted for processing.

No Content

204

The request has been fulfilled but does not return a representation (that is, the response is empty).

Partial Content

206

The request has been fulfilled the partial GET request for the resource.

Bad Request

400

The request was not understood due to bad syntax or missing required parameters.

Unauthorized

401

Authentication failed, or the user does not have permissions for a requested operation.

Forbidden

403

The server understood the request but refused to fulfill it.

Not Found

404

A requested resource was not found but might be available again in the future.

Method Not Allowed

405

The request method is not supported for this resource.

Request Timeout

408

The server timed out waiting for the request.

Conflict

409

The request could not be completed due to a conflict with the current state of the resource.

Length Required

411

The request did not specify the length of its content, which is required by the requested resource.

Precondition Failed

412

The server does not meet one of the preconditions that the requester put on the request.

Request Entity Too Large

413

The server is refusing to process a request because the request entity is larger than the server is willing or able to process.

Expectation Failed

417

The server cannot meet the requirements of the Expect request-header field.

Unprocessable Entity

422

The request could not be followed due to semantic errors.

Too Many Requests

429

Too many requests have been sent in a given amount of time. Pause requests, wait up to one minute, and try again. (Intended for use with rate limiting.)

Internal Server Error

500

The service encountered an unexpected condition that prevented it from fulfilling the request.

Service Unavailable

503

The service is currently unable to handle the request due to a temporary overloading or maintenance. This is a temporary condition. Try again later.

An example of an error message follows.

Example: Error message example

HTTP/1.1 201 Created
Last-Modified: Fri, 17 Jan 2014 17:28:35 GMT
Content-Length: 116
Etag: 8a964ee2a5e88be344f36c22562a6486
Content-Type: text/html; charset=UTF-8
X-Trans-Id: tx4d5e4f06d357462bb732f-0052d96843
Date: Fri, 17 Jan 2014 17:28:35 GMT