search

HeadObject

hashtag
Documentación: HeadObject

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

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

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

hashtag
Ejemplos

Ejemplo de solicitud (sin encabezados opcionales):

Ejemplo de respuesta:

Ejemplo de solicitud (con encabezado Range):

Ejemplo de respuesta:

AnteriorListObjectsV2SiguienteGetObject

Última actualización