API Errors

Common Errors Returned by All Services

The following table lists the common errors returned by all the services for Oracle Cloud Infrastructure.

HTTP Status Code Error Code Description Retry
400 CannotParseRequest The request is incorrectly formatted. No.
400 InvalidParameter A parameter is invalid or incorrectly formatted. No.
400 LimitExceeded Fulfilling this request exceeds the Oracle-defined limit for this tenancy for this resource type. No.
400 MissingParameter A required parameter is missing. No.
400 QuotaExceeded Fulfilling this request exceeds the administrator-defined quota for this compartment for this resource. No.
400 RelatedResourceNot AuthorizedOrNotFound

A resource specified in the body of the request was not found, or you do not have authorization to access that resource.

Yes, with backoff.
401 NotAuthenticated

The required authentication information was not provided or was incorrect. There are other reasons why this error code is generated. For more information, see HTML Status Code 401.

Yes, with backoff.
402 SignUpRequired This operation requires opt-in before it may be called. No.
403 NotAuthorized You do not have authorization to update one or more of the fields included in this request. No.
404 NotAuthorizedOrNotFound A resource specified via the URI (path or query parameters) of the request was not found, or you do not have authorization to access that resource. For more information, see HTML Status Code 404. Yes, with backoff.
404 NotFound There is no operation supported at the URI path and HTTP method you specified in the request. No.
405 MethodNotAllowed The target resource does not support the HTTP method. No.
409 IncorrectState The requested state for the resource conflicts with its current state. Yes, with backoff. Refer to the error description for any required actions before you retry.
409 InvalidatedRetryToken The provided retry token was used in an earlier request that resulted in a system update, but a subsequent operation invalidated the token. This can happen, for example, in cases where an entity created with the same token has since been deleted. If the system state change that is associated with this request should be performed again, retry it using a different token. No.
409 NotAuthorizedOr ResourceAlreadyExists You do not have authorization to perform this request, or the resource you are attempting to create already exists. This error code is returned only from create operations, where it is returned instead of the more general NotAuthorizedOrNotFound error code. Yes, with backoff.
412 NoEtagMatch The ETag specified in the request does not match the ETag for the resource. No.
429 TooManyRequests You have issued too many requests to the Oracle Cloud Infrastructure APIs in too short of an amount of time. Yes, with backoff.
500 InternalServerError An internal server error occurred. Yes, with backoff.
501 MethodNotImplemented The HTTP request target does not recognize the HTTP method. No.
503 ServiceUnavailable The service is currently unavailable. Yes, with backoff.

Error Details and Troubleshooting

HTTP status code: 401
  • Missing or incorrect authentication information. Verify that all the required information (tenant OCID, user OCID, fingerprint, and private key) is provided and accurate. Verify that the public key corresponding to the fingerprint has been uploaded for the user. For more information, see Required Keys and OCIDs.
  • Clock skew. This status code is returned if the client's clock is skewed more than five (5) minutes from the server's clock. For more information, see Maximum Allowed Client Clock Skew.
  • API request signature error. This status code is returned if a required header is missing from a signing string. For more information, see Request Signatures.
Error Codes: NotAuthorizedOrNotFound, RelatedResourceNotAuthorizedOrNotFound , NotAuthorizedOrResourceAlreadyExists
  • Authorization error. Verify that the user is in a group that has the permissions to work with resources in a compartment.
  • Compartment or resource not found. Verify that the compartment or resource exist and is referenced correctly. For example, this status code is returned for either of the following errors:

    • CompartmentNotFound if a compartment doesn't exist
    • VolumeNotFound if a volume doesn't exist