Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Actualización más reciente 2024-09-18 GMT+08:00

Consulta de metadatos de objetos

Funciones

Los usuarios con el permiso de lectura en objetos pueden realizar la operación HeadObject para obtener metadatos de objetos. Los metadatos del objeto se incluyen en la respuesta.

Esta operación admite la encriptación del lado del servidor.

Control de versiones

De forma predeterminada, esta operación devuelve los metadatos más recientes de un objeto. Si el objeto tiene un marcador de borrado, se devuelve el código de estado 404. Para obtener los metadatos de objeto de una versión especificada, el parámetro versionId se puede utilizar para especificar la versión deseada.

Sintaxis de solicitud

1
2
3
HEAD /ObjectName HTTP/1.1 
Host: bucketname.obs.region.myhuaweicloud.com Date: date
Authorization: authorization

Parámetros de solicitud

Tabla 1 describe los parámetros de solicitud.

Tabla 1 Parámetros de solicitud

Parámetro

Descripción

Obligatorio

versionId

ID de versión del objeto

Tipo: string

No

Encabezados de solicitud

Esta solicitud utiliza encabezados comunes. Para obtener más información, consulte Tabla 3.

Además, la solicitud puede usar encabezados adicionales, como se muestra en Tabla 2.

Tabla 2 Encabezados de solicitud

Encabezado

Descripción

Obligatorio

Origin

Origen de la solicitud entre dominios especificada por la solicitud previa. En general, es un nombre de dominio.

Tipo: string

No

Access-Control-Request-Headers

Indica los encabezados HTTP de una solicitud. La solicitud puede utilizar varios encabezados HTTP.

Tipo: string

No

x-obs-server-side-encryption-customer-algorithm

Indica el algoritmo de descifrado cuando se utiliza SSE-C.

Tipo: string

Ejemplo: x-obs-server-side-encryption-customer-algorithm:AES256

Restricción: Este encabezado debe usarse junto con x-obs-server-side-encryption-customer-key y x-obs-server-side-encryption-customer-key-MD5.

No. Este encabezado se requiere cuando se utiliza SSE-C.

x-obs-server-side-encryption-customer-key

Indica la clave de descifrado cuando se utiliza SSE-C.

Tipo: string

Ejemplo: x-obs-server-side-encryption-customer-key:K7QkYpBkM5+hca27fsNkUnNVaobncnLht/rCB2o/9Cw=

Restricción: Este encabezado es una clave de 256 bits codificada en Base64 y debe usarse junto con x-obs-server-side-encryption-customer-algorithm y x-obs-server-side-encryption-customer-key-MD5.

No. Este encabezado se requiere cuando se utiliza SSE-C.

x-obs-server-side-encryption-customer-key-MD5

Indica el valor MD5 de la clave de descifrado cuando se utiliza SSE-C. El valor MD5 se utiliza para comprobar si se produce algún error durante la transmisión de la clave.

Tipo: string

Ejemplo: x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==

Restricción: Este encabezado es un valor MD5 de 128 bits codificado en Base64 y debe usarse junto con x-obs-server-side-encryption-customer-algorithm y x-obs-server-side-encryption-customer-key.

No. Este encabezado se requiere cuando se utiliza SSE-C.

Elementos de solicitud

Esta solicitud no implica ningún elemento.

Sintaxis de respuesta

1
2
3
4
5
6
HTTP/1.1 status_code
Content-Type: type
Date: date
Content-Length: length
Etag: etag
Last-Modified: time

Encabezados de respuesta

La respuesta a la solicitud utiliza encabezados comunes. Para más detalles, consulte Tabla 1.

Además de los encabezados de respuesta comunes, los encabezados de mensaje enumerados en Tabla 3 puede ser usado.

Tabla 3 Encabezados de respuesta adicionales

Encabezado

Descripción

x-obs-expiration

Cuando un objeto tiene su regla de ciclo de vida, el tiempo de caducidad del objeto está sujeto a esta regla. Este campo de encabezado es usar expiry-date para describir la fecha de caducidad del objeto. Si la regla de ciclo de vida está configurada solo para todo el bucket, no para objetos individuales, el tiempo de expiración del objeto está sujeto a la regla de ciclo de vida del bucket. Este campo de encabezado utiliza expiry-date y rule-id para describir la información de caducidad detallada de los objetos. Si no se configura ninguna regla de ciclo de vida, este campo de encabezado no está contenido en la respuesta.

Tipo: string

x-obs-website-redirect-location

Indica la ubicación redirigida. Si el bucket está configurado con información de sitio web, este parámetro se puede establecer para los metadatos de objeto de modo que el punto de conexión de sitio web evalúe la solicitud para el objeto como una redirección 301 a otro objeto en el mismo bucket o una URL externa.

Tipo: string

x-obs-version-id

ID de versión del objeto. Si el objeto no tiene ningún número de versión especificado, la respuesta no contiene este encabezado.

Tipo: string

Valor predeterminado: ninguno

Access-Control-Allow-Origin

Indica que el origen se incluye en la respuesta si el origen de la solicitud cumple los requisitos de configuración de CORS cuando CORS está configurado para los bucket.

