Todos los productos
Search

Este producto

    Object Storage Service:GetObjectMeta

    Centro de documentos

    Object Storage Service:GetObjectMeta

    Última actualización: Sep 03, 2026

    La operación GetObjectMeta recupera los metadatos de un objeto, incluidos su ETag, tamaño y hora de última modificación, sin devolver el contenido del objeto.

    Notas

    Nota

    Si el objeto es un enlace simbólico, se devuelven los metadatos del enlace simbólico.

    Si el control de versiones está deshabilitado, debe tener el permiso oss:GetObject. Si el control de versiones está habilitado, debe tener el permiso oss:GetObjectVersion para recuperar los metadatos de una versión específica. Especifique la versión con el encabezado de solicitud x-oss-version-id. Grant custom permissions to a RAM user.

    Control de versiones

    De forma predeterminada, GetObjectMeta recupera los metadatos de la versión actual. Si la versión actual es un marcador de eliminación, OSS devuelve 404 Not Found. Si especifica un versionId en la solicitud, se devuelven los metadatos de esa versión.

    Sintaxis de la solicitud

    HEAD /ObjectName?objectMeta HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

    Encabezados de solicitud

    DescribeRegions utiliza únicamente encabezados de solicitud comunes. Para más información, consulte Common request headers.

    Encabezados de respuesta

    Encabezado de respuesta

    Tipo

    Ejemplo

    Descripción

    Content-Length

    String

    344606

    El tamaño del objeto en bytes.

    ETag

    String

    5B3C1A2E053D763E1B002CC607C5****

    Se genera un ETag (etiqueta de entidad) al crear un objeto para identificar su contenido.

    Para los objetos creados mediante PutObject, el ETag es el hash MD5 del contenido. Para los objetos creados por otros métodos, el ETag es un valor único, pero no corresponde al hash MD5. Utilice el ETag para comprobar si el contenido ha cambiado, pero no para validar la integridad de los datos mediante MD5.

    Valor predeterminado: None

    x-oss-transition-time

    String

    Tue, 23 Apr 2024 07:21:42 GMT

    La hora en que una regla de ciclo de vida convirtió el objeto a Cold Archive o Deep Cold Archive.

    Nota

    • Si elimina un objeto de Cold Archive o Deep Cold Archive después de 180 días de su conversión, no se aplica ningún cargo por eliminación anticipada. Si elimina el objeto dentro de los 180 días posteriores a su conversión, se aplica un cargo por eliminación anticipada.

    • Este campo no sirve para determinar la hora en que una regla de ciclo de vida convierte un objeto a la clase de almacenamiento IA o Archive. El cumplimiento del requisito de duración mínima de almacenamiento para un objeto IA o Archive depende de la hora Last-Modified.

    x-oss-last-access-time

    String

    Tue, 30 Mar 2021 06:07:48 GMT

    La hora del último acceso al objeto en formato GMT (HTTP 1.1). Se devuelve únicamente cuando el seguimiento de acceso está habilitado. Se actualiza cada vez que se accede al objeto.

    Importante

    La hora del último acceso se actualiza de forma asíncrona. OSS suele actualizarla en un plazo de 24 horas. Si se accede a un objeto varias veces dentro de un periodo de 24 horas, solo se registra la primera hora de acceso.

    Last-Modified

    String

    Fri, 24 Feb 2012 06:07:48 GMT

    La hora de la última modificación del objeto, en formato GMT (HTTP 1.1).

    Nota

    • La duración mínima de almacenamiento para objetos en la clase Infrequent Access es de 30 días. Esta duración se calcula a partir de la hora Last-Modified del objeto. Si elimina un objeto después de 30 días desde su hora Last-Modified, no se aplica ningún cargo por eliminación anticipada.

    • La duración mínima de almacenamiento para objetos en la clase Archive Storage es de 60 días. Esta duración se calcula a partir de la hora Last-Modified del objeto. Si elimina un objeto después de 60 días desde su hora Last-Modified, no se aplica ningún cargo por eliminación anticipada.

    x-oss-version-id

    String

    CAEQNRiBgIDMh4mD0BYiIDUzNDA4OGNmZjBjYTQ0YmI4Y2I4ZmVlYzJlNGVk****

    El ID de versión del objeto. Este campo se devuelve únicamente cuando se obtienen los metadatos de una versión específica de un objeto.

    x-oss-sealed-time

    String

    Sat, 11 Oct 2025 06:41:42 GMT

    La hora en que se realizó la operación de sellado en el objeto anexable, en formato GMT (HTTP 1.1). Se devuelve únicamente para objetos anexables sellados.

    Esta operación también devuelve Common response headers.

    Ejemplos

    • Control de versiones deshabilitado

      Ejemplo de solicitud

      HEAD /oss.jpg?objectMeta HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 29 Apr 2015 05:21:12 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

      Ejemplo de respuesta

      Importante

      Si habilita el namespace jerárquico para un bucket y luego crea una carpeta mediante la operación CreateDirectory, el ETag se devuelve como "null" al llamar a la operación GetObjectMeta para obtener los metadatos de la carpeta.

      • Seguimiento de acceso deshabilitado

        HTTP/1.1 200 OK
