Erreurs d'API
Erreurs courantes renvoyées par tous les services
Le tableau ci-dessous répertorie les erreurs courantes renvoyées par tous les services Oracle Cloud Infrastructure.
Code de statut HTTP | Code d'erreur | Description | Nouvelle tentative |
---|---|---|---|
400 | CannotParseRequest |
Le format de la demande n'est pas correct. | Non. |
400 | InvalidParameter
|
Un paramètre n'est pas valide ou son format est incorrect. | Non. |
400 | LimitExceeded
|
L'exécution de cette demande dépasse la limite définie par Oracle pour cette location et ce type de ressource. | Non. |
400 | MissingParameter
|
Un paramètre requis est manquant. | Non. |
400 | QuotaExceeded
|
L'exécution de cette demande dépasse le quota défini par l'administrateur pour ce compartiment et cette ressource. | Non. |
400 | RelatedResourceNot AuthorizedOrNotFound
|
Une ressource spécifiée dans le corps de la demande est introuvable ou vous n'êtes pas autorisé à accéder à cette ressource. |
Non. |
401 | NotAuthenticated
|
Les informations d'authentification requises n'ont pas été fournies ou sont incorrectes. |
Non. |
403 | NotAllowed
|
Cette opération doit être dirigée vers la région d'origine. | Non. |
403 | NotAuthorized
|
Vous n'êtes pas autorisé à mettre à jour certains des champs inclus dans cette demande. | Non. |
403 | SignUpRequired
|
Cette opération exige un consentement avant d'être appelée. | Non. |
404 | InvalidParameter |
Un composant de chemin dynamique n'est pas valide, ou est valide d'un point de vue syntaxique mais n'est pas autorisé. | Non. |
404 | NotAuthorizedOrNotFound
|
Une ressource spécifiée via l'URI (chemin ou paramètres de requête) de la demande est introuvable, ou vous n'êtes pas autorisé à accéder à cette ressource. Pour plus d'informations, reportez-vous à Code de statut HTML 404. | Non. |
404 | NotFound
|
Aucune opération n'est prise en charge au niveau du chemin d'URI et de la méthode HTTP que vous avez indiqués dans la demande. | Non. |
404 | NamespaceNotFound
|
Vous n'êtes pas autorisé à effectuer cette demande ou la ressource demandée est introuvable. | Non. |
405 | MethodNotAllowed
|
La ressource cible ne prend pas en charge la méthode HTTP. | Non. |
409 | Conflict
|
L'état demandé pour la ressource est en conflit avec son état en cours. Cet état n'est pas transitoire. | Non. |
409 | ExternalServerIncorrectState
|
Le serveur est dans un état incorrect, a expiré, a renvoyé une réponse non valide ou est inaccessible. | Oui, avec attente. Reportez-vous à la description de l'erreur pour connaître les actions à effectuer avant de réessayer. |
409 | IncorrectState
|
L'état demandé pour la ressource est en conflit avec son état en cours, mais après un certain temps, l'état sera correct. | Oui, avec attente. Reportez-vous à la description de l'erreur pour connaître les actions à effectuer avant de réessayer. |
409 | InvalidatedRetryToken
|
Le jeton de nouvelle tentative fourni a été utilisé dans une demande précédente qui a entraîné une mise à jour du système, mais une opération suivante a invalidé le jeton. Cela peut se produire, par exemple, lorsqu'une entité créée avec le même jeton a depuis été supprimée. Si un changement d'état du système associé à cette demande doit être de nouveau effectué, réessayez en utilisant un autre jeton. | Non. |
409 | ResourceLocked
|
La ressource demandée est verrouillée. Cela est généralement dû au fait que la ressource est en cours d'utilisation ou que la modification de la ressource entraîne l'arrêt du fonctionnement d'une autre ressource. | Non. |
409 | NotAuthorizedOrResourceAlreadyExists
|
Vous n'êtes pas autorisé à exécuter cette demande ou la ressource que vous tentez de créer existe déjà. Ce code d'erreur est renvoyé uniquement à partir d'opérations de création , à la place du code d'erreur NotAuthorizedOrNotFound plus général. |
Non. |
412 | NoEtagMatch
|
L'ETag spécifiée dans la demande ne correspond pas à celle de la ressource. | Non. |
413 | PayloadTooLarge
|
L'entité de demande dépasse les limites définies par le serveur. | Non. |
422 | UnprocessableEntity
|
La charge utile est correcte d'un point de vue syntaxique, mais n'est pas valide sémantiquement. | Non. |
429 | TooManyRequests
|
Vous avez émis trop de demandes pour les API Oracle Cloud Infrastructure en un temps réduit. | Oui, avec attente. |
431 | RequestHeaderFieldsTooLarge
|
Les en-têtes HTTP de la demande sont trop longs. La demande peut être soumise à nouveau après réduction de la taille de ses en-têtes. | Non. |
500 | InternalServerError
|
Une erreur de serveur interne est survenue. | Oui, avec attente. |
501 | MethodNotImplemented
|
La cible de demande HTTP ne reconnaît pas la méthode HTTP. | Non. |
503 | ExternalServerUnreachable
|
Une connexion avec un système externe nécessaire à l'exécution de la demande n'a pas pu être établie. | Oui, avec attente. |
503 | ExternalServerTimeout
|
Une connexion avec un système externe nécessaire à l'exécution de la demande a expiré avant la réception d'une réponse. | Oui, avec attente. |
503 | ExternalServerInvalidResponse
|
Une connexion avec un système externe nécessaire à l'exécution de la demande a généré une réponse inacceptable. | Oui, avec attente. |
503 | ServiceUnavailable
|
Le service n'est pas disponible actuellement. | Oui, avec attente. |
Détails d'erreur d'API et résolution
Cette section contient des informations détaillées et des suggestions de dépannage pour les codes d'erreur de statut HTTP.
Codes d'erreur de statut HTTP 400
InvalidParameter
Description
Une valeur de paramètre n'est pas valide ou son format est incorrect.
Dépannage
- Recherchez l'opération dans la documentation relative à l'API REST et vérifiez que les paramètres de la demande ne comportent ni erreurs typographiques ni formats incorrects. Corrigez la demande.
MissingParameter
Description
Un paramètre requis est manquant
Dépannage
- La demande ne contient pas un paramètre requis pour l'API. Recherchez l'opération dans la documentation relative à l'API REST et corrigez la demande.
QuotaExceeded
Description
L'exécution de cette demande dépasse le quota défini par l'administrateur pour ce compartiment et cette ressource.
Dépannage
- L'exécution de cette demande entraînerait le dépassement du quota défini par l'administrateur pour ce compartiment et cette ressource. Vérifiez le quota de ressources et demandez une augmentation de quota, ou nettoyez les ressources non utilisées si nécessaire. Pour en savoir plus sur les quotas, reportez-vous à Présentation des quotas de compartiment.
LimitExceeded
Description
L'exécution de cette demande dépasse la limite définie par Oracle pour cette location et ce type de ressource.
Dépannage
L'exécution de cette demande entraînerait le dépassement de la limite définie par Oracle pour cette location et ce type de ressource. Vérifiez la limite de la ressource au niveau de la location et demandez une augmentation de limite pour la location, ou nettoyez les ressources non utilisées. Renvoyez ensuite la demande. Pour en savoir plus sur vos limites de service OCI et sur la procédure pour demander une augmentation de limite, reportez-vous à Limites de service.CannotParseRequest
Description
Le format de la demande n'est pas correct.
Dépannage
Pour la plupart des opérations qui comportent un corps, la demande doit être au format JSON. Recherchez l'opération dans la documentation relative à l'API REST pour savoir si elle accepte le format JSON. Si tel est le cas, vérifiez que le corps de demande transmis respecte le format JSON.InvalidStorageTier
Description
La demande utilise un niveau de stockage non valide.
Dépannage
Le paramètre storageTier fourni est incorrect. Recherchez l'opération dans la documentation relative à l'API REST et corrigez la demande.Codes d'erreur de statut HTTP 401
NotAuthenticated
Description
Les informations d'authentification requises n'ont pas été fournies ou sont incorrectes.
Dépannage
Plusieurs éléments peuvent déclencher ce code d'erreur :
- Informations d'authentification manquantes ou incorrectes.
- Vérifiez que toutes les informations requises (OCID de locataire, OCID utilisateur, empreinte et clé privée) sont fournies et exactes.
- Vérifiez que
private_key_path
pointe vers votre clé privée et non vers la clé publique correspondante - Vérifiez que le format des paires de clés publique/privée que vous utilisez est correct.
- Vérifiez que le compte utilisateur fait partie d'un groupe disposant des droits d'accès appropriés pour effectuer les actions du plan que vous exécutez
- Vérifiez que votre location est abonnée à la région que vous ciblez dans votre plan.
- Vérifiez que la clé publique correspondant à l'empreinte a été téléchargée pour l'utilisateur sous le nom duquel vous effectuez la demande. Pour plus d'informations, reportez-vous à Clés et OCID requis.
- Décalage d'horloge. Ce code de statut est renvoyé si l'horloge du client est décalée de plus de cinq (5) minutes par rapport à celle du serveur. Pour plus d'informations, reportez-vous à Décalage maximal autorisé de l'horloge client.
- Erreur de signature de la demande d'API. Ce code de statut est renvoyé si une information requise est manquante ou de format incorrect dans l'en-tête Authorization. Pour plus d'informations, reportez-vous à Signatures des demandes.
Codes d'erreur de statut HTTP 403
SignUpRequired
Description
Cette opération exige un consentement avant d'être appelée.
Dépannage
Assurez-vous que l'utilisateur a souscrit la fonctionnalité. Si ce n'est pas le cas, contactez le support technique et inscrivez-vous au service.NotAllowed
Description
Cette opération doit être dirigée vers la région d'origine.
Dépannage
Cette opération doit être dirigée vers la région d'origine. Mettez à jour le code source pour fournir des informations de région correctes.NotAuthorized
Description
Vous n'êtes pas autorisé à mettre à jour certains des champs inclus dans cette demande.
Dépannage
Vérifiez la demande et enlevez tous les champs non autorisés. Pour en savoir plus sur les droits d'accès, reportez-vous à Référence de stratégie.Codes d'erreur de statut HTTP 404
NamespaceNotFound
Description
Une ressource spécifiée via l'URI (chemin ou paramètres de requête) de la demande est introuvable, ou vous n'êtes pas autorisé à accéder à cette ressource.
Dépannage
La ressource est introuvable ou l'appelant n'est pas autorisé à effectuer l'opération demandée sur la ressource. Cette ressource est indiquée via l'URI de demande pour les opérations GET (liste ou entité unique), UPDATE et DELETE. Vérifiez que la ressource demandée existe réellement et que vous y avez accès. Pour en savoir plus sur les droits d'accès, reportez-vous à Référence de stratégie.NotFound
Description
Aucune opération n'est prise en charge au niveau du chemin d'URI et de la méthode HTTP que vous avez indiqués dans la demande.
Dépannage
Les composants de chemin statique n'existent pas ou vous n'êtes pas autorisé à y accéder. Vérifiez la demande et mettez à jour le composant de chemin statique.NotAuthorizedOrNotFound
Description
Une ressource spécifiée via l'URI (chemin ou paramètres de requête) de la demande est introuvable, ou vous n'êtes pas autorisé à accéder à cette ressource.
Dépannage
La ressource est introuvable ou l'appelant n'est pas autorisé à effectuer l'opération demandée sur la ressource. Cette ressource est indiquée via l'URI de demande pour les opérations GET (liste ou entité unique), UPDATE et DELETE. Vérifiez que la ressource demandée existe réellement et que vous y avez accès. Pour en savoir plus sur les droits d'accès, reportez-vous à Référence de stratégie.InvalidParameter
Description
Un paramètre spécifié dans le chemin n'est pas valide ou est valide d'un point de vue syntaxique mais pas autorisé.
Dépannage
Vérifiez que les paramètres de la demande ne comportent ni erreurs typographiques ni formats incorrects. Recherchez l'opération dans la documentation relative à l'API REST et corrigez la demande.Codes d'erreur de statut HTTP 405
MethodNotAllowed
Description
La ressource cible ne prend pas en charge la méthode HTTP utilisée.
Dépannage
La méthode HTTP de la demande (par exemple, PUT, POST, DELETE ou GET) n'est pas autorisée par la ressource cible. Vérifiez si la méthode HTTP voulue est indiquée correctement et recherchez l'opération dans la documentation relative à l'API REST pour vérifier que vous utilisez la méthode HTTP qui convient.Codes d'erreur de statut HTTP 409
NotAuthorizedOrResourceAlreadyExists
Description
Vous n'êtes pas autorisé à exécuter cette demande ou la ressource que vous tentez de créer existe déjà. Ce code d'erreur est renvoyé uniquement à partir d'opérations de création, à la place du code d'erreur NotAuthorizedOrNotFound
plus général.
Dépannage
- Si la demande concerne la création d'une ressource, vérifiez que cette dernière n'existe pas déjà et que l'utilisateur appelant est autorisé à créer ce type de ressource dans le compartiment.
- Vérifiez que l'utilisateur fait partie d'un groupe qui dispose des droits d'accès nécessaires pour utiliser des ressources dans un compartiment. Pour en savoir plus sur les droits d'accès, reportez-vous à Référence de stratégie.
InvalidatedRetryToken
Description
Le jeton de nouvelle tentative fourni a été utilisé dans une demande précédente qui a entraîné une mise à jour du système, mais une opération suivante a invalidé le jeton. Cela peut se produire lorsqu'une entité créée avec le même jeton a depuis été supprimée. Si un changement d'état du système associé à cette demande doit de nouveau être effectué, utilisez un autre jeton.
Dépannage
Vérifiez le code source et assurez-vous que le jeton de nouvelle tentative est utilisé correctement.ExternalServerIncorrectState
Description
Le serveur est dans un état incorrect, a expiré, a renvoyé une réponse non valide ou est inaccessible.
Dépannage
Procédez comme suit :
- Consultez le message d'erreur pour plus de détails. Vous devrez peut-être redémarrer votre serveur et vous assurer qu'il est accessible par les services Oracle.
- Pour plus d'informations, consultez les journaux d'erreurs de votre serveur.
- Votre serveur a peut-être rencontré un problème temporaire. Patientez quelques temps, puis réessayez la demande.
- Si la demande échoue, contactez le support technique OCI et incluez l'ID opc-request-id de la demande ou de la réponse HTTP qui a échoué.
IncorrectState
Description
L'état demandé pour la ressource est en conflit avec son état en cours, mais après un certain temps, l'état sera correct.
Dépannage
Procédez comme suit :
- Vérifiez les dépendances de ressource. Une ressource ne peut pas être supprimée si elle est encore utilisée par d'autres ressources.
- Réessayez ultérieurement ou mettez le code à jour de façon à attendre que le bon état soit atteint avant d'effectuer cette action. Certaines opérations nécessitent que la ressource se trouve dans un état donné (par exemple, en cours d'exécution).
Conflit
Description
L'état demandé pour la ressource est en conflit avec son état en cours. Cet état n'est pas transitoire.
Dépannage
Vérifiez l'état de ressource demandé et réessayez.ResourceLocked
Description
La ressource demandée est verrouillée. Cela est généralement dû au fait que la ressource est en cours d'utilisation ou que la modification de la ressource entraîne l'arrêt du fonctionnement d'une autre ressource.
Dépannage
Pour plus de détails sur le verrou, consultez la ressource. Vous pouvez appeler une API pour enlever le verrou sur la ressource, ou transmettre un paramètre à l'API pour ignorer le verrou et effectuer l'opération demandée.
Si le verrou a été placé sur la ressource par un service externe, il se peut que vous ne puissiez pas du tout le supprimer. Par exemple, les administrateurs des locations parent peuvent créer des quotas verrouillés dans une location enfant, et les administrateurs de la location enfant ne peuvent pas modifier les quotas.
Certains verrous spécifient une ressource associée dans laquelle vous devez supprimer la ressource associée afin de supprimer le verrou sur cette ressource.
Codes d'erreur de statut HTTP 412
NoEtagMatch
Description
L'ETag spécifiée dans le champ if-match de la demande ne correspond pas à celle de la ressource.
Dépannage
Si cela n'est pas attendu, corrigez l'ETag dans la demande. Pour plus d'informations sur les ETags, reportez-vous à la documentation relative à l'ETag.
Codes d'erreur de statut HTTP 413
PayloadTooLarge
Description
L'entité de demande dépasse les limites définies par le serveur.
Dépannage
Essayez d'envoyer une demande plus petite.
Codes d'erreur de statut HTTP 422
UnprocessableEntity
Description
La charge utile est correcte d'un point de vue syntaxique, mais n'est pas valide sémantiquement.
Dépannage
Le service ne parvient pas à traiter la demande. Vérifiez la demande et reformatez-la si nécessaire.
Codes d'erreur de statut HTTP 429
TooManyRequests
Description
Vous avez émis trop de demandes pour les API Oracle Cloud Infrastructure dans un laps de temps trop court.
Dépannage
Ce problème est dû à un trop grand nombre de demandes dans un laps de temps limité. Si le service dispose de mécanismes de ralentissement, un trop grand nombre de demandes dans un court laps de temps entraînera le rejet de certaines d'entre elles. Essayez d'espacer les demandes pour éviter cette erreur.
Codes d'erreur de statut HTTP 431
RequestHeaderFieldsTooLarge
Description
Les en-têtes HTTP de la demande sont trop longs.
Dépannage
La demande peut être soumise à nouveau après réduction de la taille de ses en-têtes.
Codes d'erreur de statut HTTP 500
InternalServerError
Description
Une erreur de serveur interne est survenue.
Dépannage
Le service n'a pas pu traiter la demande pour des raisons inconnues. Il s'agit généralement d'un problème côté service, probablement dû à une coupure de service temporaire ou à un bug. Réessayez d'envoyer la même demande. Si la nouvelle tentative échoue, contactez le support technique OCI et incluez dans votre message l'ID opc-request-id
de la demande ou de la réponse HTTP qui a échoué.
Codes d'erreur de statut HTTP 501
MethodNotImplemented
Description
La cible de demande HTTP ne reconnaît pas la méthode HTTP.
Dépannage
La méthode HTTP de la demande n'est pas implémentée sur le service. Recherchez l'opération dans la documentation relative à l'API REST et mettez à jour la demande afin d'utiliser la méthode HTTP qui convient à l'opération.