Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Atualizado em 2022-11-07 GMT+08:00

Consulta de metadados de objeto

Funções

Usuários com permissão de leitura em objetos podem executar a operação HeadObject para obter metadados de objetos. Os metadados do objeto são incluídos na resposta.

Esta operação suporta encriptação do lado do servidor.

Controle de versões

Por padrão, esta operação retorna os metadados mais recentes de um objeto. Se o objeto tiver um marcador de exclusão, o código de status 404 será retornado. Para obter os metadados do objeto de uma versão especificada, o parâmetro versionId pode ser usado para especificar a versão desejada.

Sintaxe da solicitação

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

Parâmetros de solicitação

Tabela 1 descreve os parâmetros de solicitação.

Tabela 1 Parâmetros de solicitação

Parâmetro

Descrição

Obrigatório

versionId

ID da versão do objeto

Tipo: string

Não

Cabeçalhos de solicitação

Essa solicitação usa cabeçalhos comuns. Para mais detalhes, consulte Tabela 3.

Além disso, a solicitação pode usar cabeçalhos adicionais, conforme mostrado em Tabela 2.

Tabela 2 Cabeçalhos de solicitação

Cabeçalho

Descrição

Obrigatório

Origin

Origem da solicitação de cross-domain especificada pela pré-solicitação. Geralmente, é um nome de domínio.

Tipo: string

Sim

Access-Control-Request-Headers

Indica os cabeçalhos HTTP de uma solicitação. A solicitação pode usar vários cabeçalhos HTTP.

Tipo: string

Não

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

Indica um algoritmo de descriptografia. O cabeçalho é usado no modo SSE-C.

Tipo: string

Exemplo: x-obs-server-encryption-customer-algorithm:AES256

Restrições: Este cabeçalho deve ser usado em conjunto com x-obs-server-side-encryption-customer-key e x-obs-server-side-encryption-customer-key-MD5.

Não. Este cabeçalho é necessário quando SSE-C é usado.

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

Indica uma chave usada para descriptografar objetos. O cabeçalho é usado no modo SSE-C.

Tipo: string

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

Restrições: Esse cabeçalho é uma chave de 256 bits codificada em Base64 e deve ser usado em conjunto com x-obs-server-side-encryption-customer-algorithm e x-obs-server-side-encryption-customer-key-MD5.

Não. Este cabeçalho é necessário quando SSE-C é usado.

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

Indica o valor MD5 de uma chave usada para descriptografar objetos. O cabeçalho é usado no modo SSE-C. O valor MD5 é usado para verificar se ocorre algum erro durante a transmissão da chave.

Tipo: string

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

Restrições: Esse cabeçalho é uma string codificada em Base64 de 128 bits e deve ser usada em conjunto com x-obs-server-side-encryption-customer-algorithm e x-obs-server-side-encryption-customer-key.

Não. Este cabeçalho é necessário quando SSE-C é usado.

Elementos de solicitação

Este pedido não envolve elementos.

Sintaxe da resposta

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

Cabeçalhos de resposta

A resposta à solicitação usa cabeçalhos comuns. Para mais detalhes, consulte Tabela 1.

Além da resposta comum cabeçalhos, a seguinte mensagem cabeçalhos também podem ser utilizados. Para mais detalhes, consulte Tabela 3.

Tabela 3 Parâmetros adicionais de cabeçalho de resposta

Cabeçalho

Descrição

x-obs-expiration

Quando um objeto tem sua regra de ciclo de vida, o tempo de expiração do objeto está sujeito à sua regra de ciclo de vida. Esse campo de cabeçalho é usar expiry-date para descrever a data de expiração do objeto. Se a regra do ciclo de vida for configurada somente para o bucket inteiro, não para objetos individuais, o tempo de expiração do objeto estará sujeito à regra do ciclo de vida do bucket. Esse campo de cabeçalho usa a expiry-date e rule-id para descrever as informações detalhadas de expiração dos objetos. Se nenhuma regra de ciclo de vida estiver configurada, esse campo de cabeçalho não estará contido na resposta.

