Status Codes

When you call any of the Compute Classic REST resources, the Response header returns one of the standard HTTP status codes defined in the following table.

Note:

Success codes are documented in the topics that describe the individual methods.
HTTP Response Code Error Description

4xx

APIClientError

A client side error, in line with 4xx errors in HTTP.

400

Bad Request

The request contains invalid parameters.

401

APIUnauthorizedError

The request requires user authentication or authorization.

403

APIForbiddenError

The server understood the request, but is refusing to fulfill it. Authorization will not help and the request should not be repeated.

404

APINotFoundError

The server hasn't found anything matching the Request-URI. No indication is given of whether the condition is temporary or permanent.

405

APIMethodNotAllowedError

The method specified in the Request-Line isn't allowed for the resource identified by the Request-URI. The Compute Classic API supports only a subset of HTTP methods (GET, POST, PUT, DELETE). And not all methods are supported for all objects. This exception will be thrown if an unsupported method is invoked.

406

APINotAcceptableError

The resource identified by the request is only capable of generating response entities which have content characteristics not acceptable according to the accept headers sent in the request.

409

APIConflictError

The request could not be completed due to a conflict with the current state of the resource, or, in the case of a resource-creation call, the requested resource already exists in the system. You can either delete the existing object and create it afresh or create a new object with a unique identifier.

410

APIGoneError

The requested resource no longer exists on the server. For example, where an instance once existed, but is no longer running, a duplicate of this instance with the same identifier can't be created.

412

APIPreconditionFailedError

When a GET or PUT request is sent to a VPN endpoint and the VPN gateway, the gateway in your data center through which you want to connect to the Oracle Cloud VPN gateway, has not been configured or is disabled.

413

APIRequestTooLarge

The image uploaded exceeds the maximum allowed upload size.

415

APIUnsupportedTypeError

The server cannot service the request as the requested entity is specified in a format which is not supported by the requested resource for the requested method. This usually indicates a JSON encoding error.

429

APITooManyRequestsError

The server cannot service this request as the number of requests raised has exceeded the specified limit. There is a limit on the number of requests that the server can handle. This limitation varies depending on the resource and the action that you want to perform. For example, there is a limit on the number of screen capture requests you can raise per instance per minute.

5xx

APIServerError

An internal error has occurred and the server is incapable of fulfilling the request.

500

APIUncaughtExceptionError

The server encountered an unexpected condition that prevented it from fulfilling the request. This error will return a reference code which you must note and supply when you contact Oracle Support.

501

APINotImplementedError

The server does not currently support the functionality required to fulfill the request.

503

APIServiceUnavailable

The server is currently unable to handle the request due to temporary overloading or maintenance. This is most likely a load-related condition, which should be alleviated after a short delay.

502/504

APIGatewayError

The connection between the API and the service layer of Oracle Single-Tenant Compute Cloud Service is down. This is generally a temporary, most likely service failover-related, condition, which should be alleviated after a short delay.

507

APIInsufficientStorage

The server is unable to store the representation needed to successfully complete the request. This condition is considered to be temporary.