Todos os produtos
Search

Este produto

    Object Storage Service:GetObjectMeta

    Central de documentação

    Object Storage Service:GetObjectMeta

    Última atualização: Jul 03, 2026

    A operação GetObjectMeta recupera os metadados de um objeto, incluindo ETag, tamanho e hora da última modificação, sem retornar o conteúdo do objeto.

    Observações

    Nota

    Se o objeto for um link simbólico, a operação retorna os metadados desse link.

    Com o versionamento desativado, você precisa da permissão oss:GetObject. Com o versionamento ativado, a permissão oss:GetObjectVersion é obrigatória para recuperar metadados de uma versão específica. Especifique a versão pelo cabeçalho de solicitação x-oss-version-id. Conceder permissões personalizadas a um usuário RAM.

    Versionamento

    Por padrão, o GetObjectMeta recupera os metadados da versão atual. Se a versão atual for um marcador de exclusão, o OSS retornará 404 Not Found. Caso você especifique um versionId na solicitação, a operação retorna os metadados dessa versão.

    Sintaxe da solicitação

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

    Cabeçalhos da solicitação

    O DescribeRegions utiliza apenas cabeçalhos de solicitação comuns. Para mais informações, consulte Cabeçalhos de solicitação comuns.

    Cabeçalhos da resposta

    Cabeçalho da resposta

    Tipo

    Exemplo

    Descrição

    Content-Length

    String

    344606

    Tamanho do objeto em bytes.

    ETag

    String

    5B3C1A2E053D763E1B002CC607C5****

    Um ETag (entity tag) é gerado durante a criação do objeto para identificar seu conteúdo.

    Para objetos criados via PutObject, o ETag corresponde ao hash MD5 do conteúdo. Em objetos criados por outros métodos, o ETag é um valor único, mas não representa o hash MD5. Utilize o ETag para verificar alterações no conteúdo, e não para validação de integridade de dados via MD5.

    Valor padrão: None

    x-oss-transition-time

    String

    Tue, 23 Apr 2024 07:21:42 GMT

    Momento em que uma regra de ciclo de vida converteu o objeto para Cold Archive ou Deep Cold Archive.

    Nota

    • A exclusão de um objeto Cold Archive ou Deep Cold Archive após 180 dias da conversão não gera taxa de exclusão antecipada. Caso a exclusão ocorra dentro desse período, a taxa será cobrada.

    • Este campo não indica o momento de conversão para as classes de armazenamento IA ou Archive por regra de ciclo de vida. A verificação do tempo mínimo de armazenamento para objetos IA ou Archive baseia-se na hora Last-Modified.

    x-oss-last-access-time

    String

    Tue, 30 Mar 2021 06:07:48 GMT

    Última hora de acesso ao objeto no formato GMT (HTTP 1.1). Retornado apenas quando o rastreamento de acesso está ativado. Atualizado mediante acesso ao objeto.

    Importante

    A atualização da última hora de acesso ocorre de forma assíncrona. O OSS geralmente realiza essa atualização em até 24 horas. Múltiplos acessos dentro desse intervalo registram apenas o primeiro horário.

    Last-Modified

    String

    Fri, 24 Feb 2012 06:07:48 GMT

    Hora da última modificação do objeto, no formato GMT (HTTP 1.1).

    Nota

    • Objetos na classe de armazenamento Infrequent Access possuem tempo mínimo de retenção de 30 dias, contados a partir da hora Last-Modified. Exclusões após esse prazo não incorrem em taxas de exclusão antecipada.

    • Para a classe Archive Storage, o tempo mínimo de retenção é de 60 dias, também calculado pela hora Last-Modified. Não há cobrança de taxa de exclusão antecipada para remoções após esse período.

    x-oss-version-id

    String

    CAEQNRiBgIDMh4mD0BYiIDUzNDA4OGNmZjBjYTQ0YmI4Y2I4ZmVlYzJlNGVk****

    ID da versão do objeto. Este campo aparece somente ao obter metadados de uma versão específica.

    x-oss-sealed-time

    String

    Sat, 11 Oct 2025 06:41:42 GMT

    Hora em que a operação de selagem foi executada no objeto anexável, no formato GMT (HTTP 1.1). Retornado exclusivamente para objetos anexáveis selados.

    Esta operação também retorna Cabeçalhos de resposta comuns.

    Exemplos

    • Versionamento desativado

      Exemplo de solicitação

      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

      Exemplo de resposta

      Importante

      Se você ativar o namespace hierárquico em um bucket e criar uma pasta pela operação CreateDirectory, a chamada subsequente ao GetObjectMeta para obter metadados dessa pasta retornará o ETag como "null".

      • Rastreamento de acesso desativado

        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

      • Rastreamento de acesso ativado

        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

    • Versionamento ativado

      Exemplo de solicitação

      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

      Exemplo de resposta

      • Rastreamento de acesso desativado

        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

      • Rastreamento de acesso ativado

        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

    Você pode executar esta operação com os seguintes SDKs:

    Interface de linha de comando ossutil

    O comando correspondente no ossutil é get-object-meta.

    Referências

    Gerenciar metadados de objetos

    Códigos de erro

    Código de erro

    Código de status HTTP

    Descrição

    Not Found

    404

    O objeto especificado não existe.