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