Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Bonnes pratiques concernant les erreurs Amazon S3
Lors de la conception d'une application devant être utilisée avec Amazon S3, il est important de gérer les erreurs Amazon S3 de façon appropriée. Cette section décrit les erreurs à prendre en compte lors de la conception de votre application.
Relancer en cas d'erreur InternalErrors
Les erreurs internes sont des erreurs qui se produisent au sein de l'environnement Amazon S3.
Les demandes qui reçoivent une réponse InternalError n'ont probablement pas été traitées. A titre d'exemple, si une demande PUT renvoie une erreur de type InternalError, une commande GET ultérieure peut récupérer l'ancienne valeur ou la valeur mise à jour.
Si Amazon S3 renvoie une réponse InternalError, relancez la demande.
Optimiser l'application pour les erreurs répétées SlowDown
Comme avec tout système distribué, S3 a des mécanismes de protection qui détectent une surconsommation involontaire des ressources et réagissent en conséquence. Les erreurs SlowDown peuvent se produire quand un taux de demande élevé déclenche l'un de ces mécanismes. Réduire le taux de demande diminuera ou éliminera des erreurs de ce type. De manière générale, la plupart des utilisateurs ne rencontrent pas fréquemment ce type d'erreur. Néanmoins, si vous voulez plus d'informations ou si vous rencontrez des erreurs SlowDown importantes ou inattendues, signalez-les sur le forum des développeurs Amazon S3
Isoler les erreurs
Note
La prise en charge de SOAP sur HTTP est obsolète, mais SOAP continue d'être disponible sur HTTP. Les nouvelles fonctions Amazon S3 ne sont pas prises en charge pour SOAP. Plutôt que d'utiliser SOAP, nous vous recommandons d'utiliser l'API REST ou les kits SDK AWS.
Amazon S3 fournit un ensemble de codes d'erreur qui sont utilisés par les deux API SOAP et REST. L'API SOAP renvoie des codes d'erreur Amazon S3 standard. L'API REST est conçue pour fonctionner comme un serveur HTTP standard et interagir avec les clients HTTP existants (par exemple, les navigateurs, les bibliothèques client HTTP, les serveurs proxy, les mémoires cache, etc.). Pour s'assurer que les clients HTTP gèrent correctement les erreurs, nous lions chaque erreur Amazon S3 à un code de statut HTTP.
Les codes de statut HTTP sont moins parlants que les codes d'erreur Amazon S3 et contiennent moins d'informations sur l'erreur. Par exemple, les erreurs Amazon S3 NoSuchKey et NoSuchBucket sont toutes les deux liées au code de statut HTTP 404 Not
Found.
Même si les codes de statut HTTP contiennent moins d'informations sur l'erreur, les clients qui comprennent les codes HTTP, mais pas l'API Amazon S3, sont généralement à même de gérer l'erreur correctement.
Par conséquent, lors de la gestion d'erreurs ou du signalement des erreurs Amazon S3 aux utilisateurs finaux, utilisez le code d'erreur Amazon S3 à la place du code de statut HTTP, car il contient plus d'informations sur l'erreur. De même, lors du débogage de votre application, vous devrez également consulter l'élément lisible <Details> de la réponse d'erreur XML.