x-oss-request-id: 559CC9BDC755F95A6448****
Date: Wed, 29 Apr 2015 05:21:12 GMT
ETag: "5B3C1A2E053D763E1B002CC607C5****"
Last-Modified: Fri, 24 Feb 2012 06:07:48 GMT
Content-Length: 344606
Connection: keep-alive
Server: AliyunOSS

      • Seguimiento de acceso habilitado

        HTTP/1.1 200 OK
x-oss-request-id: 559CC9BDC755F95A6448****
Date: Wed, 29 Apr 2015 05:21:12 GMT
ETag: "5B3C1A2E053D763E1B002CC607C5****"
x-oss-transition-time: Tue, 23 Apr 2024 07:21:42 GMT
x-oss-last-access-time: Thu, 14 Oct 2021 11:49:05 GMT
Last-Modified: Fri, 24 Feb 2012 06:07:48 GMT
Content-Length: 344606
Connection: keep-alive
Server: AliyunOSS

    • Control de versiones habilitado

      Ejemplo de solicitud

      GET /example?objectMeta&versionId=CAEQNRiBgIDMh4mD0BYiIDUzNDA4OGNmZjBjYTQ0YmI4Y2I4ZmVlYzJlNGVk**** HTTP/1.1
Host: versioning-test.oss-cn-hangzhou.aliyuncs.com
Date: Tue, 09 Apr 2019 06:24:00 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

      Ejemplo de respuesta

      • Seguimiento de acceso deshabilitado

        HTTP/1.1 200 OK
x-oss-version-id: CAEQNRiBgIDMh4mD0BYiIDUzNDA4OGNmZjBjYTQ0YmI4Y2I4ZmVlYzJlNGVk****
x-oss-request-id: 5CAC3A80B7AEADE0170005F6
Date: Tue, 09 Apr 2019 06:24:00 GMT
ETag: "1CF5A685959CA2ED8DE6E5F8ACC2****"
Last-Modified: Tue, 09 Apr 2019 06:24:00 GMT
Content-Length: 119914
Connection: keep-alive
Server: AliyunOSS

      • Seguimiento de acceso habilitado

        HTTP/1.1 200 OK
x-oss-version-id: CAEQNRiBgIDMh4mD0BYiIDUzNDA4OGNmZjBjYTQ0YmI4Y2I4ZmVlYzJlNGVk****
x-oss-request-id: 5CAC3A80B7AEADE0170005F6
Date: Tue, 09 Apr 2019 06:24:00 GMT
ETag: "1CF5A685959CA2ED8DE6E5F8ACC2****"
x-oss-last-access-time: Thu, 14 Oct 2021 11:49:05 GMT
Last-Modified: Tue, 09 Apr 2019 06:24:00 GMT
Content-Length: 119914
Connection: keep-alive
Server: AliyunOSS

    SDK

    Puede llamar a esta operación mediante los siguientes SDK:

    Interfaz de línea de comandos ossutil

    El comando correspondiente de ossutil es get-object-meta.

    Referencias

    Manage object metadata

    Códigos de error

    Código de error

    Código de estado HTTP

    Descripción

    Not Found

    404

    El objeto especificado no existe.