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.

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.

403 NotAllowed This operation must be directed at the home region. No.
403 NotAuthorized You do not have authorization to update one or more of the fields included in this request. No.
403 SignUpRequired This operation requires opt-in before it may be called. No.
404 InvalidParameter A dynamic path component is invalid or is syntactically valid but is not allowed. 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. No.
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 Conflict The requested state for the resource conflicts with its current state. This state is not transient. No.
409 IncorrectState The requested state for the resource conflicts with its current state but given some amount of time it will be in the correct 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. No.
412 NoEtagMatch The ETag specified in the request does not match the ETag for the resource. No.
413 PayloadTooLarge The request entity is larger than limits defined by server. No.
422 UnprocessableEntity Payload is syntactically correct but semantically invalid. 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.
431 RequestHeaderFieldsTooLarge The request's HTTP headers are too long. The request may be resubmitted after reducing the size of the request headers. No.
500 InternalServerError An internal server error occurred. Yes, with backoff.
501 MethodNotImplemented The HTTP request target does not recognize the HTTP method. No.
503 ExternalServerUnreachable A connection with an external system needed to fulfill the request could not be established. Yes, with backoff.
503 ExternalServerTimeout A connection with an external system needed to fulfill the request timed out before a response was received. Yes, with backoff.
503 ExternalServerInvalidResponse A connection with an external system needed to fulfill the request resulted in an unacceptable response. Yes, with backoff.
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