HeadObject

Documentación: HeadObject

Descripción

La operación HeadObject recupera los metadatos de un objeto sin recuperar el objeto en sí. Esta operación es útil para comprobar la existencia de un objeto, obtener su tamaño, tipo de contenido, y otra información antes de realizar una operación GET para recuperar el objeto completo.

Solicitud

Método: HEAD

URI:

  • Estilo virtual-host: https://{bucket-name}.s3.latam-scl-x.datageneral.cl/{object-key}

  • Estilo path: https://s3.latam-scl-x.datageneral.cl/{bucket-name}/{object-key}

Encabezados:

  • Host: Requerido. Especifica el nombre del bucket (para virtual-host) o el host del servicio (para path-style).

  • Date: Requerido. Fecha y hora de la solicitud.

  • Authorization: Requerido. Contiene la firma de la solicitud para la autenticación.

  • Range: Opcional. Recupera el rango de bytes especificado de un objeto.

  • If-Modified-Since: Opcional. Devuelve el objeto solo si ha sido modificado desde la fecha especificada.

  • If-Unmodified-Since: Opcional. Devuelve el objeto solo si no ha sido modificado desde la fecha especificada.

  • If-Match: Opcional. Devuelve el objeto solo si el ETag coincide con el ETag especificado.

  • If-None-Match: Opcional. Devuelve el objeto solo si el ETag no coincide con el ETag especificado.

  • x-amz-request-payer: Opcional. Si se establece en requester, indica que el solicitante pagará por la solicitud y la transferencia de datos.

  • x-amz-version-id: Opcional. Especifica una versión particular del objeto.

Cuerpo de la solicitud:

  • Vacío. No se requiere un cuerpo de solicitud para recuperar los metadatos de un objeto.

Respuesta

Códigos de estado:

  • 200 OK: La solicitud fue exitosa. Todos los metadatos del objeto se devuelven en los encabezados de la respuesta.

  • 206 Partial Content: La solicitud fue exitosa, pero solo se devolvió un rango de bytes del objeto.

  • 304 Not Modified: El objeto no ha sido modificado desde la fecha especificada en el encabezado If-Modified-Since.

  • 400 Bad Request: La solicitud no se pudo procesar debido a un error del cliente.

  • 403 Forbidden: El cliente no tiene permiso para acceder al objeto.

  • 404 Not Found: El objeto no existe.

  • 412 Precondition Failed: Una o más de las condiciones especificadas en los encabezados If-Modified-Since, If-Unmodified-Since, If-Match, o If-None-Match no se cumplieron.

  • 416 Requested Range Not Satisfiable: El rango especificado en el encabezado Range no es válido.

  • Otros códigos de error: Pueden aplicar códigos de error específicos del servicio S3.

Encabezados de la respuesta:

  • Date: Fecha y hora de la respuesta.

  • Content-Type: El tipo de contenido del objeto.

  • Content-Length: El tamaño del objeto en bytes.

  • ETag: El ETag del objeto.

  • Last-Modified: La fecha y hora en que se modificó por última vez el objeto.

  • Accept-Ranges: Indica que se aceptan solicitudes de rango para el objeto (bytes).

  • x-amz-version-id: La versión del objeto (si está habilitado el versionamiento).

  • x-amz-storage-class: La clase de almacenamiento del objeto.

  • x-amz-request-id: Un identificador único para la solicitud.

  • x-amz-id-2: Un identificador único extendido para la solicitud.

  • Server: Información sobre el servidor que procesó la solicitud.

  • Cualquier metadato definido por el usuario: Los metadatos definidos por el usuario se devuelven con el prefijo x-amz-meta-.

Cuerpo de la respuesta:

  • Vacío. No hay contenido en el cuerpo de la respuesta para una solicitud HEAD exitosa.

Ejemplos

Ejemplo de solicitud (sin encabezados opcionales):

HEAD /objeto1.txt HTTP/1.1
Host: my-bucket.s3.latam-scl-x.datageneral.cl
Date: Fri, 30 Jul 2024 20:00:00 GMT
Authorization: AWS AKIAIOSFODNN7EXAMPLE:QWxhZGVpbjEgXA==

Ejemplo de respuesta:

HTTP/1.1 200 OK
Date: Fri, 30 Jul 2024 20:00:01 GMT
Content-Type: text/plain
Content-Length: 1024
ETag: "xxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Last-Modified: Fri, 30 Jul 2024 19:00:00 GMT
Accept-Ranges: bytes
x-amz-request-id: 65423A7B884B82F1
Server: MyS3Server

Ejemplo de solicitud (con encabezado Range):

HEAD /objeto1.txt HTTP/1.1
Host: my-bucket.s3.latam-scl-x.datageneral.cl
Date: Fri, 30 Jul 2024 20:00:00 GMT
Authorization: AWS AKIAIOSFODNN7EXAMPLE:QWxhZGVpbjEgXA==
Range: bytes=0-1023

Ejemplo de respuesta:

HTTP/1.1 206 Partial Content
Date: Fri, 30 Jul 2024 20:00:01 GMT
Content-Type: text/plain
Content-Length: 1024
ETag: "xxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Last-Modified: Fri, 30 Jul 2024 19:00:00 GMT
Accept-Ranges: bytes
Content-Range: bytes 0-1023/1024
x-amz-request-id: 65423A7B884B82F1
Server: MyS3Server
AnteriorListObjectsV2SiguienteGetObject

Última actualización