Errores de API
Errores comunes devueltos por todos los servicios
En la siguiente tabla se muestran los errores comunes devueltos por todos los servicios de Oracle Cloud Infrastructure.
| Código de estado de HTTP | Código de error | Descripción | Reintentar |
|---|---|---|---|
| 400 | CannotParseRequest |
La solicitud tiene un formato incorrecto. | No. |
| 400 | InvalidParameter
|
Un parámetro no es válido o tiene un formato incorrecto. | No. |
| 400 | LimitExceeded
|
Al satisfacer la solicitud se supera el límite definido por Oracle para este arrendamiento y este tipo de recurso. | No. |
| 400 | MissingParameter
|
Falta un parámetro necesario. | No. |
| 400 | QuotaExceeded
|
Al satisfacer la solicitud se supera la cuota definida por el administrador para este compartimento y este recurso. | No. |
| 400 | RelatedResourceNot AuthorizedOrNotFound
|
No se ha encontrado el recurso especificado en el cuerpo de la solicitud o no tiene autorización para acceder a ese recurso. |
No. |
| 401 | NotAuthenticated
|
No se ha proporcionado la información de autenticación necesaria o es incorrecta. |
No. |
| 403 | NotAllowed
|
Esta operación se debe dirigir a la región principal. | No. |
| 403 | NotAuthorized
|
No tiene autorización para actualizar uno o más de los campos incluidos en esta solicitud. | No. |
| 403 | SignUpRequired
|
Esta operación requiere la inclusión para poder llamarla. | No. |
| 404 | InvalidParameter |
Un componente de ruta de acceso dinámica no es válido o es válido sintácticamente, pero no está permitido. | No. |
| 404 | NotAuthorizedOrNotFound
|
No se ha encontrado un recurso especificado a través del URI (ruta de acceso o parámetros de consulta) de la solicitud, o bien no tiene autorización para acceder a ese recurso. Para obtener más información, consulte Código 404 de estado de HTML. | No. |
| 404 | NotFound
|
No hay ninguna operación soportada en la ruta de acceso del URI y el método HTTP especificados en la solicitud. | No. |
| 404 | NamespaceNotFound
|
No tiene autorización para realizar esta solicitud o no se ha podido encontrar el recurso solicitado. | No. |
| 405 | MethodNotAllowed
|
El recurso de destino no soporta el método HTTP. | No. |
| 409 | Conflict
|
El estado solicitado para el recurso entra en conflicto con su estado actual. Este estado no es transitorio. | No. |
| 409 | ExternalServerIncorrectState
|
El servidor tiene un estado incorrecto, ha sufrido un timeout, ha devuelto una respuesta no válida o no se puede acceder a él. | Sí, con limitación. Consulte la descripción del error para ver las acciones necesarias antes de volver a intentarlo. |
| 409 | IncorrectState
|
El estado solicitado para el recurso entra en conflicto con su estado actual pero, después de una cantidad de tiempo determinada, tendrá el estado correcto. | Sí, con limitación. Consulte la descripción del error para ver las acciones necesarias antes de volver a intentarlo. |
| 409 | InvalidatedRetryToken
|
El token de reintento proporcionado se ha utilizado en una solicitud anterior que ha provocado una actualización del sistema, pero una operación posterior ha invalidado el token. Esto puede suceder, por ejemplo, en casos en los que se ha suprimido una entidad creada con el mismo token. Si se debe realizar de nuevo el cambio de estado del sistema asociado a esta solicitud, vuelva a intentarlo con otro token. | No. |
| 409 | ResourceLocked
|
El recurso solicitado está bloqueado. Esto suele deberse a que el recurso está en uso activo o a que la modificación del recurso hará que otro recurso deje de funcionar. | No. |
| 409 | NotAuthorizedOrResourceAlreadyExists
|
No tiene autorización para realizar esta solicitud o el recurso que intenta crear ya existe. Este código de error solo se devuelve desde las operaciones de creación, donde se devuelve en lugar del código de error más general NotAuthorizedOrNotFound. |
No. |
| 412 | NoEtagMatch
|
El ETag especificado en la solicitud no coincide con el ETag del recurso. | No. |
| 413 | PayloadTooLarge
|
La entidad de solicitud es mayor que los límites definidos por el servidor. | No. |
| 422 | UnprocessableEntity
|
La carga útil es sintácticamente correcta pero semánticamente no es válida. | No. |
| 429 | TooManyRequests
|
Ha emitido demasiadas solicitudes para las API de Oracle Cloud Infrastructure en muy poco tiempo. | Sí, con limitación. |
| 431 | RequestHeaderFieldsTooLarge
|
Las cabeceras HTTP de la solicitud son demasiado largas. La solicitud se puede volver a enviar después de reducir el tamaño de las cabeceras de solicitud. | No. |
| 500 | InternalServerError
|
Se ha producido un error interno del servidor. | Sí, con limitación. |
| 501 | MethodNotImplemented
|
El destino de la solicitud HTTP no reconoce el método HTTP. | No. |
| 503 | ExternalServerUnreachable
|
No se ha podido establecer una conexión con un sistema externo necesario para tramitar la solicitud. | Sí, con limitación. |
| 503 | ExternalServerTimeout
|
Se ha producido un timeout en la conexión con un sistema externo necesario para tramitar la solicitud antes de recibir una respuesta. | Sí, con limitación. |
| 503 | ExternalServerInvalidResponse
|
Una conexión con un sistema externo necesario para tramitar la solicitud dio como resultado una respuesta inaceptable. | Sí, con limitación. |
| 503 | ServiceUnavailable
|
El servicio no está disponible actualmente. | Sí, con limitación. |
Detalles de errores y solución de problemas de API
Esta sección contiene información detallada y sugerencias de solución de problemas para los códigos de error de estado de HTTP.
Códigos de error 400 de estado de HTTP
InvalidParameter
Descripción
Un valor de parámetro no es válido o tiene un formato incorrecto.
Solución de Problemas
- Consulte la documentación de la API de REST para conocer la operación, compruebe si los parámetros de la solicitud tienen errores tipográficos o formatos incorrectos, y corrija la solicitud.
MissingParameter
Descripción
Falta un parámetro necesario
Solución de Problemas
- A la solicitud le falta un parámetro necesario para esta API. Consulte la documentación de la API de REST para conocer la operación y corrija la solicitud.
QuotaExceeded
Descripción
Al satisfacer la solicitud se supera la cuota definida por el administrador para este compartimento y este recurso.
Solución de Problemas
- La cuota definida por el administrador para este compartimento de este recurso se superaría al satisfacer esta solicitud. Compruebe la cuota de recursos y solicite un aumento de la cuota o elimine los recursos no utilizados si es necesario. Para obtener más información sobre las cuotas, consulte Visión general de las cuotas de compartimento.
LimitExceeded
Descripción
Al satisfacer la solicitud se supera el límite definido por Oracle para este arrendamiento y este tipo de recurso.
Solución de Problemas
El límite definido por Oracle para este arrendamiento para este tipo de recurso se superaría al satisfacer esta solicitud. Compruebe el límite de nivel de arrendamiento de este recurso y solicite un aumento del límite en el arrendamiento o elimine los recursos no utilizados y vuelva a enviar la solicitud. Para obtener más información sobre los límites de su servicio OCI y cómo solicitar un aumento del límite, consulte Límites de servicio.CannotParseRequest
Descripción
La solicitud tiene un formato incorrecto.
Solución de Problemas
La solicitud para la mayoría de las operaciones que utilizan un cuerpo debe tener el formato JSON. Consulte la documentación de la API de REST relativa a la operación para confirmar si la operación utiliza JSON y, si es así, confirme que transfiere un JSON válido en el cuerpo de la solicitud.InvalidStorageTier
Descripción
La solicitud utiliza un nivel de almacenamiento no válido.
Solución de Problemas
El parámetro storageTier proporcionado no es correcto. Consulte la documentación de la API de REST para conocer la operación y corrija la solicitud.Códigos de error 401 de estado de HTTP
NotAuthenticated
Descripción
No se ha proporcionado la información de autenticación necesaria o es incorrecta.
Solución de Problemas
Hay varios elementos que pueden disparar este código de error:
- Falta la información de autenticación o es incorrecta.
- Verifique que se proporciona toda la información necesaria (OCID del inquilino, OCID del usuario, huella y clave privada) y que esta es precisa.
- Verifique que
private_key_pathapunta a la clave privada y no a la clave pública correspondiente - Verifique que los pares de claves pública/privada que está utilizando tienen el formato correcto.
- Verifique que la cuenta de usuario forma parte de un grupo con los permisos adecuados para poder realizar las acciones del plan que está ejecutando
- Verifique que el arrendamiento se ha suscrito a la región a la que se dirige en el plan
- Verifique que la clave pública que corresponde a la huella se ha cargado para el usuario a través del cual realiza la solicitud. Para obtener más información, consulte Claves y OCID necesarios.
- Sesgo de reloj. Este código de estado se devuelve si el reloj del cliente está sesgado más de cinco (5) minutos respecto al reloj del servidor. Para obtener más información, consulte Máximo sesgo de reloj del cliente permitido.
- Error de firma de solicitud de API. Este código de estado se devuelve si falta una parte de información necesaria o tiene un formato incorrecto en la cabecera de autorización. Para obtener más información, consulte Firmas de solicitud.
Códigos de error 403 de estado de HTTP
SignUpRequired
Descripción
Esta operación requiere la inclusión para poder llamarla.
Solución de Problemas
Asegúrese de que el usuario esté registrado para esta función. Si no es así, póngase en contacto con los con los servicios de soporte y regístrese para este servicio.NotAllowed
Descripción
Esta operación se debe dirigir a la región principal.
Solución de Problemas
Esta operación se debe dirigir a la región principal. Actualice el código de origen para proporcionar la información de región correcta.NotAuthorized
Descripción
No tiene autorización para actualizar uno o más de los campos incluidos en esta solicitud.
Solución de Problemas
Compruebe la solicitud y elimine todos los campos no autorizados. Para obtener más información sobre los permisos, consulte Referencia de política.Códigos de error 404 de estado de HTTP
NamespaceNotFound
Descripción
No se ha encontrado un recurso especificado a través del URI (ruta de acceso o parámetros de consulta) de la solicitud, o bien no tiene autorización para acceder a ese recurso.
Solución de Problemas
No se ha encontrado el recurso o el emisor de llamada no está autorizado a realizar la operación solicitada en el recurso para un recurso especificado mediante el URI de solicitud para las operaciones GET (list o get de entidad única), UPDATE y DELETE. Compruebe que el recurso solicitado existe y que tiene acceso a él. Para obtener más información sobre los permisos, consulte Referencia de política.NotFound
Descripción
No hay ninguna operación soportada en la ruta de acceso del URI y el método HTTP especificados en la solicitud.
Solución de problemas de
Los componentes de la ruta estática no existen o no tiene autorización para acceder a ellos. Compruebe la solicitud y actualice el componente de ruta estática.NotAuthorizedOrNotFound
Descripción
No se ha encontrado un recurso especificado a través del URI (ruta de acceso o parámetros de consulta) de la solicitud, o bien no tiene autorización para acceder a ese recurso.
Solución de problemas de
No se ha encontrado el recurso o el emisor de llamada no está autorizado a realizar la operación solicitada en el recurso para un recurso especificado mediante el URI de solicitud para las operaciones GET (list o get de entidad única), UPDATE y DELETE. Compruebe que el recurso solicitado existe y que tiene acceso a él. Para obtener más información sobre los permisos, consulte Referencia de política.InvalidParameter
Descripción
Un parámetro especificado en la ruta no es válido, o es sintácticamente válido pero no está permitido.
Solución de problemas de
Compruebe si los parámetros de la solicitud contienen errores tipográficos o formatos incorrectos. Consulte la documentación de la API de REST para conocer la operación y corrija la solicitud.Códigos de error 405 de estado de HTTP
MethodNotAllowed
Descripción
El recurso de destino no soporta el método HTTP utilizado.
Solución de problemas de
El método HTTP de la solicitud (por ejemplo, PUT, POST, DELETE o GET) no se permite en el recurso de destino. Compruebe si el método HTTP deseado se ha especificado correctamente y consulte la documentación de la API de REST para confirmar que está utilizando el método HTTP correcto.Códigos de error 409 de estado de HTTP
NotAuthorizedOrResourceAlreadyExists
Descripción
No tiene autorización para realizar esta solicitud o el recurso que intenta crear ya existe. Este código de error solo se devuelve desde las operaciones de creación, donde se devuelve en lugar del código de error más general NotAuthorizedOrNotFound.
Solución de problemas de
- Si la solicitud es para crear un recurso, compruebe que el recurso no existe y que el usuario que realiza la llamada está autorizado a crear este tipo de recurso en este compartimento.
- Verifique que el usuario está en un grupo que tiene permisos para trabajar con recursos en un compartimento. Para obtener más información sobre los permisos, consulte Referencia de política.
InvalidatedRetryToken
Descripción
El token de reintento proporcionado se ha utilizado en una solicitud anterior que ha provocado una actualización del sistema, pero una operación posterior ha invalidado el token. Esto puede suceder en los casos en los que una entidad creada con el mismo token se ha suprimido posteriormente. Si es necesario realizar de nuevo el cambio de estado del sistema asociado a esta solicitud, utilice un token diferente.
Solución de problemas de
Compruebe el código de origen y verifique que el token de reintento se ha utilizado correctamente.ExternalServerIncorrectState
Descripción
El servidor tiene un estado incorrecto, ha sufrido un timeout, ha devuelto una respuesta no válida o no se puede acceder a él.
Solución de problemas de
Realice lo siguiente:
- Compruebe el mensaje de error para obtener más información. Puede que tenga que volver a iniciar el servidor y asegurarse de que los servicios de Oracle puedan acceder a él.
- Consulte los logs de errores del servidor para obtener información útil.
- Es posible que el servidor haya experimentado un problema temporal. Espere un momento y, a continuación, vuelva a intentar la solicitud.
- Si la solicitud sigue fallando, póngase en contacto con el soporte técnico de OCI e incluya el opc-request-id de la solicitud o respuesta HTTP que ha fallado.
IncorrectState
Descripción
El estado solicitado para el recurso entra en conflicto con su estado actual pero, después de una cantidad de tiempo determinada, tendrá el estado correcto.
Solución de problemas de
Realice lo siguiente:
- Compruebe las dependencias de recursos. No se puede suprimir un recurso si todavía lo utilizan otros recursos.
- Vuelva a intentar la solicitud más tarde o actualice el código para esperar a que se alcance el estado correcto antes de realizar esta acción. Algunas operaciones requieren que el recurso tenga un estado determinado (por ejemplo, en ejecución).
Conflicto
Descripción
El estado solicitado para el recurso entra en conflicto con su estado actual. Este estado no es transitorio.
Solución de problemas de
Compruebe el estado del recurso solicitado y vuelva a intentarlo.ResourceLocked
Descripción
El recurso solicitado está bloqueado. Esto suele deberse a que el recurso está en uso activo o a que la modificación del recurso hará que otro recurso deje de funcionar.
Solución de problemas de
Compruebe el recurso para obtener detalles sobre el bloqueo. Puede llamar a una API para eliminar el bloqueo en el recurso o puede transferir un parámetro a la API para ignorar el bloqueo y realizar la operación solicitada.
Si un servicio externo colocó el bloqueo en el recurso, es posible que no pueda eliminar el bloqueo en absoluto. Por ejemplo, los administradores de los arrendamientos principales pueden crear cuotas bloqueadas en un arrendamiento secundario y los administradores del arrendamiento secundario no pueden cambiar las cuotas.
Algunos bloqueos especifican un recurso relacionado en el que debe suprimir el recurso relacionado para eliminar el bloqueo de este recurso.
Códigos de error 412 de estado de HTTP
NoEtagMatch
Descripción
La ETag especificada en el campo if-match de la solicitud no coincide con la ETag del recurso.
Solución de problemas de
Corrija la ETag en la solicitud si no es la esperada. Para obtener más información sobre las ETag, consulte la documentación de Etag.
Códigos de error 413 de estado de HTTP
PayloadTooLarge
Descripción
La entidad de solicitud es mayor que los límites definidos por el servidor.
Solución de problemas de
Intente enviar una solicitud más pequeña.
Códigos de error 422 de estado de HTTP
UnprocessableEntity
Descripción
La carga útil es sintácticamente correcta pero semánticamente no es válida.
Solución de problemas de
El servicio no puede procesar la solicitud. Compruebe la solicitud y vuelva a formatearla si es necesario.
Códigos de error 429 de estado de HTTP
TooManyRequests
Descripción
Ha emitido demasiadas solicitudes para las API de Oracle Cloud Infrastructure demasiado rápido.
Solución de problemas de
Está causado por un número demasiado alto de solicitudes en un corto período de tiempo. Si el servicio tiene mecanismos de limitación, demasiadas solicitudes en un breve período de tiempo provocarán que se rechacen algunas solicitudes. Intente agregar algunos retrasos entre solicitudes para evitar este error.
Códigos de error 431 de estado de HTTP
RequestHeaderFieldsTooLarge
Descripción
Las cabeceras HTTP de la solicitud son demasiado largas.
Solución de problemas de
La solicitud se puede volver a enviar después de reducir el tamaño de las cabeceras de solicitud.
Códigos de error 500 de estado de HTTP
InternalServerError
Descripción
Se ha producido un error interno del servidor.
Solución de problemas de
El servicio no ha podido procesar la solicitud por motivos desconocidos. Por lo general, se trata de una incidencia en el servicio, posiblemente debido a una interrupción temporal del servicio o a un bug. Vuelva a intentar enviar la misma solicitud. Si el reintento sigue fallando, póngase en contacto con el soporte técnico de OCI e incluya opc-request-id de la solicitud o respuesta HTTP que ha fallado en el mensaje.
Códigos de error 501 de estado de HTTP
MethodNotImplemented
Descripción
El destino de la solicitud HTTP no reconoce el método HTTP.
Solución de problemas de
El método HTTP de la solicitud no está implantado en el servicio. Consulte la documentación de la API de REST para conocer la operación y actualice la solicitud para que utilice el método HTTP adecuado para la operación.