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