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.

Central de ajuda> Object Storage Service> Referência de API> As API> Operações em objetos> Modificação de metadados de um objeto

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

Ver PDF

Modificação de metadados de um objeto

Funções

Esta operação modifica, exclui ou adiciona metadados aos objetos carregados em um bucket.

Sintaxe da solicitação

    
         PUT /ObjectName?metadata HTTP/1.1 
Host: bucketname.obs.region.myhuaweicloud.com 
Content-Type: application/xml 
Content-Length: length
Authorization: authorization
Date: date
<Optional Additional Header> 
<object Content>

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

O OBS suporta os seis cabeçalhos de solicitação HTTP: Cache-Control, Expires, Content-Encoding, Content-Disposition, Content-Type e Content-Language. Ele salva esses valores de cabeçalho nos metadados do objeto. Quando o objeto é baixado ou consultado, os valores salvos são definidos para os cabeçalhos HTTP correspondentes e retornados ao cliente.

**Tabela 2** Cabeçalhos de solicitação
Cabeçalho	Descrição	Obrigatório
x-obs-metadata-directive	Indicador de operação de metadados. O valor pode ser REPLACE_NEW or REPLACE. REPLACE_NEW: Os metadados que têm um valor existente são substituídos. É atribuído um valor aos metadados que não tem um valor. Os metadados não especificados permanecem inalterados. (Observação: um cabeçalho com metadados personalizados é substituído.) REPLACE: Use o campo de cabeçalho transportado na solicitação atual para substituir os metadados originais. Os metadados não especificados (exceto x-obs-storage-class) serão excluídos. Tipo: string	Sim
Cache-Control	Especifica o comportamento de cache da página da Web quando o objeto é baixado. Tipo: string	Não
Content-Disposition	Especifica o nome do objeto quando ele é baixado. Tipo: string	Não
Content-Encoding	Especifica o formato de codificação de conteúdo quando um objeto está sendo carregado. Tipo: string	Não
Content-Language	Especifica o formato do idioma do conteúdo quando um objeto é baixado. Tipo: string	Não
Content-Type	Tipo de arquivo do objeto. Tipo: string	Não
Expires	Especifica o tempo de expiração do cache da página da Web quando o objeto é baixado. Tipo: string	Não
x-obs-website-redirect-location	Quando o bucket é configurado com o redirecionamento do site, a solicitação para obter o objeto pode ser redirecionada para outro objeto ou para uma URL externa no bucket. No exemplo a seguir, o cabeçalho da solicitação define o redirecionamento para um objeto (anotherPage.html) no mesmo bucket: x-obs-website-redirect-location:/anotherPage.html No exemplo a seguir, o cabeçalho da solicitação define o redirecionamento do objeto para uma URL externa: x-obs-website-redirect-location:http://www.example.com/ Tipo: string Restrição: O valor deve ser prefixado por uma barra (/), http://, ou https://. O comprimento do valor não pode exceder 2 KB.	Não
x-obs-storage-class	Especifica a classe de armazenamento de um objeto. Tipo: string O OBS fornece três classes de armazenamento: Padrão (STANDARD), Acesso Infrequente (WARM) e Arquivo (COLD). Portanto, os valores para este elemento podem ser STANDARD, WARM, e COLD. O feitiço desses valores é sensível a maiúsculas e minúsculas. Examplo: x-obs-storage-class: STANDARD	Não
x-obs-meta-*	Um cabeçalho de mensagem começando com x-obs-meta- pode ser adicionado a uma solicitação para adicionar metadados personalizados para gerenciamento de objetos. Os metadados personalizados serão retornados no cabeçalho da resposta quando você recuperar ou consultar os metadados do objeto. Para obter mais informações, consulte Gerenciamento de metadados de objeto. Tipo: string Exemplo: x-obs-meta-test: test metadata	Não

Elementos de solicitação

Este pedido não envolve elementos.

Sintaxe da resposta

    
         HTTP/1.1 status_code
Date: date
Content-Length: length
Etag: etag
Last-Modified: time

Cabeçalhos de resposta

