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.

# Configuration d’un document d’erreur personnalisé
<a name="CustomErrorDocSupport"></a>

Une fois que vous avez 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. A titre d’exemple, lorsqu’une erreur HTTP 404 Not Found se produit, Google Chrome peut afficher son propre message d’erreur, sans tenir compte du document d’erreur renvoyé par Amazon S3.

**Topics**
+ [

## Codes de réponse HTTP Amazon S3
](#s3-http-error-codes)
+ [

## Configuration d'un document d'erreur personnalisé
](#custom-error-document)

## Codes de réponse HTTP Amazon S3
<a name="s3-http-error-codes"></a>

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 Moved Permanently (Déplacé de façon permanente) et redirige ces 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 finale, il recherche d’abord l’objet portant le nom de clé `x`. Si l’objet est introuvable, Amazon S3 en conclut que la demande concerne le sous-dossier `x` et redirige la demande en ajoutant une barre oblique à la fin, puis renvoie le code **302 Found (Trouvé)**.   | 
| 304 – Non modifié |  Amazon S3 utilise des en-têtes de requête `If-Modified-Since`, `If-Unmodified-Since`, `If-Match` et/ou `If-None-Match` pour déterminer si l’objet demandé est identique à la copie mise en cache conservée 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 Forbidden |  Le point de terminaison de site web renvoie le code d’erreur **403 Forbidden** 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 politique de compartiment ou une liste ACL.   | 
| 404 – Non trouvé |  Le point de terminaison de site web renvoie le code d’erreur **404 – Non trouvé** pour les raisons suivantes : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonS3/latest/userguide/CustomErrorDocSupport.html) 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 plus d’informations sur la façon dont Amazon S3 interprète l’URL comme une demande pour un objet ou un document d’index, consultez [Configuration d’un document d’index](IndexDocumentSupport.md).   | 
| 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 du site web répond avec le code **503 Service Unavailable (Service non disponible)** quand 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 Forbidden**.

![\[Exemple de message d’erreur 403 Forbidden\]](http://docs.aws.amazon.com/fr_fr/AmazonS3/latest/userguide/images/WebsiteErrorExample403.png)


## Configuration d'un document d'erreur personnalisé
<a name="custom-error-document"></a>

Lorsque vous configurez votre compartiment en tant que site Web statique, vous pouvez fournir un document d’erreur personnalisé contenant un message d’erreur explicite et des conseils supplémentaires. Amazon S3 renvoie votre document d’erreur personnalisé uniquement pour la classe HTTP 4xx des codes d’erreur. 

Pour configurer un document d’erreur personnalisé à l’aide de la console S3, procédez comme suit. Vous pouvez également configurer un document d'erreur à l'aide de l'API REST AWS SDKs, du AWS CLI, du ou CloudFormation. Pour plus d’informations, consultez les ressources suivantes :
+ [PutBucketWebsite](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketWebsite.html)dans le manuel de *référence de l'API Amazon Simple Storage Service*
+ [AWS::S3::Bucket WebsiteConfiguration](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-websiteconfiguration.html) dans le *guide de l'utilisateur CloudFormation *
+ [put-bucket-website](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/put-bucket-website.html) dans la *référence de commande de l'AWS CLI *

Lorsque vous activez l’hébergement de site Web statique pour votre compartiment, vous entrez le nom du document d’erreur (par exemple, **404.html**). Après avoir activé l’hébergement de site web statique pour le compartiment, vous chargez un fichier HTML avec le nom du document d’erreur dans votre compartiment.

**Pour configurer un document d’erreur**

1. Créez un document d’erreur, par exemple `404.html`.

1. Enregistrez le fichier de document d’erreur au niveau local.

   Le nom du document d’erreur est sensible à la casse et doit correspondre exactement au nom que vous saisissez lorsque vous activez l’hébergement de site web statique. Par exemple, si vous entrez `404.html` pour le nom du **document d’Erreur** dans la boîte de dialogue **Hébergement de site Web statique**, le nom de fichier de votre document d’erreur doit également être `404.html`.

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

1. Dans le volet de navigation de gauche, choisissez **Compartiments à usage général**.

1. Dans la liste des compartiments, choisissez le nom du compartiment que vous souhaitez utiliser pour héberger un site Web statique.

1. Activez l’hébergement de site Web statique pour votre compartiment et entrez le nom exact de votre document d’erreur (par exemple, `404.html`). Pour plus d’informations, consultez [Activation de l’hébergement de sites web](EnableWebsiteHosting.md) et [Configuration d’un document d’erreur personnalisé](#CustomErrorDocSupport).

   Après l'activation de l'hébergement de site web statique, passez à l'étape 6. 

1. Pour charger le document d’erreur dans votre compartiment, effectuez l’une des opérations suivantes :
   + Faites glisser et déposez le fichier du document d’erreur dans la liste des compartiments de la console.
   + Choisissez **Upload (Charger)**, puis suivez les instructions pour choisir et charger le fichier d'index.

   Pour step-by-step obtenir des instructions, voir[Chargement d’objets](upload-objects.md).