Endpoints de site

Quando você configura seu bucket como um site estático, o site fica disponível no endpoint de site específico da Região da AWS do bucket. 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 um endpoint de site e um endpoint de API REST.

Dependendo da Região, os endpoints de site do Amazon S3 seguem um destes dois formatos.

• Região s3-website dash ‐ http://bucket-name.s3-website-Region.amazonaws.com

• s3-website ponto (.) Região ‐ http://bucket-name.s3-website.Region.amazonaws.com

Esses URLs retornam o documento de indexação padrão configurado para o site. Para obter uma lista completa dos endpoints do site do Amazon S3, consulte Endpoints de site do Amazon S3.

nota

Para aumentar a segurança dos sites estáticos do Amazon S3, os domínios de endpoint do site do Amazon S3 (por exemplo, s3-website-us-east-1.amazonaws.com ou s3-website.ap-south-1.amazonaws.com) são registrados na Lista Pública de Sufixos (PSL). Para maior segurança, recomendamos que você use cookies com um prefiro __Host- caso precise definir cookies confidenciais no nome de domínio de sites estáticos do Amazon S3. Essa prática ajudará a defender seu domínio contra tentativas de falsificação de solicitação entre sites (CSRF). Para obter mais informações, consulte a página Set-Cookie na Mozilla Developer Network.

Se você quiser que seu site seja público, será necessário fazer com que seu conteúdo seja publicamente legível para que seus clientes possam acessá-lo no endpoint de site. Para ter mais informações, consulte Configuração de permissões para acesso ao site.

Importante

Os endpoints de site do Amazon S3 não oferecem suporte a HTTPS ou pontos de acesso. Se quiser usar HTTPS, você poderá usar o Amazon CloudFront para servir um site estático hospedado no Amazon S3. Para obter mais informações, consulte Como uso o CloudFront para atender a solicitações HTTPS para meu bucket do Amazon S3? Para usar HTTPS com um domínio personalizado, consulte Configuração de um site estático usando um domínio personalizado registrado no Route 53.

Os buckets de pagamento pelo solicitante não permitem acesso por um endpoint de site. Qualquer solicitação para tal bucket recebe uma resposta 403 Acesso negado. Para obter mais informações, consulte Configuração de buckets de Pagamento pelo solicitante para transferências de armazenamento e uso.

Exemplos de endpoint de site

Os exemplos a seguir mostram como você pode acessar um bucket do Amazon S3 configurado como um site estático.

exemplo - solicitação de um objeto no nível raiz

Para solicitar um objeto específico que é armazenado no nível raiz do bucket, use a seguinte estrutura de URL.

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

Por exemplo, o URL a seguir solicita o objeto photo.jpg que está armazenado no nível raiz do bucket.

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

exemplo - solicitação de um objeto em um prefixo

Para solicitar um objeto armazenado em uma pasta em seu bucket, use a seguinte estrutura de URL.

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

O URL a seguir solicita o objeto docs/doc1.html em seu bucket.

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

Adicionar um registro DNS CNAME

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 Personalizar URLs do Amazon S3 com registros CNAME.

Usar um domínio personalizado com o Route 53

Em vez de acessar o site usando um endpoint de site do Amazon S3, você pode usar seu próprio domínio registrado com Amazon Route 53 para veicular conteúdo, por exemplo, example.com. Você pode usar o Amazon S3 com o Route 53 para hospedar um site no domínio raiz. Por exemplo, se você tiver o domínio raiz example.com e quiser hospedar seu site no Amazon S3, os visitantes do site poderão acessá-lo no navegador digitando http://www.example.com ou http://example.com.

Para ver uma demonstração de exemplo, consult Tutorial: Configurar um site estático usando um domínio personalizado registrado no Route 53.

Principais diferenças entre um endpoint de site e um endpoint de API REST

Um endpoint de site do Amazon S3 é otimizado para acesso de um navegador da Web. A tabela a seguir resume as principais diferenças entre um endpoint de API REST e um 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 completa dos endpoints do Amazon S3, consulte Endpoints e cotas do Amazon S3 na .Referência geral da AWS