Amazon Simple Storage Service
Guia do desenvolvedor (Versão da API 2006-03-01)

Endpoints de site

Quando você configura um bucket para hospedagem de sites, o site é disponibilizado pelo endpoint de site específico da região. Os endpoints de site são diferentes dos endpoints para onde você envia solicitações de API REST. Para obter mais informações sobre as diferenças entre os endpoints, consulte Principais diferenças entre o site da Amazon e o endpoint de API REST.

nota

Os endpoints de site do Amazon S3 não são compatíveis com HTTPS. Para obter informações sobre como usar HTTPS com um bucket do Amazon S3, consulte Como usar o CloudFront para atender a solicitações HTTPS para meu bucket do Amazon S3? e Solicitar HTTPS para comunicação entre o CloudFront e a origem do Amazon S3.

As duas formas gerais de um endpoint de site do Amazon S3 são:

bucket-name.s3-website-region.amazonaws.com
bucket-name.s3-website.region.amazonaws.com

A forma usada para o endpoint depende da região em que o bucket reside. Por exemplo, se o seu bucket chama example-bucket e reside na região Oeste dos EUA (Oregon), o site está disponível no seguinte endpoint de site do Amazon S3:

http://example-bucket.s3-website-us-west-2.amazonaws.com/

Ou, se o seu bucket chama example-bucket e reside na região UE (Frankfurt), o site está disponível no seguinte endpoint de site do Amazon S3:

http://example-bucket.s3-website.eu-central-1.amazonaws.com/

Para obter uma lista dos endpoints de site do Amazon S3 por região, consulte Endpoints de site do Amazon Simple Storage Service na Referência geral da AWS.

Para que seus clientes acessem o conteúdo no endpoint de site, você deve fazer com que seu conteúdo seja publicamente legível. Para fazer isso, você pode usar uma política de bucket ou uma ACL em um objeto para conceder as permissões necessárias.

nota

Os buckets de Pagamento pelo solicitante não permitem acesso pelo endpoint do site. Qualquer solicitação para tal bucket recebe uma resposta 403 Access Denied. Para obter mais informações, consulte Buckets de Pagamento pelo solicitante.

Se você tiver um domínio registrado, poderá adicionar uma entrada DNS CNAME para apontar para o endpoint de site do Amazon S3. Por exemplo, se você registrou o domínio www.example-bucket.com, pode criar um bucket www.example-bucket.com e adicionar um registro DNS CNAME que aponte para www.example-bucket.com.s3-website-<region>.amazonaws.com. Todas as solicitações a http://www.example-bucket.com são redirecionadas para www.example-bucket.com.s3-website-<region>.amazonaws.com. Para obter mais informações, consulte Hospedagem virtual de buckets.

Principais diferenças entre o site da Amazon e o endpoint de API REST

O endpoint de site é otimizado para acesso de um navegador da web. A tabela a seguir descreve as principais diferenças entre o endpoint de API REST da Amazon e o endpoint de site.

Principal diferença Endpoint de API REST Endpoint de site
Controle de acesso

Oferece suporte a conteúdo público e privado.

Oferece suporte apenas a conteúdo publicamente legível.
Manuseio de mensagens de erro

Retorna uma resposta de erro formatada em XML.

Retorna um documento HTML.
Suporte a redirecionamento

Não aplicável

Oferece suporte a redirecionamentos no nível do objeto e do bucket.
Solicitações com suporte

Oferece suporte a todas as operações de bucket e de objeto

Oferece suporte apenas a solicitações GET e HEAD em objetos.
Responde a solicitações GET e HEAD na raiz de um bucket Retorna uma lista de chaves de objeto no bucket. Retorna o documento de índice especificado na configuração de site.
Suporte a Secure Sockets Layer (SSL) Oferece suporte a conexões SSL. Não oferece suporte a conexões SSL.

Para obter uma lista dos endpoints do Amazon S3, consulte Endpoints de solicitações.