Fazer o download de um objeto

Faz o download de um objeto.

As solicitações GET para objetos podem incluir um cabeçalho Range, conforme definido na RFC HTTP 1.1, para limitar o escopo dos dados retornados dentro do objeto, mas esteja ciente de queDeterminadas circunstâncias o cabeçalho do intervalo será ignorado.

Os objetos armazenados no Cloud Storage em um estado compactado podem ser descompactados automaticamente como parte de uma solicitação de download quando determinados critérios são atendidos. Esse comportamento de transcodificação elimina a necessidade de um solicitante de descompactar o objeto.

As solicitações também podem incluir cabeçalhos If-Modified-Since ou If-UnModified-Since, fazendo com que a resposta omita o corpo se o objeto não tiver sido modificado ou tenha sido modificado, desde um carimbo de data/hora especificado. Se o objeto não atender a uma condição de cabeçalho If- Modified-Since, a resposta será 304 Not Modified e, se o objeto não atender a uma condição de cabeçalho If-UnModified-Since, a resposta será {101 Falha ao pré-requisito }.

Da mesma forma, as solicitações podem incluir cabeçalhos If-Match e If-None-Match com uma ETag para fazer a correspondência. Se o objeto não corresponder a uma condição de cabeçalho If-Match, a resposta será 412 Precondition Failed, e se o objeto corresponder ao hash fornecido em um cabeçalho If-None-Match, a resposta será 304 Not{101 }Modificado.

Consulte o guia Como fazer o download de objetos para mais instruções sobre como fazer o download de um objeto.

Parâmetros de string de consulta

Parâmetro Descrição Obrigatório
generation Você poderá usá-lo se quiser buscar uma versão de objeto específica. Não

Consulte parâmetros de string de consulta de URL assinado para informações sobre os parâmetros incluídos ao criar e usar URLs assinados.

Cabeçalhos de solicitação

Além dos cabeçalhos de solicitação comuns, os itens a seguir podem ser usados.

Header Descrição Obrigatório
If-Match Uma tag de entidade (ETag). Se a ETag especificada for a mesma que a ETag para o objeto, o objeto será baixado. Não
If-Modified-Since Data e hora. Se o objeto tiver sido modificado após a data e a hora especificadas, o objeto será baixado. Não
If-None-Match Uma tag de entidade (ETag). Se a ETag especificada for diferente da ETag para o objeto, o objeto será baixado. Não
If-Unmodified-Since Data e hora. Se o objeto tiver sido modificado após a data especificada, o objeto será baixado. Não
Range O intervalo de um objeto (em bytes) que você deseja baixar.

Aviso: as somas de verificação retornadas ao fazer o download de dados do Cloud Storage abrangem o conteúdo completo do objeto. Assim, se você especificar um intervalo de solicitações, não será possível detectar a corrupção de dados apenas nesse intervalo de bytes. Portanto, recomendamos o uso de solicitações de intervalo apenas para reiniciar o download de um objeto completo após o último deslocamento recebido, porque nesse caso você pode calcular e validar a soma de verificação quando o download completo for concluído.

Não

Para fazer o download de um objeto criptografado por uma chave de criptografia fornecida pelo cliente, use os cabeçalhos listados na página "Criptografia" na solicitação.

Elementos do corpo da solicitação

Esta solicitação não inclui um documento XML no corpo da solicitação.

Sintaxe da solicitação

A sintaxe a seguir se aplica às solicitações GET Object que não usam o parâmetro de string de consulta acl.

GET /OBJECT_NAME HTTP/1.1
Host: BUCKET_NAME.storage.googleapis.com
Content-Length: 0
Authorization: AUTHENTICATION_STRING
Range: bytes=BYTE_RANGE
If-Match: ENTITY_TAG
If-Modified-Since: DATE
If-None-Match: ENTITY_TAG
If-Unmodified-Since: DATE

Cabeçalhos de resposta

A solicitação pode retornar diversos cabeçalhos de resposta, dependendo dos cabeçalhos de solicitação usados, incluindo: Cache-Control, Content-Length, Content-Type, Content-Disposition, ETag e Last-Modified.

Elementos do corpo da resposta

A resposta contém os dados do objeto.

Exemplo

No exemplo a seguir, é feito o download de um objeto chamado paris.jpg que está em um bucket chamado travel-maps.

Solicitação

GET /paris.jpg HTTP/1.1
Host: travel-maps.storage.googleapis.com
Content-Length: 0
Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg

Resposta

HTTP/1.1 200 OK
Content-Type: image/jpg
Last-Modified: Fri, 19 Feb 2010 22:13:49 GMT
ETag: "2281880ef78388266ecd7d4c1b472a0e"
Content-Length: 328
Date: Fri, 19 Feb 2010 22:13:49 GMT

328 bytes of data...