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)__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
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?
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.
Tópicos
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.
. Todas as solicitações a Region
.amazonaws.comhttp://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