**Tabela 3** Parâmetros adicionais de cabeçalho de resposta
Cabeçalho	Descrição
x-obs-metadata-directive	Indicador de operação de metadados. O valor pode ser REPLACE_NEW ou REPLACE. Tipo: string
Cache-Control	Especifica o comportamento de cache da página da Web quando o objeto é baixado. Se um pedido carrega este cabeçalho campo, a resposta mensagem deve conter este cabeçalho campo. Tipo: string
Content-Disposition	Especifica o nome do objeto quando ele é baixado. Se um pedido carrega este cabeçalho campo, a resposta mensagem deve conter este cabeçalho campo. Tipo: string
Content-Encoding	Especifica o formato de codificação de conteúdo quando um objeto está sendo carregado. Se um pedido carrega este cabeçalho campo, a resposta mensagem deve conter este cabeçalho campo. Tipo: string
Content-Language	Especifica o formato do idioma do conteúdo quando um objeto é baixado. Se um pedido carrega este cabeçalho campo, a resposta mensagem deve conter este cabeçalho campo. Tipo: string
Expires	Especifica o tempo de expiração do cache da página da Web quando o objeto é baixado. Se um pedido carrega este cabeçalho campo, a resposta mensagem deve conter este cabeçalho campo. Tipo: string
x-obs-website-redirect-location	Quando o bucket é configurado com o redirecionamento do site, a solicitação para obter o objeto pode ser redirecionada para outro objeto ou para uma URL externa no bucket. Se um pedido carrega este cabeçalho campo, a resposta mensagem deve conter este cabeçalho campo. Tipo: string
x-obs-storage-class	Especifica a classe de armazenamento de um objeto. Se um pedido carrega este cabeçalho campo, a resposta mensagem deve conter este cabeçalho campo. Tipo: string
x-obs-meta-*	Os metadados personalizados são usados para gerenciar objetos de maneira personalizada. Se um pedido carrega este cabeçalho campo, a resposta mensagem deve conter este cabeçalho campo. Tipo: string

Elementos de resposta

Esta resposta não envolve 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

Adicição de metadados de objeto

Adicione os seguintes metadados ao objeto: Content-Type:application/zip and x-obs-meta-test:meta.

    
         PUT /object?metadata HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 14:24:33 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:NxtSMS0jaVxlLnxlO9awaMTn47s=
x-obs-metadata-directive:REPLACE_NEW
Content-Type:application/zip
x-obs-meta-test:meta

Resposta de exemplo 1

    
         HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 8DF400000163D3E4BB5905C41B6E65B6
Accept-Ranges: bytes
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSD3nAiTaBoeyt9oHp9vTYtXnLDmwV6D
Date: WED, 01 Jul 2015 04:19:21 GMT
Content-Length: 0
x-obs-metadata-directive:REPLACE_NEW
x-obs-meta-test:meta

Solicitação de exemplo 2

Modificação de metadados de objeto

Se os metadados x-obs-meta-test:testmeta existirem no objeto e o valor de x-obs-storage-class for WARM, altere os metadados x-obs-meta-test do objeto para newmeta e altere x-obs-storage-class para COLD

    
         PUT /object?metadata HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 14:24:33 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:NxtSMS0jaVxlLnxlO9awaMTn47s=
x-obs-metadata-directive:REPLACE_NEW
x-obs-meta-test:newmeta
x-obs-storage-class:COLD

Resposta da amostra 2

    
         HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 8DF400000163D3E4BB5905C41B6E65B6
Accept-Ranges: bytes
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSD3nAiTaBoeyt9oHp9vTYtXnLDmwV6D
Date: WED, 01 Jul 2015 04:19:21 GMT
Content-Length: 0
x-obs-metadata-directive:REPLACE_NEW
x-obs-meta-test:newmeta
x-obs-storage-class:COLD

Solicitação de exemplo 3

Exclusão de metadados de objeto

Metadados x-obs-meta-test:newmeta e Content-Type:application/zipexistem no objeto, e excluem x-obs-meta-test.

    
         PUT /object?metadata HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 14:24:33 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:NxtSMS0jaVxlLnxlO9awaMTn47s=
x-obs-metadata-directive:REPLACE
Content-Type:application/zip

Resposta de exemplo 3

    
         HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: 8DF400000163D3E4BB5905C41B6E65B6
Accept-Ranges: bytes
x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSD3nAiTaBoeyt9oHp9vTYtXnLDmwV6D
Date: WED, 01 Jul 2015 04:19:21 GMT
Content-Length: 0
x-obs-metadata-directive:REPLACE