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.

Exemple de référence pour les redirections et les réécritures

Cette section fournit des exemples de divers scénarios de redirection courants.

Vous pouvez utiliser ces exemples pour comprendre la syntaxe JSON permettant de créer vos propres redirections et réécritures dans l'éditeur JSON de la console Amplify.

Redirections et réécritures simples

Vous pouvez utiliser l'exemple suivant pour rediriger définitivement une page spécifique vers une nouvelle adresse.

Format JSON

[
  {
    "source": "/original.html", 
    "status": "301", 
    "target": "/destination.html", 
    "condition": null
  }
]

Vous pouvez utiliser l'exemple suivant pour rediriger n'importe quel chemin situé dans un dossier vers le même chemin dans un autre dossier.

Format JSON

[
  {
    "source": "/docs/<*>", 
    "status": "301", 
    "target": "/documents/<*>", 
    "condition": null
  }
]

Vous pouvez utiliser l'exemple suivant pour rediriger tout le trafic vers index.html sous forme de réécriture. Dans ce scénario, la réécriture permet d'indiquer à l'utilisateur qu'il a accédé à l'adresse d'origine.

Format JSON

[
  {
    "source": "/<*>", 
    "status": "200", 
    "target": "/index.html", 
    "condition": null
  }
]

Vous pouvez utiliser l'exemple suivant pour utiliser une réécriture afin de modifier le sous-domaine qui apparaît à l'utilisateur.

Format JSON

[
  {
    "source": "https://mydomain.com", 
    "status": "200", "target": "https://www.mydomain.com", 
    "condition": null
  }
]

Vous pouvez utiliser l'exemple suivant pour rediriger vers un autre domaine avec un préfixe de chemin.

Format JSON

[
  {
    "source": "https://mydomain.com",
    "status": "302",
    "target": "https://www.mydomain.com/documents/",
    "condition": null
  }
]

Vous pouvez utiliser l'exemple suivant pour rediriger les chemins d'un dossier introuvable vers une page 404 personnalisée.

Format JSON

[
  {
    "source": "/<*>",
    "status": "404",
    "target": "/404.html",
    "condition": null
  }
]

Redirections pour les applications Web à page unique (SPA)

La plupart des frameworks SPA prennent en charge HTML5 History.pushState () pour modifier l'emplacement du navigateur sans lancer de requête au serveur. Cela fonctionne pour les utilisateurs qui commencent leur transition à partir de la racine (ou /index.html), mais échoue pour les utilisateurs qui accèdent directement à une autre page.

L'exemple suivant utilise des expressions régulières pour configurer une réécriture 200 pour tous les fichiers dans index.html, à l'exception des extensions de fichier spécifiées dans l'expression régulière.

Format JSON

[
  {
    "source": "</^[^.]+$|\.(?!(css|gif|ico|jpg|js|png|txt|svg|woff|woff2|ttf|map|json|webp)$)([^.]+$)/>",
    "status": "200", 
    "target": "/index.html", 
    "condition": null
  }
]

Réécriture du proxy inversé

L'exemple suivant utilise une réécriture pour transférer du contenu provenant d'un autre emplacement afin que l'utilisateur sache que le domaine n'a pas changé. Le protocole HTTPS est le seul protocole pris en charge pour les proxys inverses.

Format JSON

[
  {
    "source": "/images/<*>", 
    "status": "200", 
    "target": "https://images.otherdomain.com/<*>", 
    "condition": null
  }
]

Trailing slashes and clean URLs

Pour créer des structures d'URL propres telles que about au lieu de about.html, des générateurs sur site statiques tels que Hugo génèrent des répertoires pour les pages avec un index.html (/about/index.html). Amplify crée automatiquement un nettoyage URLs en ajoutant une barre oblique lorsque cela est nécessaire. Le tableau ci-dessous présente différents scénarios :

Espaces réservés

Vous pouvez utiliser l'exemple suivant pour rediriger les chemins d'une structure de dossiers vers une structure correspondante dans un autre dossier.

Format JSON

[
  {
    "source":  "/docs/<year>/<month>/<date>/<itemid>", 
    "status": "301",
    "target": "/documents/<year>/<month>/<date>/<itemid>",
               "condition": null
   }
]

Chaînes de requête et paramètres de chemin

Vous pouvez utiliser l'exemple suivant pour rediriger un chemin vers un dossier dont le nom correspond à la valeur d'un élément de chaîne de requête figurant dans l'adresse d'origine :

Format JSON

[
  {
    "source": "/docs?id=<my-blog-id-value>", 
    "status": "301",
    "target": "/documents/<my-blog-id-value>", 
    "condition": null
  }
]

Vous pouvez utiliser l'exemple suivant pour rediriger tous les chemins introuvables à un niveau donné d'une structure de dossiers vers index.html dans un dossier spécifique.

Format JSON

[
  {
    "source": "/documents/<x>/<y>/<z>", 
    "status": "404", 
    "target": "/documents/index.html", 
    "condition": null
  }
]

Redirections basées sur les régions

Vous pouvez utiliser l'exemple suivant pour rediriger les demandes en fonction de la région.

Format JSON

[
  {
    "source": "/documents", 
    "status": "302", 
    "target": "/documents/us/", 
    "condition": "<US>"
  }
]

Utilisation d'expressions génériques dans les redirections et les réécritures

Vous pouvez utiliser l'expression générique<*>, dans l'adresse d'origine pour une redirection ou une réécriture. Vous devez placer l'expression à la fin de l'adresse d'origine et elle doit être unique. Amplify ignore les adresses d'origine qui incluent plusieurs expressions génériques ou les utilise à un emplacement différent.

Voici un exemple de redirection valide avec une expression générique.

Les deux exemples suivants illustrent des redirections non valides avec des expressions génériques.