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

Configuração de tags para um bucket

Funções

Essa operação adiciona tags a um bucket.

Depois que as tags forem adicionadas a um bucket, todos os registros de dados de cobrança (os CDR) gerados pelas solicitações desse bucket receberão as mesmas tags. Assim, os relatórios de CDR podem ser categorizados para análise detalhada de custos. Por exemplo, se um aplicativo em execução fizer carregamento de dados em um bucket, você poderá marcar o bucket com o nome do aplicativo. Desta forma, os custos na aplicação podem ser analisados usando tags nos CDR.

Para executar essa operação, você deve ter a permissão PutBucketTagging. Por padrão, somente o proprietário do bucket pode excluir as tags de um bucket. O proprietário do bucket pode permitir que outros usuários executem essa operação definindo uma política de bucket ou concedendo a eles a permissão.

  • Um bucket pode ter no máximo 10 tags.
  • Uma chave de tag e um valor de chave podem conter no máximo 36 e 43 caracteres, respectivamente.
  • Chaves de marca e valores de chave não podem conter vírgulas (*), barras verticais (|), sinais de menor que (<), sinais de maior que (,), sinais de igual (=), barras invertidas Códigos ASCII (0x00 a 0x1F).

Sintaxe da solicitação

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
PUT /?tagging HTTP/1.1 
Host: bucketname.obs.region.myhuaweicloud.com 
Date: date
Authorization: authorization string
Content-SHA256: SHA256
<Tagging> 
    <TagSet>
        <Tag> 
            <Key>Tag Name</Key> 
            <Value>Tag Value</Value> 
        </Tag> 
    </TagSet> 
</Tagging>

Parâmetros de solicitação

Esta solicitação não contém nenhum parâmetro.

Cabeçalhos de solicitação

Tabela 1 lista o cabeçalho da solicitação.

Tabela 1 Cabeçalhos de solicitação

Cabeçalho

Descrição

Obrigatório

Content-SHA256

Base64-encoded 256-bit SHA256 resumo da mensagem de acordo com SHA.

Tipo: string

Exemplo: ogX9qClMrVJUBiUSIKDFM0qO41jJM0I5SCN55/OtMyI=

Sim

Elementos de solicitação

Nessa solicitação, você deve configurar tags de bucket no corpo da solicitação. A configuração da tag é carregada no formato XML. Tabela 2 descreve os elementos de configuração.

Tabela 2 Elementos de configuração da etiqueta de bucket

Cabeçalho

Descrição

Obrigatório

Tagging

Elemento do conjunto de tags e tag

Tipo: elemento

Antepassado: nenhum

Sim

TagSet

Elemento do conjunto de tags

Tipo: elemento

Antepassado: Adição de tags

Sim

Tag

Elemento da informação da tag

Tipo: elemento

Antepassado: TagSet

Sim

Key

Nome da etiqueta

Tipo: string

Antepassado: Tag

Sim

Value

Valor da tag

Tipo: string

Antepassado: Tag

Sim

Sintaxe da resposta

1
2
3
4
5
HTTP/1.1 status_code
x-obs-request-id: request id
x-obs-id-2: id
Content-Length: length
Date: date

Cabeçalhos de resposta

A resposta à solicitação usa cabeçalhos comuns. Para mais detalhes, consulte Tabela 1.

Elementos de resposta

Esta resposta não envolve elementos.

Respostas de erro

Além de códigos de erro comuns, essa API também retorna outros códigos de erro. A tabela a seguir lista erros comuns e possíveis causas. Para mais detalhes, consulte Tabela 3.

Tabela 3 Erros de configuração da tag do bucket

Código de erro

Descrição

Código de status HTTP

InvalidTagError

Uma tag inválida é fornecida ao configurar tags de bucket.

400 Bad Request

MalformedXMLError

Um formato XML incorreto é fornecido ao configurar tags de bucket.

400 Bad Request

Solicitação de exemplo

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
PUT /?tagging HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: Wed, 27 Jun 2018 13:22:50 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:Pf1ZyGvVYg2BzOjokZ/BAeR1mEQ=
Content-SHA256: ogX9qClMrVJUBiUSIKDFM0qO41jJM0I5SCN55/OtMyI=
Content-Length: 182

<Tagging xmlns="http://obs.ap-southeast-1.myhuaweicloud.com/doc/2015-06-30/">
  <TagSet>
    <Tag>
      <Key>TagName1</Key>
      <Value>TageSetVaule1</Value>
    </Tag>
  </TagSet>
</Tagging>

Resposta de exemplo

1
2
3
4
5
HTTP/1.1 204 No Content
Server: OBS
x-obs-request-id: BF26000001643FEBA09B1ED46932CD07
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCSEZp87iEirC6DggPB5cN49pSvHBWClg
Date: Wed, 27 Jun 2018 13:22:50 GMT