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.

En esta página

Funciones
Control de versiones
Sintaxis de solicitud
Parámetros de solicitud
Encabezados de solicitud
Elementos de solicitud
Sintaxis de respuesta
Encabezados de respuesta
Elementos de respuesta
Respuestas de error
Modelo de solicitud
Modelo de respuesta

Mostrar todo

Centro de ayuda/ Object Storage Service/ Referencia de la API/ Las API/ Operaciones en objetos/ Consulta de metadatos de objetos

Consulta de metadatos de objetos

Actualización más reciente 2024-09-18 GMT+08:00

Ver PDF

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

    
       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

    
       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

    
       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

    
       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

Tema principal: Operaciones en objetos

Tema anterior: Descarga de objetos

Tema siguiente: Eliminación de un objeto

Comentarios

¿Le pareció útil esta página?

Sí No

Deje algún comentario

Muchas gracias por sus comentarios. Seguiremos trabajando para mejorar la documentación.

El sistema está ocupado. Vuelva a intentarlo más tarde.

¿Cuáles de los siguientes problemas se presentaron?

Contenido diferente a la de la IU del producto

Descripciones poco claras

Falta de ejemplos o código

Pasos incorrectos

No puedo encontrar lo que necesito

Falta de prácticas recomendadas

Comentarios (opcional)

0/500

Seleccione al menos un tipo de problema e ingrese sus comentarios o sugerencias.

Ingrese 500 caracteres como máximo.

Enviar Cancelar