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
1 2 3 4 5 6 7 8 |
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
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.
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
1 2 3 4 5 |
HTTP/1.1 status_code Date: date Content-Length: length Etag: etag Last-Modified: time |
Cabeçalhos 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.
1 2 3 4 5 6 7 8 9 |
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
1 2 3 4 5 6 7 8 9 |
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
1 2 3 4 5 6 7 8 9 |
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
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 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.
1 2 3 4 5 6 7 8 |
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
1 2 3 4 5 6 7 8 |
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 |