Definir rótulos de bucket

Para adicionar ou modificar rótulos em um bucket, faça uma solicitação PUT com escopo para o bucket pretendido e use o parâmetro de string de consulta tagging. junto com um elemento <Tagging> no corpo da solicitação.

Parâmetros de string de consulta

Parâmetro Descrição Obrigatório
tagging Usado ao adicionar ou modificar rótulos aplicados a um bucket. Se usado, inclua os rótulos no corpo da solicitação. Não

Consulte parâmetros de string de consulta de URL assinado para informações sobre os parâmetros incluídos ao criar e usar URLs assinados.

Cabeçalhos de solicitação

Veja cabeçalhos de solicitação comuns.

Elementos do corpo da solicitação

Os elementos do corpo da solicitação a seguir serão aplicáveis somente se você usar o parâmetro de string de consulta tagging para definir os rótulos aplicados ao bucket.

Element Descrição
Tagging O contêiner do TagSet.
TagSet É o contêiner de todos os rótulos aplicados ao bucket.
Tag É um contêiner para um rótulo individual. Um rótulo é composto por um par key:value.
Key A chave de um rótulo.
Value O valor de um rótulo.

Sintaxe da solicitação

A sintaxe a seguir se aplica às solicitações PUT Bucket que usam o parâmetro de string de consulta tagging.

PUT /?tagging HTTP/1.1
Host: BUCKET_NAME.storage.googleapis.com
Date: DATE
Content-Length: REQUEST_BODY_LENGTH
Authorization: AUTHENTICATION_STRING

<?xml version="1.0" encoding="UTF-8"?>
<Tagging>
  <TagSet>
     <Tag>
       <Key>LABEL_KEY</Key>
       <Value>LABEL_VALUE</Value>
     </Tag>
  </TagSet>
</Tagging>

Cabeçalhos de resposta

A solicitação pode retornar diversos cabeçalhos de resposta, dependendo dos cabeçalhos de solicitação usados.

Elementos do corpo da resposta

A resposta não inclui um documento XML no corpo da resposta.

Exemplo

O exemplo a seguir define uma configuração de rótulo que consiste em dois rótulos em um bucket chamado my-bucket.

Solicitação

PUT /?tagging HTTP/1.1
Host: my-bucket.storage.googleapis.com
Date: Thu, 24 Jan 2016 02:34:56 GMT
Content-Length: 196
Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg

<?xml version="1.0" encoding="UTF-8"?>
<Tagging>
  <TagSet>
     <Tag>
       <Key>environment</Key>
       <Value>production</Value>
     </Tag>
     <Tag>
       <Key>billing</Key>
       <Value>marketing-department</Value>
     </Tag>
  </TagSet>
</Tagging>

Resposta

HTTP/1.1 200 OK
Date: Thu, 24 Jan 2016 02:34:56 GMT
Expires: Mon, 01 Jan 1990 00:00:00 GMT
Cache-Control: no-cache, no-store, must-revalidate
Content-Length: 0
Content-Type: text/html