When an oracle-compute command executes successfully, it either terminates silently or prints a table of values about the object on which the operation was performed.
If an error occurs, the command returns an exit status code and an exception. The exit status code is stored in the exit status environment variable, the name of which depends on the UNIX shell that you use.
The following table describes exit status codes.
| Exit status | Exception and description |
|---|---|
|
0 |
Success |
|
1 |
General error, including operations that are not allowed. |
|
2 |
Shell builtins have been misused as a result of a missing keyword or component, or an underlying permission problem not related to Oracle Compute Cloud Service permissions. |
|
3 |
APIException Indicates an error during the operation of the client or server. |
|
4 |
ValidationError The input data is not valid. For example, missing values, wrong types or references to non-existent objects. This exception always contains detailed information on the input data. |
|
5 |
APIInternalError Indicates that communications might have succeeded, but something went wrong inside the client. This is the base class for the APICodec error. |
|
6 |
APICodecError Indicates a problem with JSON format encoding an object or decoding the response. This is the base class for the APIDecoding and APIEncoding errors. |
|
7 |
APIDecodingError Indicates a problem with decoding a response to an object, usually because of an invalid JSON format. |
|
8 |
APIEncodingError Indicates a problem with encoding an object usually caused by data in an unrecognizable format. |
|
9 |
APIClientError A client side error, in line with 4xx errors in HTTP. |
|
10 |
APIUnauthorizedError The request requires user authentication or authorization. |
|
11 |
APIForbiddenError The request is formed properly, but the server cannot fulfill it. The issue is not related to authorization. Do not repeat the request. |
|
12 |
APINotFoundError The server has not found a match for the URI in the request. This state might be temporary so repeat the request. |
|
13 |
APIMethodNotAllowedError The method specified in the Request-Line is not allowed for the resource identified by the Request-URI. This exception occurs when the request includes a method that is not supported for the object. |
|
14 |
APINotAcceptableError The resource specified in the request generates response that has characteristics that are not allowed by the accept headers in the request. |
|
15 |
APIConflictError The request could not be completed because of a conflict with the state of the resource or the resource already exists. You can either delete the existing object to allow the request to create it or you can create a new object with a unique identifier. |
|
16 |
APIGoneError The requested resource does not exist. This error occurs when an instance exists but is not running, so a duplicate of this instance with the same identifier can not be created. |
|
17 |
APIUnsupportedTypeError The server cannot complete the request because the request contains a format that is not supported by the method for the resource. This error indicates an error in JSON formatting. |
|
18 |
APIServerError An internal error has occurred and the server cannot fulfill the request. |
|
21 |
APIUncaughtExceptionError The server encountered an unexpected condition that prevented it from fulfilling the request. The error includes a code. Use this code when you report the problem to My Oracle Support. |
|
22 |
APINotImplementedError The server does not support the functionality required to fulfill the request. |
|
23 |
APIServiceUnavailable The server is unable to handle the request due to temporary overloading or maintenance. This error is usually related to the load on the server and is temporary. Repeat the request. |
|
30 |
IOError A file to be uploaded to the server cannot be found or is unavailable. |
|
24 |
APIGatewayError The Oracle Compute service layer is not able to respond. This is usually related to a failover of the service and is temporary. Repeat the request. |
|
31 |
APINetworkError There was a network error while trying to communicate with the server. This can result from a DNS lookup failure or TCP connection failure. |
|
33 |
APIRequestTooLarge The request attempts to upload an image that exceeds the maximum upload size. |
For debugging, use the -d option while running the oracle-compute command. The -d option prints out all the HTTP traffic, which facilitates the user in debugging error messages.