Tous les produits
Search
Centre de documentation

CDN:Configurer des pages d'erreur personnalisées

Dernière mise à jour :Aug 18, 2026

Configurez Alibaba Cloud CDN pour qu'il renvoie une page d'erreur personnalisée lorsqu'un client demande un contenu inexistant ou qu'une erreur survient. Au lieu d'afficher un message d'erreur par défaut, un point de présence (POP) du réseau CDN diffuse la page que vous spécifiez, offrant ainsi une expérience utilisateur utile et conforme à votre image de marque.

Informations générales

Alibaba Cloud CDN vous permet de rediriger les utilisateurs vers une page d'erreur personnalisée lorsque le système renvoie un code d'état HTTP spécifique.

Lorsqu'un client demande une ressource inexistante sur votre service web, le serveur d'origine renvoie généralement une page d'erreur 404 par défaut. Pour améliorer l'expérience utilisateur, configurez une page d'erreur personnalisée en spécifiant l'URL de redirection associée à un code d'état de réponse HTTP ou HTTPS particulier.

Remarque

Si votre page d'erreur personnalisée utilise des ressources accélérées par Alibaba Cloud CDN, les frais standard de diffusion de contenu s'appliquent.

Codes d'état pris en charge

Vous ne pouvez configurer des pages d'erreur personnalisées que pour les codes d'état suivants : 400, 403, 404, 405, 414, 416, 500, 501, 502, 503 et 504.

Code d'état

Description

400

La requête contient une erreur de syntaxe.

403

Le serveur a compris la requête, mais refuse de l'autoriser.

404

Le serveur n'a pas trouvé la ressource demandée.

405

Le serveur reconnaît la méthode de requête, mais ne la prend pas en charge pour la ressource cible.

414

L'URL de la requête est trop longue pour que le serveur puisse la traiter.

416

Le serveur ne peut pas servir la plage demandée.

500

Le serveur a rencontré une condition inattendue qui l'a empêché de satisfaire la requête.

501

Le serveur ne prend pas en charge la fonctionnalité requise pour satisfaire la requête.

502

Le serveur, agissant en tant que passerelle ou proxy, a reçu une réponse non valide d'un serveur amont.

503

Le serveur est temporairement incapable de traiter la requête, souvent en raison d'une maintenance ou d'une surcharge.

504

Le serveur, agissant en tant que passerelle ou proxy, n'a pas reçu de réponse dans les délais impartis de la part d'un serveur amont.

Procédure

  1. Connectez-vous à la console CDN.

  2. Dans le volet de navigation de gauche, cliquez sur Domain Names.

  3. Sur la page Domain Names, localisez le nom de domaine cible et cliquez sur Manage dans la colonne Actions.

  4. Dans le volet de navigation du domaine, cliquez sur Cache.

  5. Cliquez sur l'onglet Custom Pages.

  6. Cliquez sur Customize pour configurer le code d'état et l'URL de la page d'erreur personnalisée.

    Par exemple, sélectionnez 404 pour le champ Error Code. Le champ Description se remplit automatiquement. Dans le champ Redirect Link, saisissez l'URL de votre page d'erreur personnalisée, par exemple http://example.aliyundoc.com/error404.html, puis cliquez sur OK.

  7. Cliquez sur OK pour enregistrer la configuration.

    Une fois la page d'erreur personnalisée configurée, vous retrouvez l'entrée dans la liste Custom Pages et pouvez cliquer sur Modify ou Delete pour la gérer.

Exemple de configuration

Pour afficher une page personnalisée en cas d'erreur 404, supposons que vous disposiez d'une page nommée error404.html dans le répertoire racine de votre serveur d'origine. Cette page est accessible via le nom de domaine accéléré example.aliyundoc.com. Configurez une page d'erreur personnalisée pour le code d'état 404 avec les paramètres suivants.

  • Error code : 404

  • Redirect link : L'URL de votre page personnalisée. Par exemple : http://example.aliyundoc.com/error404.html.

  • Result : Lorsqu'une requête client déclenche une erreur 404, l'utilisateur est redirigé vers http://example.aliyundoc.com/error404.html.

Référence API

Appelez BatchSetCdnDomainConfig pour configurer une page d'erreur personnalisée. Définissez functionName sur error_page.