Tipo: string

Access-Control-Allow-Headers

Indica que los encabezados se incluyen en la respuesta si los encabezados de la solicitud cumplen los requisitos de configuración de CORS cuando CORS está configurado para los bucket.

Tipo: string

Access-Control-Max-Age

Valor de MaxAgeSeconds en la configuración CORS del servidor cuando CORS está configurado para los bucket.

Tipo: integer

Access-Control-Allow-Methods

Indica que los métodos de la regla se incluyen en la respuesta si Access-Control-Request-Method en la solicitud cumple los requisitos de configuración de CORS cuando CORS está configurado para los bucket.

Tipo: string

Opciones de valor: GET, PUT, HEAD, POST, DELETE

Access-Control-Expose-Headers

Valor de ExposeHeader en la configuración de CORS de un servidor cuando CORS está configurado para los bucket.

Tipo: string

x-obs-server-side-encryption

Este encabezado se incluye en una respuesta si se utiliza SSE-KMS.

Tipo: string

Ejemplo: x-obs-server-side-encryption:kms

x-obs-server-side-encryption-kms-key-id

Indica el ID de clave principal. Este encabezado se incluye en una respuesta si se utiliza SSE-KMS.

Tipo: string

Formato: regionID:domainID:key/key_id regionID indica el ID de la región a la que pertenece la clave. domainID indica el ID del tenant al que pertenece la clave. key_id indica el ID de clave utilizado en esta encriptación.

Ejemplo: x-obs-server-side-encryption-kms-key-id:region:domainiddomainiddomainiddoma0001:key/4f1cd4de-ab64-4807-920a-47fc42e7f0d0

x-obs-server-side-encryption-customer-algorithm

Indica un algoritmo de descifrado. Este encabezado se incluye en una respuesta si se utiliza SSE-C.

Tipo: string

Ejemplo: x-obs-server-side-encryption-customer-algorithm:AES256

x-obs-server-side-encryption-customer-key-MD5

Indica el valor MD5 de una clave utilizada para descifrar objetos. Este encabezado se incluye en una respuesta si se utiliza SSE-C.

Tipo: string

Ejemplo: x-obs-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==

x-obs-storage-class

Este encabezado se devuelve cuando la clase de almacenamiento de un objeto no es Standard. El valor puede ser WARM o COLD.

Tipo: string

x-obs-restore

Este encabezado se devuelve cuando se está restaurando o se ha restaurado un objeto de un Archive o un Deep Archive. Representa el estado de restauración del objeto, que puede ser ongoing-request="true" (el objeto se está restaurando) u ongoing-request="false", expiry-date="Wed, 7 Nov 2012 00:00:00 GMT" (el objeto se ha restaurado). En estos estados, el expiry-date indica cuándo caducará el objeto restaurado.

Tipo: string

x-obs-object-type

Si el objeto no es normal, se devuelve este campo de encabezado. El valor puede ser Appendable

Tipo: string

x-obs-next-append-position

Este campo de encabezado se devuelve cuando el objeto es un objeto anexable.

Tipo: integer

x-obs-uploadId

Este encabezado se devuelve si el objeto es una combinación de varias partes. El valor de encabezado indica el ID de la tarea de carga multiparte correspondiente.

Tipo: string

x-obs-object-lock-mode

Modo de WORM que se aplicará al objeto. Actualmente, solo se admite COMPLIANCE. Este encabezado solo se devuelve cuando el objeto tiene una política de retención a nivel de objeto configurada o se ha aplicado la política de WORM a nivel de bucket predeterminada. Para configurar este encabezado, se requiere el permiso GetObjectRetention.

Tipo: string

Ejemplo: x-obs-object-lock-mode:COMPLIANCE

x-obs-object-lock-retain-until-date

Indica el tiempo de caducidad de la retención de WORM. El valor debe ser una hora UTC que cumpla con la norma ISO 8601, por ejemplo 2015-07-01T04:11:15Z. Este encabezado solo se devuelve cuando el objeto tiene una política de retención a nivel de objeto configurada o se ha aplicado la política de WORM a nivel de bucket predeterminada. Para configurar este encabezado, se requiere el permiso GetObjectRetention.

Tipo: string

Ejemplo: x-obs-object-lock-retain-until-date:2015-07-01T04:11:15Z

Elementos de respuesta

Esta respuesta no contiene elementos.

Respuestas de error

No se devuelven respuestas de error especiales. Para obtener más información sobre las respuestas de error, consulte Tabla 2.

Modelo de solicitud

1
2
3
4
5
6
HEAD /object1 HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 04:19:25 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:/cARjk81l2iExMfQqn6iT3qEZ74=

Modelo de respuesta

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 8DF400000163D3E4BB5905C41B6E65B6
Accept-Ranges: bytes
ETag: "3b46eaf02d3b6b1206078bb86a7b7013"
Last-Modified: WED, 01 Jul 2015 01:19:21 GMT
Content-Type: binary/octet-stream
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSD3nAiTaBoeyt9oHp9vTYtXnLDmwV6D
Date: WED, 01 Jul 2015 04:19:21 GMT
Content-Length: 4572