# Configurar um documento de índice
<a name="IndexDocumentSupport"></a>

Ao habilitar a hospedagem de sites, você também deve configurar e fazer upload de um documento de índice. Um *documento de índice* é uma página da Web que o Amazon S3 retorna quando uma solicitação é feita para a raiz de um site ou para qualquer subpasta. Por exemplo, se um usuário insere `http://www.example.com` no navegador, ele não está solicitando nenhuma página específica. Nesse caso, o Amazon S3 exibe o documento de índice, que às vezes é referido como a *página padrão*.

Quando você habilita a hospedagem de sites estáticos para seu bucket, insere o nome do documento de índice (por exemplo, `index.html`). Depois de habilitar a hospedagem de sites estáticos para seu bucket, faça upload de um arquivo HTML com o nome do documento de índice para o bucket. 

A barra no final do URL no nível raiz é opcional. Por exemplo, se você configurar seu site com `index.html` como o documento de índice, qualquer um dos URLs a seguir retornará `index.html`.

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

Para obter mais informações sobre endpoints de site do Amazon S3, consulte [Endpoints de site](WebsiteEndpoints.md).

## Pastas e documentos de índice
<a name="IndexDocumentsandFolders"></a>

No Amazon S3, um bucket é um contêiner de objetos simples. Ele não fornece nenhuma organização hierárquica, já que o sistema de arquivos em seu computador faz isso. No entanto, você pode criar uma hierarquia lógica usando nomes de chaves de objetos que envolvam uma estrutura de pastas. 

Por exemplo, considere um bucket com três objetos e que tenha os nomes de chaves a seguir. Embora esses objetos sejam armazenados sem uma organização hierárquica física, você pode pressupor a seguinte estrutura lógica de pastas com base nos nomes das chaves.
+ `sample1.jpg`: o objeto está na raiz do bucket.
+ `photos/2006/Jan/sample2.jpg`: o objeto está na subpasta `photos/2006/Jan`.
+ `photos/2006/Feb/sample3.jpg`: o objeto está na subpasta `photos/2006/Feb`. 

No console do Amazon S3, você também pode criar uma pasta em um bucket. Por exemplo, você pode criar uma pasta chamada `photos`. Você pode fazer upload de objetos no bucket ou na pasta `photos` no bucket. Se você adicionar o objeto `sample.jpg` ao bucket, o nome da chave será `sample.jpg`. Se você fizer upload do objeto na pasta `photos`, o nome da chave de objeto será `photos/sample.jpg`.

Se você criar um estrutura de pastas em seu bucket, deverá ter um documento de índice em cada nível. Em cada pasta, o documento de índice deve ter o mesmo nome, por exemplo, `index.html`. Quando um usuário especificar um URL que se assemelhe a uma consulta de pasta, a presença ou a ausência de uma barra no final determinará o comportamento do site. Por exemplo, o URL a seguir, com uma barra no final, retorna o documento de índice `photos/index.html`. 

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

Contudo, se você excluir a barra no final do URL anterior, o Amazon S3 procurará primeiro um objeto `photos` no bucket. Se o objeto `photos` não for encontrado, ele procurará um documento de índice, `photos/index.html`. Se esse documento for encontrado, o Amazon S3 retornará uma mensagem `302 Found` e apontará para a chave `photos/`. Para solicitações subsequentes a `photos/`, o Amazon S3 retorna `photos/index.html`. Se o documento de índice não for encontrado, o Amazon S3 retornará um erro.

## Configurar um documento de índice
<a name="configuring-index-document"></a>

Para configurar um documento de índice usando o console do S3, use o procedimento a seguir. Você também pode configurar um documento de índice usando a API REST, os AWS SDKs, a AWS CLI ou o CloudFormation. 

**nota**  
Em um bucket com versionamento habilitado, é possível carregar várias cópias do `index.html`, mas somente a versão mais recente será resolvida. Para obter mais informações sobre como usar o versionamento do S3, consulte [Reter várias versões de objetos com o Versionamento do S3](Versioning.md).

Quando você habilita a hospedagem de sites estáticos para seu bucket, insere o nome do documento de índice (por exemplo, **index.html**). Depois de habilitar a hospedagem de sites estáticos para seu bucket, faça upload de um arquivo HTML com esse nome de documento de índice para o bucket.

**Como configurar o documento de índice**

1. Criar um arquivo `index.html`

   Se você não tiver um arquivo `index.html`, poderá usar o HTML a seguir para criar um:

   ```
   <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>
   ```

1. Salve o arquivo de índice localmente.

   O nome do documento de índice deve corresponder exatamente ao nome do documento de índice que você inseriu na caixa de diálogo **Hospedagem de site estático**. O nome do documento de índice diferencia maiúsculas de minúsculas. Por exemplo, se você inserir `index.html` no nome do **Documentos de índice** na caixa de diálogo **Hospedagem de site estático**, o nome do arquivo do documento de índice também deverá ser `index.html` e não `Index.html`.

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. No painel de navegação à esquerda, escolha **Buckets de uso geral**.

1. Na lista de buckets, escolha o nome do bucket que você deseja usar para hospedar um site estático.

1. Habilite a hospedagem de sites estáticos para seu bucket e insira o nome exato do documento de índice (por exemplo, `index.html`). Para obter mais informações, consulte [Habilitar a hospedagem de sites](EnableWebsiteHosting.md).

   Depois de habilitar a hospedagem estática do site, vá para a etapa 6. 

1. Para fazer upload do documento de índice para o bucket, siga um destes procedimentos:
   + Arraste e solte o arquivo de índice na listagem de buckets do console.
   + Escolha **Upload (Fazer upload)** e siga as instruções para escolher e fazer upload do arquivo de índice.

   Para obter instruções detalhadas, consulte [Fazer upload de objetos](upload-objects.md).

1. (Opcional) Faça upload do conteúdo de outro site para o seu bucket.

Depois, é necessário definir permissões para acesso ao site. Para mais informações, consulte [Configuração de permissões para acesso ao site](WebsiteAccessPermissionsReqd.md). 

Também é possível configurar um [documento de erro](CustomErrorDocSupport.md), o [registro em log do tráfego da web](LoggingWebsiteTraffic.md) ou um [redirecionamento](how-to-page-redirect.md).