Configura etiquetas de depósitos

Para agregar o modificar las etiquetas aplicadas a un depósito, debes realizar una solicitud PUT que tenga alcance al depósito deseado y usar el parámetro de string de consulta tagging. junto con un elemento <Tagging> en el cuerpo de la solicitud.

Parámetros de string de consulta

Parámetro Descripción Obligatorio
tagging Se usa cuando se agregan o modifican etiquetas aplicadas a un depósito. Si se usa, incluye las etiquetas en el cuerpo de la solicitud. No

Consulta los parámetros de string de consulta de URL firmados para obtener información sobre los parámetros que incluyes cuando creas y usas URL firmadas.

Solicita encabezados

Consulta encabezados de solicitud comunes.

Elementos de cuerpo de la solicitud

Los siguientes elementos del cuerpo de la solicitud solo se aplican si usas el parámetro de string de consulta tagging para configurar las etiquetas que se aplican al depósito.

Elemento Descripción
Tagging Es el contenedor de TagSet.
TagSet El contenedor de todas las etiquetas que se aplican al depósito.
Tag Es un contenedor de una etiqueta individual. Una etiqueta está compuesta por un par key:value.
Key La clave de una etiqueta.
Value El valor de una etiqueta.

Sintaxis de la solicitud

La siguiente sintaxis se aplica a las solicitudes del depósito PUT que usan el 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>

Encabezados de respuesta

La solicitud puede mostrar una variedad de encabezados de respuesta según los encabezados de la solicitud que uses.

Elementos del cuerpo de la respuesta

La respuesta no incluye un documento XML en el cuerpo de la respuesta.

Ejemplo

En el siguiente ejemplo, se establece una configuración de etiqueta que consta de dos etiquetas a un depósito llamado my-bucket.

Solicitud

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>

Respuesta

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