Configurar un documento de error personalizado - Amazon Simple Storage Service

Configurar un documento de error personalizado

Después de configurar el bucket como un sitio web estático, cuando se produce un error, Amazon S3 devuelve un documento de error HTML. Opcionalmente, puede configurar el bucket con un documento de error personalizado para que Amazon S3 devuelva dicho documento cuando se produzca un error.

nota

Algunos navegadores muestran su propio mensaje de error cuando se produce un error, y omiten el documento de error de Amazon S3. Por ejemplo, cuando se produce un error HTTP 404 Not Found (HTTP 404 No encontrado), Google Chrome puede omitir el documento de error de Amazon S3 y mostrar su propio error.

Códigos de respuesta HTTP de Amazon S3

En la siguiente tabla se muestra el subconjunto de los códigos de respuesta HTTP que Amazon S3 devuelve cuando ocurre un error.

Código de error HTTP Descripción
301 Moved Permanently (Desplazado permanentemente) Cuando un usuario envía una solicitud directamente a los puntos de enlace del sitio web de Amazon S3 (http://s3-website.Region.amazonaws.com/), Amazon S3 devuelve una respuesta 301 Moved Permanently (301 Trasladado de forma permanente) y redirecciona esas solicitudes a https://aws.amazon.com/s3/.
302 Found (Encontrado)

Cuando Amazon S3 recibe una solicitud para una clave x, http://bucket-name.s3-website.Region.amazonaws.com/x, sin la barra diagonal, primero busca el objeto con el nombre de clave x. Si no encuentra el objeto, Amazon S3 determina que la solicitud es para una subcarpeta x, redirecciona la solicitud, añade una barra al final y devuelve el código 302 Found (302 Encontrado).

304 Not Modified (No modificado)

Los usuarios de Amazon S3 solicitan encabezados If-Modified-Since, If-Unmodified-Since, If-Match o If-None-Match para determinar si el objeto solicitado es el mismo que la copia almacenada que conserva el cliente. Si el objeto es el mismo, el punto de enlace del sitio web devuelve una respuesta 304 Not Modified (No modificado).

400 Malformed Request (Solicitud con formato incorrecto)

El punto de enlace de sitio web devuelve una respuesta 400 Malformed Request (Solicitud con formato incorrecto) cuando un usuario intenta obtener acceso a un bucket con el punto de enlace regional incorrecto.

403: prohibido

El punto de enlace de sitio web devuelve una respuesta 403 Forbidden (Prohibido) cuando la solicitud de un usuario se traduce en un objeto que no se puede leer públicamente. El propietario del objeto debe permitir la lectura pública del objeto mediante una política de bucket o una ACL.

404 Not Found (No encontrado)

El punto de enlace de sitio web devuelve una respuesta 404 Not Found (No encontrado) por las razones siguientes:

  • Amazon S3 determina que el URL del sitio web hace referencia a una clave de objeto que no existe.

  • Amazon S3 infiere que la solicitud es para un documento de índice que no existe.

  • Un bucket especificado en el URL no existe.

  • Un bucket especificado en el URL existe pero no está configurado como sitio web.

Puede crear un documento personalizado que se devuelve para 404 Not Found (No encontrado). Asegúrese de que el documento esté cargado al bucket configurado como sitio web y que la configuración de alojamiento del sitio web utilice el documento.

Para obtener información acerca de cómo Amazon S3 interpreta un URL como una solicitud para un objeto o un documento de índice, consulte Configurar un documento de índice.

500 Service Error (Error de servicio)

El punto de enlace del sitio web devuelve una respuesta 500 Service Error (Error de servicio) cuando ocurre un error interno del servidor.

503 Service Unavailable

El punto de enlace del sitio web devuelve una respuesta 503 Service Unavailable (503 Servicio no disponible) cuando Amazon S3 determina que debe reducir la velocidad de solicitud.

Para cada uno de estos errores, Amazon S3 devuelve un mensaje HTML predefinido. A continuación, se muestra un ejemplo de un mensaje HTML devuelto para la respuesta 403 Forbidden (Prohibido).


					Ejemplo de mensaje de error 403 Forbidden (Prohibido)

Configurar un documento de error personalizado

Cuando configura el bucket como un sitio web estático, puede proporcionar un documento de error personalizado que contenga un mensaje de error sencillo y ayuda adicional. Amazon S3 devuelve el documento de error personalizado para las clase de códigos de error HTTP 4XX únicamente.

Para configurar un documento de error personalizado mediante la consola de S3, siga los pasos que se muestran a continuación. También puede configurar un documento de errores mediante la API de REST, los SDK de AWS, la AWS CLI o AWS CloudFormation. Para obtener más información, consulte los siguientes temas:

Cuando habilite el alojamiento de sitios webs estáticos para el bucket, escriba el nombre del documento de error (por ejemplo, 404.html). Después de habilitar el alojamiento de sitios web estáticos para el bucket, cargue un archivo HTML con el nombre de este documento de error en el bucket.

Para configurar un documento de error,

  1. Cree un documento de error, por ejemplo 404.html.

  2. Guarde el archivo de documento de error localmente.

    El nombre del documento de error distingue mayúsculas y minúsculas y debe coincidir exactamente con el nombre que escriba al habilitar el alojamiento de sitios web estáticos. Por ejemplo, si escribe 404.html en el nombre del Error document (Documento de error) en el cuadro de diálogo Static website hosting (Alojamiento de sitio web estático), el nombre del archivo del documento de error también debe ser 404.html.

  3. Inicie sesión en la AWS Management Console y abra la consola de Amazon S3 en https://console.aws.amazon.com/s3/.

  4. En la lista Buckets, elija el nombre del bucket que desea utilizar para alojar un sitio web estático.

  5. Habilite el alojamiento de sitios web estáticos para su bucket y escriba el nombre exacto del documento de error (por ejemplo, 404.html). Para obtener más información, consulte Habilitar el alojamiento de sitios web.

    Después de habilitar el alojamiento estático del sitio web, continúe con el paso 6.

  6. Para cargar el documento de error en el bucket, realice una de las siguientes acciones:

    • Arrastre y suelte el archivo del documento de error a la lista de buckets de la consola.

    • Elija Upload (Cargar) y siga las instrucciones para elegir y cargar el archivo de índice.

    Para obtener instrucciones paso a paso, consulte Carga de objetos.