Objeto HEAD

Enumera los metadatos de un objeto.

Si el objeto no existe, Cloud Storage muestra un código de estado 404 Not Found.

Parámetros de string de consulta

Parámetro Descripción Obligatorio
generation Puedes usarlo si quieres recuperar una generació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

Header Descripción Obligatorio
Authorization La string de autenticación para la solicitud.
Content-Length

La longitud del cuerpo de la solicitud sin encabezados (en bytes).

No
Date La fecha y la hora de la solicitud. No
Host El URI para Cloud Storage. Para obtener más información, consulta Solicita extremos.
If-Match Una etiqueta de entidad (ETag) Si el ETag que especificas es el mismo que el ETag para el objeto, se mostrarán los metadatos. No
If-Modified-Since Una fecha y hora. Si el objeto se modificó más tarde que la fecha y la hora especificadas, se mostrarán los metadatos. No
If-None-Match Una etiqueta de entidad (ETag) Si el ETag que especificas es diferente de la ETag para el objeto, se muestran los metadatos. No
If-Unmodified-Since Una fecha y hora. Si el objeto no se modificó después de la fecha que especificas, se muestran los metadatos. No
Range Rango (en bytes) que deseas mostrar. No
x-goog-if-generation-match Si la generación que especificas es la misma que la generación del objeto, se mostrarán los metadatos. No
x-goog-if-metageneration-match Si la metageneración que especificas es la misma que la metageneración del objeto, se mostrarán los metadatos. No
x-goog-user-project El proyecto al que se facturarán los cargos asociados con la solicitud. No

Elementos de cuerpo de la solicitud

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

Sintaxis de la solicitud

HEAD /OBJECT_NAME HTTP/1.1
Host: BUCKET_NAME.storage.googleapis.com
Date: DATE
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 no incluye un documento XML en el cuerpo de la respuesta. Las respuestas de error a las solicitudes HEAD tampoco contienen un cuerpo de respuesta.

Ejemplo

La siguiente muestra obtiene metadatos de un objeto llamado paris.jpg que está en un depósito llamado travel-maps.

Solicitud

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

Respuesta

...
expires: Wed, 30 May 2018 21:41:23 GMT
date: Wed, 30 May 2018 21:41:23 GMT
cache-control: private, max-age=0
last-modified: Wed, 30 May 2018 20:36:34 GMT
etag: "2218880ef78838266ecd7d4c1b742a0e"
x-goog-generation: 1486161811706000
x-goog-metageneration: 15
x-goog-stored-content-encoding: identity
x-goog-stored-content-length: 328
content-type: image/jpg
x-goog-hash: crc32c=HBrbzQ==
x-goog-hash: md5=OCydg52+pPG1Bwawjsl7DA==
x-goog-storage-class: STANDARD
accept-ranges: bytes
content-length: 328
...