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