View a markdown version of this page

Cabeçalhos de resposta comuns - Amazon Simple Storage Service

Cabeçalhos de resposta comuns

A tabela a seguir descreve os cabeçalhos de resposta comuns à maioria das respostas do Amazon S3.

Name (Nome) Descrição
Access-Control-Allow-Credentials

Um booleano que determina se o servidor permite que as solicitações do CORS contenham credenciais. Se o cabeçalho da solicitação Access-Control-Allow-Origin estiver definido como '*', o cabeçalho da resposta Access-Control-Allow-Credentials será omitido; caso contrário, será definido como true quando a avaliação do CORS for bem-sucedida.

Tipo: booliano

Padrão: nenhum
Access-Control-Allow-Headers

Uma lista de cabeçalhos HTTP permitidos para suas solicitações do CORS. O cabeçalho da resposta Access-Control-Allow-Headers é retornado para avaliações bem-sucedidas do CORS e especifica explicitamente todos os Access-Control-Request-Headers permitidos.

Tipo: string

Padrão: nenhum
Access-Control-Allow-Methods

Uma lista que especifica quais métodos HTTP são permitidos. O Amazon S3 só permitirá solicitações do CORS de métodos de CORS permitidos quando a avaliação do CORS for bem-sucedida.

Tipo: string

Padrão: nenhum
Access-Control-Allow-Origin

A localização da origem permitida. O Amazon S3 só enviará o cabeçalho da resposta Access-Control-Allow-Origin quando a avaliação do CORS for bem-sucedida. Se a origem da solicitação corresponder a '*' nas origens permitidas da configuração do CORS, o '*' será retornado nesse cabeçalho de resposta em vez da origem original.

Tipo: string

Padrão: nenhum
Access-Control-Expose-Headers

Uma lista que permite que um servidor identifique um cabeçalho de resposta que expõe o acesso aos aplicativos quando a avaliação do CORS é bem-sucedida.

Tipo: string

Padrão: nenhum
Access-Control-Max-Age

O tempo em segundos que seu navegador pode armazenar em cache a resposta para uma solicitação preliminar do CORS conforme identificado pelo recurso, pelo método HTTP e pela origem. O cabeçalho da resposta Access-Control-Max-Age só é retornado quando a avaliação do CORS é bem-sucedida.

Tipo: inteiro

Padrão: nenhum
Vary

Uma lista que indica em quais cabeçalhos de solicitação o resultado da avaliação do CORS varia. O cabeçalho da resposta Vary só é retornado quando a avaliação do CORS é bem-sucedida.

Tipo: string

Padrão: nenhum
Content-Length

O comprimento em bytes do corpo da resposta.

Tipo: string

Padrão: nenhum
Content-Type

O tipo MIME do conteúdo. Por exemplo, Content-Type: text/html; charset=utf-8.

Tipo: string

Padrão: nenhum
Connection

Um valor que especifica se a conexão com o servidor está aberta ou fechada.

Tipo: Enum

Valores válidos: open | close

Padrão: nenhum
Date

A data e a hora em que o Amazon S3 respondeu; por exemplo, Quarta, 1º de março de 2006 12:00:00 GMT.

Tipo: string

Padrão: nenhum
ETag

Um ETag (identificador de entidade) representa uma versão específica do objeto. O ETag reflete as alterações apenas no conteúdo de um objeto, não em seus metadados. O ETag pode ou não ser um digest MD5 do objeto de dados. Tudo depende de como o objeto foi criado e de como está criptografado. Funciona assim:

  • Objetos criados por meio do Console de gerenciamento da AWS, pelo objeto PUT, POST Object, ou pela operação Copy:

    • Os objetos que são texto simples ou são criptografados no lado do servidor com chaves gerenciadas pelo Amazon S3 (SSE-S3) têm ETags que são um resumo MD5 dos dados.

    • Os objetos criptografados no lado do servidor com chaves fornecidas pelo cliente (SSE-C) ou chaves do AWS Key Management Service (AWS KMS) (SSE-KMS) têm ETags que não são um resumo MD5 dos dados do objeto.

  • Os objetos criados pela operação Multipart Upload ou Upload Part Copy têm ETags que não são resumos MD5, independentemente do método de criptografia.

Tipo: string
Server

O nome do servidor que criou a resposta.

Tipo: string

Padrão: AmazonS3

x-amz-delete-marker

Um valor que especifica se o objeto retornado foi (true) ou não (false) um marcador de exclusão.

Tipo: booliano

Valores válidos: true | false

Padrão: Falso
x-amz-id-2

Um token especial usado junto com o cabeçalho x-amz-request-id para ajudar a AWS a solucionar problemas. Para obter informações sobre o Suporte ao uso desses IDs de solicitação, consulte Solução de problemas do Amazon S3.

Tipo: string

Padrão: nenhum
x-amz-request-id

Um valor criado pelo Amazon S3 que identifica com exclusividade a solicitação. Esse valor é usado junto com o cabeçalho x-amz-id-2 para ajudar a AWS a solucionar problemas. Para obter informações sobre o Suporte ao uso desses IDs de solicitação, consulte Solução de problemas do Amazon S3.

Tipo: string

Padrão: nenhum
x-amz-server-side-encryption

O algoritmo de criptografia no lado do servidor usado para armazenar esse objeto no Amazon S3 (por exemplo, AES256, aws:kms).

Valores válidos: AES256 | aws:kms
x-amz-version-id

A versão do objeto. Quando você habilita o versionamento, o Amazon S3 gera um número aleatório para objetos adicionados a um bucket. O valor tem codificação UTF-8 e está pronto para URL. Quando você PUT um objeto em um bucket em que o versionamento foi suspenso, o ID da versão é sempre null.

Tipo: string

Valores válidos: null | qualquer string com codificação UTF-8 pronta para URL

Padrão: nulo