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.

Nesta página

Funções
Controle de versões
Sintaxe da solicitação
Parâmetros de solicitação
Cabeçalhos de solicitação
Elementos de solicitação
Sintaxe da resposta
Cabeçalhos de resposta
Elementos de resposta
Respostas de erro
Solicitação de exemplo
Resposta de exemplo

Mostrar todos

Central de ajuda/ Object Storage Service/ Referência de API/ As API/ Operações em objetos/ Consulta de metadados de objeto

Consulta de metadados de objeto

Atualizado em 2022-11-07 GMT+08:00

Ver PDF

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

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

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

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

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

Tópico principal: Operações em objetos

Tópico anterior: Download de objetos

Próximo tópico: Exclusão de um objeto

Feedback

Esta página foi útil?

Sim Não

Deixar um comentário

Obrigado por seus comentários. Estamos trabalhando para melhorar a documentação.

O sistema está ocupado. Tente novamente mais tarde.

Quais dos seguintes problemas você encontrou?

O conteúdo é inconsistente com a UI do produto

Descrições pouco claras

Falta de exemplos ou código

Passos incorretos

Não encontro o que preciso

Falta de melhores práticas

Feedback (opcional)

0/500

Selecione pelo menos um tipo de problema e insira seus comentários ou sugestões.

Insira um máximo de 500 caracteres.

Enviar Cancelar