Descarga un objeto

Descarga un objeto.

Las solicitudes GET de los objetos pueden incluir un encabezado Range como se define en la RFC 1.1 HTTP para limitar el alcance de los datos que se muestran dentro del objeto, pero ten en cuenta que, en ciertas circunstancias, el 101}El encabezado de rango se ignora.

Los objetos que se almacenan en Cloud Storage en un estado comprimido pueden descomprimirse automáticamente como parte de una solicitud de descarga cuando se cumplen ciertos criterios. Este comportamiento de transcodificación elimina la necesidad de que un solicitante descomprima el objeto.

Las solicitudes también pueden incluir los encabezados If-Modified-Since o If-UnModified-Since, lo que provoca que la respuesta omita el cuerpo si el objeto no se modificó o se modificó desde la marca de tiempo especificada. Si el objeto no cumple con una condición de encabezado If- Modified-Since, la respuesta es 304 Not Modified y, si el objeto no cumple con una condición de encabezado If-UnModified-Since, la respuesta es {101. }412 Error en la condición previa.

Del mismo modo, las solicitudes pueden incluir los encabezados If-Match y If-None-Match con una ETag para la coincidencia. Si el objeto no coincide con una condición de encabezado If-Match, la respuesta es 412 Precondition Failed y, si el objeto coincide con el hash dado en un encabezado If-None-Match, la respuesta es 304 Not{101. }Modificado.

Consulta la guía Descarga objetos para obtener instrucciones sobre cómo descargar un objeto.

Parámetros de string de consulta

Parámetro Descripción Obligatorio
generation Puedes usarlo si quieres recuperar una versión de objeto específica. No

Consulta los parámetros de string de consulta de URL firmados para obtener información sobre los parámetros que incluyes cuando creas y usas URL firmadas.

Solicita encabezados

Además de los encabezados de solicitud comunes, se puede usar lo siguiente.

Header Descripción Obligatorio
If-Match Una etiqueta de entidad (ETag) Si el ETag que especificas es el mismo que el ETag para el objeto, entonces el objeto se descarga. No
If-Modified-Since Una fecha y hora. Si el objeto se modificó más adelante de la fecha y hora que especificas, se descargará el objeto. No
If-None-Match Una etiqueta de entidad (ETag) Si el ETag que especificas es diferente de la ETag para el objeto, este se descarga. No
If-Unmodified-Since Una fecha y hora. Si el objeto no se modificó más adelante de la fecha que especificas, se descargará el objeto. No
Range El rango de un objeto (en bytes) que deseas descargar.

Advertencia: Las sumas de verificación que se muestran cuando descargas datos de Cloud Storage cubren el contenido del objeto completo. Por lo tanto, si especificas un rango de solicitud, no hay forma de detectar la corrupción de datos solo para ese rango de bytes. Por lo tanto, recomendamos usar solicitudes de rango solo para reiniciar la descarga de un objeto completo después del último desplazamiento recibido, porque en ese caso puedes calcular y validar la suma de verificación cuando se completa la descarga.

No

Para descargar un objeto encriptado por una clave de encriptación proporcionada por el cliente, usa los encabezados que aparecen en la página de encriptación de tu solicitud.

Elementos de cuerpo de la solicitud

Esta solicitud no incluye un documento XML en el cuerpo de la solicitud.

Sintaxis de la solicitud

La siguiente sintaxis se aplica a las solicitudes de objetos GET que no usan el 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

Encabezados de respuesta

La solicitud puede mostrar una variedad de encabezados de respuesta según los encabezados de solicitud que uses, incluidos Cache-Control, Content-Length, Content-Type, Content-Disposition, ETag yLast-Modified.

Elementos del cuerpo de la respuesta

La respuesta contiene los datos del objeto.

Ejemplo

En el siguiente ejemplo se descarga un objeto llamado paris.jpg que se encuentra en un depósito llamado maps-travel.

Solicitud

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

Respuesta

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