Configurar un documento de índice - Amazon Simple Storage Service
Documento de índice y carpetasConfiguración de un documento de índice

Configurar un documento de índice

Cuando habilita el alojamiento de sitios web, también debe configurar y cargar un documento de índice. Un documento de índice es una página web que devuelve Amazon S3 cuando se realiza una solicitud a la raíz de un sitio web o cualquier subcarpeta. Por ejemplo, si un usuario introduce http://www.example.com en el navegador, el usuario no solicita ninguna página específica. En ese caso, Amazon S3 ofrece el documento de índice, al que a veces se denomina la página predeterminada.

Cuando habilite el alojamiento de sitio web estático para su bucket, escriba el nombre del documento de índice (por ejemplo: index.html). Después de habilitar el alojamiento de sitio web estático para el bucket, cargue un archivo HTML con el nombre del documento de índice en el bucket.

La barra diagonal en el URL raíz es opcional. Por ejemplo, si configura el sitio web con index.html como documento de índice, las siguientes URL devuelven index.html.

http://example-bucket.s3-website.Region.amazonaws.com/
http://example-bucket.s3-website.Region.amazonaws.com

Para obtener más información acerca de los puntos de enlace de sitio web de Amazon S3, consulte Puntos de enlace de sitio web.

Documento de índice y carpetas

En Amazon S3, un bucket es un contenedor plano de objetos. No proporciona ninguna organización jerárquica como hace el sistema de archivos en su equipo. Sin embargo, puede crear una jerarquía lógica al usar los nombres de clave de objeto que implican una estructura de carpeta.

Por ejemplo, tomemos el caso de un bucket con tres objetos y los siguientes nombres de clave. Aunque están almacenados sin una organización jerárquica, puede inferir la siguiente estructura lógica de carpeta de los nombres de clave.

  • sample1.jpg El objeto es la raíz del bucket.

  • photos/2006/Jan/sample2.jpg El objeto se encuentra en la subcarpeta photos/2006/Jan.

  • photos/2006/Feb/sample3.jpg El objeto se encuentra en la subcarpeta photos/2006/Feb.

En la consola de Amazon S3, también puede crear una carpeta en un bucket. Por ejemplo, puede crear una carpeta denominada photos. Puede cargar objetos en el bucket o en la carpeta photos dentro del bucket. Si añade el objeto sample.jpg al bucket, el nombre de clave será sample.jpg. Si carga el objeto a la carpeta photos, el nombre de clave del objeto será photos/sample.jpg.

Si crea esa estructura de carpeta en el bucket, debe tener un documento de índice en cada nivel. En cada carpeta, el documento de índice debe tener el mismo nombre, por ejemplo, index.html. Cuando un usuario especifica un URL que es similar a la búsqueda de una carpeta, la presencia o ausencia de una barra diagonal determina el comportamiento del sitio web. Por ejemplo, el siguiente URL, con una barra diagonal, devuelve el documento de índice photos/index.html. 

http://bucket-name.s3-website.Region.amazonaws.com/photos/

Sin embargo, si excluye la barra diagonal del URL anterior, Amazon S3 primero buscará un objeto photos en el bucket. Si no encuentra el objeto photos, busca un documento de índice, photos/index.html. Se encuentra el documento, Amazon S3 devuelve un mensaje 302 Found e indica la clave photos/. Para las solicitudes posteriores a photos/, Amazon S3 devuelve photos/index.html. Si no encuentra el documento de índice, Amazon S3 devuelve un error.

Configuración de un documento de índice

Para configurar un documento de índice mediante la consola de S3, utilice el siguiente procedimiento. También puede configurar un documento de índice mediante la API de REST, los SDK de AWS, la AWS CLI o AWS CloudFormation.

nota

En un bucket habilitado para control de versiones, puede cargar varias copias de index.html, pero solo se resolverá la versión más reciente. Para obtener más información sobre el uso del control de versiones de S3, consulte Usar el control de versiones en buckets de S3.

Cuando habilite el alojamiento de sitio web estático para su bucket, escriba el nombre del documento de índice (por ejemplo: index.html). Después de habilitar el alojamiento de sitio web estático para el bucket, cargue un archivo HTML con el nombre de este documento de índice en el bucket.

Para configurar el documento de índice

  1. Cree un archivo index.html.

    Si no tiene un archivo index.html, puede usar el siguiente HTML para crear uno:

    <html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>My Website Home Page</title>
</head>
<body>
  <h1>Welcome to my website</h1>
  <p>Now hosted on Amazon S3!</p>
</body>
</html>

  2. Guarde el archivo de índice localmente.

    El nombre del archivo de documento de índice debe coincidir exactamente con el nombre del documento de índice que especifique en el cuadro de diálogo Static website hosting (Alojamiento de sitio web estático). El nombre del documento de índice distingue entre mayúsculas y minúsculas. Por ejemplo, si escribe index.html en el nombre del Index document (Documento de índice) en el cuadro de diálogo Static website hosting (Alojamiento de sitio web estático), el nombre del archivo de documento de índice también debe ser index.html y no Index.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 e introduzca el nombre exacto del documento de índice (por ejemplo: index.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 índice en el bucket, realice una de las siguientes acciones:

    • Arrastre y suelte el archivo de índice en 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.

  7. (Opcional) Cargue otros contenidos del sitio web en su bucket.

A continuación, debe establecer permisos para el acceso al sitio web. Para obtener información, consulte Configurar permisos para el acceso a sitios web.

También puede configurar opcionalmente un documento de error, un registro de tráfico web o una redirección.