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