Endpoints de site - Amazon Simple Storage Service

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.

  • s3-website dash (-) Regionhttp://bucket-name.s3-website-Region.amazonaws.com

  • s3-website ponto (.) Regiãohttp://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 de endpoints de site do Amazon S3, consulte Endpoints de site do Amazon S3.

Para que seus clientes acessem o conteúdo no endpoint de site, é necessário fazer com que seu conteúdo seja publicamente legível. Para fazer isso, edite as configurações de bloqueio de acesso público do S3 do bucket. Para obter mais informações, consulte Usar o bloqueio de acesso público do Amazon S3. Depois, use uma política de bucket ou uma lista de controle de acesso (ACL) em um objeto para conceder as permissões necessárias. Para obter mais informações, consulte Definir permissões para acesso ao site.

Importante

Os endpoints de site do Amazon S3 não são compatíveis com HTTPS. Para obter informações sobre o uso de HTTPS com um bucket do Amazon S3, consulte o seguinte:

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

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 CNAMEs.

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 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, consulte 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 de endpoints do Amazon S3, consulte Endpoints e cotas do Amazon S3 na AWS General Reference.