Tipo: string

x-obs-website-redirect-location

Indica o local redirecionado para. Se o bucket for configurado com informações do site, esse parâmetro poderá ser definido para os metadados do objeto, de modo que o ponto de extremidade do site avalie a solicitação do objeto como um redirecionamento 301 para outro objeto no mesmo bucket ou para um URL externo.

Tipo: string

x-obs-version-id

ID da versão do objeto. Se o objeto não tiver um número de versão especificado, a resposta não conterá esse cabeçalho.

Tipo: string

Não há valor padrão.

Access-Control-Allow-Origin

Indica que a origem é incluída na resposta se a origem na solicitação atender aos requisitos de configuração do CORS quando o CORS é configurado para buckets.

Tipo: string

Access-Control-Allow-Headers (Cabeçalhos de Acesso-Controle-Permitir)

Indica que os cabeçalhos serão incluídos na resposta se os cabeçalhos da solicitação atenderem aos requisitos de configuração do CORS quando o CORS for configurado para buckets.

Tipo: string

Access-Control-Max-Age

Valor de MaxAgeSeconds na configuração CORS do servidor quando o CORS é configurado para buckets.

Tipo: inteiro

Access-Control-Allow-Methods

Indica que os métodos na regra são incluídos na resposta se Access-Control-Request-Method na solicitação atender aos requisitos de configuração do CORS quando o CORS estiver configurado para buckets.

Tipo: string

Os valores possíveis são GET, PUT, HEAD, POST e DELETE.

Access-Control-Expose-Headers

Valor de ExposeHeader na configuração CORS de um servidor quando o CORS é configurado para buckets.

Tipo: string

x-obs-server-side-encryption

Este cabeçalho é incluído em uma resposta se SSE-KMS for usado.

Tipo: string

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

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

Indica a ID da chave mestra. Este cabeçalho é incluído em uma resposta se SSE-KMS for usado.

Tipo: string

O formato é o seguinte:regionID:domainID:key/key_id regionID é o ID da região à qual a chave pertence. domainID é o ID da conta do locatário ao qual a chave pertence. key_id é o ID da chave usado nessa encriptação.

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

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

Indica um algoritmo de descriptografia. Este cabeçalho é incluído em uma resposta se SSE-C é usado.

Tipo: string

Exemplo: x-obs-server-encryption-customer-algorithm:AES256

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

Indica o valor MD5 de uma chave usada para descriptografar objetos. Este cabeçalho é incluído em uma resposta se SSE-C é usado.

Tipo: string

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

x-obs-storage-class

Esse cabeçalho é retornado quando a classe de armazenamento de um objeto não é Padrão. Opções de valor: WARM e COLD

Tipo: string

x-obs-restore

Para um objeto um arquivoque está sendo restaurado ou foi restaurado, esse cabeçalho é retornado. Indica o status de restauração do objeto. As opções de valor são as seguintes: restaurando em curso-request=true; você obteve em curso-request=false, expiração-date=Wed, 07 Nov 2012 00:00:00 GMT. Nas informações anteriores, a data de expiração indica o tempo de expiração após o objeto ser restaurado.

Tipo: string

x-obs-object-type

Se o objeto não for normal, este campo de cabeçalho é retornado. O valor pode ser Appendable

Tipo: string

x-obs-next-append-position

Este campo de cabeçalho é retornado quando o objeto é um objeto anexável.

Tipo: inteiro

x-obs-uploadId

Este cabeçalho é retornado se o objeto for uma combinação de várias partes. O valor de cabeçalho indica o ID da tarefa de upload de várias partes correspondente.

Tipo: string

Elementos de resposta

Esta resposta não contém elementos.

Respostas de erro

Nenhuma resposta de erro especial é retornada. Para obter detalhes sobre respostas de erro, consulte Tabela 2.

Solicitação de exemplo

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=

Resposta de exemplo

 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