Métodos de acesso a um bucket - Amazon Simple Storage Service

Métodos de acesso a um bucket

É possível acessar seu bucket usando o console do Amazon S3. Usando a interface do console, você pode executar quase todas as operações de bucket sem ter que gravar nenhum código.

Se você acessa um bucket de forma programática, o Amazon S3 oferece suporte à arquitetura RESTful na qual seus buckets e objetos são recursos, cada um com um URI de recurso que os identifica de maneira exclusiva.

O Amazon S3 é compatível com os URLs no estilo de hospedagem virtual e estilo de caminho para acessar um bucket. Como os buckets podem ser acessados usando URLs no estilo de hospedagem virtual e estilo de caminho, recomendamos criar buckets com nomes compatíveis com DNS. Para obter mais informações, consulte Restrições e limitações do bucket.

nota

As solicitações no estilo de caminho e estilo de hospedagem virtual usam a estrutura de endpoint S3 ponto Região (s3.Region), por exemplo, https://my-bucket.s3.us-west-2.amazonaws.com. No entanto, algumas regiões mais antigas do Amazon S3 também são compatíveis com endpoints S3 traço Região (s3-Region), por exemplo, https://my-bucket.s3-us-west-2.amazonaws.com. Se o bucket estiver em uma dessas regiões, você poderá ver endpoints s3-Region nos logs de acesso ao servidor ou nos logs do AWS CloudTrail. Recomendamos que você não use essa estrutura de endpoint em suas solicitações.

Acesso no estilo de hospedagem virtual

Em uma solicitação no estilo de hospedagem virtual, o nome do bucket faz parte do nome do domínio no URL.

Os URLs no estilo de hospedagem virtual do Amazon S3 usam o seguinte formato:

https://bucket-name.s3.region-code.amazonaws.com/key-name

Neste exemplo, DOC-EXAMPLE-BUCKET1 é o nome do bucket, Oeste dos EUA (Oregon) é a região, e puppy.png é o nome da chave.

https://DOC-EXAMPLE-BUCKET1.s3.us-west-2.amazonaws.com/puppy.png

Para obter mais informações sobre acesso no estilo de hospedagem virtual, consulte Solicitações no estilo de hospedagem virtual.

Acesso ao estilo de caminho

No Amazon S3, os URLs no estilo de caminho usam o seguinte formato:

https://s3.region-code.amazonaws.com/bucket-name/key-name

Por exemplo, se você criar um bucket chamado DOC-EXAMPLE-BUCKET1 na região Oeste dos EUA (Oregon) e quiser acessar o objeto puppy.jpg nele, use o seguinte URL no estilo de caminho:

https://s3.us-west-2.amazonaws.com/DOC-EXAMPLE-BUCKET1/puppy.jpg

Para obter mais informações, consulte Solicitações no estilo de caminho.

Importante

Atualização (23 de setembro de 2020): para garantir que os clientes tenham o tempo necessário para fazer a transição para URLs no estilo de hospedagem virtual, decidimos postergar a desativação de URLs no estilo de caminho. Para obter mais informações, consulte Amazon S3 Path Deprecation Plan – The Rest of the Story no Blog de notícias da AWS.

Acessar um bucket do S3 por IPv6

O Amazon S3 tem um conjunto de endpoints de pilha dupla, que são compatíveis com solicitações para buckets do S3 por Internet Protocol versão 6 (IPv6) e por IPv4. Para obter mais informações, consulte Fazer solicitações por meio do IPv6.

Acessar um bucket por meio de pontos de acesso do S3

Além de acessar um bucket diretamente, você pode fazer isso por meio de um ponto de acesso. Para obter mais informações sobre o recurso pontos de acesso do S3, consulte Gerenciamento de acesso a dados com pontos de acesso do Amazon S3.

Os pontos de acesso do S3 oferecem suporte apenas ao endereçamento em estilo de host virtual. Para endereçar um bucket por meio de um ponto de acesso, use o formato a seguir.

https://AccessPointName-AccountId.s3-accesspoint.region.amazonaws.com.
nota
  • Se o nome do ponto de acesso incluir caracteres de traço (-), inclua os traços no URL e insira outro traço antes do ID da conta. Por exemplo, para usar um ponto de acesso chamado finance-docs, de propriedade da conta 123456789012 na Região us-west-2, o URL apropriado seria https://finance-docs-123456789012.s3-accesspoint.us-west-2.amazonaws.com.

  • Os pontos de acesso do S3 não suportam acesso por HTTP, apenas acesso seguro por HTTPS.

Acessar um bucket usando S3://

Alguns serviços da AWS exigem a especificação de um bucket do Amazon S3 usando S3://bucket. O exemplo a seguir mostra o formato correto. Lembre-se de que, ao usar esse formato, o nome do bucket não inclui a Região da AWS.

S3://bucket-name/key-name

O exemplo a seguir usa o bucket de amostra descrito na seção de estilo de caminho anterior.

S3://mybucket/puppy.jpg