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