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.

(Facultatif) Configuration de la redirection de pages web

Si votre compartiment Amazon S3 est configuré pour l'hébergement de site web statique, vous pouvez configurer des redirections pour votre compartiment ou les objets qu'il contient. Vous disposez des options suivantes pour configurer des redirections.

Rediriger les demandes pour le point de terminaison de site web de votre compartiment vers un autre compartiment ou domaine

Vous pouvez rediriger toutes les demandes d'un point de terminaison de site web pour un compartiment vers un autre compartiment ou domaine. Si vous redirigez toutes les demandes, chaque demande adressée au point de terminaison de site web est redirigée vers le compartiment ou le domaine spécifié.

Par exemple, si votre domaine racine est example.com, et que vous souhaitez gérer des demandes pour http://example.com et http://www.example.com, vous devez créer deux compartiments nommés example.com et www.example.com. Ensuite, gérez le contenu dans le compartiment example.com et configurez l'autre compartiment www.example.com de manière à rediriger toutes les demandes vers le compartiment example.com. Pour plus d’informations, consultez les informations relatives à la configuration d’un site Web statique à l’aide d’un nom de domaine personnalisé.

Configurer des règles de redirection pour utiliser des redirections conditionnelles avancées

Avec les règles de redirection avancées, vous pouvez acheminer des demandes de façon conditionnelle, en fonction de noms de clés d'objets spécifiques, de préfixes dans la demande ou de codes réponse. A titre d'exemple, supposez que vous supprimiez ou renommiez un objet dans votre compartiment. Vous pouvez ajouter une règle de routage qui redirige la demande vers un autre objet. Si vous souhaitez qu'un dossier ne soit plus accessible, vous pouvez ajouter une règle de routage pour rediriger la demande vers une autre page Web. Vous pouvez également ajouter une règle de routage pour gérer des conditions d'erreur en acheminant les demandes qui renvoient l'erreur vers un autre domaine, où celle-ci sera traitée.

Lorsque vous activez l'hébergement de site web statique pour votre compartiment, vous pouvez éventuellement spécifier des règles de redirection avancées. Amazon S3 impose une limitation de 50 règles de routage par configuration de site web. Si vous avez besoin de plus de 50 règles de routage, vous pouvez utiliser la redirection d'objet. Pour de plus amples informations, veuillez consulter Utilisation de la console S3.

Pour plus d'informations sur la configuration des règles de routage à l'aide du RESTAPI, consultez PutBucketWebsitele Amazon Simple Storage Service API Reference.

Éléments de règle de routage

Voici la syntaxe générale permettant de définir les règles de routage dans la configuration d'un site Web dans JSON et XML Pour configurer les règles de redirection dans la nouvelle console S3, vous devez utiliserJSON. Pour JSON des exemples, voirExemples de règles de redirection.

JSON

[
    {
      "Condition": {
        "HttpErrorCodeReturnedEquals": "string",
        "KeyPrefixEquals": "string"
      },
      "Redirect": {
        "HostName": "string",
        "HttpRedirectCode": "string",
        "Protocol": "http"|"https",
        "ReplaceKeyPrefixWith": "string",
        "ReplaceKeyWith": "string"
      }
    }
  ]
 
Note: Redirect must each have at least one child element. You can have either ReplaceKeyPrefix with or ReplaceKeyWith but not both.

XML

<RoutingRules> =
    <RoutingRules>
         <RoutingRule>...</RoutingRule>
         [<RoutingRule>...</RoutingRule>   
         ...]
    </RoutingRules>

<RoutingRule> =
   <RoutingRule>
      [ <Condition>...</Condition> ]
      <Redirect>...</Redirect>
   </RoutingRule>

<Condition> =
   <Condition> 
      [ <KeyPrefixEquals>...</KeyPrefixEquals> ]
      [ <HttpErrorCodeReturnedEquals>...</HttpErrorCodeReturnedEquals> ]
   </Condition>
    Note: <Condition> must have at least one child element.

<Redirect> =
   <Redirect> 
      [ <HostName>...</HostName> ]
      [ <Protocol>...</Protocol> ]
      [ <ReplaceKeyPrefixWith>...</ReplaceKeyPrefixWith>  ]
      [ <ReplaceKeyWith>...</ReplaceKeyWith> ]
      [ <HttpRedirectCode>...</HttpRedirectCode> ]
   </Redirect>

Note: <Redirect> must have at least one child element. You can have either ReplaceKeyPrefix with or ReplaceKeyWith but not both.

Le tableau suivant décrit les éléments de la règle de routage.

Exemples de règles de redirection

Les exemples suivants décrivent les tâches de redirection courantes :

Rediriger les demandes pour un objet

Vous pouvez rediriger les demandes d'un objet vers un autre objet ou URL en définissant l'emplacement de redirection du site Web dans les métadonnées de l'objet. Vous configurez la redirection en ajoutant la propriété x-amz-website-redirect-location aux métadonnées d'objet. Sur la console Amazon S3, vous définissez l'élément Website Redirect Location (Emplacement de redirection de site web) dans les métadonnées de l'objet. Si vous utilisez Amazon S3 API, vous définissezx-amz-website-redirect-location. Le site web interprète alors l'objet comme une redirection 301.

Pour rediriger une demande vers un autre objet, vous définissez l'emplacement de redirection vers la clé de l'objet cible. Pour rediriger une demande vers un site externeURL, vous devez définir l'emplacement de redirection URL comme vous le souhaitez. Pour plus d’informations sur les métadonnées d’objet, consultez Métadonnées d'objet définies par le système.

Quand vous définissez une redirection de page, vous pouvez garder ou supprimer le contenu de l'objet source. Par exemple, si vous avez un objet page1.html dans votre compartiment, vous pouvez rediriger toutes les demandes de cette page vers un autre objet, page2.html. Vous avez deux options :