Fazer solicitações usando a API REST - Amazon Simple Storage Service

Fazer solicitações usando a API REST

Esta seção contém informações sobre como fazer solicitações para endpoints do Amazon S3 usando a API REST. Para obter uma lista de todos os endpoints da Amazon S3, consulte Regiões e endpoints na Referência geral da AWS.

Criar nomes de host do S3 para solicitações de API REST

Endpoints do Amazon S3 seguem a estrutura mostrada abaixo:

s3.Region.amazonaws.com

Os endpoints de pontos de acesso do Amazon S3 e endpoints de pilha dupla também seguem a estrutura padrão:

  • Pontos de acesso do Amazon S3s3-accesspoint.Region.amazonaws.com

  • Pilha duplas3.dualstack.Region.amazonaws.com

Para obter uma lista completa de regiões e endpoints do Amazon S3, consulte Amazon S3 endpoints and quotas (Endpoints e cotas do Amazon S3) na Amazon Web Services General Reference (Referência geral da Amazon Web Services).

Solicitações de estilo de hospedagem virtual e caminho

Ao fazer solicitações usando a API REST, use URIs no estilo de hospedagem virtual ou de caminho para os endpoints do Amazon S3. Para obter mais informações, consulte Hospedagem virtual de buckets.

exemplo Solicitação no estilo de hospedagem virtual

Veja a seguir um exemplo de uma solicitação de estilo de hospedagem virtual para excluir o arquivo puppy.jpg do bucket examplebucket na região Oeste dos EUA (Oregon). Para obter mais informações sobre solicitações de estilo hosted virtual, consulte Solicitações no estilo de hospedagem virtual.

DELETE /puppy.jpg HTTP/1.1 Host: examplebucket.s3.us-west-2.amazonaws.com Date: Mon, 11 Apr 2016 12:00:00 GMT x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT Authorization: authorization string

exemplo Solicitação no estilo de caminho

Veja a seguir um exemplo com a versão no estilo de caminho da mesma solicitação.

DELETE /examplebucket/puppy.jpg HTTP/1.1 Host: s3.us-west-2.amazonaws.com Date: Mon, 11 Apr 2016 12:00:00 GMT x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT Authorization: authorization string

Atualmente, o Amazon S3 é compatível com acesso virtual de estilo de hospedagem e de caminho em todas as regiões, mas isso mudará (consulte a nota Importante a seguir).

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

Importante

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

Fazer solicitações para endpoints de pilha dupla usando a API REST

Ao usar a API REST, acesse um endpoint de pilha dupla diretamente usando um nome de endpoint (URI) de hospedagem virtual ou de caminho. Todos os nomes de endpoint de pilha dupla do Amazon S3 incluem a região. Diferente dos endpoints somente-IPv4 padrão, os endpoints de hospedagem virtual e de caminho usam nomes de endpoint específicos para a região.

exemplo Solicitação de endpoint de pilha dupla do estilo de hospedagem virtual

Conforme mostrado no exemplo a seguir, use um endpoint no estilo de hospedagem virtual na solicitação REST que recupera o objeto do bucket chamado puppy.jpg do bucket examplebucket na região Oeste dos EUA (Oregon).

GET /puppy.jpg HTTP/1.1 Host: examplebucket.s3.dualstack.us-west-2.amazonaws.com Date: Mon, 11 Apr 2016 12:00:00 GMT x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT Authorization: authorization string

exemplo Solicitação de endpoint de pilha dupla no estilo de caminho

Ou use um endpoint no de estilo caminho na solicitação, conforme mostrado no exemplo a seguir.

GET /examplebucket/puppy.jpg HTTP/1.1 Host: s3.dualstack.us-west-2.amazonaws.com Date: Mon, 11 Apr 2016 12:00:00 GMT x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT Authorization: authorization string

Para obter mais informações sobre endpoints de pilha dupla, consulte Usar endpoints de pilha dupla do Amazon S3.

Para obter mais informações sobre como fazer solicitações usando a API REST, consulte os tópicos abaixo.