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-14 GMT+08:00

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

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

1
2
3
4
5
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.

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