Erreurs d'API
Erreurs communes retournées par tous les services
Le tableau suivant répertorie les erreurs communes retournées par tous les services pour Oracle Cloud Infrastructure.
| Code de statut HTTP | Code d'erreur | Description | Réessayer |
|---|---|---|---|
| 400 | CannotParseRequest |
Le format de la demande n'est pas correct. | Non. |
| 400 | InvalidParameter
|
Un paramètre n'est pas valide ou a un format incorrect. | Non. |
| 400 | LimitExceeded
|
L'exécution de cette demande dépasse la limite définie par Oracle pour ce type de ressource. | Non. |
| 400 | MissingParameter
|
Un paramètre obligatoire est manquant. | Non. |
| 400 | QuotaExceeded
|
L'exécution de cette demande dépasse le quota défini par l'administrateur pour ce compartiment pour cette ressource. | Non. |
| 400 | RelatedResourceNot AuthorizedOrNotFound
|
Une ressource indiqué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 principale. | Non. |
| 403 | NotAuthorized
|
Vous n'êtes pas autorisé à mettre à jour un ou plusieurs des champs inclus dans cette demande. | Non. |
| 403 | SignUpRequired
|
Cette opération requiert une option d'inclusion avant d'être appelée. | Non. |
| 404 | InvalidParameter |
Un composant de chemin dynamique n'est pas valide ou il est syntaxiquement valide, mais pas autorisé. | Non. |
| 404 | NotAuthorizedOrNotFound
|
Une ressource indiquée au moyen de l'URI (chemin ou paramètres d'interrogation) de la demande est introuvable ou vous n'êtes pas autorisé à accéder à cette ressource. Pour plus d'informations, voir Code de statut HTML 404. | Non. |
| 404 | NotFound
|
Aucune opération n'est prise en charge pour le chemin d'URI et 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 courant. Cet état n'est pas transitoire. | Non. |
| 409 | ExternalServerIncorrectState
|
Le serveur est dans un état incorrect et a expiré, a retourné une réponse non valide ou est inaccessible. | Oui, avec délai d'attente. Consultez la description de l'erreur pour connaître les éventuelles actions requises avant de réessayer. |
| 409 | IncorrectState
|
L'état demandé pour la ressource est en conflit avec son état courant, mais après un certain délai, l'état sera correct. | Oui, avec délai d'attente. Consultez la description de l'erreur pour connaître les éventuelles actions requises avant de réessayer. |
| 409 | InvalidatedRetryToken
|
Le jeton de nouvelle tentative fourni était utilisé dans une demande antérieure qui a entraîné une mise à jour du système, mais une opération ultérieure a invalidé le jeton. Cela peut se produire, par exemple, dans les cas où une entité créée avec le même jeton a depuis été supprimée. Si la modification d'état du système associée à cette demande doit être réexécutée, relancez-la à l'aide d'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 active, ou parce que la modification de la ressource entraînera 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 retourné uniquement par les opérations de création; il est retourné au lieu du code d'erreur NotAuthorizedOrNotFound plus général. |
Non. |
| 412 | NoEtagMatch
|
L'élément ETag indiqué dans la demande ne correspond pas à celui de la ressource. | Non. |
| 413 | PayloadTooLarge
|
L'entité de la demande est supérieure aux limites définies par le serveur. | Non. |
| 422 | UnprocessableEntity
|
Les données utiles sont syntaxiquement correctes, mais sémantiquement non valides. | Non. |
| 429 | TooManyRequests
|
Vous avez émis trop de demandes aux API Oracle Cloud Infrastructure dans un délai trop court. | Oui, avec délai d'attente. |
| 431 | RequestHeaderFieldsTooLarge
|
Les en-têtes HTTP de la demande sont trop longs. La demande pourra être resoumise après réduction de la taille des en-têtes de demande. | Non. |
| 500 | InternalServerError
|
Une erreur interne de serveur s'est produite. | Oui, avec délai d'attente. |
| 501 | MethodNotImplemented
|
La cible de la demande HTTP ne reconnaît pas la méthode HTTP. | Non. |
| 503 | ExternalServerUnreachable
|
Une connexion à un système externe, nécessaire pour exécuter la demande, n'a pas pu être établie. | Oui, avec délai d'attente. |
| 503 | ExternalServerTimeout
|
Une connexion à un système externe, nécessaire pour exécuter la demande, a expiré avant la réception d'une réponse. | Oui, avec délai d'attente. |
| 503 | ExternalServerInvalidResponse
|
Une connexion à un système externe, nécessaire pour exécuter la demande, a entraîné une réponse inacceptable. | Oui, avec délai d'attente. |
| 503 | ServiceUnavailable
|
Le service n'est pas disponible actuellement. | Oui, avec délai d'attente. |
Détails et dépannage des erreurs d'API
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 400 de statut HTTP
InvalidParameter
Description
Une valeur de paramètre n'est pas valide ou a un format incorrect.
Dépannage
- Reportez-vous à la documentation relative aux API REST pour plus d'information sur l'opération, vérifiez si les paramètres de la demande contiennent des fautes de frappe ou des formats incorrects, puis corrigez la demande.
MissingParameter
Description
Un paramètre obligatoire est manquant
Dépannage
- Il manque un paramètre obligatoire dans la demande pour cette API. Reportez-vous à la documentation relative aux API REST pour plus d'information sur l'opération et corrigez la demande.
QuotaExceeded
Description
L'exécution de cette demande dépasse le quota défini par l'administrateur pour ce compartiment pour cette ressource.
Dépannage
- Le quota défini par l'administrateur pour ce compartiment pour cette ressource serait dépassé si cette demande était exécutée. Vérifiez le quota de la ressource et demandez une augmentation de celui-ci ou nettoyez les ressources inutilisées si nécessaire. Pour en savoir plus sur les quotas, voir Aperçu des quotas de compartiment.
LimitExceeded
Description
L'exécution de cette demande dépasse la limite définie par Oracle pour ce type de ressource.
Dépannage
La limite définie par Oracle pour cette location pour ce type de ressource serait dépassée si cette demande était exécutée. Vérifiez la limite au niveau de la location pour cette ressource et demandez une augmentation de la limite ou nettoyez les ressources non utilisées et renvoyez la demande. Pour en savoir plus sur vos limites de service OCI et sur la façon de demander une augmentation de limite, voir Limites de service.CannotParseRequest
Description
Le format de la demande n'est pas correct.
Dépannage
Pour la plupart des opérations qui utilisent un corps, la demande doit être au format JSON. Consultez la documentation relative aux API REST pour savoir si l'opération prend en charge le format JSON et, si tel est le cas, vérifiez que le format JSON utilisé dans le corps de la demande est valide.InvalidStorageTier
Description
La demande utilise un niveau de stockage non valide.
Dépannage
Le paramètre storageTier fourni est incorrect. Reportez-vous à la documentation relative aux API REST pour plus d'information sur l'opération et corrigez la demande.Codes d'erreur 401 de statut HTTP
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 du locataire, OCID de l'utilisateur, empreinte digitale et clé privée) sont fournies et correctes
- Vérifiez que
private_key_pathpointe vers votre clé privée et non vers la clé publique correspondante - Vérifiez que les paires de clés publiques/privées que vous utilisez ont un format correct
- Vérifiez que le compte d'utilisateur fait partie d'un groupe disposant des autorisations appropriées pour effectuer les actions du plan que vous exécutez
- Vérifiez que votre location a été abonnée à la région que vous ciblez dans votre plan
- Vérifiez que la clé publique correspondant à l'empreinte digitale a été chargée pour l'utilisateur au nom duquel vous effectuez la demande. Pour plus d'informations, voir Clés et OCID requis.
- Variation de l'horloge. Ce code de statut est retourné si l'horloge du client présente une variation de plus de cinq (5) minutes par rapport à l'horloge du serveur. Pour plus d'informations, voir Variation d'horloge maximale autorisée pour le client.
- Erreur de signature de demande d'API. Ce code de statut est retourné si une information requise est manquante ou si son format est incorrect dans l'en-tête d'autorisation. Pour plus d'informations, voir Signatures des demandes.
Codes d'erreur 403 de statut HTTP
SignUpRequired
Description
Cette opération requiert une option d'inclusion avant d'être appelée.
Dépannage
Assurez-vous que l'utilisateur s'est inscrit à cette fonction. Si tel n'est pas le cas, communiquez avec le soutien technique et inscrivez-vous pour ce service.NotAllowed
Description
Cette opération doit être dirigée vers la région principale.
Dépannage
Cette opération doit être dirigée vers la région principale. Mettez à jour le code source pour fournir les informations correctes sur la région.NotAuthorized
Description
Vous n'êtes pas autorisé à mettre à jour un ou plusieurs des champs inclus dans cette demande.
Dépannage
Vérifiez la demande et supprimez les champs non autorisés. Pour en savoir plus sur les autorisations, voir Informations de référence sur les politiques.Codes d'erreur 404 de statut HTTP
NamespaceNotFound
Description
Une ressource indiquée au moyen de l'URI (chemin ou paramètres d'interrogation) 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, pour une ressource spécifiée au moyen de l'URI de la demande pour les opérations GET (liste ou entité unique), UPDATE et DELETE. Vérifiez que la ressource demandée existe et que vous y avez accès. Pour en savoir plus sur les autorisations, voir Informations de référence sur les politiques.NotFound
Description
Aucune opération n'est prise en charge pour le chemin d'URI et la méthode HTTP que vous avez indiqués dans la demande.
Dépannage
Les composants du chemin statique n'existent pas ou vous n'êtes pas autorisé à y accéder. Vérifiez la demande et mettez à jour les composants du chemin statique.NotAuthorizedOrNotFound
Description
Une ressource indiquée au moyen de l'URI (chemin ou paramètres d'interrogation) 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, pour une ressource spécifiée au moyen de l'URI de la demande pour les opérations GET (liste ou entité unique), UPDATE et DELETE. Vérifiez que la ressource demandée existe et que vous y avez accès. Pour en savoir plus sur les autorisations, voir Informations de référence sur les politiques.InvalidParameter
Description
Un paramètre spécifié dans le chemin n'est pas valide ou il est syntaxiquement valide, mais il n'est pas autorisé.
Dépannage
Vérifiez si les paramètres de la demande contiennent des fautes de frappe ou des formats incorrects. Reportez-vous à la documentation relative aux API REST pour plus d'information sur l'opération et corrigez la demande.Codes d'erreur 405 de statut HTTP
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 spécifiée correctement et consultez la documentation relative aux API REST pour vérifier que vous utilisez la méthode HTTP correcte pour l'opération.Codes d'erreur 409 de statut HTTP
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 retourné uniquement par les opérations de création; il est retourné au lieu du code d'erreur NotAuthorizedOrNotFound plus général.
Dépannage
- Si la demande vise à créer une ressource, vérifiez que celle-ci n'existe pas déjà et que l'utilisateur appelant est autorisé à créer ce type de ressource dans ce compartiment.
- Vérifiez que l'utilisateur est membre d'un groupe disposant des autorisations nécessaires pour utiliser les ressources d'un compartiment. Pour en savoir plus sur les autorisations, voir Informations de référence sur les politiques.
InvalidatedRetryToken
Description
Le jeton de nouvelle tentative fourni était utilisé dans une demande antérieure qui a entraîné une mise à jour du système, mais une opération ultérieure a invalidé le jeton. Cela peut se produire dans les cas où une entité créée avec le même jeton a depuis été supprimée. Si la modification d'état du système associée à cette demande doit être réexécutée, 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 et a expiré, a retourné une réponse non valide ou est inaccessible.
Dépannage
Essayez ce qui 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.
- Consultez les journaux d'erreurs de votre serveur pour obtenir des informations utiles.
- Votre serveur a peut-être rencontré un problème temporaire. Patientez quelques instants, puis réessayez la demande.
- Si la demande continue d'échouer, communiquez avec le soutien technique OCI et indiquez 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 courant, mais après un certain délai, l'état sera correct.
Dépannage
Essayez ce qui suit :
- Vérifiez les dépendances de la ressource. Une ressource ne peut pas être supprimée si elle est toujours utilisée par d'autres ressources.
- Renouvelez la demande plus tard ou mettez à jour le code pour attendre que l'état approprié soit atteint avant d'effectuer cette action. Certaines opérations nécessitent que la ressource soit 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 courant. Cet état n'est pas transitoire.
Dépannage
Vérifiez l'état de la ressource demandée 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 active, ou parce que la modification de la ressource entraînera l'arrêt du fonctionnement d'une autre ressource.
Dépannage
Vérifiez la ressource pour plus de détails sur le verrouillage. Vous pouvez appeler une API pour supprimer le verrouillage de la ressource, ou vous pouvez transmettre un paramètre à l'API pour ignorer le verrouillage 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 parents 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 indiquent une ressource associée dans laquelle vous devez supprimer la ressource associée afin de supprimer le verrouillage de cette ressource.
Codes d'erreur 412 de statut HTTP
NoEtagMatch
Description
L'élément ETag indiqué dans le champ if-match de la demande ne correspond pas à celui de la ressource.
Dépannage
Corrigez l'élément ETag dans la demande si ce comportement n'est pas attendu. Pour plus d'informations sur les éléments ETag, voir la documentation sur Etag.
Codes d'erreur 413 de statut HTTP
PayloadTooLarge
Description
L'entité de la demande est supérieure aux limites définies par le serveur.
Dépannage
Essayez d'envoyer une demande plus petite.
Codes d'erreur 422 de statut HTTP
UnprocessableEntity
Description
Les données utiles sont syntaxiquement correctes, mais sémantiquement non valides.
Dépannage
Le service ne peut pas traiter la demande. Vérifiez la demande et reformatez-la, si nécessaire.
Codes d'erreur 429 de statut HTTP
TooManyRequests
Description
Vous avez envoyé trop de demandes aux API Oracle Cloud Infrastructure trop rapidement.
Dépannage
Cela est dû à l'envoi d'un trop grand nombre de demandes en peu de temps. Si le service dispose de mécanismes de limitation et que trop de demandes sont envoyées dans un laps de temps réduit, certaines demandes sont rejetées. Essayez de respecter un certain délai entre les demandes pour éviter cette erreur.
Codes d'erreur 431 de statut HTTP
RequestHeaderFieldsTooLarge
Description
Les en-têtes HTTP de la demande sont trop longs.
Dépannage
La demande pourra être resoumise après réduction de la taille des en-têtes de demande.
Codes d'erreur 500 de statut HTTP
InternalServerError
Description
Une erreur interne de serveur s'est produite.
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 lié au service, probablement une indisponibilité temporaire ou un bogue. Réessayez d'envoyer la même demande. Si la nouvelle tentative échoue, communiquez avec le soutien technique OCI et indiquez la valeur opc-request-id de la demande ou de la réponse HTTP qui a échoué dans votre message.
Codes d'erreur 501 de statut HTTP
MethodNotImplemented
Description
La cible de la demande HTTP ne reconnaît pas la méthode HTTP.
Dépannage
La méthode HTTP de la demande n'est pas mise en oeuvre dans le service. Consultez la documentation relative aux API REST pour plus d'informations sur l'opération et mettez à jour la demande afin d'utiliser la méthode HTTP appropriée pour l'opération.