(Facultatif) Configuration d'un document d'erreur personnalisé - Amazon Simple Storage Service

Si nous fournissons une traduction de la version anglaise du guide, la version anglaise du guide aura préséance en cas de contradiction. La traduction sera une traduction automatique.

(Facultatif) Configuration d'un document d'erreur personnalisé

Après avoir configuré votre compartiment en tant que site web statique, lorsqu'une erreur se produit, Amazon S3 renvoie un document d'erreur HTML. Vous pouvez éventuellement configurer votre compartiment avec un document d'erreur personnalisé afin que Amazon S3 renvoie ce document en cas d'erreur.

Note

Certains navigateurs affichent leur propre message d'erreur lorsqu'une erreur se produit, sans tenir compte du document d'erreur renvoyé par Amazon S3. Par exemple, lorsqu’un HTTP 404 Not Found se produit, Google Chrome peut ignorer le document d’erreur qui Amazon S3 renvoie et affiche sa propre erreur.

Codes de réponse HTTP Amazon S3

Le tableau suivant répertorie le sous-ensemble des codes de réponse HTTP qu'Amazon S3 renvoie quand une erreur se produit.

Code d'erreur HTTP Description :
301 – Déplacé de façon permanente Lorsqu'un utilisateur envoie une demande directement au point de terminaison du site web Amazon S3 (http://s3-website.Region.amazonaws.com/), Amazon S3 renvoie une réponse 301 – Déplacé de façon permanente et redirige les demandes vers https://aws.amazon.com/s3/.
302 – Trouvé

Quand Amazon S3 reçoit une demande pour une clé x, http://bucket-name.s3-website.Region.amazonaws.com/x, sans barre oblique de fin, il recherche d’abord l’objet avec le nom de clé x. Si l’objet est introuvable, Amazon S3 détermine que la demande concerne le sous-dossier x et redirige la demande en ajoutant une barre oblique à la fin, et renvoie 302 trouvés.

304 – Non modifié

Les utilisateurs Amazon S3 demandent des en-têtes If-Modified-Since, If-Unmodified-Since, If-Match et/ou If-None-Match pour déterminer si l'objet demandé est le même que la copie mise en cache détenue par le client. Si l'objet est le même, le point de terminaison de site web renvoie une réponse 304 – Non modifié.

400 – Demande incorrecte

Le point de terminaison de site web renvoie un code 400 – Demande incorrecte quand l'utilisateur tente d'accéder à un compartiment via le point de terminaison régional incorrect.

403 (Accès interdit)

Le point de terminaison de site web renvoie le code d'erreur 403 – Interdit quand la demande de l'utilisateur est traduite en objet qui n'est pas accessible en lecture au public. Le propriétaire de l'objet doit permettre l'accès à l'objet en lecture au public via la stratégie de compartiment ou une liste ACL.

404 (Introuvable)

Le point de terminaison de site web renvoie le code d'erreur 404 – Non trouvé pour les raisons suivantes :

  • Amazon S3 détermine que l'URL du site web fait référence à une clé d'objet qui n'existe pas.

  • Amazon S3 déduit que la demande concerne un document d'index qui n'existe pas.

  • Le compartiment spécifié dans l'URL n'existe pas.

  • Le compartiment spécifié dans l'URL existe, mais n'est pas configuré comme un site web.

Vous pouvez créer un document personnalisé qui sera renvoyé dans le cadre du code 404 – Non trouvé. Assurez-vous que le document est chargé dans le compartiment configuré comme un site web et que la configuration d'hébergement du site web est définie pour utiliser le document.

Pour savoir comment Amazon S3 interprète l'URL en tant que demande d'objet ou de document d'index, consultez Configuration d’un document d'index.

500 – Erreur service

Le point de terminaison de site web répond avec le code 500 – Erreur service quand une erreur interne du serveur se produit.

503 – Service non disponible

Le point de terminaison de site web renvoie le code d'erreur 503 – Service non disponible lorsqu'Amazon S3 détermine que vous devez réduire le débit des demandes.

Pour chacune de ces erreurs, Amazon S3 renvoie un message HTML prédéfini. Voici un exemple de message HTML renvoyé pour une réponse 403 – Accès interdit.


						Exemple de message d'erreur 403 – Accès interdit

Configuration d'un document d'erreur personnalisé

Lorsque vous configurez votre compartiment en tant que site web statique, vous pouvez éventuellement fournir un document d'erreur personnalisé contenant un message d'erreur convivial et une aide supplémentaire. Amazon S3 renvoie votre document d'erreur personnalisé uniquement pour la classe HTTP 4XX de codes d'erreur.

Pour configurer un document d'erreur personnalisé

  1. Connectez-vous à AWS Management Console et ouvrez la console Amazon S3 à l'adresse https://console.aws.amazon.com/s3/.

  2. Dans la liste Compartiments, choisissez le nom de votre compartiment.

  3. Sélectionnez Propriétés.

  4. Choisissez Hébergement de site Web statique.

    Si votre compartiment est déjà configuré en tant que site web statique, vous pouvez appliquer l'étape suivante pour mettre à jour ou ajouter des informations sur le document d'erreur. Si vous n'avez pas configuré votre compartiment en tant que site web statique, vous devez d'abord réaliser la configuration requise. Pour plus d'informations, consultez Activation de l'hébergement de site Web,

  5. Dans le cadre Error document (Document d'erreur), saisissez le nom de votre document d'erreur.

  6. Choisissez Enregistrer

Pour plus d'informations sur l'utilisation de l’API REST pour configurer votre compartiment en tant que site web statique avec un document d'erreur personnalisé, consultez PutBucketWebsite dans le Amazon Simple Storage Service API Reference.